DocumentaciónExperience PlatformGuía de conectores de origen

[Beta]{class="badge informative"}

Pinterest Ads

Última actualización: 2 de octubre de 2026

Creado para:

  • Desarrollador
NOTE
El origen Pinterest Ads está en la versión beta. Lea Resumen de fuentes para conocer los términos y condiciones.
IMPORTANT
El origen Pinterest Ads está disponible como parte del SKU Customer Journey Analytics.

Use el origen Pinterest Ads para conectar sus cuentas de publicidad e ingerir metadatos de medios de pago y métricas de rendimiento. Adobe Experience Platform publica estos datos en conjuntos de datos de medios pagados. Use estos conjuntos de datos en Adobe Customer Journey Analytics para analizar sus campañas de marketing.

Para conectar tu cuenta, inicia sesión en Pinterest y autoriza a Experience Platform a acceder a tus datos publicitarios. No es necesario generar ni introducir las credenciales de la API manualmente.

Cómo funciona la ingesta how-it-works

Después de crear un flujo de datos y seleccionar las cuentas de publicidad, Experience Platform aprovisiona los conjuntos de datos y programa la ingesta automáticamente.

Proceso
Comportamiento
Aprovisionamiento de conjuntos de datos
Reutiliza los conjuntos de datos de medios pagados existentes en su organización y los crea si no existen.
Relleno inicial
Se ejecuta 30 minutos después de la creación del flujo de datos y recupera los metadatos y las métricas de los últimos 30 días.
Ingesta diaria
Se ejecuta una vez al día, empezando el día siguiente a la creación del flujo de datos, y recupera los metadatos y las métricas del día anterior.
Restablecimiento
Se ejecuta tres veces para cada ejecución de ingesta diaria: uno, dos y tres días después de esa ejecución.

El restablecimiento recupera datos históricos actualizados para tener en cuenta los cambios en las métricas informadas anteriormente. No configure usted mismo las programaciones de relleno, de ingesta diaria o de reafirmación.

Requisitos previos de cuenta prerequisites

Antes de conectar su cuenta de, asegúrese de que dispone de lo siguiente:

  • Cuenta de anuncio de Pinterest existente.
  • Las campañas y los anuncios ya están configurados en esa cuenta de publicidad.
  • Acceso para iniciar sesión en Pinterest y autorizar a Experience Platform para que acceda a las cuentas de publicidad que seleccione.

Configuración automática del conjunto de datos schema-and-dataset-provisioning

El conector asigna conjuntos de datos, esquemas y asignaciones de campos automáticamente. No se crea un esquema de destino, ni se selecciona un conjunto de datos de destino, ni se asignan campos durante la creación del flujo de datos.

Los tipos de entidad asignados son cuenta, campaña, grupo de publicidad, publicidad, recurso, experiencia y métricas de resumen. Assets representa Pinterest clavijas. Los registros de experiencia combinan información de Pines y anuncios en lugar de una API de experiencia independiente.

Asignaciones de campo XDM pinterest-fields

Utilice las siguientes tablas para comprender los campos principales asignados a esquemas XDM (Experience Data Model). El conector asigna paidMedia.adNetwork a pinterest.

Campos de cuenta account-fields

El esquema de cuenta almacena la identidad y los detalles de la cuenta de publicidad.

Campo de Pinterest
Campo XDM
Descripción
id
paidMedia.accountID
El identificador de la cuenta de publicidad.
name
paidMedia.accountDetails.accountName
El nombre de la cuenta del anuncio.
country
paidMedia.accountDetails.country
El código de país.
currency
paidMedia.accountDetails.currency
El código de divisa.
permissions
paidMedia.accountDetails.permissions
Matriz de permisos de cuenta.
time_zone
paidMedia.accountDetails.timezone
Zona horaria de la cuenta del anuncio.
created_time
paidMedia.metadata.createdTime
La marca de tiempo de creación, convertida a ISO 8601.
updated_time
paidMedia.metadata.updatedTime
La marca de tiempo de la modificación, convertida a ISO 8601.

Campos de Campaign campaign-fields

El esquema de campaña almacena la identidad, el estado y las relaciones de la campaña con las cuentas de publicidad.

Campo de Pinterest
Campo XDM
Descripción
id
paidMedia.campaignID
El identificador de campaña.
ad_account_id
paidMedia.accountID
El identificador de cuenta de publicidad principal.
name
paidMedia.metadata.name
Nombre de la campaña.
status
paidMedia.metadata.status
El estado de campaña normalizado.
summary_status
paidMedia.metadata.servingStatus
El estado de envío normalizado.
created_time
paidMedia.metadata.createdTime
La marca de tiempo de creación, convertida a ISO 8601.
updated_time
paidMedia.metadata.updatedTime
La marca de tiempo de la modificación, convertida a ISO 8601.

Para campañas, grupos de anuncios y anuncios, el conector normaliza ACTIVE, PAUSED, ARCHIVED y DRAFT a valores de estado en minúsculas. Asigna DELETED_DRAFT a deleted.

Campos del grupo de anuncios ad-group-fields

El esquema de grupos de publicidad almacena la identidad y las relaciones de los grupos de publicidad con las campañas y las cuentas de.

Campo de Pinterest
Campo XDM
Descripción
id
paidMedia.adGroupID
El identificador del grupo de publicidad.
ad_account_id
paidMedia.accountID
El identificador de cuenta de publicidad principal.
campaign_id
paidMedia.campaignID
El identificador de la campaña principal.
name
paidMedia.metadata.name
El nombre del grupo de publicidad.
status
paidMedia.metadata.status
El estado normalizado del grupo de anuncios.
summary_status
paidMedia.metadata.servingStatus
El estado de envío normalizado.

Campos de anuncio ad-fields

El esquema de publicidad almacena la identidad de la publicidad, el estado de la revisión y las relaciones con otras entidades de medios de pago.

Campo de Pinterest
Campo XDM
Descripción
id
paidMedia.adID
El identificador del anuncio.
ad_group_id
paidMedia.adGroupID
Identificador del grupo de anuncios principal.
campaign_id
paidMedia.campaignID
El identificador de la campaña principal.
ad_account_id
paidMedia.accountID
El identificador de cuenta de publicidad principal.
pin_id
paidMedia.assetID
El identificador de anclaje relacionado.
name
paidMedia.metadata.name
El nombre del anuncio.
status
paidMedia.metadata.status
El estado de anuncio normalizado.
review_status
adDetails.reviewStatus
El estado de la revisión, como pending, rejected, approved o not_reviewed.

Los títulos y las descripciones de Creative proceden del pin relacionado en lugar del objeto de anuncio.

Campos de recurso asset-fields

El esquema de recursos almacena el contenido de anclaje y las propiedades de medios. Las siguientes asignaciones describen los anclajes con una sola imagen o vídeo.

Campo de Pinterest
Campo XDM
Descripción
id
paidMedia.assetID
El identificador de anclaje.
title
assetDetails.title
El título del anclaje.
description
assetDetails.description
La descripción del anclaje.
media.media_type
assetDetails.assetType
El tipo de recurso, como image o video.
media.images["1200x"].url
assetDetails.mediaProperties.url
La URL de imagen disponible más grande.
media.images["150x150"].url
assetDetails.mediaProperties.thumbnailURL
La URL de la miniatura de la imagen.
media.video_url
assetDetails.mediaProperties.url
La URL de vídeo de un anclaje de vídeo.
media.cover_image_url
assetDetails.mediaProperties.thumbnailURL
La URL de la imagen de portada de un anclaje de vídeo.
media.duration
assetDetails.videoProperties.duration
La duración del vídeo, proporcionada por Pinterest en milisegundos.

En el caso de los pines con varias imágenes, vídeos o medios mixtos, cada elemento se convierte en un registro de recursos independiente. El conector genera un identificador de recurso mediante {pin_id}_{index}, donde index es la posición del elemento a partir de cero. Estos recursos utilizan el tipo de recurso carousel_card.

Campos de experiencia experience-fields

Los registros de experiencia describen la experiencia creativa derivada del anclaje y el anuncio. El identificador de experiencia utiliza el identificador de anclaje.

Tipo creativo de Pinterest
Tipo de experiencia XDM
REGULAR
single_image
VIDEO, MAX_VIDEO, CTV_VIDEO
single_video
CAROUSEL
carousel
COLLECTION, MAX_WIDTH_REGULAR_COLLECTION, MAX_WIDTH_VIDEO_COLLECTION
collection
IDEA, SHOWCASE
instant_experience
QUIZ, SHOPPING, COLLAGE, APP
other

En el caso de los anclajes con varios elementos multimedia, el conector rellena experienceDetails.carouselProperties.cards[] con una entrada por elemento. Cada tarjeta hace referencia a su identificador de recurso generado.

Campos de métricas de resumen summary-metrics-fields

Las métricas de resumen almacenan datos de rendimiento de publicidad. El conector asigna métricas de anuncios y métricas de recursos de Ad Analytics, usando PIN_ID como clave de agrupación de recursos.

Campo de Pinterest
Campo XDM
Descripción
SPEND_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR
metrics.spend
Gasto de Advertising.
PAID_IMPRESSION, TOTAL_IMPRESSION
metrics.impressions
Recuento de impresiones.
TOTAL_CLICKTHROUGH, CLICKTHROUGH_1, CLICKTHROUGH_2
metrics.clicks
Haga clic en count.
CTR, ECTR, CTR_2
metrics.ctr
Tasa de pulsaciones.
TOTAL_ENGAGEMENT, ENGAGEMENT_1, ENGAGEMENT_2
metrics.engagements
Recuento de participación.
TOTAL_CONVERSIONS
metrics.conversions
Recuento de conversiones.
CHECKOUT_ROAS
metrics.roas
Retorno del gasto en publicidad para conversiones de cierre de compra.
TOTAL_VIDEO_MRC_VIEWS, VIDEO_MRC_VIEWS_1, VIDEO_MRC_VIEWS_2
metrics.videoViews
Recuento de visualizaciones de vídeo.
TOTAL_VIDEO_P100_COMPLETE, VIDEO_P100_COMPLETE_2
metrics.videoCompletions
Recuento de visualizaciones de vídeo completadas.

Las asignaciones adicionales incluyen métricas de coste, conversión, vídeo, atribución y participación.

Las métricas de resumen de experiencia incluyen desgloses de dispositivo y ubicación de los análisis de segmentación de anuncios. El conector solicita APPTYPE para los desgloses del dispositivo y PLACEMENT para los desgloses de ubicación. No se solicitan otros desgloses de segmentación.

Conecte su cuenta connect-to-platform

Para crear un flujo de datos, siga el tutorial de la interfaz de usuario de Pinterest Ads.

Use la documentación de la API de Pinterest para obtener información acerca de las API de publicidad subyacentes.

recommendation-more-help
experience-platform-help-sources