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 todavía utiliza esta versión heredada del SDK, debe actualizar la implementación con el SDK de Adobe Experience Platform antes del final de junio de 2024. Obtenga información sobre cómo migrar al SDK de Adobe Experience Platform en este artículo.
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.
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 su etiqueta correspondiente Mobile Property.
-
Crear un nuevo(a) Mobile property en la IU de recopilación de datos. Para obtener más información, consulte la documentación.
-
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.
-
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.
-
En Administration > Channels > Mobile app (SDK V4), seleccione la aplicación de SDK V4 que desee migrar.
-
Seleccione la pestaña Mobile application migration to AEP SDK .
-
En la lista desplegable Select AEP SDK mobile application to merge current application with, seleccione la aplicación móvil del SDK para Adobe Experience Platform creada anteriormente.
-
Haga clic en Migrate.
-
En la ventana Migration application, haga clic en Ok.
-
Aparece la ventana de finalización correcta, haga clic en Go to Adobe Experience Platform SDK Channel list.
-
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.
-
Seleccione su 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.
Luego tendrá que 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 según corresponda.
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: 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 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: En la lista solo se muestra la aplicación elegible de su Organizational unit. Asegúrese de que tiene la aplicación de Adobe Experience Platform correcta para la migración. Property Status de su aplicación de Adobe Experience Platform debe establecerse en Ready to Configure y Mobile app migration status 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 pueden migrar.
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 estará 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
R: Los administradores de Organizational unit ALL tendrán derechos para administrar ambas aplicaciones móviles y se encargarán 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, por lo que la aplicación móvil no será visible para los usuarios de Organizational unit A. La aplicación móvil estará disponible para los administradores de 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(a) Organizational unit o en un(a) Organizational unit con un vínculo principal.
Para obtener más información sobre Organizational unit, consulte esta 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 se mostrarán correctamente en la lista desplegable Push channel settings.