Como migrar seu aplicativo para dispositivos móveis do SDK v4 para o SDK da Adobe Experience Platform

IMPORTANTE

O processo de migração é irreversível.

Leia o documento cuidadosamente antes de iniciar a migração do aplicativo móvel do SDK V4 para o SDK do Adobe Experience Platform.

Sobre a migração do SDK V4

A Adobe Campaign Standard processa aplicativos móveis usando o SDK V4 como aplicativos separados daqueles que usam o Adobe Experience Platform SDK.
Depois de atualizar a versão do SDK do Adobe da v4 para o Adobe Experience Platform, os aplicativos móveis precisam continuar usando os dados e campanhas atuais do assinante do aplicativo: por conseguinte, é necessária uma migração.

OBSERVAÇÃO

Esta página documenta a migração de um aplicativo móvel SDK v4 para um aplicativo SDK do Adobe Experience Platform recém-criado. Seus aplicativos móveis SDK v4 não serão mesclados com um aplicativo móvel SDK da Adobe Experience Platform com um Configured Property status.

O que não mudará após a migração
Não haverá efeito nos deliveries e campanhas existentes usando o aplicativo SDK V4 migrado.
O nome do aplicativo móvel permanecerá o mesmo.
As credenciais da plataforma para iOS e Android serão retidas.
Todos os assinantes do aplicativo e seus dados serão retidos.
O aplicativo móvel SDK v4 existente continuará enviando dados (dados PII, Informações do assinante e do token) para o Adobe Campaign Standard.
O Organizational unit do aplicativo móvel permanecerá o mesmo.
O que mudará após a migração
O aplicativo móvel estará disponível em Administration > Channels > Mobile app (Adobe Experience Platform SDK). Antes da migração, ele estava disponível em Administration > Channels > Mobile app (SDK V4).
O Collect PII Endpoint do aplicativo será alterado. A mais velha Collect PII Endpoint continuará a funcionar, os dados enviados não serão perdidos.
O aplicativo será vinculado a uma tag Mobile Property. Ele será processado como um aplicativo móvel recém-criado.
O aplicativo Adobe Experience Platform SDK original usado na migração não existirá como um aplicativo separado. Somente o aplicativo SDK v4 migrado estará disponível.

Migrar seu aplicativo móvel do SDK v4 para o SDK do Adobe Experience Platform

Antes de migrar, você deve levar em conta as seguintes recomendações:

  • O processo de migração é irreversível.
  • Você não deve executar a migração de vários aplicativos ao mesmo tempo. Você também deve garantir que a migração de um mesmo aplicativo não seja acionada por várias janelas ao mesmo tempo.
  • Antes da migração, verifique se você recebeu a variável Organizational unit do aplicativo móvel que deseja migrar e do aplicativo Adobe Experience Platform que está usando para migração.
  • Após a migração, o aplicativo se tornará um aplicativo SDK do Adobe Experience Platform. Suas alterações serão vinculadas à tag correspondente Mobile Property.
  1. Crie um novo Mobile property na interface do usuário da coleta de dados. Para obter mais informações sobre isso, consulte o documentação.

  2. No Adobe Campaign Standard, no menu avançado, selecione Administration > Application Settings > Workflows e abra o syncWithLaunch fluxo de trabalho. Verifique se o workflow terminou sem erro.

  3. Após a conclusão do workflow, em Administration > Channels > Mobile app (Adobe Experience Platform SDK) verifique se o aplicativo móvel está disponível no Adobe Campaign Standard e em Ready to Configure estado.

  4. Em Administration > Channels > Mobile app (SDK V4), selecione o aplicativo SDK V4 que deseja migrar.

  5. Selecione a guia Mobile application migration to AEP SDK.

  6. No Select AEP SDK mobile application to merge current application with selecione o aplicativo móvel SDK do Adobe Experience Platform criado anteriormente.

  7. Clique em Migrate.

  8. Na janela Migration application, clique em Ok.

  9. A janela de conclusão bem-sucedida é exibida; clique em Go to Adobe Experience Platform SDK Channel list.

  10. Na página da lista de canais do SDK do Adobe Experience Platform, verifique se o aplicativo móvel V4 anterior está definido como Ready To Configure.

  11. Selecione seu aplicativo móvel e clique em Save para concluir a migração.

Após essa migração, os assinantes coletados pela versão V4 do aplicativo móvel e os novos assinantes coletados pela versão AEP do aplicativo móvel estarão disponíveis no aplicativo migrado.

Para distinguir os dois tipos diferentes de assinantes, é possível adicionar um novo campo personalizado de Text tipo ao estender o recurso personalizado Subscriptions to an application (appSubscriptionRcp) as sdkversion ou appVersion por exemplo. Para obter mais informações sobre como estender um recurso personalizado, consulte esta seção página.
Em seguida, será necessário configurar a tag associada Mobile property para enviar esse valor de campo personalizado na chamada Collect PII e alterar a configuração do aplicativo móvel de acordo.

Perguntas frequentes

P: No aplicativo móvel SDK v4, a migração do aplicativo móvel para a guia Adobe Experience Platform SDK não está visível.

A: No menu avançado Administration > Application Settings > Options, verifique o valor da variável Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option opção. Deve ser definido como 1 e ativado por padrão. O administrador pode ter desativado manualmente.

P: Na guia Mobile application migration to Adobe Experience Platform SDK , a mensagem No data é exibida.

A: Somente a aplicação elegível do seu Organizational unit é mostrada na lista. Certifique-se de ter o aplicativo Adobe Experience Platform correto para a migração. O Property Status do aplicativo Adobe Experience Platform deve ser definido como Ready to Configure e Mobile app migration status defina como Not Migrated.

P: Por que o aplicativo Adobe Experience Platform SDK com o Status da propriedade configurada não pode ser usado para migração?

A: O processo de migração retém os assinantes e atributos do SDK v4. Ela só mantém as informações relacionadas à tag do aplicativo Adobe Experience Platform SDK. Os assinantes e outros dados do aplicativo SDK do Adobe Experience Platform serão perdidos. Para evitar perda de dados, somente os aplicativos Adobe Experience Platform SDK com a variável Ready to Configure Property Status são elegíveis para migração.

P: Após a migração, onde posso encontrar meu aplicativo móvel SDK v4 anterior?

A: O aplicativo móvel após a migração estará visível no menu avançado Administration > Channels > Mobile app (Adobe Experience Platform SDK).

P: Após a migração, onde posso encontrar meu aplicativo Adobe Experience Platform SDK recém-criado?

A: O aplicativo Adobe Experience Platform SDK recém-criado usado para a migração não existirá como um aplicativo separado. Somente o aplicativo SDK v4 migrado estará disponível.

P: Se a unidade organizacional do aplicativo móvel SDK v4 estiver definida como A (um filho da unidade organizacional ALL) e o SDK do Adobe Experience Platform estiver definido como ALL. Como posso migrar meu aplicativo móvel?

A: Administradores do Organizational unit TODAS terão os direitos de gerenciar aplicativos móveis e serão responsáveis pela migração.

P: Se a unidade organizacional do aplicativo móvel SDK v4 estiver definida como A e o aplicativo SDK do Adobe Experience Platform estiver definido como B (um irmão da unidade organizacional A). Como posso migrar meu aplicativo móvel?

A: O aplicativo SDK do Adobe Experience Platform é o ativo de um irmão Organizational unit, o aplicativo móvel não estará visível para os usuários do Organizational unit A. O aplicativo móvel estará disponível para os Administradores do Organizational unit TODOS, mas não recomendamos que esses administradores migrem o aplicativo móvel.
Nesse caso, você deve mover seus aplicativos móveis no mesmo Organizational unit ou em Organizational unit com um link principal.
Para obter mais informações sobre Organizational unit consulte esta seção seção.

P: Na página do aplicativo móvel do SDK do Adobe Experience Platform (migrado do aplicativo móvel v4), no menu suspenso Configurações do canal de push , nenhuma informação como data/nome carregado é exibida para a chave do Android ou certificado do iOS

A: O sistema não armazena essas informações quando o aplicativo móvel SDK V4 é criado. Ao migrar seu aplicativo móvel SDK V4 para um aplicativo móvel SDK da Adobe Experience Platform, seu aplicativo móvel migrado também não terá esse tipo de informação. Assim que um usuário fizer upload de um novo certificado iOS ou chave Android, os diferentes detalhes da chave ou certificado serão armazenados e exibidos corretamente na variável Push channel settings lista suspensa.

Nesta página