DocumentazioneExperience PlatformGuida ai connettori di origini

[Beta]{class="badge informative"}

Pinterest Ads

Ultimo aggiornamento: 2 ottobre 2026

Creato per:

  • Sviluppatore
NOTE
L'origine Pinterest Ads è in versione beta. Leggi la Panoramica origini per i termini e le condizioni.
IMPORTANT
L'origine Pinterest Ads è disponibile come parte dello SKU Customer Journey Analytics.

Utilizza l’origine Pinterest Ads per collegare gli account degli annunci e acquisire metadati di contenuti multimediali a pagamento e metriche delle prestazioni. Adobe Experience Platform pubblica questi dati nei set di dati per supporti a pagamento. Utilizza questi set di dati in Adobe Customer Journey Analytics per analizzare le campagne di marketing.

Per connettere il tuo account, accedi a Pinterest e autorizza Experience Platform ad accedere ai tuoi dati pubblicitari. Non è necessario generare o immettere manualmente le credenziali API.

Come funziona l’acquisizione how-it-works

Dopo aver creato un flusso di dati e aver selezionato gli account dell’annuncio, Experience Platform esegue il provisioning dei set di dati e pianifica automaticamente l’acquisizione.

Processo
Comportamento
Provisioning dei set di dati
Riutilizza i set di dati a pagamento esistenti nell’organizzazione e li crea se non esistono.
Retrocompilazione iniziale
Viene eseguito 30 minuti dopo la creazione del flusso di dati e recupera i metadati e le metriche per gli ultimi 30 giorni.
Acquisizione giornaliera
Viene eseguito una volta al giorno, a partire dal giorno successivo alla creazione del flusso di dati, e recupera i metadati e le metriche per il giorno precedente.
Restatement
Viene eseguito tre volte per ogni esecuzione di acquisizione giornaliera: uno, due e tre giorni dopo tale esecuzione.

La ridefinizione recupera i dati storici aggiornati per tenere conto delle modifiche apportate alle metriche precedentemente segnalate. Non puoi configurare autonomamente la pianificazione della retrocompilazione, dell’acquisizione giornaliera o della rigenerazione.

Prerequisiti per l’account prerequisites

Prima di connettere l’account, assicurati di disporre dei seguenti elementi:

  • Un account annuncio Pinterest esistente.
  • Campagne e annunci già impostati in tale account pubblicitario.
  • Accedere per accedere a Pinterest e autorizzare Experience Platform ad accedere agli account annuncio selezionati.

Impostazione automatica del set di dati schema-and-dataset-provisioning

Il connettore assegna automaticamente set di dati, schemi e mappature di campi. Non puoi creare uno schema di destinazione, selezionare un set di dati di destinazione o mappare i campi durante la creazione del flusso di dati.

I tipi di entità mappati sono account, campagna, gruppo di annunci, annuncio, risorsa, esperienza e metriche di riepilogo. Assets rappresenta Pinterest pin. I record di esperienza combinano informazioni provenienti da pin e annunci anziché da un’API di esperienza separata.

Mappature campi XDM pinterest-fields

Utilizza le tabelle seguenti per comprendere i campi core mappati agli schemi Experience Data Model (XDM). Il connettore mappa paidMedia.adNetwork a pinterest.

Campi account account-fields

Lo schema account memorizza l’identità dell’account dell’annuncio e i relativi dettagli.

Campo Pinterest
Campo XDM
Descrizione
id
paidMedia.accountID
L’identificatore dell’account dell’annuncio.
name
paidMedia.accountDetails.accountName
Il nome dell’account dell’annuncio.
country
paidMedia.accountDetails.country
Il codice del paese.
currency
paidMedia.accountDetails.currency
Il codice valuta.
permissions
paidMedia.accountDetails.permissions
Un array di autorizzazioni account.
time_zone
paidMedia.accountDetails.timezone
Il fuso orario dell’account dell’annuncio.
created_time
paidMedia.metadata.createdTime
Il timestamp di creazione, convertito in ISO 8601.
updated_time
paidMedia.metadata.updatedTime
La marca temporale della modifica, convertita in ISO 8601.

Campi della campagna campaign-fields

Lo schema della campagna memorizza l’identità, lo stato e le relazioni della campagna con gli account degli annunci.

Campo Pinterest
Campo XDM
Descrizione
id
paidMedia.campaignID
L’identificatore della campagna.
ad_account_id
paidMedia.accountID
L’identificatore dell’account dell’annuncio principale.
name
paidMedia.metadata.name
Il nome della campagna.
status
paidMedia.metadata.status
Stato normalizzato della campagna.
summary_status
paidMedia.metadata.servingStatus
Lo stato di consegna normalizzato.
created_time
paidMedia.metadata.createdTime
Il timestamp di creazione, convertito in ISO 8601.
updated_time
paidMedia.metadata.updatedTime
La marca temporale della modifica, convertita in ISO 8601.

Per campagne, gruppi di annunci e annunci, il connettore normalizza ACTIVE, PAUSED, ARCHIVED e DRAFT in valori di stato in minuscolo. Mappa DELETED_DRAFT a deleted.

Campi del gruppo di annunci ad-group-fields

Lo schema del gruppo di annunci memorizza l’identità e le relazioni del gruppo di annunci con le campagne e gli account.

Campo Pinterest
Campo XDM
Descrizione
id
paidMedia.adGroupID
L’identificatore del gruppo di annunci.
ad_account_id
paidMedia.accountID
L’identificatore dell’account dell’annuncio principale.
campaign_id
paidMedia.campaignID
L’identificatore della campagna principale.
name
paidMedia.metadata.name
Il nome del gruppo di annunci.
status
paidMedia.metadata.status
Stato del gruppo di annunci normalizzati.
summary_status
paidMedia.metadata.servingStatus
Lo stato di consegna normalizzato.

Campi annuncio ad-fields

Lo schema dell’annuncio memorizza l’identità dell’annuncio, lo stato di revisione e le relazioni con altre entità multimediali a pagamento.

Campo Pinterest
Campo XDM
Descrizione
id
paidMedia.adID
L’identificatore dell’annuncio.
ad_group_id
paidMedia.adGroupID
L’identificatore del gruppo di annunci principale.
campaign_id
paidMedia.campaignID
L’identificatore della campagna principale.
ad_account_id
paidMedia.accountID
L’identificatore dell’account dell’annuncio principale.
pin_id
paidMedia.assetID
Identificatore pin correlato.
name
paidMedia.metadata.name
Il nome dell’annuncio.
status
paidMedia.metadata.status
Lo stato dell’annuncio normalizzato.
review_status
adDetails.reviewStatus
Lo stato della revisione, ad esempio pending, rejected, approved o not_reviewed.

I titoli e le descrizioni di Creative provengono dal pin correlato anziché dall’oggetto annuncio.

Campi risorsa asset-fields

Lo schema risorsa archivia il contenuto pin e le proprietà multimediali. Le mappature seguenti descrivono pin con una singola immagine o video.

Campo Pinterest
Campo XDM
Descrizione
id
paidMedia.assetID
L’identificatore Pin.
title
assetDetails.title
Il titolo del pin.
description
assetDetails.description
La descrizione del pin.
media.media_type
assetDetails.assetType
Tipo di risorsa, ad esempio image o video.
media.images["1200x"].url
assetDetails.mediaProperties.url
URL immagine più grande disponibile.
media.images["150x150"].url
assetDetails.mediaProperties.thumbnailURL
URL della miniatura dell’immagine.
media.video_url
assetDetails.mediaProperties.url
URL del video per un pin video.
media.cover_image_url
assetDetails.mediaProperties.thumbnailURL
URL dell’immagine di copertina di un pin video.
media.duration
assetDetails.videoProperties.duration
Durata del video, fornita da Pinterest in millisecondi.

Se utilizzi pin con più immagini, video o file multimediali diversi, ogni elemento diventa un record di risorsa separato. Il connettore genera un identificatore di risorsa utilizzando {pin_id}_{index}, dove index è la posizione dell’elemento a partire da zero. Queste risorse utilizzano il tipo di risorsa carousel_card.

Campi esperienza experience-fields

I record di esperienza descrivono l’esperienza creativa derivata dal pin e dall’annuncio. L’identificatore dell’esperienza utilizza l’identificatore Pin.

Tipo di creatività Pinterest
Tipo di esperienza 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

Per i pin con più elementi multimediali, il connettore compila experienceDetails.carouselProperties.cards[] con una voce per elemento. Ogni scheda fa riferimento al proprio identificatore di risorsa generato.

Campi delle metriche di riepilogo summary-metrics-fields

Le metriche di riepilogo memorizzano i dati sulle prestazioni della pubblicità. Il connettore mappa le metriche e le metriche delle risorse da Ad Analytics, utilizzando PIN_ID come chiave di raggruppamento delle risorse.

Campo Pinterest
Campo XDM
Descrizione
SPEND_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR
metrics.spend
Spesa Advertising.
PAID_IMPRESSION, TOTAL_IMPRESSION
metrics.impressions
Conteggio impression.
TOTAL_CLICKTHROUGH, CLICKTHROUGH_1, CLICKTHROUGH_2
metrics.clicks
Fai clic su conteggio.
CTR, ECTR, CTR_2
metrics.ctr
Percentuale di clic.
TOTAL_ENGAGEMENT, ENGAGEMENT_1, ENGAGEMENT_2
metrics.engagements
Conteggio coinvolgimento.
TOTAL_CONVERSIONS
metrics.conversions
Conteggio delle conversioni.
CHECKOUT_ROAS
metrics.roas
Ritorno sulle spese pubblicitarie per le conversioni di pagamento.
TOTAL_VIDEO_MRC_VIEWS, VIDEO_MRC_VIEWS_1, VIDEO_MRC_VIEWS_2
metrics.videoViews
Conteggio visualizzazioni video.
TOTAL_VIDEO_P100_COMPLETE, VIDEO_P100_COMPLETE_2
metrics.videoCompletions
Conteggio visualizzazioni video completato.

Altre mappature includono metriche di costo, conversione, video, attribuzione e coinvolgimento.

Le metriche di riepilogo dell’esperienza includono raggruppamenti di dispositivi e posizionamenti da Ad Targeting Analytics. Il connettore richiede APPTYPE per i raggruppamenti dei dispositivi e PLACEMENT per i raggruppamenti dei posizionamenti. Non sono richieste altre suddivisioni di targeting.

Connetti il tuo account connect-to-platform

Per creare un flusso di dati, segui l’esercitazione sull’interfaccia utente di Pinterest Ads.

Utilizza la documentazione API di Pinterest per informazioni sulle API pubblicitarie sottostanti.

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