Cómo integrar el SDK de eventos en la aplicación de TikTok

Antes de empezar

Necesitas una cuenta publicitaria de TikTok y un ID de la aplicación de TikTok para utilizar el SDK de eventos en la aplicación de TikTok para Android e iOS. Si tienes una aplicación, puedes utilizarla o crear una nueva.

Nota: Ahora, el SDK de eventos en la aplicación de TikTok admite una configuración híbrida con los MMP en la misma cuenta. Para integrar el SDK, puedes crear una cuenta publicitaria de TikTok o usar la cuenta de MMP que ya tengas.

Cómo integrar el SDK de eventos en la aplicación de TikTok

Paso 1: Crea una aplicación o usa una existente para generar un ID de la aplicación de TikTok y un App Secret.

Opción 1: Añadir un SDK a una aplicación de MMP conectada (configuración híbrida)

1. Inicia sesión en TikTok Ads Manager.

2. Haz clic en la pestaña Herramientas y, a continuación, en Administrador de eventos.

3. Selecciona Fuentes de datos y selecciona la aplicación a la que quieras añadir la conexión con el SDK.

   
   
   

4. Ve a la pestaña Ajustes y haz clic en Seleccionar un socio en el SDK de eventos en la aplicación de TikTok.

   
   
   

5. Continúa con el procedimiento y añade el SDK a la cuenta. Genera tu ID de la aplicación de TikTok y App Secret.

   

Opción 2: Añadir el SDK a una aplicación creada recientemente

1. Inicia sesión en TikTok Ads Manager.

2. Haz clic en la pestaña Herramientas y, a continuación, en Administrador de eventos.

3. Selecciona Conectar fuente de datos en el panel de navegación de la parte superior y elige Aplicación.

   
   
   

4. Selecciona SDK de TikTok para conectar tu aplicación.

   
   
   

5. Especifica los detalles de la aplicación y créala. Continúa con el procedimiento y genera tu ID de la aplicación de TikTok y App Secret.

   
   
   

Paso 2: Sigue las instrucciones de la guía del Developer Center (Centro para desarrolladores) de TikTok para integrar el SDK de eventos en la aplicación de TikTok.

1. Para inicializar el SDK, necesitas tener el ID de la aplicación, ID de la aplicación de TikTok y App Secret antes de empezar con el paso 1.

   1. Demostración del ID de la aplicación e ID de la aplicación de TikTok:

      
      
      

   2. Demostración del App Secret:

      
      
      

2. Descarga el SDK en GitHub. Los SDK compatibles por el momento son el SDK nativo de iOS, el SDK nativo de Android y el SDK de Unity.

Paso 3: Haz postbacks de eventos a través del SDK.

1. Para obtener una lista completa de los eventos en la aplicación estándar que puedes registrar y de los eventos registrados automáticamente, consulta Eventos estándar.

2. Los eventos registrados se muestran a continuación. Nota: Puedes desactivar los eventos registrados automáticamente. Para obtener más información, consulta la documentación para desarrolladores del SDK de eventos en la aplicación.

   1. Iniciar aplicación: cuando se lanza la aplicación.

   2. Instalar aplicación: cuando la aplicación se lanza por primera vez.

   3. Retención de dos días: la aplicación se abre de nuevo al día siguiente de abrirla por primera vez.

   4. Compra: pagos realizados correctamente para productos consumibles/no consumibles/suscripciones.

      1. Asegúrate de que el postback de eventos de compra registrados automáticamente se ajuste a los requisitos de tu negocio antes de habilitarlo. Consulta más detalles sobre el evento de compra registrado automáticamente en iOS y el evento de compra registrado automáticamente en Android.

Nota especial sobre el evento de compra registrado automáticamente: El SDK puede capturar de manera automática las transacciones realizadas a través de StoreKit (iOS) o Facturación de Google Play (Android). Para poder transferir más propiedades y parámetros o si no utilizas la pasarela de pagos nativa de Apple o Google, te recomendamos que utilices el postback manual de eventos de compra.

Paso 4: [iOS] Mide los eventos SKAN.

En el entorno SKAdNetwork (SKAN), se recomienda tener solo un SDK para notificar los valores de conversión. Si utilizas un MMP u otro SDK para actualizar los valores de conversión para SKAdNetwork, asegúrate de añadir disableSKAdNetworkSupport() a la configuración para evitar conflictos con las actualizaciones.

Determina si necesitas habilitar la medición SKAN para el SDK de TikTok:

Si tienes un MMP:

• El SDK del MMP actualiza el valor de conversión y tienes previsto utilizar el esquema de SKAN del MMP: desactiva la compatibilidad con SKAdNetwork en el SDK de TikTok y no cargues el esquema en el Administrador de eventos de TikTok. (Tu MMP sigue siendo la única fuente de referencia para las actualizaciones del valor de conversión y el esquema).

Si no tienes un MMP:

Asegúrate de que el valor de conversión de SKAN lo actualice un único SDK.

• Otro SDK que no es del MMP está actualizando el valor de conversión: desactiva la compatibilidad con SKAdNetwork en el SDK de TikTok, pero carga un esquema en el Administrador de eventos de TikTok. (TikTok utilizará el esquema, pero no llevará a cabo actualizaciones redundantes del valor de conversión).

• El SDK de TikTok se encarga de actualizar el valor de conversión: activa la compatibilidad con SKAdNetwork en el SDK de TikTok y carga un esquema en el Administrador de eventos de TikTok. (TikTok se convierte en el principal encargado de realizar las actualizaciones del valor de conversión de SKAN).

Para obtener más información, consulta la documentación para desarrolladores del SDK de eventos en la aplicación.

Paso 5: Verifica los postbacks en tiempo real con el modo de depuración.

A partir de la versión 1.5.0 del SDK, los usuarios tienen dos métodos para verificar la integración con el SDK antes del lanzamiento:

• (Recomendado) Modo de eventos de prueba basado en tokens; el Administrador de eventos de TikTok se encarga de realizarlo por entero y no requiere modificar el código.

• Modo de depuración manual: requiere modificación. Si utilizas la depuración manual, recuerda desactivar el modo de depuración antes del lanzamiento de tu aplicación. Los eventos generados con una de estas dos herramientas se someten a un flujo de prueba y no se pueden utilizar en los informes.

  • Modo de depuración: ON

    

    Modo de depuración: OFF

    

Paso 6: Publica la nueva versión de la aplicación con el SDK de TikTok en la App Store (iOS) o Play Store (Android).

Podrás ver el evento del SDK que se muestra en la pestaña de informes del Administrador de eventos cuando TikTok empieza a recibir la señal en tiempo real del SDK. Las señales del modo de prueba no se mostrarán aquí.

Paso 7: Publica tu campaña con el SDK de TikTok.

Si tienes algún problema para integrar el SDK de eventos en la aplicación, envía una solicitud al servicio de atención al cliente. Asegúrate de seleccionar Medición y SDK de eventos en la aplicación a continuación como categoría del problema.