Casi d’uso per dispositivi mobili supportati in Adobe Campaign Standard

In questa pagina è riportato l’elenco di tutti i casi d’uso per dispositivi mobili supportati in Adobe Campaign Standard utilizzando Adobe Experience Platform SDKs. Il supporto di questi casi d’uso richiede l’installazione e la configurazione di Adobe Experience Platform SDKs, tags in Adobe Experience Platform, e Adobe Campaign Standard. Per ulteriori informazioni, consulta questa pagina.

Adobe Campaign Standard supporta i seguenti casi d’uso:

• Registrare un profilo mobile in Campaign Standard
• Inviare un token push a Campaign Standard
• Arricchire un profilo mobile con dati personalizzati dell’applicazione
• Arricchire un profilo mobile con i dati del ciclo di vita dell’applicazione
• Tracciare l’interazione dell’utente con le notifiche push
• Implementare un evento personalizzato nell’app mobile per attivare i messaggi in-app
• Imposta i campi di collegamento per l’autenticazione aggiuntiva per il modello di profilo basato sui messaggi in-app

Per configurare questi casi d’uso, sono necessarie le seguenti estensioni:

• Adobe Campaign Standard
  Per installare e configurare l’estensione Campaign Standard, consulta Configurare l’estensione Campaign Standard nell’interfaccia utente di Data Collection.
• Mobile Core, che viene installato automaticamente.
  Per ulteriori informazioni sull’estensione core per dispositivi mobili, consulta Core mobile.
• Profile, che viene installato automaticamente.
  Per ulteriori informazioni sull’estensione Profilo, consulta Profilo.

Registrare un profilo mobile in Campaign Standard

Con iOS

In iOS, i seguenti elementi Experience Platform APIs sono obbligatori:

• Lifecycle Start, quando l'app viene avviata e quando l'app è in primo piano.
• Lifecycle Pause, quando l'app è in background.

Per ulteriori informazioni, consulta Estensione del ciclo di vita in iOS.

Di seguito è riportato un esempio di implementazione di questo caso d’uso con iOS:

 func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {


 ACPCore.setLogLevel(.debug)
 appId = SettingsBundle.getLaunchAppId()

 //===== START Set up Adobe SDK =====
 ACPCore.configure(withAppId: appId)

 ACPCampaign.registerExtension()
 ACPIdentity.registerExtension()
 ACPLifecycle.registerExtension()
 ACPUserProfile.registerExtension()
 ACPSignal.registerExtension()
 ACPCore.start()
 ACPCore.lifecycleStart(nil)

 return true
 }

func applicationDidEnterBackground(_ application: UIApplication) {
 ACPCore.lifecyclePause()
 }

 func applicationDidBecomeActive(_ application: UIApplication) {
 // Workaround until jira AMSDK-7411 is fixed.
 sleep(2)
 ACPCore.lifecycleStart(nil)
 }

Con Android

In Android, i seguenti Experience Platform APIs sono obbligatori:

• OnResume
• OnPause

Per ulteriori informazioni, consulta Estensione del ciclo di vita in Android.

Di seguito è riportato un esempio di implementazione per questo caso d’uso con Android:

@Override

public void onResume() {
 super.onResume();
 MobileCore.setApplication(getApplication());
 MobileCore.lifecycleStart(null);
 handleOpenTracking();
 }

 @Override
 public void onPause() {
 super.onPause();
 MobileCore.lifecyclePause();
 }

Inviare un token push ad Adobe Campaign Standard

Con iOS

In iOS, i seguenti elementi Experience Platform SDK è obbligatorio:

• setPushIdentifier
  Per ulteriori informazioni, consulta setPushIdentifier.

Di seguito è riportato un esempio di implementazione per questo caso d’uso con iOS:

func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {

 // Register Device Token
 ACPCore.setPushIdentifier(deviceToken)

Con Android

In Android, i seguenti Experience Platform SDK è obbligatorio:

• setPushIdentifier
  Per ulteriori informazioni, consulta setPushIdentifier.

Di seguito è riportato un esempio di implementazione per questo caso d’uso con Android:

@Override
public void onNewToken(String token) {
    Log.d(TAG, "Refreshed token: " + token);
    MobileCore.setPushIdentifier(token);
}

Arricchire un profilo mobile con dati personalizzati dell’applicazione

Affinché questo caso d’uso funzioni, devi creare regole per i postback PII. Per ulteriori informazioni, consulta Postback PII.

Con iOS

In iOS, i seguenti elementi Experience Platform API è obbligatorio:

• collectPII
  Per ulteriori informazioni, consulta collectPII.

Di seguito è riportato un esempio di implementazione di questo caso d’uso con iOS:

ACPCore.collectPii(["pushPlatform":"apns", "email":email, "firstName":firstName, "lastName":lastName])

Con Android

In Android, i seguenti Experience Platform API è obbligatorio:

• collectPII
  Per ulteriori informazioni, consulta collectPII.

Di seguito è riportato un esempio di implementazione per questo caso d’uso con Android:

HashMap<String, String> data = new HashMap<>();
data.put("pushPlatform", "gcm");
data.put("firstName", firstNameText);
data.put("lastName", lastNameText);
data.put("email", emailText);
MobileCore.collectPii(data);

Arricchire un profilo mobile con i dati del ciclo di vita dell’applicazione

Affinché questo caso d’uso funzioni, devi creare regole per i postback PII. Per ulteriori informazioni, consulta Postback PII.

Con iOS

In iOS, i seguenti elementi Experience Platform APIs sono obbligatori:

• Lifecycle Start, quando l'app viene avviata e quando l'app è in primo piano.
• Lifecycle Pause, quando l'app è in background.

Per ulteriori informazioni, consulta Estensione del ciclo di vita in iOS.

Di seguito è riportato un esempio di implementazione di questo caso d’uso con iOS:

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {


 ACPCore.setLogLevel(.debug)
 appId = SettingsBundle.getLaunchAppId()

 //===== START Set up Adobe SDK =====
 ACPCore.configure(withAppId: appId)

 ACPCampaign.registerExtension()
 ACPIdentity.registerExtension()
 ACPLifecycle.registerExtension()
 ACPUserProfile.registerExtension()
 ACPSignal.registerExtension()
 ACPCore.start()
 ACPCore.lifecycleStart(nil)

 return true
 }

func applicationDidEnterBackground(_ application: UIApplication) {
 ACPCore.lifecyclePause()
 }

 func applicationDidBecomeActive(_ application: UIApplication) {
 // Workaround until jira AMSDK-7411 is fixed.
 sleep(2)
 ACPCore.lifecycleStart(nil)
 }

Con Android

In Android, i seguenti Experience Platform APIs sono obbligatori:

• OnResume
• OnPause

Per ulteriori informazioni, consulta Estensione del ciclo di vita in Android.

Di seguito è riportato un esempio di implementazione per questo caso d’uso con Android:

@Override

public void onResume() {
 super.onResume();
 MobileCore.setApplication(getApplication());
 MobileCore.lifecycleStart(null);
 handleOpenTracking();
 }

 @Override
 public void onPause() {
 super.onPause();
 MobileCore.lifecyclePause();
 }

Tracciare l’interazione dell’utente con le notifiche push

Devi creare regole per il postback del tracciamento delle notifiche push. Per ulteriori informazioni, consulta Postback tracciamento notifiche push.

Con iOS

In iOS, i seguenti elementi Experience Platform SDK è obbligatorio:

• trackAction. Per ulteriori informazioni, consulta Tracciare le azioni eseguite nell’app.

Di seguito è riportato un esempio di implementazione di questo caso d’uso con iOS:

let deliveryId = userInfo["_dId"] as? String
let broadlogId = userInfo["_mId"] as? String
if (deliveryId != nil && broadlogId != nil) {
    ACPCore.trackAction("tracking", data: ["deliveryId": deliveryId!, "broadlogId": broadlogId!, "action":"2"])
}

Con Android

In Android, i seguenti Experience Platform SDK è obbligatorio:

• trackAction
  Per ulteriori informazioni, consulta Tracciare le azioni eseguite nell’app.

Di seguito è riportato un esempio di implementazione per questo caso d’uso con Android:

contextData.put("deliveryId", deliveryId);
contextData.put("broadlogId", messageId);
contextData.put("action", "2");
MobileCore.trackAction("tracking", contextData);

Implementare un evento personalizzato nell’applicazione per attivare i messaggi in-app

Con iOS

In iOS, i seguenti elementi Experience Platform SDK è obbligatorio:

• trackAction. Per ulteriori informazioni, consulta Tracciare le azioni eseguite nell’app.

Di seguito è riportato un esempio di implementazione di questo caso d’uso con iOS:

ACPCore.trackAction(mobileEventName, data: [:] )

Con Android

In Android, i seguenti Experience Platform SDK è obbligatorio:

• trackAction
  Per ulteriori informazioni, consulta Tracciare le azioni eseguite nell’app.

Di seguito è riportato un esempio di implementazione per questo caso d’uso con Android:

MobileCore.trackAction(mobileEventText, new HashMap<String,String>());

Imposta campi di collegamento per autenticazione aggiuntiva

Con iOS

Per impostare i campi di collegamento per l’autenticazione aggiuntiva per il modello di profilo basato sui messaggi in-app in iOS, procedi come segue Experience Platform SDK è obbligatorio:

• Imposta campi di collegamento
  Per ulteriori informazioni, consulta Imposta campi di collegamento.
• Reimposta campi di collegamento
  Per ulteriori informazioni, consulta Reimposta campi di collegamento.

Di seguito sono riportati esempi di implementazioni di questo caso d’uso con iOS.

Per impostare i campi di collegamento:

var linkageFields = [String: String]()
linkageFields["cusEmail"] = "john.doe@email.com"
ACPCampaign.setLinkageFields(linkageFields)

Per reimpostare i campi di collegamento:

ACPCampaign.resetLinkageFields(linkageFields)

Con Android

Per impostare i campi di collegamento per un’autenticazione aggiuntiva per il modello di profilo basato sui messaggi in-app in Android, è necessario il seguente SDK di Experience Platform:

• Imposta campi di collegamento
  Per ulteriori informazioni, consulta Imposta campi di collegamento.
• Reimposta campi di collegamento
  Per ulteriori informazioni, consulta Reimposta campi di collegamento.

Di seguito sono riportati esempi di implementazioni di questo caso d’uso con Android.

Per impostare i campi di collegamento:

HashMap<String, String> linkageFields = new HashMap<String, String>();
linkageFields.put("cusEmail", "john.doe@email.com");
Campaign.setLinkageFields(linkageFields);

Per reimpostare i campi di collegamento:

Campaign.resetLinkageFields()

Risorse Business.Adobe.com