DokumentationExperience PlatformTaggar

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

Last update: Thu Dec 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Skapat för:

  • Developer

Braze är en plattform för kundengagemang som driver kundcentrerad interaktion mellan konsumenter och varumärken i realtid. Använda Brazekan 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.

The Braze Track Events API händelsevidarebefordran kan du utnyttja data som samlats in i Adobe Experience Platform Edge Network och skicka dem till Braze i form av händelser på serversidan med Braze User Track API.

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

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 dra nytta av kundanalys och målgruppsfunktioner.

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. Använda olika tag skickas dessa data till Edge Network i realtid. Härifrån kommer Braze tillägg för händelsevidarebefordring skickar automatiskt relevanta händelser till Braze från serversidan.

När data har skickats kan organisationens analysteam sedan utnyttja dem Braze’s funktioner för att bearbeta datauppsättningar och få affärsinsikter för att generera diagram, instrumentpaneler eller andra visualiseringar som kan informera affärsintressenter. Se Braze kunder sida för mer information om olika användningsexempel för plattformen.

Braze krav och skyddsräcken prerequisites

Du måste ha en Braze för att kunna använda sina 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 börja skapa konto.

API-skyddsräcken

Tillägget använder två av BrazeAPI:er och deras begränsningar beskrivs nedan:

API
Hastighetsgränser
User Track
50 000 förfrågningar per minut.
Se User Track API-dokumentation för mer information.
User Identify
20 000 förfrågningar per minut.
Se User Identify API-dokumentation för mer information.
NOTE
Se guiden på Braze API-begränsningar för närmare uppgifter om de begränsningar som de fastställer.

Fakturerbara datapunkter

Skicka ytterligare anpassade attribut till Braze kan öka din Braze datapunktskonsumtion. Kontakta Braze kontohanteraren innan ytterligare anpassade attribut skickas. Se Braze dokumentation om fakturerbara datapunkter för mer information.

Samla nödvändig konfigurationsinformation configuration-details

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

Nyckeltyp
Beskrivning
Exempel
Braze Instance
REST-slutpunkten som är associerad med Braze konto. Se Braze dokumentation om instanser för vägledning.
https://rest.iad-03.braze.com
API-nyckel
The Braze API-nyckel som är associerad med Braze konto.
Se Braze dokumentation om REST API-nyckel för vägledning.
YOUR-BRAZE-REST-API-KEY

Skapa en hemlighet

Skapa ett nytt hemlighet för vidarebefordran av händelser och ange värdet Braze API-nyckel. Detta används för att autentisera anslutningen till ditt konto samtidigt som värdet är säkert.

Installera och konfigurera Braze extension install

Installera tillägget genom att skapa en egenskap för vidarebefordring av händelser eller välj en befintlig egenskap att redigera i stället.

Välj Extensions i den vänstra navigeringen. I Catalog flik, välja Install på kortet för Braze tillägg.

Installera Braze tillägg.

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

  • Braze Rest Endpoint URL: Du kan ange värdet för Braze rest endpoint URL as plain text in the provided input.
  • API Key: Välj hemligt dataelement som du skapade tidigare, som innehåller Braze API-nyckel.

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

The Braze konfigurationssida för tillägg.

Skapa en Send Event regel tracking-rule

Skapa en ny händelsevidarebefordring efter installationen regel och konfigurera villkoren efter behov. När du konfigurerar åtgärderna för regeln väljer du Braze tillägg, välj Send Event för åtgärdstypen.

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 en 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 External User ID eller Braze User Identifier fält eller User Alias -avsnitt.

Event Data

Indata
Beskrivning
Obligatoriskt
Event Name ​
Händelsens namn.
Ja
Event Time
Datum-tid som sträng i ISO 8601 eller i yyyy-MM-dd'T'HH:mm:ss:SSSZ format.
Ja
App Identifier
Programidentifieraren eller app_id är en parameter som associerar aktivitet med ett specifikt program i appgruppen. Det anger vilket program i appgruppen du interagerar med. Läs mer om API-identifierartyper.
Event Properties ​
Ett JSON-objekt som innehåller anpassade egenskaper för händelsen.
NOTE
The Braze Send Event funktionsmakrot kräver bara en Event Name och Event Time ska anges, men du bör inkludera så mycket information som möjligt i fältet för anpassade egenskaper. Mer information om Braze händelseobjekt, se 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 ISO-3166-1 alpha-2 format.
Language
Språk som sträng i ISO-639-1 format.
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 & 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

Skapa en ny händelsevidarebefordring efter installationen regel och konfigurera villkoren efter behov. När du konfigurerar åtgärderna för regeln väljer du Braze tillägg, välj Send Purchase Event för åtgärdstypen.

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

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 en 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 slutföra External User ID fält, Braze User Identifier eller User Alias -avsnitt.

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 yyyy-MM-dd'T'HH:mm:ss:SSSZ format.
Ja
Currency ​
Valuta som en sträng i ISO 4217 Alfabetiskt valutakodformat.
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 ett specifikt program i appgruppen. Det anger vilket program i appgruppen du interagerar med. Läs mer om API-identifierartyper.
Purchase Properties ​
Ett JSON-objekt som innehåller anpassade egenskaper för köpet.
NOTE
The Braze Send Event funktionsmakrot kräver bara en Event Name och Event Time ska anges, men du bör inkludera så mycket information som möjligt i fältet för anpassade egenskaper. Mer information om Braze händelseobjekt, se 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 ISO-3166-1 alpha-2 format.
Language
Språk som sträng i ISO-639-1 format.
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 & 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 Adobe Experience Platform integreringen lyckades, du kommer att se händelser i Braze konsol när visa användarprofiler. De nya händelsedata som skickas till Braze återspeglas i Purchases del av en viss användares fliken Översikt.

Nästa steg

I den här guiden beskrivs hur du skickar konverteringshändelser till Braze med händelsevidarebefordran. Mer information om efterföljande program för händelsedata som skickas till Braze, se officiell dokumentation.

Mer information om funktioner för att vidarebefordra händelser i Experience Platform finns i händelsevidarebefordring - översikt.

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