Migración de la aplicación móvil del SDK v4 al SDK de Adobe Experience Platform

IMPORTANTE

El proceso de migración es irreversible.

Lea detenidamente el documento antes de iniciar la migración de la aplicación móvil SDK V4 al SDK para Adobe Experience Platform.

Acerca de la migración del SDK V4

Adobe Campaign Standard procesa las aplicaciones móviles mediante el SDK V4 como aplicaciones independientes de las que utilizan el SDK de Adobe Experience Platform.
Después de actualizar la versión del SDK de Adobe de 4 a Adobe Experience Platform, las aplicaciones móviles deben seguir utilizando los datos y campañas del suscriptor de la aplicación existente: por lo tanto, es necesaria una migración.

NOTA

Esta página documenta la migración de una aplicación móvil SDK v4 a una aplicación SDK para Adobe Experience Platform recién creada. Las aplicaciones móviles SDK v4 no se combinarán con una aplicación móvil del SDK de Adobe Experience Platform con Configured Property status.

Qué no cambiará después de la migración
No habrá ningún efecto en los envíos y campañas existentes que utilicen la aplicación V4 del SDK migrado.
El nombre de la aplicación móvil seguirá siendo el mismo.
Se conservarán las credenciales de la plataforma para iOS y Android.
Se conservarán todos los suscriptores de la aplicación y sus datos.
La aplicación móvil v4 del SDK existente seguirá enviando datos (datos PII, información del suscriptor y del token) a Adobe Campaign Standard.
El Organizational unit de la aplicación móvil seguirá siendo el mismo.
Qué cambiará después de la migración
La aplicación móvil estará disponible en Administration > Channels > Mobile app (Adobe Experience Platform SDK). Antes de la migración, estaba disponible en Administration > Channels > Mobile app (SDK V4).
El Collect PII Endpoint de la aplicación cambiará. El Collect PII Endpoint anterior seguirá funcionando, los datos enviados no se perderán.
La aplicación se asociará a un Adobe Experience Platform Launch Mobile Property. Se procesará como una aplicación móvil recién creada.
La aplicación de SDK de Adobe Experience Platform original utilizada en la migración no existe como aplicación independiente. Solo estará disponible la aplicación SDK v4 migrada.

Migración de la aplicación móvil del SDK v4 al SDK de Adobe Experience Platform

Antes de migrar, debe tener en cuenta las siguientes recomendaciones:

  • El proceso de migración es irreversible.
  • No debe ejecutar la migración de varias aplicaciones al mismo tiempo. También debe asegurarse de que la migración de una misma aplicación no se active por varias ventanas al mismo tiempo.
  • Antes de la migración, asegúrese de que tiene asignado el Organizational unit de la aplicación móvil que desea migrar y de la aplicación de Adobe Experience Platform que está utilizando para la migración.
  • Después de la migración, la aplicación se convertirá en una aplicación de SDK para Adobe Experience Platform. Sus cambios se vincularán a su correspondiente Launch Mobile Property.
  1. Cree un nuevo Mobile property en Adobe Experience Platform Launch. Para obtener más información, consulte Documentación de Adobe Experience Platform Launch.

  2. En Adobe Campaign Standard, en el menú avanzado, seleccione Administration > Application Settings > Workflows y abra el flujo de trabajo syncWithLaunch. Compruebe si el flujo de trabajo ha finalizado sin errores.

  3. Una vez finalizado el flujo de trabajo, en el menú Administration > Channels > Mobile app (Adobe Experience Platform SDK) , compruebe si la aplicación móvil está disponible en Adobe Campaign Standard y está en estado Ready to Configure .

  4. En Administration > Channels > Mobile app (SDK V4), seleccione la aplicación SDK V4 que desea migrar.

  5. Seleccione la pestaña Mobile application migration to AEP SDK .

  6. En la lista desplegable Select AEP SDK mobile application to merge current application with, seleccione la aplicación móvil del SDK de Adobe Experience Platform creada anteriormente.

  7. Haga clic en Migrate.

  8. En la ventana Migration application, haga clic en Ok.

  9. Aparece la ventana de finalización correcta, haga clic en Go to Adobe Experience Platform SDK Channel list.

  10. En la página de la lista de canales del SDK para Adobe Experience Platform, compruebe que la aplicación móvil V4 anterior esté configurada como Ready To Configure.

  11. Seleccione la aplicación móvil y haga clic en Save para completar la migración.

Después de esta migración, los suscriptores recopilados por la versión V4 de la aplicación móvil y los nuevos suscriptores recopilados por la versión AEP de la aplicación móvil estarán disponibles en la aplicación migrada.

Para distinguir los dos tipos diferentes de suscriptores, puede agregar un nuevo campo personalizado de tipo Text al ampliar el recurso personalizado Subscriptions to an application (appSubscriptionRcp) como sdkversion o appVersion por ejemplo. Para obtener más información sobre cómo ampliar un recurso personalizado, consulte esta página.
A continuación, debe configurar el Launch Mobile property asociado para enviar este valor de campo personalizado en la llamada a Collect PII y cambiar la configuración de la aplicación móvil en consecuencia.

Preguntas frecuentes

P: En la aplicación móvil SDK v4, la migración de la aplicación móvil a la pestaña SDK de Adobe Experience Platform no está visible.

A: En el menú avanzado Administration > Application Settings > Options, compruebe el valor de la opción Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option. Debe estar establecido en 1 y habilitado de forma predeterminada. Es posible que el administrador lo haya deshabilitado manualmente.

P: Desde la pestaña Mobile application migration to Adobe Experience Platform SDK , aparece el mensaje No data .

A: En la lista solo se muestra la aplicación apta de su Organizational unit. Asegúrese de que tiene la aplicación de Adobe Experience Platform correcta para la migración. El Property Status de la aplicación de Adobe Experience Platform debe establecerse en Ready to Configure y el Mobile app migration status en Not Migrated.

P: ¿Por qué no se puede utilizar para la migración la aplicación SDK de Adobe Experience Platform con el estado de propiedad configurado?

A: El proceso de migración conserva los suscriptores y atributos del SDK v4. Solo conserva la información relacionada con Launch desde la aplicación SDK de Adobe Experience Platform. Se perderán los suscriptores y otros datos de la aplicación de SDK para Adobe Experience Platform. Para evitar la pérdida de datos, solo las aplicaciones de SDK de Adobe Experience Platform con Ready to Configure Property Status son elegibles para la migración.

P: Después de la migración, ¿dónde puedo encontrar mi aplicación móvil v4 SDK anterior?

A: La aplicación móvil después de la migración será visible desde el menú avanzado Administration > Channels > Mobile app (Adobe Experience Platform SDK).

P: Después de la migración, ¿dónde puedo encontrar la aplicación de SDK para Adobe Experience Platform recién creada?

A: La aplicación de SDK de Adobe Experience Platform recién creada que se utiliza para la migración no existe como aplicación independiente. Solo estará disponible la aplicación SDK v4 migrada.

P: Si la unidad organizativa de la aplicación móvil SDK v4 está establecida en A (un elemento secundario de la unidad organizativa ALL) y el SDK de Adobe Experience Platform está establecido en ALL. ¿Cómo puedo migrar mi aplicación móvil?

A: Los administradores de Organizational unit ALL tendrán los derechos para administrar ambas aplicaciones móviles y estarán a cargo de la migración.

P: Si la unidad organizativa de la aplicación móvil SDK v4 está definida en A y la aplicación del SDK de Adobe Experience Platform en B (elemento del mismo nivel que la unidad organizativa A). ¿Cómo puedo migrar mi aplicación móvil?

A: Si la aplicación del SDK de Adobe Experience Platform es el recurso de un Organizational unit hermano, la aplicación móvil no será visible para los usuarios del Organizational unit A. La aplicación móvil estará disponible para los administradores del Organizational unit ALL, pero no se recomienda que estos administradores migren la aplicación móvil.
En este caso, debe mover las aplicaciones móviles en el mismo Organizational unit o en un Organizational unit con un vínculo principal.
Para obtener más información sobre Organizational unit, consulte esta sección.

P: En la página de la aplicación móvil del SDK de Adobe Experience Platform (migrada desde la aplicación móvil v4), en la lista desplegable de configuración de canal push, no se muestra información como la fecha y el nombre cargados para la clave de Android o el certificado de iOS

A: El sistema no almacena esta información cuando se crea la aplicación móvil SDK V4. Al migrar la aplicación móvil SDK V4 a una aplicación móvil del SDK de Adobe Experience Platform, la aplicación móvil migrada no tendrá este tipo de información. Tan pronto como un usuario cargue un nuevo certificado de iOS o una clave de Android, los distintos detalles de la clave o certificado se almacenarán y mostrarán correctamente en la lista desplegable Push channel settings.

En esta página