Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
Temas:
Creado para:
Desarrollador
Pinterest es un motor de descubrimiento visual que permite encontrar ideas como recetas, decoración del hogar, inspiración de estilos, etc. Hay miles de millones de anclajes en Pinterest, que también se pueden compartir con otros en Pinterest. Puede recopilar los eventos de interacción del usuario y aprovechar Pinterest Analytics para comprender el comportamiento del usuario y ejecutar anuncios segmentados.
La extensión Pinterest Conversiones de la API reenvío de eventos le permite aprovechar los datos capturados en Adobe Experience Platform Edge Network y enviarlos a Pinterest. Este documento describe los casos de uso de la extensión, cómo instalarla y cómo integrar sus capacidades en las reglas de reenvío de eventos.
Los tokens de acceso de conversiones son el método de autenticación usado por Pinterest al interactuar con la API Pinterest.
Casos de uso
Esta extensión debe usarse si desea usar datos de Edge Network en Pinterest para aprovechar las capacidades de Customer Analytics.
Por ejemplo, considere un equipo de marketing en una organización. El equipo captura los datos del evento de interacción de usuarios de su sitio web y los carga en Pinterest mediante esta extensión de reenvío de eventos.
Los equipos de marketing y análisis pueden aprovechar las capacidades de Pinterest Analytics para comprender las interacciones y el comportamiento de los usuarios clave, lo que permite comprender mejor a los usuarios y dirigirlos a campañas de publicidad segmentadas.
Para obtener más información sobre casos de uso específicos de Pinterest, consulte la documentación de Pinterest casos de uso.
También necesitará una cuenta de desarrollador de Pinterest, que deberá asociarse a su cuenta comercial de Pinterest. Para asociar tu cuenta de desarrollador con tu cuenta de empresa, consulta la Pinterest cuenta de desarrollador.
Recopilar detalles de configuración necesarios configuration-details
Para conectar el Experience Platform a Pinterest, se requieren las siguientes entradas:
Credencial
Descripción
Ejemplo
ID de cuenta de anuncios
Su Id De Cuenta De Anuncios De Pinterest. Consulte la Pinterest documentación para obtener instrucciones.
123456789012
Token de acceso de conversión
Su token de acceso de conversión de Pinterest. Consulte el documento Pinterest API de conversiones para obtener instrucciones. Solo se le pedirá que realice esta acción una vez, ya que este token no caduca.
Instalar y configurar la extensión Pinterest install
En el panel de navegación izquierdo, seleccione Extensions. Seleccione Install en la tarjeta para la extensión Pinterest en la ficha Catalog.
Configurar la extensión de Pinterest
IMPORTANT
Según sus necesidades de implementación, es posible que tenga que crear un esquema, elementos de datos y un conjunto de datos antes de configurar la extensión. Revise todos los pasos de configuración antes de empezar para determinar qué entidades debe configurar para su caso de uso.
En el panel de navegación izquierdo, seleccione Extensions. Seleccione Configure en la tarjeta para la extensión Pinterest en la ficha Installed**.
Extensión
En la siguiente pantalla, escriba los Ads Account Id y Conversion Access Token que recopiló anteriormente en la sección detalles de configuración. Cuando haya terminado, seleccione Save.
Configuración de una regla de reenvío de eventos config-rule
Una vez configurados todos los elementos de datos, puede empezar a crear reglas de reenvío de eventos que determinan cuándo y cómo se enviarán los eventos a Pinterest.
Cree una nueva regla en su propiedad de reenvío de eventos. En Actions, agregue una nueva acción y establezca la extensión en Pinterest. Para enviar eventos de Edge Network a Pinterest, establezca Action Type en Send Event.
Después de la selección, aparecen controles adicionales para configurar aún más el evento. Debe asignar las propiedades de evento Pinterest a los elementos de datos que creó anteriormente.
Event Data
Se requerirán los siguientes datos de evento para crear la nueva regla:
Nombre del campo
Descripción
Ejemplo
Event Name
Tipo del evento de usuario. Sin embargo, este puede ser cualquier tipo de evento; para aprovechar Pinterest Analytics, se recomienda usar Pinterest códigos de evento
* retirada * add_to_cart * page_visit * registro * [Evento definido por el usuario]
Action Source
Origen que indica dónde se produjo el evento de conversión.
* app_android * app_ios * web * sin conexión
Event Time
Hace referencia a la hora del evento. El formato de hora predeterminado utilizado es UNIX, con el formato <seconds>.<miliseconds> según la zona horaria local. Para obtener más información, consulte la Pinterest API.
1433188255.500 indica 1433188255 segundos y 500 milisegundos después de epoch, o lunes, 1 de junio de 2015, a las 7:50:55 PM GMT.
Event ID
Una cadena de ID única que identifica este evento y que puede utilizarse para la desduplicación entre eventos introducidos mediante la API de conversión y el seguimiento de Pinterest. Sin esto, es probable que los datos del evento se contabilicen dos veces e informarán sobre la inflación de las métricas.
Objeto JSON que contiene propiedades personalizadas del evento. Seleccione entre proporcionar JSON sin procesar o utilizar un conjunto simplificado de entradas de clave-valor.
{ "event_source_url": "http://site.com" }
Se pueden configurar las siguientes propiedades de evento:
Nombre del campo
Descripción
URL de Source de evento
URL del evento de conversión web.
ID de tienda de aplicaciones
ID de aplicación de la tienda de aplicaciones.
Nombre de aplicación
Nombre de la aplicación.
Versión de aplicación
La versión de la aplicación.
Marca del dispositivo
Marca del dispositivo que utiliza el usuario.
Operador de dispositivo
Operador de telefonía móvil del usuario para su dispositivo.
Modelo de dispositivo
Modelo del dispositivo del usuario.
Device Type
Tipo de dispositivo que utiliza el usuario.
Versión del SO
Versión del sistema operativo del dispositivo.
Idioma del usuario
Código de idioma ISO-639-1 de dos caracteres que indica el idioma del usuario.
User Data
Los siguientes datos de usuario se pueden introducir mediante campos no obligatorios:
Nombre del campo
Descripción
Ejemplo
Email
Dirección de correo electrónico del usuario o hash SHA256 del correo electrónico de la dirección del usuario.
ebd543592…f2b7e1
Mobile Adverstising IDs
Hashes Sha256 de los ID de Google Advertising (GAID) o el identificador de Apple para anunciantes (IDFA) del usuario
ebd543592…f2b7e1
Client IP Address
La dirección IP del usuario, que puede estar en formato IPv4 o IPv6. Se utiliza para la coincidencia.
192.168.0.1
Client User Agent
Cadena del agente de usuario del explorador web del usuario.
Objeto JSON que contiene otra información del cliente. Seleccione entre proporcionar JSON sin procesar o utilizar un conjunto simplificado de entradas de clave-valor.
{ "ph": "122333445" }
Las propiedades de información del cliente que se pueden configurar son las siguientes:
Nombre del campo
Descripción
Teléfono
Número de contacto del usuario. Solo se aceptan dígitos y deben introducirse con el código de país, el código de área y el número.
Género
El sexo puede introducirse como "f" para las mujeres, "m" para los hombres o "n" para los no binarios.
Fecha de nacimiento
Fecha de nacimiento, indicada como año, mes y día.
Apellidos
Apellido del usuario.
Nombre
Nombre del usuario.
Ciudad
Ciudad de residencia del usuario. Esto se utiliza principalmente con fines de facturación.
Estado
El estado del usuario, que se proporciona como código de dos letras en minúsculas.
Código postal
Código postal del usuario, que se utiliza principalmente con fines de facturación.
País
Código de país ISO-3166 de dos caracteres que indica el país del usuario.
ID externo
ID único del anunciante que identifica a un usuario en su espacio. Por ejemplo, ID de usuario, ID de fidelidad, etc.
ID de clic
El identificador único almacenado en la cookie _epik de su dominio o en el parámetro de consulta &epik= de la dirección URL.
IMPORTANT
Antes de enviar los datos al extremo de la API Pinterest, la extensión hará un hash y normalizará los valores de los campos siguientes: Correo electrónico, Número de teléfono, Nombre, Apellidos, Sexo, Fecha de nacimiento, Ciudad, Estado, Código postal, País e ID externo. La extensión no hará un hash del valor de estos campos si ya hay una cadena SHA256.
Custom Data
Se pueden introducir los siguientes datos personalizados para la regla:
Nombre del campo
Descripción
Moneda
El código de divisa en formato ISO-4217. Si no se proporciona, Pinterest tomará de forma predeterminada la moneda del anunciante establecida durante la creación de la cuenta.
Valor
Valor total del evento. Se acepta como cadena en la solicitud. Esto se analizará en un dígito doble.
Cadena de búsqueda
La cadena de búsqueda relacionada con el evento de conversión del usuario.
ID de pedido
ID del pedido. Enviar order_id ayudará a Pinterest a deduplicar eventos cuando sea necesario.
Número de productos
Número total de productos del evento. Por ejemplo, el número total de artículos comprados en un evento de cierre de compra.
ID de contenido
Lista (matriz) de ID de productos.
Contenido
Una lista (matriz) de objetos que contienen información sobre productos, como precio y cantidad.
Validar datos dentro de Pinterest
Una vez creada y ejecutada la regla de reenvío de eventos, valide si el evento enviado a la API Pinterest se muestra según lo esperado en la interfaz de usuario de Pinterest.
Si la colección de eventos y la integración de Experience Platform se realizaron correctamente, verá eventos en la interfaz de usuario de Pinterest.
Puede obtener más información y ver la distribución de datos de evento Pinterest.
Próximos pasos
En esta guía se explica cómo instalar y configurar la extensión de reenvío de eventos Pinterest en la interfaz de usuario. Para obtener más información, consulte la documentación oficial:
