Estensione Pinterest per l’inoltro degli eventi

Pinterest è un motore di scoperta visiva per trovare idee come ricette, arredamento, ispirazione di stile e altro ancora. Ci sono miliardi di pin Pinterest, che può anche essere condiviso con altri su Pinterest. Puoi fascicolare gli eventi di interazione dell’utente e sfruttare Pinterest Analytics per comprendere il comportamento degli utenti ed eseguire annunci mirati.

Il Pinterest Conversioni API inoltro eventi consente di sfruttare i dati acquisiti in Adobe Experience Platform Edge Network e di inviarli a Pinterest. Questo documento descrive i casi di utilizzo dell’estensione, come installarla e come integrarne le funzionalità nell’inoltro degli eventi regole.

I token di accesso per le conversioni sono il metodo di autenticazione utilizzato da Pinterest quando si interagisce con Pinterest API.

Casi d’uso

Utilizza questa estensione se desideri utilizzare i dati provenienti dalla rete Edge in Pinterest per sfruttare le funzionalità di analisi del cliente.

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

I team di marketing e analisi possono quindi sfruttare Pinterest Funzionalità di Analytics 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 per Pinterest, fare riferimento a Pinterest casi d’uso documentazione.

Pinterest prerequisiti

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

Avrai anche bisogno di un Pinterest account sviluppatore, che dovrà essere associato al tuo Pinterest account aziendale. Per associare l'account sviluppatore all'account aziendale, fare riferimento a Pinterest ​ account sviluppatore.

Raccogliere i dettagli di configurazione richiesti

Per collegare l’Experience Platform a Pinterest, sono necessari i seguenti input:

Credenziali Descrizione Esempio
ID account annunci Il tuo Pinterest Aggiunge l'ID account. Consulta la sezione Pinterest documentazione a titolo indicativo. 123456789012
Token di accesso alla conversione Il tuo Pinterest Token di accesso alla conversione. Consulta la sezione Pinterest API di conversione documento di orientamento.
Questa operazione sarà necessaria solo una volta, poiché il token non scade.

Installare e configurare Pinterest estensione

Per installare l'estensione: creare una proprietà di inoltro degli eventi oppure scegli una proprietà esistente da modificare.

Nel menu di navigazione a sinistra, seleziona Estensioni. Seleziona Installa sulla scheda per Pinterest estensione in Catalogo scheda.

Catalogo che visualizza il Pinterest estensione con Installa evidenziato.

Configura l'estensione Pinterest

IMPORTANTE

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 sulla scheda per Pinterest estensione in Installatoscheda **.

Pinterest mostrato nella Installa scheda con Configura evidenziato.

Nella schermata successiva, immettere ID account annunci e Token di accesso alla conversione che hai raccolto in precedenza in dettagli di configurazione sezione. Al termine, seleziona Salva.

Il Pinterest Configura schermata che evidenzia ID account annunci e Token di accesso alla conversione campi di input.

Configurare una regola di inoltro degli eventi

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 un nuovo regola nella proprietà di inoltro degli eventi. Sotto Azioni, aggiungi una nuova azione e imposta l'estensione su Pinterest. Per inviare eventi di rete Edge a Pinterest, imposta Tipo di azione a Invia evento.

Il Pinterest Invia evento creazione di regole.

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

Event Data (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 * pagamento
* add_to_cart
* page_visit
* iscrizione
* [Evento definito dall'utente]
Origine azione 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, consulta Pinterest API. 1433188255.500 indica 1433188255 secondi e 500 millisecondi dopo l’epoca, oppure lunedì 1 giugno 2015, alle ore 7:50:55 PM GMT.
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.

Il Pinterest Dati evento evidenziato nell’azione regola.

È possibile configurare le seguenti proprietà di evento:

Nome campo Descrizione
URL origine 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 Mobile Advertising Hash Sha256 degli "ID pubblicitari Google" (GAID) o degli "ID pubblicitari Apple" (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 informativi del cliente Oggetto JSON contenente altre informazioni sul cliente. Scegli se fornire JSON non elaborato o utilizzare un set semplificato di input chiave-valore.

Il Pinterest Dati utente evidenziato nell’azione 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.
IMPORTANTE

Prima di inviare i dati a Pinterest Endpoint API, l’estensione eseguirà l’hash e normalizzerà i valori dei seguenti campi: 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 verrà impostata automaticamente sulla 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. Invio order_id aiuterà Pinterest 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à.

Il Pinterest Dati personalizzati evidenziato nell’azione regola.

Convalidare i dati in Pinterest

Una volta creata ed eseguita la regola di inoltro degli eventi, verifica se l’evento inviato a Pinterest L’API viene visualizzata come previsto in Pinterest UI.

Se la raccolta di eventi e Experience Platform integrazione riuscita, gli eventi all'interno del Pinterest UI.

Il Pinterest gestione eventi

È possibile eseguire un ulteriore drill-through e visualizzare Pinterest distribuzione dei dati evento.

Il Pinterest distribuzione dei dati

Passaggi successivi

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

In questa pagina