DocumentationExperience PlatformGuide des connecteurs sources

[Beta]{class="badge informative"}

Pinterest Ads

Dernière mise à jour : 2 octobre 2026

Créé pour :

  • Développeur
NOTE
La source Pinterest Ads est en version Beta. Lisez la Présentation des sources pour connaître les termes et conditions.
IMPORTANT
La source de Pinterest Ads est disponible dans le cadre du SKU Customer Journey Analytics.

Utilisez la source Pinterest Ads pour connecter vos comptes publicitaires et ingérer des métadonnées de médias achetés et des mesures de performances. Adobe Experience Platform publie ces données dans des jeux de données de médias achetés. Utilisez ces jeux de données dans Adobe Customer Journey Analytics pour analyser vos campagnes marketing.

Pour connecter votre compte, connectez-vous à Pinterest et autorisez Experience Platform à accéder à vos données publicitaires. Vous n’avez pas besoin de générer ou de saisir manuellement les informations d’identification API.

Fonctionnement de l’ingestion how-it-works

Après avoir créé un flux de données et sélectionné vos comptes publicitaires, Experience Platform approvisionne automatiquement les jeux de données et planifie l’ingestion.

Processus
Comportement
Approvisionnement des jeux de données
Réutilise les jeux de données de médias achetés existants de votre organisation et les crée s’ils n’existent pas.
Renvoi initial
S’exécute 30 minutes après la création du flux de données et récupère les métadonnées et les mesures des 30 derniers jours.
Ingestion quotidienne
S’exécute une fois par jour, à partir du jour suivant la création du flux de données, et récupère les métadonnées et les mesures du jour précédent.
Retraitement
S’exécute trois fois pour chaque exécution d’ingestion quotidienne : un, deux et trois jours après cette exécution.

Le retraitement récupère les données historiques mises à jour pour prendre en compte les modifications apportées aux mesures précédemment signalées. Vous ne configurez pas vous-même les plannings de renvoi, d’ingestion quotidienne ou de retraitement.

Conditions préalables relatives au compte prerequisites

Avant de connecter votre compte , vérifiez que vous disposez des éléments suivants :

  • Un compte publicitaire Pinterest existant.
  • Les campagnes et les publicités sont déjà configurées dans ce compte publicitaire.
  • Accès pour vous connecter à Pinterest et autoriser Experience Platform à accéder aux comptes publicitaires que vous sélectionnez.

Configuration automatique des jeux de données schema-and-dataset-provisioning

Le connecteur affecte automatiquement les jeux de données, les schémas et les mappages de champs. Vous ne créez pas de schéma cible, ne sélectionnez pas de jeu de données cible et ne mappez pas de champs lors de la création du flux de données.

Les types d’entités mappés sont les mesures compte, campagne, groupe publicitaire, publicité, ressource, expérience et résumé. Assets représente les épingles Pinterest. Les enregistrements d’expérience combinent des informations provenant d’épingles et de publicités plutôt que d’une API d’expérience distincte.

Mappages de champs XDM pinterest-fields

Utilisez les tableaux suivants pour comprendre les champs principaux mappés aux schémas de modèle de données d’expérience (XDM). Le connecteur mappe paidMedia.adNetwork à pinterest.

Champs du compte account-fields

Le schéma de compte stocke l’identité et les détails de votre compte publicitaire.

Champ Pinterest
Champ XDM
Description
id
paidMedia.accountID
Identifiant du compte publicitaire.
name
paidMedia.accountDetails.accountName
Nom du compte publicitaire.
country
paidMedia.accountDetails.country
Code pays.
currency
paidMedia.accountDetails.currency
Code de devise.
permissions
paidMedia.accountDetails.permissions
Tableau d’autorisations de compte.
time_zone
paidMedia.accountDetails.timezone
Fuseau horaire du compte publicitaire.
created_time
paidMedia.metadata.createdTime
Date et heure de création, converties en ISO 8601.
updated_time
paidMedia.metadata.updatedTime
Date et heure de modification, converties en ISO 8601.

Champs de campagne campaign-fields

Le schéma de la campagne stocke l’identité, le statut et les relations de la campagne avec les comptes publicitaires.

Champ Pinterest
Champ XDM
Description
id
paidMedia.campaignID
Identifiant de la campagne.
ad_account_id
paidMedia.accountID
Identifiant du compte publicitaire parent.
name
paidMedia.metadata.name
Nom de la campagne.
status
paidMedia.metadata.status
Statut de la campagne normalisée.
summary_status
paidMedia.metadata.servingStatus
Statut de diffusion normalisé.
created_time
paidMedia.metadata.createdTime
Date et heure de création, converties en ISO 8601.
updated_time
paidMedia.metadata.updatedTime
Date et heure de modification, converties en ISO 8601.

Pour les campagnes, les groupes d’annonces et les annonces, le connecteur normalise les valeurs de statut ACTIVE, PAUSED, ARCHIVED et DRAFT en minuscules. Il mappe les DELETED_DRAFT aux deleted.

Champs de groupe publicitaire ad-group-fields

Le schéma de groupe publicitaire stocke l’identité du groupe publicitaire et les relations avec les campagnes et les comptes.

Champ Pinterest
Champ XDM
Description
id
paidMedia.adGroupID
Identifiant du groupe publicitaire.
ad_account_id
paidMedia.accountID
Identifiant du compte publicitaire parent.
campaign_id
paidMedia.campaignID
Identifiant de campagne parent.
name
paidMedia.metadata.name
Nom du groupe publicitaire.
status
paidMedia.metadata.status
Statut du groupe publicitaire normalisé.
summary_status
paidMedia.metadata.servingStatus
Statut de diffusion normalisé.

Ajouter des champs ad-fields

Le schéma des publicités stocke l’identité des publicités, le statut de révision et les relations avec d’autres entités de médias achetés.

Champ Pinterest
Champ XDM
Description
id
paidMedia.adID
Identifiant de la publicité.
ad_group_id
paidMedia.adGroupID
Identifiant du groupe publicitaire parent.
campaign_id
paidMedia.campaignID
Identifiant de campagne parent.
ad_account_id
paidMedia.accountID
Identifiant du compte publicitaire parent.
pin_id
paidMedia.assetID
Identifiant d’épingle associé.
name
paidMedia.metadata.name
Nom de la publicité.
status
paidMedia.metadata.status
Statut de la publicité normalisée.
review_status
adDetails.reviewStatus
Statut de révision, tel que pending, rejected, approved ou not_reviewed.

Les titres et descriptions de Creative proviennent de l’épingle associée plutôt que de l’objet publicitaire.

Champs de ressource asset-fields

Le schéma de ressource stocke le contenu épinglé et les propriétés multimédia. Les mappages suivants décrivent les épingles avec une seule image ou vidéo.

Champ Pinterest
Champ XDM
Description
id
paidMedia.assetID
Identifiant d’épingle.
title
assetDetails.title
Titre de l’épingle.
description
assetDetails.description
Description de l’épingle.
media.media_type
assetDetails.assetType
Type de ressource, tel que image ou video.
media.images["1200x"].url
assetDetails.mediaProperties.url
La plus grande URL d’image disponible.
media.images["150x150"].url
assetDetails.mediaProperties.thumbnailURL
URL de la miniature de l’image.
media.video_url
assetDetails.mediaProperties.url
URL d’une épingle de vidéo.
media.cover_image_url
assetDetails.mediaProperties.thumbnailURL
URL de l’image de couverture d’une épingle de vidéo.
media.duration
assetDetails.videoProperties.duration
Durée de la vidéo, fournie par Pinterest en millisecondes.

Pour les épingles comportant plusieurs images, vidéos ou supports variés, chaque élément devient un enregistrement de ressource distinct. Le connecteur génère un identifiant de ressource à l’aide de {pin_id}_{index}, où index correspond à la position de l’élément à partir de zéro. Ces ressources utilisent le type de ressource carousel_card.

Champs d’expérience experience-fields

Les enregistrements d’expérience décrivent l’expérience créative dérivée de l’épingle et de la publicité. L’identifiant d’expérience utilise l’identifiant d’épingle .

Type de contenu créatif Pinterest
Type d’expérience 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

Pour les épingles comportant plusieurs éléments multimédias, le connecteur renseigne experienceDetails.carouselProperties.cards[] avec une entrée par élément. Chaque carte référence son identifiant de ressource généré.

Champs de mesures récapitulatives summary-metrics-fields

Les mesures récapitulatives stockent les données de performances publicitaires. Le connecteur mappe les mesures de publicité et les mesures de ressources d’ad analytics, en utilisant PIN_ID comme clé de regroupement des ressources.

Champ Pinterest
Champ XDM
Description
SPEND_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR
metrics.spend
dépenses Advertising.
PAID_IMPRESSION, TOTAL_IMPRESSION
metrics.impressions
Nombre d’impressions.
TOTAL_CLICKTHROUGH, CLICKTHROUGH_1, CLICKTHROUGH_2
metrics.clicks
Nombre de clics.
CTR, ECTR, CTR_2
metrics.ctr
Taux de clics.
TOTAL_ENGAGEMENT, ENGAGEMENT_1, ENGAGEMENT_2
metrics.engagements
Nombre d’engagements.
TOTAL_CONVERSIONS
metrics.conversions
Nombre de conversions.
CHECKOUT_ROAS
metrics.roas
Retour sur dépenses publicitaires pour les conversions de passage en caisse.
TOTAL_VIDEO_MRC_VIEWS, VIDEO_MRC_VIEWS_1, VIDEO_MRC_VIEWS_2
metrics.videoViews
Nombre de vues vidéo.
TOTAL_VIDEO_P100_COMPLETE, VIDEO_P100_COMPLETE_2
metrics.videoCompletions
Nombre de vues vidéo terminées.

Les mappages supplémentaires comprennent les mesures de coût, de conversion, de vidéo, d’attribution et d’engagement.

Les mesures de résumé de l’expérience incluent les répartitions des appareils et des emplacements depuis les analyses de ciblage publicitaire. Le connecteur demande des APPTYPE pour les répartitions d’appareil et des PLACEMENT pour les répartitions d’emplacement. D’autres répartitions de ciblage ne sont pas demandées.

Connecter votre compte connect-to-platform

Pour créer un flux de données, suivez le tutoriel sur l’interface utilisateur de Pinterest Ads 🔗.

Utilisez la documentation de l’API Pinterest 🔗 pour plus d’informations sur les API publicitaires sous-jacentes.

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