Información general

Mediante la API de Pinterest para conversiones, los anunciantes pueden enviar conversiones directamente a Pinterest, a través de una conexión de servidor a servidor. Las conversiones capturadas con la API de Pinterest se pueden usar para la resegmentación en las campañas y se pueden revisar en los informes de conversión para mejorar la visibilidad de las conversiones.

A través de la API de Pinterest para conversiones, los anunciantes pueden enviar lo siguiente:

  • Conversiones web
  • Conversiones en la aplicación
  • Conversiones offline
  • Los eventos se pueden recibir en tiempo real o en un plazo de una hora después de que el evento ocurra y se capture. Los eventos que lleguen fuera de esta ventana o como parte de un evento en lote retrasado se contarán como conversiones offline. 

    Si usas la API de Pinterest para conversiones junto con la etiqueta de Pinterest, puedes maximizar la visibilidad de las conversiones capturadas. Nuestra práctica recomendada es usar ambas soluciones de captura de conversiones para garantizar que recibas una visión global del rendimiento de tu campaña de conversiones.

    La API de Pinterest

    La API de Pinterest para conversiones es uno de varios productos que se encuentran dentro de nuestro ecosistema de API de Pinterest. Cualquier persona que tenga una cuenta de Pinterest Business podrá usar la API de Pinterest para conversiones, pero esto no otorga, automáticamente, acceso a la API de Pinterest más amplia. 

    La plataforma para desarrolladores de Pinterest tiene información sobre todos los productos de la API de Pinterest. 

    Para empezar

    Cualquier persona que tenga una cuenta de Pinterest Business tiene acceso a la API de Pinterest para conversiones.

    Para comenzar, primero tendrás que generar un token de acceso. Un token de acceso es una cadena de caracteres que verifica que las solicitudes se realizan y se envían a la cuenta de usuario correcta. 

    Para generar un token de acceso: 

  • Inicia sesión en tu cuenta para empresa de Pinterest
  • Haz clic en Anuncios en el menú superior y elige Conversiones.
  • Selecciona la página del token de acceso a conversiones en el panel de navegación de la izquierda.
  • Haz clic en el botón Generar nuevo token.
  • Copia el nuevo token de acceso y vuelve al proceso de configuración.
  • Si estás intentando acceder a una cuenta que no te pertenece, primero tendrás que configurar Acceso para empresas. 

    Implementación

    Eventos de conversión: todos los tipos de eventos disponibles para su captura en la etiqueta de Pinterest también están disponibles a través de la API de Pinterest para conversiones. Puedes encontrar una lista completa de los eventos y más información sobre su importancia en nuestra documentación para desarrolladores de la API de Pinterest.

    Para configurar una integración de la API de servidor a servidor, se requieren recursos de desarrollo de software y de ingeniería por parte del propietario del sitio web. La cantidad de esfuerzo del desarrollador técnico variará en función de lo siguiente:

  • El nivel de familiaridad del desarrollador con las integraciones de API. Si nunca antes hizo una integración de API, es posible que necesite trabajo adicional.  Si ya implementaste otras API de conversiones, el desarrollador solo deberá hacer algunos cambios incrementales.
  • La cantidad de eventos de los cuales se está haciendo seguimiento y en qué etapa del proceso de conversión se nos enviarán los datos.
  • Si un anunciante quiere o necesita usar un proveedor externo para hacer la integración (es decir, Shopify, GTM, Tellium).
  • Si ya estás usando la etiqueta de Pinterest

    Recomendamos usar la API de Pinterest para conversiones junto con la etiqueta de Pinterest para garantizar que estés maximizando tus conversiones. 

    Si ya configuraste la etiqueta de Pinterest anteriormente, deberás asegurarte de que no se cuenten las conversiones dos veces: una vez a través de la etiqueta de Pinterest y otra a través de la API. 

    Para lograr esto, deberás asegurarte de que el parámetro, event_id, se esté procesando con las conversiones capturadas tanto por la etiqueta de Pinterest como por la API de Pinterest para conversiones. 

    Nuestro sistema reconocerá los event_ids como duplicados y solo conservará la primera conversión capturada. Para garantizar que esta deduplicación sea exitosa, deberán cumplirse los siguientes requisitos:

  • Los event_ids deben ser idénticos entre las mismas conversiones: una persona accede a una página web, y tanto la etiqueta de Pinterest como la API de Pinterest activan una conversión de visita a la página. Las dos conversiones deberán tener event_ids que coincidan enviados de vuelta para que nuestro sistema reconozca que son la misma conversión. 
  • Los event_ids deben ser únicos para las diferentes conversiones: una persona accede a una página web, y tanto la etiqueta de Pinterest como la API de Pinterest activan una conversión de visita a la página. A continuación, la persona agrega una camiseta al carrito. Esto hace que el evento AddToCart se active tanto en la etiqueta de Pinterest como en la API de Pinterest. Si bien los event_ids activados para los mismos eventos deben coincidir, los event_ids que se envían para el evento de visita a la página y el evento AddToCart deben ser únicos. De esta forma, nuestro sistema los reconoce como eventos separados.
  • En función de ese identificador de evento y del event_name, Pinterest eliminará del registro los eventos duplicados, siempre que (a) el evento no tenga lugar offline (la action_source no sea offline) y (b) Pinterest reciba los eventos duplicados en un plazo de 48 horas uno con respecto al otro.

    Verificando la configuración

    Una vez que hayas terminado de configurar la API, puedes verificar que se reciban los eventos de conversión comprobando lo siguiente:

  • Códigos de respuesta: el desarrollador que configura la integración de la API puede revisar los códigos de respuesta devueltos con cada solicitud enviada después de que se activa una conversión. 
  • Página de deduplicación en el Administrador de anuncios: las conversiones posteriores a la deduplicación aparecerán en la Página de deduplicación del Administrador de anuncios. Para acceder a la página de deduplicación:
    • Inicia sesión en tu cuenta para empresa de Pinterest
    • Haz clic en Anuncios, en el menú superior y elige Conversiones.
    • Selecciona Deduplicación en el panel de navegación de la izquierda.
  • Calidad y resiliencia

    La resiliencia es el estado de una configuración de la API para conversiones que permite el nivel más alto de coincidencia y atribución de señales. Estos datos adicionales nos ayudarán a proporcionar informes más precisos a medida que las políticas de la industria de los anuncios cambian y evolucionan.

    Estado de resiliencia

    Hay dos categorías de estado de resiliencia: Buena y Deficiente. El estado de resiliencia es visible en la sección Estado de la conversión del administrador de anuncios.

    Resiliencia buena

    Opción 1: Cobertura de identificadores específicos

  • Cobertura de identificadores:
    • El 90% o más de los eventos deben tener IP/UA. 
    • El 10% o más de los eventos de la parte inferior del funnel tienen correos electrónicos con hash o MAID. 
    • El 10% o más de los eventos tienen ID externo.
  • Superposición con datos de la etiqueta (cuando corresponda).
    • El 90%* o más de los eventos de la etiqueta deben recibirse a través de la CAPI. 
  • O:

    Opción 2: Se alcanza la tasa de coincidencia base

  • Tasa de coincidencia de usuarios de la CAPI del 60% o más.
  • Superposición con datos de la etiqueta (cuando corresponda).
  • El 90%* o más de los eventos de la etiqueta deben recibirse a través de la CAPI. 


  • Resiliencia deficiente

    Cualquier estado que no sea bueno.

    ID y señales de resiliencia

    Envía las siguientes señales para alcanzar el estado de anunciante resiliente.

    Señales/de los ID de API Pesas/rango
    client_ip_address + client_user_agent Alto
    em Alto
    external_id Alto
    hashed_maid Alto
    click_id Alto
    fn + ln Bajo
    ph Bajo
    ge, bd, ct, st, zp, país Bajo

    * Pesas/rango con base en la probabilidad de aumentar la tasa de coincidencia

    Implementación de terceros

    Pinterest tiene varias integraciones de terceros para admitir el proceso de adopción de la API. 

    Google Tag Manager: lado del servidor

    Conecta tu cuenta de Google Tag Manager con la API de Pinterest para conversiones para descubrir cuánto influye Pinterest en el tráfico a tu tienda y las ventas de tus productos.

    Esta integración requiere que implementes un contenedor de servidor con tu proveedor de nube preferido y con conocimiento del etiquetado en el servidor. Para obtener más información sobre los requisitos previos, visita el sitio para desarrolladores

    Shopify

    Esta integración de la API para conversiones complementa la etiqueta de Pinterest para garantizar una buena cobertura y calidad de datos. Si la aplicación de Shopify está instalada, no se requiere ninguna acción para aprovechar esta mejora. Los cambios se aplicarán, automáticamente, a la tienda del comerciante.

    Tealium

    Los anunciantes que estén interesados en Tealium pueden configurar la API para conversiones de manera directa con el proveedor externo. Tealium construye la plantilla y ayudará a facilitar la integración con el anunciante. 

    El proceso de implementación se describe en el Centro de Aprendizaje de Tealium. Cualquier pregunta de soporte sobre la implementación puede enviarse a support [at] tealium.com (support[at]tealium[dot]com)

    Si te interesa alguna integración de terceros adicional, comunícate con tu representante de ventas para obtener más información. 

    Comprensión del Procesamiento de datos limitado

    A partir del 1 de enero de 2023, los anunciantes podrán usar un indicador de Procesamiento de datos limitado para que puedan cumplir con la Ley de Privacidad del Consumidor de California, enmendada por la Ley de Derechos de Privacidad de California (conjuntamente, CCPA). Con este indicador, Pinterest limitará el uso de ciertos datos para ayudar a los anunciantes a cumplir con la configuración de privacidad del usuario. Por ejemplo, un anunciante podría implementar el indicador de Procesamiento de datos limitado para los usuarios de California que hayan decidido no vender ni compartir sus datos en virtud de la CCPA. Cuando se use este indicador, Pinterest actuará como proveedor de servicios en virtud de la CCPA con respecto a los datos marcados de los usuarios de California.

    Los anunciantes son responsables de cumplir con las exclusiones de los usuarios, así como de identificar su estado de residencia al implementar el indicador de Procesamiento de datos limitado.

    End of Other articles Links
    Still need help? Contact us
    User feedback
    ¿Fue útil este artículo?

    collection_fields

    ¿Cómo podemos mejorarlo?