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 do 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 mantidas.
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, ela estava disponível em Administration > Channels > Mobile app (SDK V4).
O Collect PII Endpoint do aplicativo será alterado. O Collect PII Endpoint mais antigo continuará a funcionar, os dados enviados não serão perdidos.
O aplicativo será vinculado a um Adobe Experience Platform Launch 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 o 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 ao Mobile Property do Launch correspondente.
  1. Crie um novo Mobile property no Adobe Experience Platform Launch. Para obter mais informações, consulte a documentação do Adobe Experience Platform Launch.

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

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

  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. Na lista suspensa Select AEP SDK mobile application to merge current application with, selecione o aplicativo móvel do 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 do tipo Text ao estender o recurso personalizado Subscriptions to an application (appSubscriptionRcp) como sdkversion ou appVersion, por exemplo. Para obter mais informações sobre como estender um recurso personalizado, consulte esta página.
Em seguida, será necessário configurar o Launch associado 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, marque o valor da opção Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option. 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 de 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 o Mobile app migration status definido 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 ao Launch do aplicativo SDK do Adobe Experience Platform. Os assinantes e outros dados do aplicativo SDK do Adobe Experience Platform serão perdidos. Para evitar perda de dados, somente os aplicativos SDK do Adobe Experience Platform com 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: Os administradores do Organizational unit ALL terão os direitos de gerenciar ambos os 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: Sendo o aplicativo SDK do Adobe Experience Platform o ativo de um Organizational unit irmão, 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 ALL, 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 um Organizational unit com um link principal.
Para obter mais informações sobre Organizational unit, consulte esta 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 carregar um novo certificado do iOS ou uma chave do Android, os diferentes detalhes da chave ou certificado serão armazenados e exibidos corretamente na lista suspensa Push channel settings.

Nesta página