DokumentationExperience PlatformTaggar

Braze Track Events API-tillägg för händelsevidarebefordring

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Utvecklare

Braze är en plattform för kundengagemang som driver kundcentrerade interaktioner mellan konsumenter och varumärken i realtid. Med Braze kan du göra följande:

  • Leverera data (t.ex. marknadsföringsmeddelanden) till riktade användare baserat på deras språkinställningar, positionering med mera för att öka konverteringsgraden och stödja viktiga affärsmål.
  • Skicka personaliserade meddelanden till kunder i flera kanaler, inklusive e-post, push-meddelanden och meddelanden i appen, vid rätt tidpunkt och på de språk de föredrar.
  • Målgruppsanpassa användare för marknadsförings- och kampanjkampanjer för att öka antalet återkommande kunder.
  • Studera användarbeteenden och mönster för att inrikta er på specifika målgrupper med anpassade meddelanden, vilket kan öka intäkterna.

Med tillägget Braze Track Events API för vidarebefordran av händelser kan du utnyttja data som har samlats in i Adobe Experience Platform Edge Network och skicka dem till Braze i form av händelser på serversidan med API:t Braze User Track .

Det här dokumentet beskriver tilläggets användningsfall, hur du installerar det i biblioteken för vidarebefordran av händelser och hur du använder dess funktioner i en regel för vidarebefordran av händelser.

Användningsfall

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

Ta till exempel en detaljhandelsorganisation som har en flerkanalsnärvaro (webbplats och mobil) och som samlar in transaktionsdata eller konverteringsdata som händelsedata från sin webbplats och sina mobila plattformar. Dessa data skickas till Edge Network i realtid med olika tagg-regler. Härifrån skickar tillägget för Braze-händelsevidarebefordran automatiskt relevanta händelser till Braze från serversidan.

När data har skickats kan organisationens analysteam sedan utnyttja Braze’s-funktioner för att bearbeta datauppsättningarna och härleda affärsinsikter för att generera diagram, instrumentpaneler eller andra visualiseringar för att informera affärsintressenter. På sidan Braze kunder finns mer information om de olika användningsexemplen för plattformen.

Braze krav och skyddsräcken prerequisites

Du måste ha ett Braze-konto för att kunna använda dess tekniker. Om du inte har något konto går du till sidan Kom igång på Braze för att ansluta till Braze Sales och starta kontoskapandet.

API-skyddsräcken

Tillägget använder två av Brazes API:er och deras gränser beskrivs nedan:

API
Hastighetsgränser
User Track
50 000 förfrågningar per minut.
Mer information finns i User Track API-dokumentationen.
User Identify
20 000 förfrågningar per minut.
Mer information finns i User Identify API-dokumentationen.
NOTE
Mer information om begränsningar finns i guiden för Braze API-gränser.

Fakturerbara datapunkter

Om du skickar ytterligare anpassade attribut till Braze kan det öka datapunktskonsumtionen för Braze. Kontakta din Braze-kontohanterare innan du skickar ytterligare anpassade attribut. Mer information finns i Braze-dokumentationen om fakturerbara datapunkter.

Samla nödvändig konfigurationsinformation configuration-details

Följande indata krävs för att ansluta Edge Network till Braze:

Nyckeltyp
Beskrivning
Exempel
Braze-instans
REST-slutpunkten som är associerad med kontot Braze. Mer information finns i Braze-dokumentationen för instanser.
https://rest.iad-03.braze.com
API-nyckel
API-nyckeln Braze som är associerad med kontot Braze.
Mer information finns i Braze-dokumentationen för REST API-nyckeln.
YOUR-BRAZE-REST-API-KEY

Skapa en hemlighet

Skapa en ny händelsevidarebefordringshemlighet och ange värdet till din Braze API-nyckel. Detta används för att autentisera anslutningen till ditt konto samtidigt som värdet är säkert.

Installera och konfigurera tillägget Braze 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 Braze.

Installera tillägget Braze.

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

  • Braze Rest Endpoint URL: Du kan ange värdet för Braze rest-URL:en som oformaterad text i angivna indata.
  • API Key: Välj det hemliga dataelement som du skapade tidigare och som innehåller din Braze API-nyckel.

Välj Save när du är klar.

Konfigurationssidan för Braze-tillägget.

Skapa en Send Event-regel tracking-rule

När du har installerat tillägget skapar du en ny händelsevidarebefordring av regeln och konfigurerar villkoren efter behov. När du konfigurerar åtgärderna för regeln väljer du tillägget Braze och väljer sedan Send Event som åtgärdstyp.

Lägg till en åtgärdskonfiguration för händelsevidarebefordringsregel.

User Identification

Indata
Beskrivning
External User ID
Lång, slumpmässig och väl distribuerad UUID eller GUID. Om du väljer en annan metod för att namnge dina användar-ID:n måste de också vara långa, slumpmässiga och väl fördelade. Läs mer om föreslagen namnkonvention för användar-ID.
Braze User ID
Braze user identifier.
User Alias
Ett alias fungerar som en alternativ unik användaridentifierare. Använd alias för att identifiera användare med andra dimensioner än ditt huvudanvändar-ID.

Användaraliasobjektet består av två delar: ett alias_name för själva identifieraren och ett alias_label som anger aliastypen. Användare kan ha flera alias med olika etiketter, men bara ett alias_name per alias_label.
NOTE
Om du vill koppla händelsen till en användare måste du fylla i antingen fältet External User ID, fältet Braze User Identifier eller avsnittet User Alias.

Event Data

Indata
Beskrivning
Obligatoriskt
Event Name ​
Händelsens namn.
Ja
Event Time
Datum-tid som sträng i ISO 8601 eller i formatet yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Ja
App Identifier
Programidentifieraren eller app_id är en parameter som associerar aktivitet med en viss app i appgruppen. Det anger vilket program i appgruppen du interagerar med. Läs mer om API-identifierartyperna.
Event Properties ​
Ett JSON-objekt som innehåller anpassade egenskaper för händelsen.
NOTE
Åtgärden Braze Send Event kräver endast att Event Name och Event Time anges, men du bör inkludera så mycket information som möjligt i fältet för anpassade egenskaper. Mer information om händelseobjektet Braze finns i officiell dokumentation.

User Attributes

Användarattribut kan vara ett JSON-objekt som innehåller fält som skapar eller uppdaterar ett attribut med det angivna namnet och värdet för den angivna användarprofilen. Följande egenskaper stöds:

Användarattribut
Beskrivning
First Name
Last Name
Phone
Email
Gender
En av följande strängar: "M", "F", "O" (annan), "N" (ej tillämplig), "P" (använd inte).
City
Country
Land som en sträng i formatet ISO-3166-1 alpha-2 .
Language
Språk som en sträng i formatet ISO-639-1.
Date of Birth
Sträng i formatet "YYY-MM-DD" (t.ex. 1980-12-21).
Time Zone
Tidszonsnamn från IANA-tidszonsdatabas (t.ex. America/New_York eller Eastern Time (USA och Kanada)).
Facebook
Hash som innehåller något av id (sträng), gillar (strängmatris), num_ativ (heltal).
Twitter
Hash som innehåller något av id (heltal), screen_name (Twitter, handle), follow_count (heltal), kompis_count (heltal), statuses_count(heltal).

Skapa en Send Purchase Event-regel purchase-rule

När du har installerat tillägget skapar du en ny händelsevidarebefordring av regeln och konfigurerar villkoren efter behov. När du konfigurerar åtgärderna för regeln väljer du tillägget Braze och väljer sedan Send Purchase Event som åtgärdstyp.

Lägg till en händelsevidarebefordringsregel för Braze Purchase-åtgärdstyp.

User Identification

Indata
Beskrivning
External User ID
Lång, slumpmässig och väl distribuerad UUID eller GUID. Om du väljer en annan metod för att namnge dina användar-ID:n måste de också vara långa, slumpmässiga och väl fördelade. Läs mer om föreslagen namnkonvention för användar-ID.
Braze User ID
Braze user identifier.
User Alias
Ett alias fungerar som en alternativ unik användaridentifierare. Använd alias för att identifiera användare med andra dimensioner än ditt huvudanvändar-ID.

Användaraliasobjektet består av två delar: ett alias_name för själva identifieraren och ett alias_label som anger aliastypen. Användare kan ha flera alias med olika etiketter, men bara ett alias_name per alias_label.
NOTE
Om du vill länka händelsen till en användare måste du antingen fylla i fältet External User ID, fältet Braze User Identifier eller avsnittet User Alias.

Purchase Data

Indata
Beskrivning
Obligatoriskt
Product ID ​
Identifierare för inköpet. (t.ex. produktnamn eller produktkategori)
Ja
Purchase Time
Datum-tid som sträng i ISO 8601 eller i formatet yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Ja
Currency ​
Valuta som en sträng i formatet ISO 4217 Alfabetisk valutakod.
Ja
Price ​
Pris.
Ja
Quantity ​
Om inget anges blir standardvärdet 1. Det högsta värdet måste vara lägre än 100.
App Identifier
Programidentifieraren eller app_id är en parameter som associerar aktivitet med en viss app i appgruppen. Det anger vilket program i appgruppen du interagerar med. Läs mer om API-identifierartyperna.
Purchase Properties ​
Ett JSON-objekt som innehåller anpassade egenskaper för köpet.
NOTE
Åtgärden Braze Send Event kräver endast att Event Name och Event Time anges, men du bör ta med så mycket information som möjligt i fältet för anpassade egenskaper. Mer information om händelseobjektet Braze finns i officiell dokumentation.

User Attributes

Användarattribut kan vara ett JSON-objekt som innehåller fält som skapar eller uppdaterar ett attribut med det angivna namnet och värdet för den angivna användarprofilen. Följande egenskaper stöds:

Användarattribut
Beskrivning
First Name
Last Name
Phone
Email
Gender
En av följande strängar: "M", "F", "O" (annan), "N" (ej tillämplig), "P" (använd inte).
City
Country
Land som en sträng i formatet ISO-3166-1 alpha-2 .
Language
Språk som en sträng i formatet ISO-639-1.
Date of Birth
Sträng i formatet "YYY-MM-DD" (t.ex. 1980-12-21).
Time Zone
Tidszonsnamn från IANA-tidszonsdatabas (t.ex. America/New_York eller Eastern Time (USA och Kanada)).
Facebook
Hash som innehåller något av id (sträng), gillar (strängmatris), num_ativ (heltal).
Twitter
Hash som innehåller något av id (heltal), screen_name (Twitter, handle), follow_count (heltal), kompis_count (heltal), statuses_count(heltal).

Validera data i Braze validate

Om händelsesamlingen och integreringen av Adobe Experience Platform lyckades visas händelser i Braze-konsolen när användarprofilervisades. De nya händelsedata som skickas till Braze visas i avsnittet Purchases på en viss användares översiktsflik.

Nästa steg

I den här guiden beskrivs hur du skickar konverteringshändelser till Braze med hjälp av händelsevidarebefordran. Mer information om program längre fram i kedjan för händelsedata som skickas till Braze finns i officiell dokumentation.

Mer information om funktioner för att vidarebefordra händelser i Experience Platform finns i översikten över vidarebefordran av händelser.

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