Casos de uso para dispositivos móveis compatíveis com o Adobe Campaign Standard mobile-use-cases
Nesta página, você encontrará a lista de todos os casos de uso de dispositivos móveis com suporte no Adobe Campaign Standard usando o Adobe Experience Platform SDKs. Observe que o suporte a esses casos de uso envolve a instalação e configuração do Adobe Experience Platform SDKs, tags in Adobe Experience Platform e Adobe Campaign Standard. Para obter mais informações, consulte esta página.
O Adobe Campaign Standard é compatível com os seguintes casos de uso:
- Registrar um perfil móvel no Campaign Standard
- Enviar um token de push para o Campaign Standard
- Enriqueça um perfil móvel com dados personalizados do seu aplicativo
- Enriqueça um perfil móvel com dados do ciclo de vida do seu aplicativo
- Rastrear a interação do usuário com notificações por push
- Implementar um evento personalizado no aplicativo móvel para acionar mensagens no aplicativo
- Definir campos de vinculação para autenticação adicional para o modelo de perfil baseado em mensagens no aplicativo
Para configurar esses casos de uso, você precisa das seguintes extensões:
- Adobe Campaign Standard
Para instalar e configurar a extensão de Campaign Standard, consulte Configurar a extensão de Campaign Standard na Interface da Coleção de Dados. - Mobile Core, que é instalado automaticamente.
Para obter mais informações sobre a extensão Mobile Core, consulte Mobile Core. - Profile, que é instalado automaticamente.
Para obter mais informações sobre a extensão do Perfil, consulte Perfil.
Registrar um perfil móvel no Campaign Standard register-mobile-profile
Com o iOS register-mobile-profile-ios
No iOS, os seguintes Experience Platform APIs são obrigatórios:
- Lifecycle Start, quando o aplicativo é iniciado e quando está em primeiro plano.
- Lifecycle Pause, quando o aplicativo está em segundo plano.
Para obter mais informações, consulte Extensão do Lifecycle no iOS.
Este é um exemplo de implementação deste caso de uso com o 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)
}
Com o Android register-mobile-profile-android
No Android, os seguintes Experience Platform APIs são obrigatórios:
- OnResume
- OnPause
Para obter mais informações, consulte Extensão do Lifecycle no Android.
Este é um exemplo de implementação para este caso de uso com o Android:
@Override
public void onResume() {
super.onResume();
MobileCore.setApplication(getApplication());
MobileCore.lifecycleStart(null);
handleOpenTracking();
}
@Override
public void onPause() {
super.onPause();
MobileCore.lifecyclePause();
}
Enviar um token de push para o Adobe Campaign Standard send-push-token
Com o iOS send-push-token-ios
No iOS, o seguinte Experience Platform SDK é obrigatório:
- setPushIdentifier
Para obter mais informações, consulte setPushIdentifier.
Este é o exemplo de implementação para este caso de uso com o iOS:
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
// Register Device Token
ACPCore.setPushIdentifier(deviceToken)
Com o Android send-push-token-android
No Android, o seguinte Experience Platform SDK é obrigatório:
- setPushIdentifier
Para obter mais informações, consulte setPushIdentifier.
Este é o exemplo de implementação para este caso de uso com o Android:
@Override
public void onNewToken(String token) {
Log.d(TAG, "Refreshed token: " + token);
MobileCore.setPushIdentifier(token);
}
Enriqueça um perfil móvel com dados personalizados do seu aplicativo enrich-mobile-profile-custom
Para que esse caso de uso funcione, é necessário criar regras para postbacks de PII. Para obter mais informações, consulte Postbacks de PII.
Com o iOS enrich-mobile-profile-custom-ios
No iOS, o seguinte Experience Platform API é obrigatório:
- collectPII
Para obter mais informações, consulte collectPII.
Este é um exemplo de implementação deste caso de uso com o iOS:
ACPCore.collectPii(["pushPlatform":"apns", "email":email, "firstName":firstName, "lastName":lastName])
Com o Android enrich-mobile-profile-custom-android
No Android, o seguinte Experience Platform API é obrigatório:
- collectPII
Para obter mais informações, consulte collectPII.
Este é um exemplo de implementação para este caso de uso com o 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);
Enriqueça um perfil móvel com dados do ciclo de vida do seu aplicativo enrich-mobile-profile-lifecycle
Para que esse caso de uso funcione, é necessário criar regras para postbacks de PII. Para obter mais informações, consulte Postbacks de PII.
Com o iOS enrich-mobile-profile-lifecycle-ios
No iOS, os seguintes Experience Platform APIs são obrigatórios:
- Lifecycle Start, quando o aplicativo é iniciado e quando está em primeiro plano.
- Lifecycle Pause, quando o aplicativo está em segundo plano.
Para obter mais informações, consulte Extensão do Lifecycle no iOS.
Este é um exemplo de implementação deste caso de uso com o 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)
}
Com o Android enrich-mobile-profile-lifecycle-android
No Android, os seguintes Experience Platform APIs são obrigatórios:
- OnResume
- OnPause
Para obter mais informações, consulte Extensão do Lifecycle no Android.
Este é um exemplo de implementação para este caso de uso com o Android:
@Override
public void onResume() {
super.onResume();
MobileCore.setApplication(getApplication());
MobileCore.lifecycleStart(null);
handleOpenTracking();
}
@Override
public void onPause() {
super.onPause();
MobileCore.lifecyclePause();
}
Rastrear a interação do usuário com notificações por push track-user-push
Você precisa criar regras para o postback de rastreamento de notificações por push. Para obter mais informações, consulte Push notifications tracking postback.
Com o iOS track-user-push-ios
No iOS, o seguinte Experience Platform SDK é obrigatório:
- trackAction. Para obter mais informações, consulte Rastrear ações do aplicativo.
Este é um exemplo de implementação deste caso de uso com o 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"])
}
Com o Android track-user-push-android
No Android, o seguinte Experience Platform SDK é obrigatório:
- trackAction
Para obter mais informações, consulte Rastrear ações do aplicativo.
Este é um exemplo de implementação para este caso de uso com o Android:
contextData.put("deliveryId", deliveryId);
contextData.put("broadlogId", messageId);
contextData.put("action", "2");
MobileCore.trackAction("tracking", contextData);
Implementar um evento personalizado no aplicativo para acionar mensagens no aplicativo custom-event-inapp
Com o iOS custom-event-inapp-ios
No iOS, o seguinte Experience Platform SDK é obrigatório:
- trackAction. Para obter mais informações, consulte Rastrear ações do aplicativo.
Este é um exemplo de implementação deste caso de uso com o iOS:
ACPCore.trackAction(mobileEventName, data: [:] )
Com o Android custom-event-inapp-android
No Android, o seguinte Experience Platform SDK é obrigatório:
- trackAction
Para obter mais informações, consulte Rastrear ações do aplicativo.
Este é um exemplo de implementação para este caso de uso com o Android:
MobileCore.trackAction(mobileEventText, new HashMap<String,String>());
Definir campos de vinculação para autenticação adicional linkage-fields-inapp
Com o iOS linkage-fields-inapp-ios
Para definir campos de vinculação para autenticação adicional para o modelo de perfil baseado em mensagens no aplicativo no iOS, o seguinte Experience Platform SDK é obrigatório:
- Definir campos de vinculação
Para obter mais informações, consulte Definir campos de vinculação. - Redefinir campos de vinculação
Para obter mais informações, consulte Redefinir campos de vinculação.
Estas são algumas implementações de exemplo deste caso de uso com o iOS.
Para definir campos de vinculação:
var linkageFields = [String: String]()
linkageFields["cusEmail"] = "john.doe@email.com"
ACPCampaign.setLinkageFields(linkageFields)
Para redefinir campos de vínculo:
ACPCampaign.resetLinkageFields(linkageFields)
Com o Android linkage-fields-inapp-android
Para definir campos de vinculação para autenticação adicional para o modelo de perfil baseado em mensagens no aplicativo no Android, é necessário o seguinte SDK de Experience Platform:
- Definir campos de vinculação
Para obter mais informações, consulte Definir campos de vinculação. - Redefinir campos de vinculação
Para obter mais informações, consulte Redefinir campos de vinculação.
Estas são algumas implementações de exemplo deste caso de uso com o Android.
Para definir campos de vinculação:
HashMap<String, String> linkageFields = new HashMap<String, String>();
linkageFields.put("cusEmail", "john.doe@email.com");
Campaign.setLinkageFields(linkageFields);
Para redefinir campos de vínculo:
Campaign.resetLinkageFields()