Casi d’uso per dispositivi mobili supportati in Adobe Campaign Standard mobile-use-cases
In questa pagina è disponibile l'elenco di tutti i casi d'uso per dispositivi mobili supportati in Adobe Campaign Standard utilizzando Adobe Experience Platform SDKs. Per supportare questi casi d'uso è necessario installare e configurare 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, vedere 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, vedere Core per dispositivi mobili. - Profile, che viene installato automaticamente.
Per ulteriori informazioni sull'estensione del profilo, vedere Profilo.
Registrare un profilo mobile in Campaign Standard register-mobile-profile
Con iOS register-mobile-profile-ios
In iOS, sono necessari i seguenti Experience Platform APIs:
- Lifecycle Start, quando l'app viene avviata e quando l'app è in primo piano.
- Lifecycle Pause, quando l'app è in background.
Per ulteriori informazioni, vedere 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 register-mobile-profile-android
In Android, sono necessari i seguenti Experience Platform APIs:
- OnResume
- OnPause
Per ulteriori informazioni, vedere 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 send-push-token
Con iOS send-push-token-ios
In iOS, è necessario Experience Platform SDK:
- setPushIdentifier
Per ulteriori informazioni, vedere 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 send-push-token-android
In Android, è necessario Experience Platform SDK:
- setPushIdentifier
Per ulteriori informazioni, vedere 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 enrich-mobile-profile-custom
Affinché questo caso d’uso funzioni, devi creare regole per i postback PII. Per ulteriori informazioni, consulta Postback PII.
Con iOS enrich-mobile-profile-custom-ios
In iOS, è necessario Experience Platform API:
- collectPII
Per ulteriori informazioni, vedere 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 enrich-mobile-profile-custom-android
In Android, è necessario Experience Platform API:
- collectPII
Per ulteriori informazioni, vedere 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 enrich-mobile-profile-lifecycle
Affinché questo caso d’uso funzioni, devi creare regole per i postback PII. Per ulteriori informazioni, consulta Postback PII.
Con iOS enrich-mobile-profile-lifecycle-ios
In iOS, sono necessari i seguenti Experience Platform APIs:
- Lifecycle Start, quando l'app viene avviata e quando l'app è in primo piano.
- Lifecycle Pause, quando l'app è in background.
Per ulteriori informazioni, vedere 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 enrich-mobile-profile-lifecycle-android
In Android, sono necessari i seguenti Experience Platform APIs:
- OnResume
- OnPause
Per ulteriori informazioni, vedere 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 track-user-push
Devi creare regole per il postback del tracciamento delle notifiche push. Per ulteriori informazioni, consulta Postback tracciamento notifiche push.
Con iOS track-user-push-ios
In iOS, è necessario Experience Platform SDK:
- 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 track-user-push-android
In Android, è necessario Experience Platform SDK:
- 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 custom-event-inapp
Con iOS custom-event-inapp-ios
In iOS, è necessario Experience Platform SDK:
- 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 custom-event-inapp-android
In Android, è necessario Experience Platform SDK:
- 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 linkage-fields-inapp
Con iOS linkage-fields-inapp-ios
Per impostare i campi di collegamento per l'autenticazione aggiuntiva per il modello di profilo basato sui messaggi in-app in iOS, è necessario il seguente Experience Platform SDK:
- Impostare i campi di collegamento
Per ulteriori informazioni, vedere Impostare i campi di collegamento. - Reimposta campi collegamento
Per ulteriori informazioni, vedere Reimposta campi 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 linkage-fields-inapp-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:
- Impostare i campi di collegamento
Per ulteriori informazioni, vedere Impostare i campi di collegamento. - Reimposta campi collegamento
Per ulteriori informazioni, vedere Reimposta campi 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()