DocumentazioneExperience PlatformTag

Estensione Pinterest per l’inoltro degli eventi

Last update: Tue Jul 16 2024 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 nell'Edge Network di Adobe Experience Platform 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 dell'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 l'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, seleziona Estensioni. Seleziona Installa sulla scheda per l'estensione Pinterest nella scheda Catalogo.

Catalogo che visualizza lestensione Pinterest con Installazione evidenziata.

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, seleziona Estensioni. Seleziona Configura nella scheda per l'estensione Pinterest nella scheda Installato**.

Estensione Pinterest visualizzata nella scheda Installa con Configura evidenziata.

Nella schermata successiva, inserisci l'ID account Ads e il Token di accesso di conversione che hai raccolto in precedenza nella sezione dettagli configurazione. Al termine, seleziona Salva.

La schermata Pinterest Configure evidenzia 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 Azioni, aggiungi una nuova azione e imposta l'estensione su Pinterest. Per inviare eventi di Edge Network a Pinterest, impostare Tipo azione su Invia evento.

Creazione della regola Pinterest Invia evento.

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

Dati evento

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

Nome campo
Descrizione
Esempio
Nome evento
Tipo dell’evento utente. Questo può essere qualsiasi tipo di evento, tuttavia, per sfruttare Pinterest Analytics si consiglia di utilizzare Pinterest codici evento
* checkout
* add_to_cart
* page_visit
* sign-up
* [Evento definito dall'utente]
Azione Source
L’origine che indica dove si è verificato l’evento di conversione.
* app_android
* app_ios
* web
* offline
Ora evento
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:
ID evento
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
Proprietà evento
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" }

I Pinterest Dati evento evidenziati 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.

Dati utente

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

Nome campo
Descrizione
Esempio
E-mail
Indirizzo e-mail utente o hash SHA256 dell’indirizzo e-mail utente.
ebd543592…f2b7e1
ID pubblicità dispositivi mobili
Hash Sha256 degli ID Advertising di Google (GAID) o degli ID Apple per gli inserzionisti (IDFA) dell’utente
ebd543592…f2b7e1
Indirizzo IP client
Indirizzo IP dell'utente, che può essere in formato IPv4 o IPv6. Utilizzato per la corrispondenza.
192.168.0.1
Agente utente client
Stringa dell’agente utente del browser web dell’utente.
Mozilla/5.0 (piattaforma; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion
Dati informazioni cliente
Oggetto JSON contenente altre informazioni sul cliente. Scegli se fornire JSON non elaborato o utilizzare un set semplificato di input chiave-valore.
{ "ph": "122333445" }

I Pinterest Dati utente evidenziati 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.

Dati Personalizzati

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à.

I Pinterest Dati personalizzati evidenziati 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