DocumentazioneExperience PlatformTag

Estensione Pinterest per l’inoltro degli eventi

Last update: Tue Oct 31 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Developer

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 prerequisites

È 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 configuration-details

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 install

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

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 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 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 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.
{ "event_source_url": "http://site.com" }

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.
{ "ph": "122333445" }

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.
IMPORTANT
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:

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743