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

O suporte aos SDKs do Adobe Experience Platform Mobile versão 4 terminou em 31 de agosto de 2021. Se você ainda estiver usando essa 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.

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.

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

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 a Organizational unit do aplicativo móvel que você deseja migrar e do aplicativo Adobe Experience Platform que você está usando para 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 à tag correspondente Mobile Property.

1. Criar um novo Mobile property na interface da Coleção de dados. Para obter mais informações, consulte 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 fluxo de trabalho terminou sem erros.

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

   

4. Entrada 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 para dispositivos móveis Adobe Experience Platform SDK 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 seu aplicativo para dispositivos móveis 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 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 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 guia Mobile application migration to Adobe Experience Platform SDK não está visível.

A: No menu avançado Administration > Application Settings > Options, verifique o valor do Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option opção. 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.

R: Somente a aplicação qualificada do seu Organizational unit é exibido na lista. Verifique se você tem o aplicativo Adobe Experience Platform correto para a migração. A variável Property Status do aplicativo Adobe Experience Platform deve ser definido como Ready to Configure e a variável Mobile app migration status definir 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?

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 aplicativos SDK da Adobe Experience Platform com o Ready to Configure Property Status são elegíveis para migração.

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

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?

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?

A: Administradores do Organizational unit TODOS 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 para dispositivos móveis?

R: Aplicativo do SDK do Adobe Experience Platform sendo 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 para dispositivos móveis.
Nesse caso, você deve mover seus aplicativos móveis na mesma Organizational unit ou em um Organizational unit com um link principal.
Para obter mais informações sobre Organizational unit, consulte esta página 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

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 da iOS ou chave do Android, os diferentes detalhes da chave ou do certificado serão armazenados e exibidos corretamente na Push channel settings menu suspenso.