Twitter-tillägg för händelsevidarebefordring

Twitter är en onlinetjänst för sociala medier och sociala nätverk där användarna kan publicera och interagera med 280-teckenlånga meddelanden som kallas tweets. Användare kan interagera med Twitter via en webbläsare, mobil klientprogramvara eller programmatiskt via sina API:er

Med Twitter API:t för webbkonverteringarkan du utnyttja data som samlats in i Adobe Experience Platform Edge Network och skicka dem till Twitter. Det här dokumentet beskriver tilläggets användningsfall, hur det installeras och hur du integrerar dess funktioner i regler för vidarebefordran av händelser.

Twitter kräver OAuth 1.0 för autentisering med API:t Twitter Web Conversions.

Användningsfall

Det här tillägget bör användas om du vill använda data från Edge Network i Twitter för att utnyttja dess funktioner för kundanalys och målinriktning.

Ta till exempel ett marknadsföringsteam i en organisation. Teamet samlar in händelsedata om användarinteraktion från sin webbplats som händelsedata från sin webbplats och läser in dem till Twitter med det här tillägget för händelsevidarebefordran.

Marknads- och analysteam kan sedan utnyttja Twitter’s-funktioner för att utföra ytterligare analyser och inrikta sig på dessa användare för riktade annonskampanjer.

Mer information om användningsfall som är specifika för Twitter finns i dokumentationen för Twitter användningsfall.

Twitter krav och skyddsräcken prerequisites

Du måste ha ett giltigt Twitter-konto för att kunna använda det här tillägget. Gå till registreringssidan Twitter för att registrera dig och skapa ett konto om du inte redan har ett.

Du måste konfigurera ditt konto som ett Twitter-utvecklarkonto. Information om hur du registrerar dig som utvecklare finns i Twitter utvecklarkontot.

API-skyddsräcken guardrails

Webbkonverterings-API:t Twitter har en hastighetsgräns på 60 000 begäranden per 15 minuters intervall, där varje begäran tillåter 500 händelser.

Samla nödvändig konfigurationsinformation configuration-details

Följande indata krävs för att ansluta Experience Platform till Twitter:

Nyckeltyp
Beskrivning
Konsumentnyckel
​ Programmets API-nyckel för åtkomst till API:t Twitter. Mer information finns i Twitter-dokumentationen om api-nycklar och hemligheter.
Konsumenthemlighet
API-hemligheten ger din app åtkomst till API:t Twitter. Mer information finns i Twitter-dokumentationen om api-nycklar och hemligheter.
Tokenhemlighet
Den token-hemlighet som inte förfaller för din app, som används för autentisering till Twitter API via OAuth. Mer information finns i Twitter-dokumentationen om att hämta åtkomsttoken för användning.
Åtkomsttoken
Åtkomsttoken som inte förfaller för din app, som används för autentisering till API:t Twitter via OAuth. Mer information finns i Twitter-dokumentationen om att hämta åtkomsttoken för användning.
Pixel-ID
Pixeln Twitter är en webbplatstagg som implementeras på din webbplats för att spåra webbplatsåtgärder eller konverteringar. Mer information finns i Twitter-dokumentationen om konverteringsspårning för webbplatser.

Installera och konfigurera tillägget Twitter install

Om du vill installera tillägget skapar du en egenskap för vidarebefordring av händelser eller väljer en befintlig egenskap att redigera i stället.

Välj Extensions i den vänstra navigeringen. På fliken Catalog väljer du Install på kortet för tillägget Twitter.

Katalog som visar installationen av tillägget Twitter.

IMPORTANT
Beroende på implementeringsbehoven kan du behöva skapa ett schema, dataelement och en datauppsättning innan du konfigurerar tillägget. Granska alla konfigurationssteg innan du startar för att avgöra vilka enheter du måste konfigurera för ditt användningsfall.

På nästa skärm anger du följande konfigurationsvärden som du tidigare har hämtat från Twitter:

  • Pixel Id
  • Consumer Key
  • Consumer Secret
  • Token
  • Token Secret

När du är klar väljer du Save.

Twitter konfigurationsskärm för tillägget Twitter.

Konfigurera en regel för vidarebefordran av händelser config-rule

När alla dataelement har konfigurerats kan du börja skapa regler för vidarebefordran av händelser som avgör när och hur händelser skickas till Twitter.

Skapa en ny regel i egenskapen för vidarebefordran av händelser. Under Actions lägger du till en ny åtgärd och anger tillägget till Twitter. Om du vill skicka Edge Network-händelser till Twitter anger du Action Type till Send Web Conversion.

Efter markeringen visas ytterligare kontroller för att ytterligare konfigurera händelsen. Du måste mappa händelseegenskaperna Twitter till dataelementen som du tidigare har skapat. Mer information finns i Twitter API:t för webbkonvertering.

Twitter skapar en konverteringshändelseregel.

User Identification

Fältnamn
Beskrivning
Exempel
Obligatoriskt
Twitter Click ID
Twitter Klicka på ID som tolkat från klicknings-URL:en.
26l6412g5p4iyj65a2oic2ayg2
Krävs om ingen annan identifierare läggs till.
Email
En e-postadress hashas med SHA256. Texten måste skrivas med gemener och alla efterföljande eller inledande blanksteg måste tas bort innan hash-kodning.
eventforwarding@example.com
Krävs om ingen annan identifierare läggs till.
Phone
Telefonen fungerar som en identifierare som matchar konverteringshändelsen. Telefonnumret måste vara i E164-format [+][landskod][riktnummer][local phone number] innan hashning utförs.
+911234567875
Krävs om ingen annan identifierare läggs till.

Conversion Data

Fältnamn
Beskrivning
Exempel
Obligatoriskt
Conversion Time
Datum-tid som sträng i ISO 8601 eller i formatet yyyy-MM-dd'T'HH:mm:ss:SSSZ.
2022-02-18T01:14:00.603Z
Ja
Event Id
ID:t för bas-36 för en specifik händelse. Detta ID ska matcha en förkonfigurerad händelse i ditt Twitter-annonskonto. Detta kallas ID för motsvarande händelse i Händelsehanteraren.
o87ne eller tw-o8z6j-o87ne (tw-pixel_id-event-id)
Ja
Number of Items
Antalet artiklar som köpts i händelsen. Detta måste vara ett positivt tal större än 0.
4
Nej
Currency
Valutan för de artiklar som köps in i händelsen. Detta uttrycks i ISO-4217 och om det inte anges kommer standardvärdet att vara USD.
USD
Nej
Value
Prisvärdet för artiklar som köpts i händelsen.
100,00
Nej
Conversion ID
En identifierare för en konverteringshändelse som kan användas för borttagning av dubbletter mellan API-konverteringar för webb-pixlar och konvertering i samma händelsetagg.
23294827
Nej
Description
En beskrivning med eventuell ytterligare information om konverteringarna.
Testkonvertering
Nej

Validera data i Twitter

När regeln för vidarebefordran av händelser har skapats och körts kontrollerar du om händelsen som skickades till Twitter-API:t visas som förväntat i Twitter-gränssnittet.

Om händelsesamlingen och integreringen av Experience Platform lyckades, kommer du att se händelser i Twitter Events manager.

Händelsehanteraren Twitter

Nästa steg

I den här guiden beskrivs hur du skickar konverteringshändelser till Twitter med hjälp av händelsevidarebefordran. Mer information om dessa underliggande tekniker finns i den officiella dokumentationen:

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