Estensione Pinterest per l’inoltro degli eventi

Last update: Thu Oct 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Sviluppatore

Pinterest è un motore di ricerca visiva che consente di trovare idee quali ricette, decorazioni domestiche, ispirazioni allo stile e altro ancora. Miliardi di pin su Pinterest, che possono essere condivisi con altri utenti su Pinterest. È possibile fascicolare gli eventi di interazione utente e sfruttare Pinterest Analytics per comprendere il comportamento dell'utente ed eseguire annunci mirati.

L'estensione Pinterest Conversions API event forwarding ti consente di sfruttare i dati acquisiti in Adobe Experience Platform Edge Network e inviarli a Pinterest. Questo documento descrive i casi di utilizzo dell'estensione, come installarla e come integrarne le funzionalità nell'inoltro degli eventi rules.

I token di accesso per le conversioni sono il metodo di autenticazione utilizzato da Pinterest durante l'interazione con l'API Pinterest.

Casi d’uso

Questa estensione deve essere utilizzata se si desidera utilizzare i dati di Edge Network in Pinterest per sfruttare le funzionalità di analisi dei clienti.

Ad esempio, considera un team di marketing in un’organizzazione. Il team acquisisce i dati dell'evento di interazione dell'utente dal proprio sito Web e li carica in Pinterest utilizzando questa estensione di inoltro degli eventi.

I team di marketing e analisi possono quindi sfruttare le funzionalità di Analytics Pinterest per comprendere le interazioni e il comportamento chiave degli utenti, consentendoti di comprendere meglio gli utenti e indirizzarli verso campagne pubblicitarie mirate.

Per ulteriori informazioni sui casi d'uso specifici di Pinterest, consulta la documentazione sui Pinterest casi d'uso.

Pinterest prerequisiti prerequisites

Per utilizzare questa estensione, è necessario disporre di un Pinterest account aziendale valido. Vai alla Pinterest pagina di registrazione per registrarti e creare un account, se non ne hai già uno.

Sarà inoltre necessario un account sviluppatore Pinterest, che dovrà essere associato all'account aziendale Pinterest. Per associare l'account sviluppatore all'account aziendale, fare riferimento all'Pinterest account sviluppatore.

Raccogliere i dettagli di configurazione richiesti configuration-details

Per connettere Experience Platform a Pinterest, sono necessari i seguenti input:

Credenziali

Descrizione

Esempio

ID account annunci

ID del tuo account Pinterest Ads. Consulta la Pinterest documentazione per maggiori informazioni.

123456789012

Token di accesso alla conversione

Il Token Di Accesso Per La Conversione Pinterest. Consulta il documento Pinterest Conversions API per maggiori informazioni.
Questa operazione verrà richiesta solo una volta, poiché il token non scade.

Installa e configura l'estensione Pinterest install

Per installare l'estensione, crea una proprietà di inoltro eventi o scegli una proprietà esistente da modificare.

Nel menu di navigazione a sinistra, selezionare Extensions. Selezionare Install sulla scheda per l'estensione Pinterest nella scheda Catalog.

Catalogo che visualizza lestensione Pinterest con Install evidenziato.

Configura l'estensione Pinterest

IMPORTANT

A seconda delle esigenze di implementazione, potrebbe essere necessario creare uno schema, elementi di dati e un set di dati prima di configurare l’estensione. Prima di iniziare, controlla tutti i passaggi di configurazione per determinare quali entità devi impostare per il tuo caso d’uso.

Nel menu di navigazione a sinistra, selezionare Extensions. Selezionare Configure sulla scheda per l'estensione Pinterest nella scheda Installed**.

Estensione Pinterest visualizzata nella scheda Install con Configure evidenziato.

Nella schermata successiva, immettere Ads Account Id e Conversion Access Token raccolti in precedenza nella sezione dettagli configurazione. Al termine, selezionare Save.

Nella schermata Pinterest Configure sono evidenziati i campi di input Ads Account Id e Conversion Access Token.

Configurare una regola di inoltro degli eventi config-rule

Una volta configurati tutti gli elementi dati, puoi iniziare a creare regole di inoltro degli eventi che determinano quando e come verranno inviati gli eventi a Pinterest.

Crea una nuova regola nella proprietà di inoltro eventi. In Actions, aggiungere una nuova azione e impostare l'estensione su Pinterest. Per inviare eventi Edge Network a Pinterest, impostare Action Type su Send Event.

Creazione della regola Pinterest Send Event.

Dopo la selezione, vengono visualizzati controlli aggiuntivi per configurare ulteriormente l’evento. È necessario mappare le proprietà evento Pinterest agli elementi dati creati in precedenza.

Event Data

Per creare la nuova regola sono necessari i seguenti dati evento:

Nome campo

Descrizione

Esempio

Event Name

Tipo dell’evento utente. Questo può essere qualsiasi tipo di evento, tuttavia, per sfruttare Pinterest Analytics si consiglia di utilizzare Pinterest codici evento

* estrazione
* add_to_cart
* visita_pagina
* iscrizione
* [Evento definito dall'utente]

Action Source

L’origine che indica dove si è verificato l’evento di conversione.

* app_android
* app_ios
* Web
* offline

Event Time

Si riferisce all’ora dell’evento. Il formato di ora predefinito utilizzato è UNIX, nel formato <seconds>.<miliseconds> a seconda del fuso orario locale. Per ulteriori informazioni, consultare Pinterest API.

1433188255.500 indica 1433188255 secondi e 500 millisecondi dopo l'epoca, oppure lunedì 1 giugno 2015 alle 19:00 GMT.:50:

Event ID

Una stringa di ID univoco che identifica questo evento e può essere utilizzata per la deduplicazione tra eventi acquisiti tramite l’API di conversione e il tracciamento di Pinterest. In caso contrario, è probabile che i dati dell’evento vengano conteggiati due volte e che venga segnalata l’inflazione metrica.

ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad

Event Properties

Oggetto JSON contenente le proprietà personalizzate dell’evento. Scegli se fornire JSON non elaborato o utilizzare un set semplificato di input chiave-valore.

{ "event_source_url": "http://site.com" }

Lelemento Pinterest Event Data evidenziato nellazione della regola.

È possibile configurare le seguenti proprietà di evento:

Nome campo

Descrizione

URL Source evento

URL dell’evento di conversione web.

ID archivio applicazioni

ID dell’app dell’app store.

Nome applicazione

Nome dell'applicazione.

Application Version

Versione dell’applicazione.

Marchio del dispositivo

Marchio del dispositivo utilizzato dall’utente.

Gestore dispositivo

Operatore mobile dell'utente per il proprio dispositivo.

Modello dispositivo

Modello del dispositivo dell’utente.

Device Type

Tipo di dispositivo utilizzato dall’utente.

Versione sistema operativo

Versione del sistema operativo del dispositivo.

Lingua utente

Codice del linguaggio ISO-639-1 a due caratteri che indica la lingua dell’utente.

User Data

I seguenti dati utente possono essere immessi da non sono campi obbligatori:

Nome campo

Descrizione

Esempio

Indirizzo e-mail utente o hash SHA256 dell’indirizzo e-mail utente.

ebd543592…f2b7e1

Mobile Adverstising IDs

Hash Sha256 degli ID Advertising di Google (GAID) o degli ID Apple per gli inserzionisti (IDFA) dell’utente

ebd543592…f2b7e1

Client IP Address

Indirizzo IP dell'utente, che può essere in formato IPv4 o IPv6. Utilizzato per la corrispondenza.

192.168.0.1

Client User Agent

Stringa dell’agente utente del browser web dell’utente.

Mozilla/5.0 (piattaforma; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion

Customer information data

Oggetto JSON contenente altre informazioni sul cliente. Scegli se fornire JSON non elaborato o utilizzare un set semplificato di input chiave-valore.

{ "ph": "122333445" }

Lelemento Pinterest User Data evidenziato nellazione della regola.

Le proprietà delle informazioni cliente che possono essere configurate sono:

Nome campo

Descrizione

Telefono

Numero di contatto utente. Sono accettate solo cifre che devono essere inserite con il prefisso del paese, l'indicativo di località e il numero.

Genere

Il genere può essere inserito come "f" per la femmina, "m" per il maschio o "n" per il non binario.

Data di nascita

Data di nascita, inserita come anno, mese e giorno.

Cognome

Cognome utente.

Nome

Nome dell'utente.

Città

Città di residenza dell'utente. Questo viene utilizzato principalmente a scopo di fatturazione.

Stato

Stato dell’utente, fornito come codice di due lettere in minuscolo.

Codice postale

zipcode dell’utente, utilizzato principalmente a scopo di fatturazione.

Paese

Codice paese ISO-3166 a due caratteri che indica il paese dell’utente.

ID esterno

ID univoco dell’inserzionista che identifica un utente nel suo spazio. Ad esempio, ID utente, ID fedeltà e così via.

ID clic

L’identificatore univoco memorizzato nel cookie _epik sul tuo dominio o il parametro di query &epik= nell’URL.

IMPORTANT

Prima di inviare i dati all'endpoint API Pinterest, l'estensione eseguirà l'hash e normalizzerà i valori dei campi seguenti: E-mail, Numero di telefono, Nome, Cognome, Genere, Data di nascita, Città, Stato, CAP, Paese e ID esterno. Se è già presente una stringa SHA256, l’estensione non eseguirà l’hashing del valore di questi campi.

Custom Data

Per la regola è possibile immettere i seguenti dati personalizzati:

Nome campo

Descrizione

Valuta

Il codice valuta ISO-4217. Se non viene specificato, Pinterest utilizzerà per impostazione predefinita la valuta dell'inserzionista impostata durante la creazione dell'account.

Valore

Valore totale dell’evento. Accettato come stringa nella richiesta. Questo verrà analizzato in una doppia cifra.

Stringa di ricerca

Stringa di ricerca correlata all'evento di conversione utente.

ID ordine

ID dell’ordine. L'invio di order_id aiuterà Pinterest a deduplicare gli eventi quando necessario.

Numero di prodotti

Numero totale di prodotti dell’evento. Ad esempio, il numero totale di articoli acquistati in un evento di pagamento.

ID contenuto

Elenco (array) di ID prodotti.

Sommario

Un elenco (array) di oggetti contenenti informazioni sui prodotti, ad esempio prezzo e quantità.

Lelemento Pinterest Custom Data evidenziato nellazione della regola.

Convalida dati in Pinterest

Una volta creata ed eseguita la regola di inoltro degli eventi, verificare se l'evento inviato all'API Pinterest viene visualizzato come previsto nell'interfaccia utente Pinterest.

Se la raccolta di eventi e l'integrazione di Experience Platform hanno avuto esito positivo, verranno visualizzati eventi nell'interfaccia utente di Pinterest.

Gestione eventi Pinterest

È possibile eseguire il drill-through e visualizzare la distribuzione dei dati dell'evento Pinterest.

Distribuzione dei dati Pinterest

Passaggi successivi

Questa guida illustra come installare e configurare l'estensione di inoltro degli eventi Pinterest nell'interfaccia utente. Per ulteriori informazioni, consulta la documentazione ufficiale:

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743