Boletín: Migración al nuevo punto final de postback de Pinterest

Sección Detalles
¿Qué hay de nuevo? Pinterest ha migrado a un nuevo punto final basado en su infraestructura de API de conversiones (CAPI). Debes actualizar para continuar enviando los eventos de tu aplicación a Pinterest. Descontinuaremos el antiguo punto final el 30 de septiembre de 2025.
Fecha de entrada en vigor 23/07/2025
Lo que debes saber

Nota

Este boletín incluye información relacionada con la fase de migración a CAPI. Para obtener información general sobre la integración de Pinterest, consulta el artículo de KB

La actualización a la nueva configuración de eventos in-app garantizará que la medición de Pinterest continúe sin interrupciones, e incluye también:

  • Más tipos de “eventos”:: Registra eventos adicionales para alinearse mejor con tus objetivos, como: Liderazgo, Búsqueda, Categoría vista, Visita de página y más.
    • Nota: Los nombres de los eventos para el nuevo punto final de Pinterest V5 son diferentes. A menos que el dashboard se actualice en consecuencia, el reporte de eventos mostrará “desconocido”. Revisa los nuevos nombres de eventos a continuación.
  • Mejora de la calidad de los datos: Benefíciate de una coincidencia mejorada y una mayor precisión en la atribución.

La nueva integración requiere tanto un ID de cuenta de anuncios como un Token de acceso. Para mantener la funcionalidad de postback, los partners deben realizar la transición al nuevo punto final de postbacks antes del 30/09/25. 

Cómo encontrar el ID de cuenta de anuncios de Pinterest en AppsFlyer
Puedes encontrar el ID de cuenta publicitaria actual para los reportes de conversión de Pinterest en AppsFlyer dentro de Pinterest Business Manager o en los reportes de Conversión de Pinterest.

  1. Inicia sesión en tu cuenta comercial de Pinterest (debes estar en un perfil comercial para ver las opciones del Hub).
  2. Escribe o pega https://www.pinterest.com/business/hub/ en tu navegador y presiona Enter.
  3. Mira la columna de navegación de color gris oscuro en el lado izquierdo del Hub. Si la columna está plegada, haz clic en el pequeño icono “≡” (hamburguesa) en la esquina superior izquierda para expandirla.
  4. Desplázate un poco hasta que veas la sección titulada “Administrar negocio”.
  5. Haz clic en Conversiones (se encuentra justo debajo de “Administrar negocio”). Esto abre el dashboard de conversiones, donde puedes revisar las conversiones de AppsFlyer enviadas a Pinterest.
  6. El ID de la cuenta de anuncios estará presente en la URL.
  7. Si varios ID de cuentas de anuncios de Pinterest reciben conversiones clonadas de AppsFlyer, verifica todos los ID de cuentas de anuncios existentes con conversiones en el Pinterest Business Manager. Asegúrate de seleccionar el ID de la cuenta de anuncios principal original para las conversiones de AppsFlyer.

Cómo encontrar el token de acceso de AppsFlyer de Pinterest
Sigue los pasos descritos en el Centro de ayuda de Pinterest aquí. Una vez en Conversiones de Pinterest, haz clic en API de conversiones > Configuración de la API, y genera un nuevo token de acceso para la cuenta.

Nota importante: Si ya has configurado la API de conversiones para Pinterest por separado fuera de AppsFlyer, utiliza el mismo token de acceso aquí para las conversiones de AppsFlyer también.

Qué debes hacer

Sigue las instrucciones que se indican a continuación para configurar y migrar los postbacks de eventos in-app en el dashboard de AppsFlyer.

  1. Configuración de eventos in-app y manejo de parámetros del dashboard
    Actualmente, admitimos los siguientes parámetros del dashboard para asignar tus eventos de Appsflyer con Pinterest:

    • ID de la cuenta de anuncios (visible)
    • Token de acceso (visible)
    • ID de etiqueta (no visible en el dashboard, pero soportado en el backend para ayudar con la transición a la nueva versión V5. Una vez que la transición al punto final V5 esté completamente soportada, el ID de etiqueta también se eliminará del backend.)

    Ten en cuenta:
    Para la nueva configuración de postback, debes introducir tanto el ID de la cuenta de anuncios como el Token de acceso (estos se pueden obtener de Pinterest si no están disponibles). Si alguno de estos valores falta, el postback fallará. Asegúrate de que ambos parámetros estén correctamente completados en la página de Integración activa de Pinterest. Para más información, consulta el artículo de KB.
    Tu cooperación es importante para una transición fluida. Gracias por tu apoyo.

  2. Asignación de eventos in-app y configuración de postbacks
    1. Por favor, reemplaza y vincula los nombres de eventos de Pinterest actuales con los nuevos nombres de eventos de la API de conversiones de Pinterest para la sección Nombre del evento para partner. Por ejemplo, si actualmente estás utilizando pin_add_to_cart en la sección de eventos de partners, reemplázala con add_to_cart en su lugar. Para más información, consulta el artículo de KB.

      event name (anterior) event name (nueva API de conversiones)
      pin_add_to_cart add_to_cart
      pin_purchase checkout
      pin_search search
      pin_registration signup
      pin_sign_up signup
      pin_category_view view_category
      add_cart add_to_cart
      start_checkout checkout
      content_view view_category

      Nota: Si no actualizas los nombres de los eventos heredados con los nombres de eventos correctos para la API de conversiones, aparecerá "Otros" para los nombres de eventos en Pinterest, en lugar del nombre de evento correcto.

    2. Selecciona la ventana de postbacks de eventos in-app a Lifetime de modo que Pinterest pueda recibir el máximo número de conversiones para la optimización de los anuncios
    3. Selecciona Todas las fuentes de medios, incluidas las orgánicas para Usuarios de, de modo que Pinterest pueda recibir el máximo número de conversiones para la optimización de los anuncios. Para más información, consulta el artículo de KB.
  3. Proceso de restauración en caso de problemas
    Se recomienda a los anunciantes que supervisen las conversiones de sus aplicaciones de AppsFlyer en Pinterest para detectar cualquier problema o incidencia con la migración. Por favor, espera hasta 30 minutos para que los datos de conversión de AppsFlyer aparezcan en Pinterest y asegúrate de supervisarlos regularmente durante unos días para validar el éxito de la migración.

    Los anunciantes pueden volver al punto final heredado omitiendo uno o ambos de account_id y access_token en la configuración de integración. 
     

    Reglas de comportamiento:

    • Tanto account_id como access_token están ausentes → Los postbacks se envían al punto final heredado (antiguo).
    • Solo se proporciona account_id (es decir, access_token está vacío) → Los postbacks se envían al punto final heredado.
    • Solo se proporciona access_token (es decir, account_id está vacío) → Los postbacks se envían al punto final heredado.
    • Tanto account_id como access_token se proporcionan → Se envían las respuestas a este nuevo punto final.

    Si tienes algún problema, ponte en contacto con el servicio de asistencia de AppsFlyer a través de support@appsflyer.com. Para cualquier problema en Pinterest, ponte en contacto con api-support@pinterest.com o con tu representante de Pinterest.