Esta función se encuentra actualmente en versión beta.
En este artículo te explicamos cómo conectarte a la interfaz de programación de aplicaciones (API, por sus siglas en inglés) para conversiones (o API de conversiones) de Spotify
Índice
Acerca de la API de conversiones de Spotify
Integración con el administrador de etiquetas Tag Manager de Google
Integración directa
Conéctate a la API de conversiones en Ads Manager
Cómo crear una integración con el Tag Manager de Google
Cómo crear una integración directa de servidor a servidor
Resolución de problemas con la API de conversiones
Acerca de la API de conversiones de Spotify
¿Qué es la API de conversiones de Spotify?
La API de conversiones de Spotify es una herramienta de atribución sin etiquetas que te permite enviar directamente a Spotify los eventos de conversión que tienen lugar tanto en línea como fuera de línea. La API de conversiones está diseñada para proporcionar una atribución integral de alta fidelidad para ayudarte a comprender el desempeño de tus campañas en Spotify.
Una vez creado, el vínculo de la API de conversiones debe seleccionarse como la fuente de datos de medición de conversiones durante el proceso de programación de campañas en el administrador de anuncios Ads Manager.
Al usar la API de conversiones de Spotify con Ads Manager, puedes hacer lo siguiente:
-
Instalar la API de conversiones, una sola vez, para medir todas tus campañas en Spotify.
-
Ver las acciones clave que los oyentes realizan a través de diferentes dispositivos en tu sitio web, en la aplicación o fuera de línea.
-
Entender mejor el ROI de tu inversión en Ads Manager.
¿Qué puede medir la API de conversiones?
La API de conversiones admite los siguientes eventos desde tu sitio web, aplicación o fuera de línea:
-
Agregar al carrito
-
Alias
-
Clientes potenciales
-
Visitas a la página
-
Compras
-
Regístrate
-
Inicios de pago
-
Vistas de producto
-
Eventos personalizados (hasta 5)
Resumen de incorporación
La API de conversiones de Spotify (CAPI, por sus siglas en inglés) permite a los anunciantes enviar los eventos que tienen lugar en el sitio web, la aplicación y fuera de línea mediante una integración de servidor a servidor. Al igual que el Spotify Pixel, esta integración te permite dar seguimiento y medir la atribución de tus campañas en Spotify al enviar estos eventos a nuestra plataforma.
Métodos de integración
Integración con el administrador de etiquetas Tag Manager de Google
Los anunciantes que usan el Tag Manager de Google (GTM, por sus siglas en inglés) pueden usar nuestra plantilla correspondiente para acceder a una opción de integración más rápida y ligera que no requiere trabajo de desarrollo.
Antes de configurar una integración con GTM, asegúrate de tener acceso a la cuenta de facturación y permisos como creador de proyectos dentro de tu organización en la plataforma de la nube de Google (GCP, por sus siglas en inglés) para poder realizar el aprovisionamiento automático. Si piensas hacer un aprovisionamiento manual en lugar de uno automático, necesitarás la ayuda de un usuario con los permisos de GCP adecuados para configurar la infraestructura de Cloud Run siguiendo la documentación de Google.
Integración directa
Para maximizar el control sobre tu proceso de integración, te recomendamos crear una integración directa con la API de conversiones. Esto requerirá la participación de un desarrollador.
Conéctate a la API de conversiones en Ads Manager
-
Inicia sesión en Ads Manager y dirígete a Eventos desde el ícono de navegación global que aparece en la esquina superior izquierda.
-
Una vez que estés en esa página, dirígete a Conectar fuente de datos y selecciona la API de conversiones.
-
A continuación, asigna un nombre para tu API de conversiones.
-
Si también piensas usar el Spotify Pixel, se recomienda crear un conjunto de datos para habilitar la medición de conversiones sin duplicados mediante el uso de los datos tanto del Spotify Pixel como de la API de conversiones.
-
Utilizando la barra de búsqueda, elige la cuenta o las cuentas de anuncios que quieras conectar a tu API de conversiones. Las cuentas de anuncios seleccionadas deben estar asociadas con tu cuenta de empresa.
-
En “Ver instrucciones de la API de conversiones”, lee la sección “Acceder a la API de conversiones” y luego dirígete a la sección Token.
-
Haz clic en “Generar token”.
-
Genera tu token de autenticación (puedes generar hasta 3 tókenes).
-
Copia tu token y el número de conexión.
-
Solo puedes enviar eventos para el número de conexión que pertenezca a la organización que generó el token.
-
Cómo crear una integración con el Tag Manager de Google
Para crear una integración con el Tag Manager de Google, necesitarás un token de autenticación y un número de conexión generados en la página de Eventos en Ads Manager de Spotify. Para acceder al panel de control y seguir los pasos que se indican a continuación, debes ser un administrador de empresa en Ads Manager.
Antes de configurar una integración con GTM, asegúrate de tener acceso a la cuenta de facturación y permisos como creador de proyectos dentro de tu organización en la GCP para poder realizar el aprovisionamiento automático. Si piensas hacer un aprovisionamiento manual en lugar de uno automático, necesitarás la ayuda de un usuario con los permisos de GCP adecuados para configurar la infraestructura de Cloud Run siguiendo la documentación de Google.
-
Sigue las instrucciones de la sección anterior para conectarte a la API de conversiones en Ads Manager.
-
Dirígete al Tag Manager de Google y crea un nuevo contenedor de servidor.
-
Haz clic en “Etiquetas” en la barra lateral izquierda y selecciona Nuevo.
-
Haz clic en “Configuración de etiquetas” y selecciona “Descubre más tipos de etiquetas en la Galería de plantillas de la comunidad” en la ventana Elegir tipo de etiqueta.
-
Busca “Spotify” y selecciona “Spotify CAPI 3P Integration Tag” > Agregar al espacio de trabajo.
-
Pega tu token de autenticación y el número de conexión del Administrador de eventos
-
Configura los eventos, la fuente de acción y selecciona los activadores.
-
Haz clic en “Guardar” para implementar la etiqueta.
También puedes acceder directamente a la plantilla de etiquetas del Tag Manager de Google para la API de conversiones aquí: https://tagmanager.google.com/gallery/#/owners/spotify/templates/conversion-api-tag-template
También puedes encontrar el repositorio público para la plantilla de etiquetas de GTM aquí: https://github.com/spotify/conversion-api-tag-template
Cómo crear una integración directa de servidor a servidor
Para crear una integración directa de servidor a servidor y acceder a la API de conversiones, necesitarás un token de autenticación y un número de conexión generados en la página de Eventos en Ads Manager de Spotify. Para acceder al panel de control y seguir los pasos que se indican a continuación, debes ser un administrador de empresa en Ads Manager.
Autenticación
Spotify admite un token de larga duración. Podrás generar hasta 3 tókenes a la vez. Después de crear el tercer token, deberás eliminar uno anterior para generar uno nuevo. Tu token no caducará y podrás usarlo indefinidamente.
Número de conexión
Para acceder a la API, necesitarás tener tu número de conexión. El número de conexión es una clave única asignada a tu organización que te permite acceder a la API cuando se usa con el token. Puedes encontrar el número de conexión en “Ver instrucciones de la API de conversiones” en Ads Manager.
Datos del usuario
Actualmente, la API de conversiones acepta cuatro (4) tipos de números únicos de identificación: dirección IP, número de dispositivo, dirección de correo electrónico cifrada y número de teléfono cifrado. Debe enviarse al menos un tipo de número único de identificación. Es recomendable incluir tanto la dirección IP como el número de dispositivo siempre que sea posible.
Uso de la API
Punto de conexión
URL del recurso: https://capi.spotify.com/capi-direct/events/
URL del recurso
ConversionService: https://capi.spotify.com/capi-direct/events/
Solicitud
Método: POST
Descripción: Este método envía eventos de conversión, lo que permite hacer un seguimiento de las interacciones del usuario, como compras, pagos y otros tipos de interacción a través del punto de conexión directo especificado de la API.
Visita Spotify for Developers para obtener más información sobre cómo enviar solicitudes a la API.
Definiciones de eventos
|
Nombre del tipo de evento |
Descripción |
|
Visitas a la página opcional |
Es el acto de ver o pasar a una página específica en un sitio web. Por ejemplo, pasar a la página de inicio del sitio web o explorar la página específica de un producto. Ten en cuenta que es obligatorio que todos los anunciantes realicen un seguimiento del evento de visitas a la página si deciden utilizar el Spotify Pixel. |
|
Clientes potenciales opcional |
Es el envío de información sobre una persona o empresa que ha expresado interés en un producto o servicio. Por ejemplo, proporcionar una dirección de correo electrónico para suscribirse a un boletín informativo. Ten en cuenta que “cliente potencial” puede tener diferentes significados según el anunciante y el sector. |
|
Agregar al carrito opcional |
Es el acto de agregar un artículo a un carrito o canasta de compras virtual. Por ejemplo, hacer clic en un botón de Agregar al carrito en un sitio web, pero sin finalizar de hecho la transacción de compra. |
|
Compras opcional |
Es la finalización de una transacción de compra en línea; generalmente se señala con una confirmación de compra o de pedido recibido, o con un recibo de compra. Por ejemplo, al pasar a una página de “Gracias por su compra” o de confirmación del pedido. |
|
Vistas de producto opcional |
Mide la acción de alguien que ve una página web dedicada a un producto específico. Prácticas recomendables:
|
|
Regístrate opcional |
Mide la acción de registrarse o inscribirse para un evento, un producto, un servicio, etc. |
|
Inicios de pago opcional |
Mide cuándo un usuario ha iniciado el proceso de pago en línea. |
|
Alias opcional |
Envía los datos del cliente del anunciante a Spotify (correo electrónico o número de teléfono). |
|
Evento personalizado opcional |
Mide las acciones de eventos específicos o personalizados en un sitio web que no están disponibles como uno de los tipos de eventos estándar de Spotify. Estos son eventos que tú mismo defines. En la versión beta, no se puede cambiar el nombre de los eventos personalizados. Aparecerán en los informes como Evento personalizado 1, Evento personalizado 2, etc., por lo que es importante documentar qué eventos personalizados se asignan a acciones específicas en tu sitio web al realizar la configuración inicial. Importante: Al presente, Ads Manager admite hasta 5 eventos personalizados. |
Resolución de problemas con la API de conversiones
Implementaste la API de conversiones en tu sitio web y han pasado al menos 20 minutos, pero aún no ves actividad en el gráfico de eventos en Ads Manager. ¿Qué debes hacer ahora?
Consejos para resolver problemas
-
Asegúrate de haber ingresado correctamente tu token y el número de conexión.
-
Confirma que la API de conversiones se seleccionó como la fuente de datos de medición de conversiones para tu campaña.
-
Si usas el Tag Manager de Google, asegúrate de haber configurado un contenedor de servidor, no un contenedor web.
-
Si usas la integración directa de servidor a servidor, asegúrate de que tu llamada API esté formateada correctamente.
Si sigues sin ver actividad en los eventos, pregunta a tu equipo de ingeniería sobre cómo se configuró la API de conversiones y qué eventos se están compartiendo.