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

O suporte aos SDKs do Adobe Experience Platform Mobile versão 4 terminou em 31 de agosto de 2021. Se você ainda estiver usando esta versão herdada do SDK, deverá atualizar sua implementação com o Adobe Experience Platform SDK antes do final de junho de 2024. Saiba como migrar para o SDK da Adobe Experience Platform neste artigo.

IMPORTANT
Leia o documento atentamente antes de iniciar a migração do aplicativo para dispositivos móveis 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 SDK da Adobe Experience Platform.

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 existentes do assinante de aplicativos: portanto, é necessária uma migração.

NOTE
Esta página documenta a migração de um aplicativo para dispositivos móveis SDK v4 para um aplicativo SDK da Adobe Experience Platform recém-criado. Os aplicativos para dispositivos móveis do SDK v4 não serão mesclados com um aplicativo para dispositivos móveis do SDK da Adobe Experience Platform com um Configured Property status.
O que não será alterado após a migração
Não haverá nenhum 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 do iOS e do 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 de assinante e token) para a Adobe Campaign Standard.
O Organizational unit do aplicativo móvel permanecerá o mesmo.
O que será alterado 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. O Collect PII Endpoint mais antigo continuará a funcionar, os dados enviados não serão perdidos.
O aplicativo será vinculado a uma marca 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 para dispositivos móveis do SDK v4 para o Adobe Experience Platform SDK how-to-migrate

Antes de migrar, considere as seguintes recomendações:

  • O processo de migração é irreversível.
  • Não execute 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 a migração.
  • Após a migração, o aplicativo se tornará um aplicativo do SDK da Adobe Experience Platform. Suas alterações serão vinculadas à sua marca correspondente Mobile Property.
  1. Crie um novo Mobile property na interface da Coleção de Dados. Para obter mais informações, consulte a documentação.

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

  3. Após a conclusão do fluxo de trabalho, no menu Administration > Channels > Mobile app (Adobe Experience Platform SDK), verifique se o aplicativo móvel está disponível no Adobe Campaign Standard e 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. No menu suspenso Select AEP SDK mobile application to merge current application with, selecione o aplicativo para dispositivos móveis 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 da Adobe Experience Platform, verifique se o aplicativo móvel V4 anterior está definido como Ready To Configure.

  11. Selecione o 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, você pode 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 a tag associada Mobile property para enviar esse valor de campo personalizado na chamada Coletar PII e alterar a configuração do aplicativo móvel de acordo.

Perguntas frequentes faq

P: No aplicativo móvel SDK v4, a guia Mobile application migration to Adobe Experience Platform SDK não está visível. tab-not-visible

R: No menu avançado Administration > Application Settings > Options, verifique o valor da opção Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option. Ela deve ser definida como 1 e ativada por padrão. O administrador pode tê-la desabilitado manualmente.

P: Na guia Mobile application migration para o Adobe Experience Platform SDK, a mensagem No data é exibida. no-data

R: Somente a aplicação qualificada de seu Organizational unit é mostrada na lista. Verifique se você tem o aplicativo Adobe Experience Platform correto para a migração. O Property Status do seu 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 do SDK do Adobe Experience Platform com o Status de propriedade configurado não pode ser usado para migração? property-status

R: O processo de migração retém os assinantes e atributos do SDK v4. Ele só mantém informações relacionadas à tag do aplicativo SDK da Adobe Experience Platform. Os assinantes e outros dados do aplicativo SDK da Adobe Experience Platform serão perdidos. Para evitar perda de dados, somente os aplicativos do SDK do Adobe Experience Platform com o Ready to Configure Property Status estão qualificados para migração.

P: Após a migração, onde posso encontrar meu aplicativo para dispositivos móveis SDK v4 anterior? v4-app-not-visible

R: O aplicativo móvel após a migração ficará 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 SDK do Adobe Experience Platform recém-criado? aep-not-visible

R: 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 (uma unidade secundária da unidade organizacional ALL) e o SDK do Adobe Experience Platform estiver definido como ALL. Como posso migrar meu aplicativo para dispositivos móveis? v4-org-unit

R: Os administradores de TODOS os Organizational unit terão os direitos de gerenciar os dois 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 para dispositivos móveis? aep-org-unit

R: Aplicativo do SDK do Adobe Experience Platform sendo o ativo de um irmão Organizational unit, o aplicativo móvel não ficará visível para 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 o certificado do iOS no-information-v5

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

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff