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

La compatibilidad con los SDK de Adobe Experience Platform Mobile versión 4 finalizó el 31 de agosto de 2021. Si sigue utilizando esta versión heredada del SDK, debe actualizar la implementación con el SDK de Adobe Experience Platform antes de finales de junio de 2024. Obtenga información sobre cómo migrar al SDK de Adobe Experience Platform en este artículo.

IMPORTANT
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 al 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 v4 a Adobe Experience Platform, las aplicaciones móviles deben seguir utilizando los datos y las campañas de suscriptores de las aplicaciones existentes: por lo tanto, es necesaria una migración.

NOTE
Esta página documenta la migración de una aplicación móvil de SDK v4 a una aplicación de SDK para Adobe Experience Platform recién creada. Las aplicaciones móviles de SDK v4 no se combinarán con una aplicación móvil de SDK para Adobe Experience Platform con una 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 SDK V4 migrada.
El nombre de la aplicación móvil seguirá siendo el mismo.
Se conservarán las credenciales de plataforma de iOS y Android.
Se conservarán todos los suscriptores de la aplicación y sus datos.
La aplicación móvil SDK v4 existente seguirá enviando datos (datos PII, información de suscriptor y token) a Adobe Campaign Standard.
El Organizational unit de la aplicación móvil seguirá siendo el mismo.
Cambios 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 mayor Collect PII Endpoint seguirá funcionando, los datos enviados no se perderán.
La aplicación se asociará a una etiqueta Mobile Property. Se procesará como una aplicación móvil recién creada.
La aplicación original del SDK de Adobe Experience Platform utilizada en la migración no existirá como una 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 how-to-migrate

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 mediante 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 la etiqueta correspondiente Mobile Property.
  1. Crear un nuevo Mobile property en la IU de recopilación de datos. Para obtener más información, consulte la documentación.

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

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

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

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

  6. Desde el Select AEP SDK mobile application to merge current application with , seleccione la aplicación móvil del SDK para 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 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 añadir un nuevo campo personalizado de Text escriba al ampliar el recurso personalizado Subscriptions to an application (appSubscriptionRcp) as sdkversion o appVersion por ejemplo. Para obtener más información sobre cómo ampliar un recurso personalizado, consulte página.
Luego deberá configurar la etiqueta asociada Mobile property 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 faq

P: En la aplicación móvil SDK v4, la pestaña Migración de la aplicación móvil al SDK para Adobe Experience Platform no está visible. tab-not-visible

R: Desde el menú avanzado Administration > Application Settings > Options, compruebe el valor del Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option opción. Debe establecerse en 1 y habilitarse de forma predeterminada. Es posible que el administrador lo haya desactivado manualmente.

P: En la pestaña Migración de aplicaciones móviles al SDK de Adobe Experience Platform, aparece el mensaje Sin datos. no-data

R: Solo la aplicación elegible de su Organizational unit se muestra en la lista. 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 configurarse como Ready to Configure y el Mobile app migration status establezca en Not Migrated.

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

R: El proceso de migración conserva los suscriptores y atributos del SDK v4. Solo mantiene la información relacionada con las etiquetas de la aplicación del SDK para Adobe Experience Platform. Se perderán los suscriptores y otros datos de la aplicación 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 aptos para la migración.

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

R: 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? aep-not-visible

R: La aplicación del SDK de Adobe Experience Platform recién creada que se utilizó para la migración no existirá como una 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á configurada en A (un elemento secundario de la unidad organizativa ALL) y el SDK de Adobe Experience Platform está configurado en ALL. ¿Cómo puedo migrar mi aplicación móvil? v4-org-unit

A: Administradores de Organizational unit TODOS tendrán derechos para gestionar 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á configurada en A y la aplicación SDK de Adobe Experience Platform está configurada en B (elemento secundario de la unidad organizativa A). ¿Cómo puedo migrar mi aplicación móvil? aep-org-unit

R: La aplicación SDK de Adobe Experience Platform es el recurso de un elemento del mismo nivel Organizational unit, 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 TODOS, pero no recomendamos a estos administradores migrar la aplicación móvil.
En este caso, debe mover las aplicaciones móviles del mismo modo 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 sección.

P: Desde 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 del canal push, no se muestra ninguna información, como la fecha/nombre cargado, para la clave de Android o el certificado de iOS no-information-v5

R: 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 SDK de Adobe Experience Platform, la aplicación móvil migrada tampoco tendrá este tipo de información. En cuanto un usuario cargue un nuevo certificado de iOS o clave de Android, los diferentes detalles de la clave o del certificado se almacenarán y mostrarán correctamente en la Push channel settings menú desplegable.

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