Estensione Twitter per l’inoltro degli eventi

Twitter è un servizio di social media e social network online, in cui gli utenti pubblicano e interagiscono con messaggi di 280 caratteri, noti come tweet. Gli utenti possono interagire con il Twitter utilizzando un browser, un software front-end per dispositivi mobili o a livello di programmazione tramite le relative API

L'estensione inoltro eventi dell'API per le conversioni Web di Twitter consente di sfruttare i dati acquisiti nell'Edge Network di Adobe Experience Platform e di inviarli a Twitter. Questo documento descrive i casi di utilizzo dell'estensione, come installarla e come integrarne le funzionalità nell'inoltro degli eventi rules.

Twitter richiede OAuth 1.0 per l'autenticazione con l'API Twitter Web Conversions.

Casi d’uso

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

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

I team di marketing e analisi possono quindi sfruttare le funzionalità di Twitter’s per eseguire ulteriori analisi e indirizzare questi utenti a campagne pubblicitarie mirate.

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

Twitter prerequisiti e guardrail prerequisites

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

È necessario impostare l'account come account sviluppatore Twitter. Per informazioni su come registrarsi come sviluppatore, fare riferimento all'account Twitter sviluppatore.

Guardrail API guardrails

L'API per le conversioni web di Twitter ha un limite di velocità di 60.000 richieste per intervallo di 15 minuti, dove ogni richiesta consente 500 eventi.

Raccogliere i dettagli di configurazione richiesti configuration-details

Per connettere l'Experience Platform a Twitter, sono necessari i seguenti input:

Tipo di chiave
Descrizione
Chiave consumer
​ La chiave API dell'app per accedere all'API Twitter. Consulta la documentazione di Twitter su chiavi e segreti API.
Segreto consumer
Il segreto API consente all'app di accedere all'API Twitter. Consulta la documentazione di Twitter su chiavi e segreti API.
Segreto token
Il segreto del token senza scadenza dell'app, utilizzato per l'autenticazione nell'API Twitter tramite OAuth. Consulta la documentazione di Twitter su come ottenere i token di accesso all'uso.
Token di accesso
Token di accesso dell'app senza scadenza, utilizzato per l'autenticazione nell'API Twitter tramite OAuth. Consulta la documentazione di Twitter su come ottenere i token di accesso all'uso.
ID pixel
Twitter Pixel è un tag del sito Web implementato nel sito Web per tenere traccia delle azioni o delle conversioni del sito. Consulta la documentazione di Twitter sul monitoraggio delle conversioni per i siti Web.

Installa e configura l'estensione Twitter install

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

Seleziona Estensioni nel menu di navigazione a sinistra. Nella scheda Catalogo, seleziona Installa sulla scheda per l'estensione Twitter.

Catalogo che mostra lestensione Twitter che evidenzia linstallazione.

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.

Nella schermata successiva, immettere i valori di configurazione raccolti in precedenza da Twitter:

  • ID pixel
  • Chiave consumer
  • Segreto consumer
  • Token
  • Segreto token

Al termine, selezionare Salva.

Schermata di configurazione Twitter per lestensione Twitter.

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

Crea una nuova regola nella proprietà di inoltro eventi. In Azioni, aggiungi una nuova azione e imposta l'estensione su Twitter. Per inviare eventi Edge Network a Twitter, impostare Tipo azione su Invia conversione Web.

Dopo la selezione, vengono visualizzati controlli aggiuntivi per configurare ulteriormente l’evento. È necessario mappare le proprietà evento Twitter agli elementi dati creati in precedenza. Per ulteriori informazioni, vedere Twitter API per conversioni Web.

Twitter creazione di una regola evento di conversione.

Identificazione utente

Nome campo
Descrizione
Esempio
Obbligatorio
Twitter ID clic
Twitter ID clic analizzato dall'URL di click-through.
26l6412g5p4iyj65a2oic2
Obbligatorio se non viene aggiunto alcun altro identificatore.
E-mail
Indirizzo e-mail con hash SHA256. Il testo deve essere in minuscolo ed eventuali spazi finali o iniziali devono essere rimossi prima dell’hashing.
eventforwarding@example.com
Obbligatorio se non viene aggiunto alcun altro identificatore.
Telefono
Il telefono funge da identificatore per corrispondere all’evento di conversione. Il numero di telefono deve essere nel formato E164 [+][prefisso paese][prefisso][local phone number] prima dell'hashing.
+911234567875
Obbligatorio se non viene aggiunto alcun altro identificatore.

Dati conversione

Nome campo
Descrizione
Esempio
Obbligatorio
Tempo di conversione
Data-ora come stringa in formato ISO 8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ.
2022-02-18T01:14:00.603Z
ID evento
ID base 36 di un evento specifico. Questo ID deve corrispondere a un evento preconfigurato contenuto nel tuo account annuncio Twitter. Questo è noto come ID dell’evento corrispondente in Gestione eventi.
o87ne o tw-o8z6j-o87ne (tw-pixel_id-event-id)
Numero di elementi
Il numero di articoli acquistati nell'evento. Deve essere un numero positivo maggiore di 0.
4
No
Valuta
Valuta degli articoli acquistati nell'evento. Questo è espresso in ISO-4217 e se non viene fornito, il valore predefinito sarà USD.
USD
No
Valore
Valore di prezzo degli articoli acquistati nell'evento.
100,00
No
ID conversione
Identificatore di un evento di conversione che può essere utilizzato per la deduplicazione tra conversioni di Web Pixel e Conversion API nello stesso tag evento.
23294827
No
Descrizione
Una descrizione con eventuali informazioni aggiuntive sulle conversioni.
Test conversione
No

Convalida dati in Twitter

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

Se la raccolta di eventi e l'integrazione di Experience Platform hanno avuto esito positivo, verranno visualizzati eventi all'interno del Twitter Gestione eventi.

Gestione eventi Twitter

Passaggi successivi

Questa guida illustra come inviare eventi di conversione a Twitter tramite l'inoltro di eventi. Per ulteriori informazioni su queste tecnologie di base, consulta la documentazione ufficiale:

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