Page Comparison

Eğer Euromsg SDK 2.0.0 versiyonundan düşük bir versiyon kullanıyorsanız buraya gidin.

...

Table of Contents

...

Adım 1 - Gerekenler

iOS Mobil Uygulaması & Xcode
P12 sertifikası & şifresi veya P8 sertifikası. -P12 sertifikası oluşturmak için tıklayın -P8 sertifikası oluşturmak için tıklayın
AppAlias (RMC Panelinden alınacak) Eğer bir hesabınız bulunmuyorsa satış temsilcimizle iletişime geçebilirsiniz. Buraya tıklayın.

Adım 2 - Kurulum

2.1 Euromsg SDK’sı Cocoapods aracılığıyla kurulmaktadır. Aşağıdaki kodu Podfile dosyanıza ekledikten sonra pod install diyerek kurabilirsiniz.

...

Notification Service Extension zengin push mesajları(görsel, video) almanıza yardımcı olur.

Xcode’u açın ve File > New > Target adımını izleyin
Notification Service Extension'ı seçin ve Next butonuna tıklayın.
Image Modified
Product Name alanına NotificationService yazın ve Finish butonuna tıklayın.
Image Modified
Finish butonuna tıkladıktan sonra açılacak diyalog penceresinde Cancel butonuna basın.
Image Modified
Eğer Activate butonuna tıklarsanız uygulama Target'ı NotificationService olacaktır. Bu bir sorun değildir. Scheme alanından uygulamanızı seçerek düzeltebilirsiniz.
Sol menüden projenizi seçin açılan alanda TARGETS altından NotificationService’i seçin. Deployment Info bölümünde Target alanını iOS 11.0 yapın.
Image Modified

NotificationService.swift dosyasını açın ve içerisindeki kodları aşağıdaki kodlarla değiştirin.

Code Block

language	swift

import UserNotifications
import Euromsg

class NotificationService: UNNotificationServiceExtension {

    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        self.contentHandler = contentHandler
        bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
        Euromsg.configure(appAlias: "

...

EuromsgIOSTest", launchOptions: nil, enableLog: true)
        Euromsg.didReceive(bestAttemptContent, withContentHandler: contentHandler)
    }

    override func serviceExtensionTimeWillExpire() {
        guard let contentHandler = self.contentHandler else {
            return;
        }
        guard let bestAttemptContent = self.bestAttemptContent else {
            return;
        }
        contentHandler(bestAttemptContent)
    }
}

Notification Content Extension Ekleme

Not: Eğer push mesajı gönderimlerinizde Carousel Push kullanacaksanız bunu eklemeniz zorunludur.

...

"Copy only when installing" seçili olmadığından emin olun. Öncelikle Main Targetınızı seçin ardından Build Phases > Embed App Extensions'ı açın. Burada eğer Copy only when installing seçili ise seçimi kaldırın. Bu seçili olması halinde pushlarınızda görsel kullanamazsınız.
Image Added

Notification Content Extension Ekleme

Not: Eğer push mesajı gönderimlerinizde Carousel Push kullanacaksanız bunu eklemeniz zorunludur.

Xcode’u açın ve File > New > Target adımını izleyin
Notification Content Extension'ı seçin ve Next butonuna tıklayın.
Image Modified
Pproduct Name alanına NotificationContent yazın ve Finish butonuna tıklayın.
Image Modified
Finish butonuna tıkladıktan sonra açılacak diyalog penceresinde Cancel butonuna tıklayın.
Image Modified
1. Eğer Activate butonuna tıklarsanız uygulama Target'ı NotificationContent olacaktır. Bu bir sorun değildir. Scheme alanından uygulamanızı seçerek düzeltebilirsiniz.
Sol menüden projenizi seçin açılan alanda TARGETS altından NotificationContent’i seçin. Deployment Info bölümünde Target alanını iOS 11.0 yapın.
Image Modified
MainInterface.storyboard ve NotificationContent.swift dosyalarını silin. Ardından NotificationContent klasörü altına EMNotificationViewController isminde swift dosyası oluşturun. Info.plist dosyasını bu linkteki ile aynı olduğuna dikkat ediniz.
Image Modified
Objective-C Bridging Header oluşturma sorulursa Don’t Create butonuna tıklayın.
Image Modified
EMNotificationViewController.swift açın ve içerisindeki kodları aşağıdaki ile değiştirin.

Code Block

language	swift

import UIKit
import UserNotifications
import UserNotificationsUI
import Euromsg

@available(iOS 10.0, *)
@objc(EMNotificationViewController)
class @objc(EMNotificationViewController)
class EMNotificationViewController: UIViewController, UNNotificationContentExtension {
    
let appUrl = URL(string: "euromsgExample://")
    let carouselView = EMNotificationCarousel.initView()
    var completion: ((_ url: URL?, _ userInfobestAttemptContent: [AnyHashable: Any]UNMutableNotificationContent?) -> Void)?
    func didReceive(_ notification: UNNotification) {

    var notificationRequestIdentifier = ""
    
  carouselView.didReceive(notification)
    }
    func didReceive(_ responsenotification: UNNotificationResponse,UNNotification) {
        notificationRequestIdentifier = notification.request.identifier
        completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
Euromsg.configure(appAlias: "EuromsgIOSTest", launchOptions: nil, enableLog: true)
        carouselView.didReceive(response, completionHandler: completion)notification)
    }
    func didReceive(_ response: UNNotificationResponse, completionHandler completion: @escaping (UNNotificationContentExtensionResponseOption) -> Void) {
        carouselView.didReceive(response, completionHandler: completion)

    }
    override func loadView() {
        completion = { [weak self] url, userInfobestAttemptContent in
            if let urlidentifier = urlself?.notificationRequestIdentifier {
                self?.extensionContext?.open(urlUNUserNotificationCenter.current().removeDeliveredNotifications(withIdentifiers: [identifier])
                if url.scheme != self?.appUrl?.scheme, let userInfo = userInfo {UNUserNotificationCenter.current().getDeliveredNotifications(completionHandler: { notifications in
                    bestAttemptContent?.badge = Euromsg.handlePushNSNumber(pushDictionaryvalue: userInfonotifications.count)
                })
            }

           else if let url = self?.appUrlurl {
                 self?.extensionContext?.open(url)
if #available(iOSApplicationExtension 12.0, *) {
           }         }self?.extensionContext?.dismissNotificationContentExtension()
        carouselView.completion = completion      }
  //Hangi öğenin seçildiğini izlemek istiyorsanız ekleyin         carouselView.delegate = selfself?.extensionContext?.open(url)
          self.view = carouselView} else {
  } } /**  Hangi carousel öğesinin seçildiğini izlemek istiyorsanız ekleyin  */ extension EMNotificationViewController: CarouselDelegate {
 if #available(iOSApplicationExtension 12.0, *) {
       func selectedItem(_ element: EMMessage.Element) {         print("Selected element is => \(element)")self?.extensionContext?.performNotificationDefaultAction()
                }
            }
     }

NotificationContent ve NotificationService için Euromsg SDK’sını eklemeliyiz. Podfile dosyanızı aşağıdaki şekilde düzenleyin ve tekrar terminalden proje dizininize giderek pod install yazarak enter tuşuna basın.

...

Code Block

target 'YOUR_PROJECT_NAME' do   }
    # Comment the next linecarouselView.completion if= youcompletion
don't want to use dynamic frameworks   use_frameworks!
pod 'Euromsg'
post_install do |installer|carouselView.delegate = self
        installer.pods_project.targets.each do |target|self.view = carouselView
    }
}

/**
 Add if target.name == 'Euromsg'
            target.build_configurations.each do |config|you want to track which carousel element has been selected
 */
extension EMNotificationViewController: CarouselDelegate {   
    func selectedItem(_ element: EMMessage.Element) {
      config.build_settings['APPLICATION_EXTENSION_API_ONLY'] = 'No'// Add your work...
        print("Selected endelement is => \(element)")
    } end   
 end
end
  # Pods for RelatedDigital

end

target 'NotificationService}

NotificationContent ve NotificationService için Euromsg SDK’sını eklemeliyiz. Podfile dosyanızı aşağıdaki şekilde düzenleyin ve tekrar terminalden proje dizininize giderek pod install yazarak enter tuşuna basın.

...

Code Block

language	none

target 'YOUR_PROJECT_NAME' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
pod 'Euromsg'
post_install do #|installer|
Pods for RelatedDigital  end

target 'NotificationContent' doinstaller.pods_project.targets.each do |target|
    # Comment the next lineif if you don't want to use dynamic frameworks
  use_frameworks!
pod 'Euromsg'
  # Pods for RelatedDigital

end

AppDelegate.swift

İlk olarak Euromsg ve UserNotifications'ı AppDelegeta’e eklemeliyiz

Code Block

language	swift

import Euromsg
import UserNotifications

class AppDelegate’in sonuna UNUserNotificationCenterDelegate eklemelisiniz. Alt satırda örneğini görebilirsiniz.

Code Block
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate

Aşağıdaki kodlardan uygun olanını didFinishLaunchingWithOptions fonksiyonunun içerisine ekleyin.

Provisional Push

Eğer provisional push izni alınmak isteniyorsa didFinishLaunchingWithOptions’a aşağıdaki kodu ekleyin. iOS 12 ya da daha eski versiyon kullanıcıları için bu fonksiyon askForNotificationPermission şeklinde çalışacaktır.

Code Block

language	swift

target.name == 'Euromsg'
            target.build_configurations.each do |config|
                  UNUserNotificationCenter.current().delegateconfig.build_settings['APPLICATION_EXTENSION_API_ONLY'] = self'No'
            end
    Euromsg.configure(appAlias: "YOUR_APP_ALIAS", enableLog: true) end
    end
end
 Euromsg.registerForPushNotifications() # Pods for RelatedDigital

end

 Euromsg.askForNotificationPermissionProvisional()
target 'NotificationService' do
  # Comment the next line if #available(iOS 13, *) {
            // handle push for iOS 13 and later in sceneDelegate
        }
        else if let userInfo = launchOptions?[UIApplication.LaunchOptionsKey.remoteNotification] as? [String: Any] {
            Euromsg.handlePush(pushDictionary: userInfo)
        }
        return true

Eğer provisional push izni almak istemiyorsanız didFinishLaunchingWithOptions’a aşağıdaki kodu ekleyin.

Code Block

language	swift

        you don't want to use dynamic frameworks
  use_frameworks!
pod 'Euromsg'
  # Pods for RelatedDigital

end

target 'NotificationContent' do
  # Comment the next line if you don't want to use dynamic frameworks
  use_frameworks!
pod 'Euromsg'
  # Pods for RelatedDigital

end

App Groups Ekleme

Tüm hepsini tamamladıktan sonra Targetlara App Groups eklemeniz gerekmektedir.

Görselde sol tarafta işaretlenmiş olan Targetlarda sırasıyla Signing & Capabilities altından App Groups ekleyin. App Groups adını group.YOUR_APP_BUNDLE_IDENTIFIER.relateddigital şeklinde yazın.

...

AppDelegate.swift

İlk olarak Euromsg ve UserNotifications'ı AppDelegeta’e eklemeliyiz

Code Block

language	swift

import Euromsg
import UserNotifications

class AppDelegate’in sonuna UNUserNotificationCenterDelegate eklemelisiniz. Alt satırda örneğini görebilirsiniz.

Code Block
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate

Aşağıdaki kodlardan uygun olanını didFinishLaunchingWithOptions fonksiyonunun içerisine ekleyin.

Provisional Push

Eğer provisional push izni alınmak isteniyorsa didFinishLaunchingWithOptions’a aşağıdaki kodu ekleyin. iOS 12 ya da daha eski versiyon kullanıcıları için bu fonksiyon askForNotificationPermission şeklinde çalışacaktır.

Code Block

language	swift

        UNUserNotificationCenter.current().delegate = self
        
        Euromsg.configure(appAlias: "YOUR_APP_ALIAS", launchOptions: launchOptions, enableLog: true, appGroupsKey: "group.YOUR_BUNDLE_ID.relateddigital", deliveredBadge: false)
        Euromsg.registerForPushNotifications()
        Euromsg.askForNotificationPermissionaskForNotificationPermissionProvisional()
        if #available(iOS 13, *) {
            // handle push for iOS 13 and later in sceneDelegate
        }
        else if let userInfo = launchOptions?[UIApplication.LaunchOptionsKey.remoteNotification] as? [String: Any] {
            Euromsg.handlePush(pushDictionary: userInfo)
        }
        return true

Eğer kullanıcılar bildirim göndermeye izin verirse aşağıdaki metod çalışır ve APNS’ten token alınarak Euromessage sistemlerine kaydolurprovisional push izni almak istemiyorsanız didFinishLaunchingWithOptions’a aşağıdaki kodu ekleyin.

Code Block

language	swift

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        Euromsg.registerToken(tokenData: deviceToken)
    }

RMC paneli üzerinden kullanıcılarınızın push mesajlarına tıklayıp tıklamadıklarını raporlayabilmek için aşağıdaki kodları ekleyin.

Code Block

language	swift

 func application(_ application: UIApplication, UNUserNotificationCenter.current().delegate = self
        
              didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {Euromsg.configure(appAlias: "YOUR_APP_ALIAS", launchOptions: launchOptions, enableLog: true, appGroupsKey: "group.YOUR_BUNDLE_ID.relateddigital", deliveredBadge: false)
        Euromsg.handlePushregisterForPushNotifications(pushDictionary:)
userInfo)     }   Euromsg.askForNotificationPermission()
  func application(_ application: UIApplication,   if #available(iOS 13, *) {
            // handle didReceiveRemoteNotificationpush userInfo:for [AnyHashableiOS :13 Any],and later in sceneDelegate
        }
        else fetchCompletionHandlerif completionHandler:let @escapinguserInfo (UIBackgroundFetchResult) -> Void) {= launchOptions?[UIApplication.LaunchOptionsKey.remoteNotification] as? [String: Any] {
            Euromsg.handlePush(pushDictionary: userInfo)
    }    }
 func userNotificationCenter(_ center: UNUserNotificationCenter,    return true

Eğer kullanıcılar bildirim göndermeye izin verirse aşağıdaki metod çalışır ve APNS’ten token alınarak Euromessage sistemlerine kaydolur.

Code Block
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) { Euromsg.registerToken(tokenData: deviceToken) }

RMC paneli üzerinden kullanıcılarınızın push mesajlarına tıklayıp tıklamadıklarını raporlayabilmek için aşağıdaki kodları ekleyin.

Code Block

language	swift

 func    willPresent notificationapplication(_ application: UNNotificationUIApplication,
                     didReceiveRemoteNotification userInfo: [AnyHashable : Any]) {
     withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptionsEuromsg.handlePush(pushDictionary: userInfo)
-> Void) {  }

    func completionHandler([.alert, .badge, .sound])application(_ application: UIApplication,
     }          func userNotificationCenter(_ center: UNUserNotificationCenter,   didReceiveRemoteNotification userInfo: [AnyHashable : Any],
                     fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) didReceive response: UNNotificationResponse,-> Void) {
        Euromsg.handlePush(pushDictionary: userInfo)
    }

    func userNotificationCenter(_ center: UNUserNotificationCenter,
              withCompletionHandler completionHandler: @escaping () -> Void) {                  willPresent Euromsg.handlePush(pushDictionary: response.notification.request.content.userInfo)notification: UNNotification,
        completionHandler()     }

SceneDelegate.swift

willConnectTo fonksiyonun içerisine aşağıdaki kod bloğunu ekleyin.

Code Block

language	swift

if #available(iOS 13, *),     let userInfo = connectionOptions.notificationResponse?.notification.request.content.userInfo {     Euromsg.handlePush(pushDictionary: userInfo) }withCompletionHandler completionHandler: @escaping

RMC’ye bilgi gönderme

Aşağıdaki kodu kullanıcı uygulamanıza üye olduğunda, üye girişi yaptığında ve uygulama ilk açılırken çalıştırın.

Eğer kullanıcı e-mail izni vermemişse permission değerini false olarak göndermelisiniz.

Code Block

language	swift

Euromsg.setEmail(email: "test@relateddigital.com", permission: true)
Euromsg.setEuroUserId(userKey: "1234567890")
Euromsg.sync()

Mobil kanaldan gelen datalarınızın RMC'ye yüklenebilmesi için, aktif RMC hesabınızda kullanmış olduğunuz referans değeriniz ne ise (KEY_ID* veya E-Mail) mobil kanaldan gelen dataların da bu referans ile gelmesine dikkat ediniz."

*KEY_ID: Uygulama sahibi tarafından müşterisinin tekilleştirilmesi için kullanılan id değerleridir. Bunlar CRM id, userid, customerid, accountid gibi farklı isimlerle ifade ediliyor olabilir.

Push Bildirim Mesajlarını Kullanma

Son 30 gün içerisinde gönderilmiş push bildirim mesajlarına aşağıdaki gibi erişebilirsiniz.

Mesajlar tarihe göre sıralanmıştır. Son gelen mesaj listenin ilk başında gösterilir.

message.encoded ile payloadı görebilir bir alt leveldaki parametreye hangi yolla ulaşabileceğinizi öğrenebilirsiniz.

Örneğin push başlığı için message.aps?.alert?.title kullanabilirsiniz

Code Block

Euromsg.getPushMessages(completion: { messages in
    for message in messages {
        print(message.encoded)
    }
})(UNNotificationPresentationOptions) -> Void) {
        if #available(iOS 14.0, *) {
            completionHandler([.banner, .sound, .badge, .list])
        } else {
            completionHandler([.alert, .badge, .sound])
        }
    }
    
    func userNotificationCenter(_ center: UNUserNotificationCenter,
                                didReceive response: UNNotificationResponse,
                                withCompletionHandler completionHandler: @escaping () -> Void) {
        Euromsg.handlePush(pushDictionary: response.notification.request.content.userInfo)
        completionHandler()
    }

SceneDelegate.swift

willConnectTo fonksiyonun içerisine aşağıdaki kod bloğunu ekleyin.

Code Block

language	swift

if #available(iOS 13, *),
    let userInfo = connectionOptions.notificationResponse?.notification.request.content.userInfo {
    Euromsg.handlePush(pushDictionary: userInfo)
}

RMC’ye bilgi gönderme

Aşağıdaki kodu kullanıcı uygulamanıza üye olduğunda, üye girişi yaptığında ve uygulama ilk açılırken çalıştırın.

Eğer kullanıcı e-mail izni vermemişse permission değerini false olarak göndermelisiniz.

Code Block

language	swift

Euromsg.setEmail(email: "test@relateddigital.com", permission: true)
Euromsg.setEuroUserId(userKey: "1234567890")
Euromsg.sync()

Mobil kanaldan gelen datalarınızın RMC'ye yüklenebilmesi için, aktif RMC hesabınızda kullanmış olduğunuz referans değeriniz ne ise (KEY_ID* veya E-Mail) mobil kanaldan gelen dataların da bu referans ile gelmesine dikkat ediniz."

*KEY_ID: Uygulama sahibi tarafından müşterisinin tekilleştirilmesi için kullanılan id değerleridir. Bunlar CRM id, userid, customerid, accountid gibi farklı isimlerle ifade ediliyor olabilir.

IYS E-Posta Kaydı

IYS kodunu Euromsg.sync() kodundan hemen önce ekleyiniz.

Code Block

language	swift

Euromsg.registerEmail(email: "example@email.com", permission: true)
//TACIR hesaplar için aşağıdaki kodu kullanınız
Euromsg.registerEmail(email: "example@commercial.com, permission: True, isCommercial: true)

Iframe

isMissingRequiredParameters	true

Versions Compared

Old Version 22

New Version Current

Key

Adım 1 - Gerekenler

Adım 2 - Kurulum

Notification Content Extension Ekleme

Notification Content Extension Ekleme

AppDelegate.swift

App Groups Ekleme

AppDelegate.swift

SceneDelegate.swift

RMC’ye bilgi gönderme

Push Bildirim Mesajlarını Kullanma

SceneDelegate.swift

RMC’ye bilgi gönderme

IYS E-Posta Kaydı