DokumentationExperience PlatformAnleitung zu Quell-Connectoren

[Beta]{class="badge informative"}

Pinterest Ads

Letzte Aktualisierung: 2. Oktober 2026

Erstellt für:

  • Entwicklerin/Entwickler
NOTE
Die Pinterest Ads-Quelle befindet sich in der Beta-Phase. Lesen Sie Quellen - Übersicht für die Nutzungsbedingungen.
IMPORTANT
Die Pinterest Ads ist als Teil der Customer Journey Analytics SKU verfügbar.

Verwenden Sie die Pinterest Ads, um Ihre Werbekonten zu verbinden und Paid-Media-Metadaten und -Leistungsmetriken aufzunehmen. Adobe Experience Platform veröffentlicht diese Daten in Paid-Media-Datensätzen. Verwenden Sie diese Datensätze in Adobe Customer Journey Analytics zur Analyse Ihrer Marketing-Kampagnen.

Um Ihr Konto zu verbinden, melden Sie sich bei Pinterest an und autorisieren Sie Experience Platform, auf Ihre Werbedaten zuzugreifen. API-Anmeldeinformationen müssen nicht manuell generiert oder eingegeben werden.

Funktionsweise der Aufnahme how-it-works

Nachdem Sie einen Datenfluss erstellt und Ihre Werbekonten ausgewählt haben, stellt Experience Platform Datensätze bereit und plant die Aufnahme automatisch.

Prozess
Verhalten
Datensatz-Bereitstellung
Verwendet vorhandene Paid-Media-Datensätze in Ihrer Organisation und erstellt sie, wenn sie nicht vorhanden sind.
Ursprüngliche Aufstockung
Wird 30 Minuten nach der Erstellung des Datenflusses ausgeführt und ruft Metadaten und Metriken der letzten 30 Tage ab.
Tägliche Aufnahme
Wird einmal täglich ausgeführt, beginnend am Tag nach der Erstellung des Datenflusses, und ruft Metadaten und Metriken für den vorherigen Tag ab.
Neuformulierung
Wird dreimal pro täglicher Erfassungsausführung ausgeführt: ein, zwei und drei Tage nach dieser Ausführung.

Mit der Anpassung werden aktualisierte historische Daten abgerufen, um Änderungen an zuvor gemeldeten Metriken zu berücksichtigen. Sie konfigurieren die Aufstockung, die tägliche Aufnahme oder Neuanordnungspläne nicht selbst.

Voraussetzungen für das Konto prerequisites

Bevor Sie Ihr -Konto verbinden, stellen Sie Folgendes sicher:

  • Ein vorhandenes Pinterest-Werbekonto.
  • Kampagnen und Anzeigen sind in diesem Werbekonto bereits eingerichtet.
  • Zugriff auf die Anmeldung bei Pinterest und die Autorisierung von Experience Platform für den Zugriff auf die von Ihnen ausgewählten Werbekonten.

Automatisches Einrichten von Datensätzen schema-and-dataset-provisioning

Der Connector weist Datensätze, Schemata und Feldzuordnungen automatisch zu. Sie erstellen während der Erstellung eines Datenflusses kein Zielschema, wählen keinen Zieldatensatz aus und ordnen keine Felder zu.

Die zugeordneten Entitätstypen sind Konto-, Kampagnen-, Anzeigengruppen-, Anzeigen-, Asset-, Erlebnis- und Zusammenfassungsmetriken. Assets stellt Pinterest Pins dar. Erlebnisdatensätze kombinieren Informationen aus Pins und Anzeigen anstelle einer separaten Erlebnis-API.

XDM-Feldzuordnungen pinterest-fields

In den folgenden Tabellen finden Sie die Kernfelder, die den Experience-Datenmodell (XDM)-Schemata zugeordnet sind. Der Connector ordnet paidMedia.adNetwork pinterest zu.

Kontofelder account-fields

Das Kontoschema speichert Ihre Werbekonto-Identität und Kontodetails.

Pinterest-Feld
XDM-Feld
Beschreibung
id
paidMedia.accountID
Die Kennung des Werbekontos.
name
paidMedia.accountDetails.accountName
Der Name des Werbekontos.
country
paidMedia.accountDetails.country
Der Länder-Code.
currency
paidMedia.accountDetails.currency
Der Währungscode.
permissions
paidMedia.accountDetails.permissions
Ein Array von Kontoberechtigungen.
time_zone
paidMedia.accountDetails.timezone
Die Zeitzone des Werbekontos.
created_time
paidMedia.metadata.createdTime
Der Erstellungszeitstempel, konvertiert in ISO 8601.
updated_time
paidMedia.metadata.updatedTime
Der Änderungszeitstempel, konvertiert in ISO 8601.

Kampagnenfelder campaign-fields

Das Kampagnenschema speichert die Kampagnenidentität, den Status und die Beziehungen zu Werbekonten.

Pinterest-Feld
XDM-Feld
Beschreibung
id
paidMedia.campaignID
Die Kampagnenkennung.
ad_account_id
paidMedia.accountID
Die Kennung des übergeordneten Werbekontos.
name
paidMedia.metadata.name
Der Kampagnenname.
status
paidMedia.metadata.status
Der normalisierte Kampagnenstatus.
summary_status
paidMedia.metadata.servingStatus
Der normalisierte Versandstatus.
created_time
paidMedia.metadata.createdTime
Der Erstellungszeitstempel, konvertiert in ISO 8601.
updated_time
paidMedia.metadata.updatedTime
Der Änderungszeitstempel, konvertiert in ISO 8601.

Für Kampagnen, Anzeigengruppen und Anzeigen normalisiert der Connector ACTIVE, PAUSED, ARCHIVED und DRAFT auf Statuswerte in Kleinbuchstaben. Er ordnet DELETED_DRAFT deleted zu.

Anzeigengruppenfelder ad-group-fields

Das Anzeigengruppenschema speichert die Identität der Anzeigengruppe und die Beziehungen zu Kampagnen und Konten.

Pinterest-Feld
XDM-Feld
Beschreibung
id
paidMedia.adGroupID
Die Anzeigengruppenkennung.
ad_account_id
paidMedia.accountID
Die Kennung des übergeordneten Werbekontos.
campaign_id
paidMedia.campaignID
Die Kennung der übergeordneten Kampagne.
name
paidMedia.metadata.name
Der Name der Anzeigengruppe.
status
paidMedia.metadata.status
Der normalisierte Anzeigengruppenstatus.
summary_status
paidMedia.metadata.servingStatus
Der normalisierte Versandstatus.

Felder hinzufügen ad-fields

Das Anzeigenschema speichert die Anzeigenidentität, den Prüfungsstatus und die Beziehungen zu anderen Paid-Media-Entitäten.

Pinterest-Feld
XDM-Feld
Beschreibung
id
paidMedia.adID
Die Anzeigenkennung.
ad_group_id
paidMedia.adGroupID
Die Kennung der übergeordneten Anzeigengruppe.
campaign_id
paidMedia.campaignID
Die Kennung der übergeordneten Kampagne.
ad_account_id
paidMedia.accountID
Die Kennung des übergeordneten Werbekontos.
pin_id
paidMedia.assetID
Die zugehörige PIN-Kennung.
name
paidMedia.metadata.name
Der Anzeigenname.
status
paidMedia.metadata.status
Der normalisierte Anzeigenstatus.
review_status
adDetails.reviewStatus
Der Überprüfungsstatus, z. B. pending, rejected, approved oder not_reviewed.

Creative-Titel und -Beschreibungen stammen aus der zugehörigen PIN und nicht aus dem Anzeigenobjekt.

Asset-Felder asset-fields

Das Asset-Schema speichert PIN-Inhalte und Medieneigenschaften. Die folgenden Zuordnungen beschreiben Pins mit einem einzelnen Bild oder Video.

Pinterest-Feld
XDM-Feld
Beschreibung
id
paidMedia.assetID
Die PIN-Kennung.
title
assetDetails.title
Der PIN-Titel.
description
assetDetails.description
Die PIN-Beschreibung.
media.media_type
assetDetails.assetType
Der Asset-Typ, z. B. image oder video.
media.images["1200x"].url
assetDetails.mediaProperties.url
Die größte verfügbare Bild-URL.
media.images["150x150"].url
assetDetails.mediaProperties.thumbnailURL
Die URL der Miniaturansicht.
media.video_url
assetDetails.mediaProperties.url
Die Video-URL für eine Video-Pin.
media.cover_image_url
assetDetails.mediaProperties.thumbnailURL
Die URL des Cover-Bildes für einen Video-Pin.
media.duration
assetDetails.videoProperties.duration
Die Videodauer, angegeben durch Pinterest in Millisekunden.

Bei Anheftungen mit mehreren Bildern, Videos oder gemischten Medien wird jedes Element zu einem separaten Asset-Datensatz. Der Connector generiert eine Asset-Kennung mithilfe von {pin_id}_{index}, wobei index die Position des Elements beginnend bei null ist. Diese Assets verwenden den carousel_card Asset-Typ .

Erlebnisfelder experience-fields

Erlebnisdatensätze beschreiben das aus der PIN und der Anzeige abgeleitete kreative Erlebnis. Die Erlebniskennung verwendet die PIN-Kennung.

Pinterest-Kreativtyp
XDM-Erlebnistyp
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

Bei Anheftungen mit mehreren Medienelementen füllt der Connector experienceDetails.carouselProperties.cards[] mit einem Eintrag pro Element. Jede Karte verweist auf ihre generierte Asset-Kennung.

Felder für Zusammenfassungsmetriken summary-metrics-fields

Zusammenfassungsmetriken speichern Leistungsdaten der Werbung. Der Connector ordnet Anzeigenmetriken und Asset-Metriken aus Ad Analytics zu, wobei PIN_ID als Asset-Gruppierungsschlüssel verwendet wird.

Pinterest-Feld
XDM-Feld
Beschreibung
SPEND_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR
metrics.spend
Ausgaben für Advertising.
PAID_IMPRESSION, TOTAL_IMPRESSION
metrics.impressions
Anzahl der Impressionen.
TOTAL_CLICKTHROUGH, CLICKTHROUGH_1, CLICKTHROUGH_2
metrics.clicks
Klicken Sie auf Anzahl.
CTR, ECTR, CTR_2
metrics.ctr
Klickrate.
TOTAL_ENGAGEMENT, ENGAGEMENT_1, ENGAGEMENT_2
metrics.engagements
Interaktionsanzahl.
TOTAL_CONVERSIONS
metrics.conversions
Konversionszählung
CHECKOUT_ROAS
metrics.roas
Rendite auf Werbeausgaben für Checkout-Konversionen.
TOTAL_VIDEO_MRC_VIEWS, VIDEO_MRC_VIEWS_1, VIDEO_MRC_VIEWS_2
metrics.videoViews
Anzahl der Videoansichten.
TOTAL_VIDEO_P100_COMPLETE, VIDEO_P100_COMPLETE_2
metrics.videoCompletions
Anzahl der abgeschlossenen Videoansichten.

Zu den zusätzlichen Zuordnungen gehören Kosten-, Konversions-, Video-, Attributions- und Interaktionsmetriken.

Zu den Erlebniszusammenfassungsmetriken gehören Aufschlüsselungen nach Gerät und Platzierung aus der Analyse von Anzeigen-Targeting. Der Connector fordert APPTYPE nach Geräteausfällen und PLACEMENT nach Platzierungsaufschlüsselungen an. Andere Aufschlüsselungen der Zielgruppenbestimmung werden nicht angefordert.

Konto verbinden connect-to-platform

Um einen Datenfluss zu erstellen, folgen Sie dem Tutorial zur Pinterest Ads-Benutzeroberfläche.

Informationen zu den zugrunde liegenden Advertising-APIs 🔗 Sie in der Dokumentation zur Pinterest-API für .

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