DocumentatieExperience PlatformTags

Braze Track Events API extensie voor doorsturen van gebeurtenissen

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

Gemaakt voor:

  • Ontwikkelaar

Braze is een platform van de klantenovereenkomst dat klant-gerichte interactie tussen consumenten en merken in real time drijft. Gebruiken Brazekunt u het volgende doen:

  • Gegevens (zoals marketingberichten) leveren aan doelgebruikers op basis van hun taalvoorkeur, voorkeur voor locaties en meer, om de conversietarieven te verhogen en belangrijke bedrijfsdoelstellingen te ondersteunen.
  • Verzend klanten gepersonaliseerde berichten over veelvoudige kanalen, met inbegrip van e-mail, dupberichten, en in-app berichten, op enkel de juiste tijd en in hun aangewezen talen.
  • Doelspecifieke gebruikers voor marketing- en promotiecampagnes om het aantal herhaalde klanten te vergroten.
  • Het gebruikersgedrag en de patronen van de studie om specifieke doelgroepen met aangepaste berichten te richten, die zouden kunnen helpen opbrengst verhogen.

De Braze Track Events API gebeurtenis doorsturen kunt u gegevens die zijn vastgelegd in het Adobe Experience Platform Edge Network gebruiken en verzenden naar Braze in de vorm van server-side-gebeurtenissen die de Braze User Track API.

Dit document behandelt de gebruiksgevallen van de uitbreiding, hoe te om het in uw gebeurtenis te installeren die bibliotheken door:sturen, en hoe te om zijn mogelijkheden in een gebeurtenis aan te wenden die door:sturen regel.

Gebruiksscenario’s

Deze extensie moet worden gebruikt als u gegevens van het Edge-netwerk wilt gebruiken in Braze om voordeel te halen uit zijn klantenanalyses en gerichte mogelijkheden.

Neem bijvoorbeeld een detailhandelsorganisatie die een multikanaalaanwezigheid (website en mobiel) heeft en die transactie- of gespreksinvoer vastlegt als gebeurtenisgegevens van hun website en mobiele platforms. Diverse gebruiken tag regels, worden deze gegevens verzonden naar het Netwerk van de Rand in echt - tijd. Van hier, Braze gebeurtenis die uitbreiding door:sturen verzendt automatisch relevante gebeurtenissen naar Braze aan de serverzijde.

Zodra de gegevens zijn verzonden, kunnen de analyseteams van de organisatie vervolgens gebruikmaken van Braze’s mogelijkheden om de datasets te verwerken en bedrijfsinzichten af te leiden om grafieken, dashboards, of andere visualisaties te produceren om bedrijfsbelanghebbenden te informeren. Zie de Braze klanten pagina voor meer informatie over de verschillende gebruiksgevallen van het platform.

Braze voorwaarden en waarborgen prerequisites

U moet een Braze rekening te houden met haar technologieën. Als u geen account hebt, navigeert u naar de Aan de slag-pagina op Braze verbinding maken met Braze Sales en start het accountaanmaakproces.

API-handleidingen

De extensie gebruikt twee van BrazeAPI's en hun beperkingen worden hieronder beschreven:

API
Snelheidslimieten
User Track
50.000 verzoeken per minuut.
Zie de User Track API-documentatie voor meer informatie.
User Identify
20.000 verzoeken per minuut.
Zie de User Identify API-documentatie voor meer informatie.
NOTE
Raadpleeg de handleiding op Braze API-limieten voor nadere bijzonderheden over de beperkingen die zij opleggen .

Billable data points

Extra aangepaste kenmerken verzenden naar Braze kan uw Braze verbruik van gegevenspunten. Raadpleeg uw Braze accountmanager voordat aanvullende aangepaste kenmerken worden verzonden. Zie de Braze documentatie over factureerbare gegevenspunten voor meer informatie .

Verzamel vereiste configuratiedetails configuration-details

Als u het Edge-netwerk wilt verbinden met Braze, zijn de volgende invoeren vereist:

Type toets
Beschrijving
Voorbeeld
Braze Instantie
Het REST-eindpunt is gekoppeld aan het Braze account. Zie de Braze documentatie over instances ter begeleiding.
https://rest.iad-03.braze.com
API-sleutel
De Braze API-sleutel gekoppeld aan de Braze account.
Zie de Braze documentatie over de REST API-sleutel ter begeleiding.
YOUR-BRAZE-REST-API-KEY

Een geheim maken

Een nieuwe gebeurtenis die geheim door:sturen en stel de waarde in op uw Braze API-sleutel. Dit wordt gebruikt om de verbinding met uw account te verifiëren en de waarde veilig te houden.

Installeer en configureer de Braze extension install

Als u de extensie wilt installeren, een eigenschap voor het doorsturen van gebeurtenissen maken of kies een bestaande eigenschap die u wilt bewerken.

Selecteren Extensions in de linkernavigatie. In de Catalog tab, selecteert u Install op de kaart voor de Braze extensie.

Installeer de Braze extensie.

Voer in het volgende scherm het volgende in configuratiewaarden dat u eerder hebt verzameld van Braze:

  • Braze Rest Endpoint URL: U kunt de waarde van uw Braze rest eindpunt URL als gewone tekst in de verstrekte input.
  • API Key: Selecteer de element met geheime gegevens die u eerder hebt gemaakt en die uw Braze API-sleutel.

Selecteren Save wanneer gereed.

De Braze extensieconfiguratiepagina

Een Send Event regel tracking-rule

Na het installeren van de uitbreiding, creeer een nieuwe gebeurtenis door:sturen regel en configureer de voorwaarden naar wens. Wanneer het vormen van de acties voor de regel, selecteer Braze extensie selecteert u vervolgens Send Event voor het actietype.

Voeg een gebeurtenis toe die de configuratie van de regelactie door:sturen.

User Identification

Invoer
Beschrijving
External User ID
Lang, willekeurig en goed verdeeld UUID of GUID. Als u een andere methode kiest om uw gebruikers-id's een naam te geven, moeten deze ook lang, willekeurig en goed gedistribueerd zijn. Meer informatie over voorgestelde naamgevingsconventie voor gebruikersnaam.
Braze User ID
Gebruikersidentificatie 'Braze'.
User Alias
Een alias fungeert als alternatieve unieke gebruikersnaam. Gebruik aliassen om gebruikers met verschillende afmetingen te identificeren dan de gebruikers-id die u als hoofdgebruiker gebruikt.

Het alias-object van de gebruiker bestaat uit twee delen: een alias_name voor de id zelf en een alias_label die het type alias aangeven. Gebruikers kunnen meerdere aliassen met verschillende labels hebben, maar slechts één alias_naam per alias_label.
NOTE
Als u de gebeurtenis aan een gebruiker wilt koppelen, moet u een van beide opties invullen External User ID of de Braze User Identifier van de User Alias sectie.

Event Data

Invoer
Beschrijving
Vereist
Event Name ​
Naam van de gebeurtenis.
Ja
Event Time
Datum/tijd als tekenreeks in ISO 8601 of in yyyy-MM-dd'T'HH:mm:ss:SSSZ gebruiken.
Ja
App Identifier
De toepassings-id of app_id is een parameter die activiteit associeert met een specifieke app in uw toepassingsgroep. Hiermee wordt aangegeven met welke app in de toepassingsgroep u werkt. Meer informatie over de Typen API-id.
Event Properties ​
Een JSON-object dat aangepaste eigenschappen van de gebeurtenis bevat.
NOTE
De Braze Send Event actie vereist slechts Event Name en Event Time op te geven, maar u moet zoveel mogelijk informatie opnemen in het veld met aangepaste eigenschappen. Voor meer informatie over de Braze gebeurtenisobject, verwijzen naar de officiële documentatie.

User Attributes

Gebruikerskenmerken kunnen een JSON-object zijn dat velden bevat waarmee een kenmerk met de opgegeven naam en waarde in het opgegeven gebruikersprofiel wordt gemaakt of bijgewerkt. De volgende eigenschappen worden ondersteund:

Gebruikerskenmerk
Beschrijving
First Name
Last Name
Phone
Email
Gender
Een van de volgende tekenreeksen: "M", "F", "O" (overige), "N" (niet van toepassing), "P" (niet van toepassing).
City
Country
Land als tekenreeks in ISO-3166-1 alpha-2 gebruiken.
Language
Taal als tekenreeks in ISO-639-1 gebruiken.
Date of Birth
Tekenreeks in de notatie "YYYY-MM-DD" (bijvoorbeeld 1980-12-21).
Time Zone
Naam tijdzone van IANA Time Zone Database (bijvoorbeeld 'America/New_York' of 'Eastern Time (VS en Canada)').
Facebook
Hash met id (string), like (array of strings), num_friends (integer).
Twitter
Hash met id (integer), screen_name (string, Twitter handle), followers_count (integer), friends_count (integer), statuses_count(integer).

Een Send Purchase Event regel purchase-rule

Na het installeren van de uitbreiding, creeer een nieuwe gebeurtenis door:sturen regel en configureer de voorwaarden naar wens. Wanneer het vormen van de acties voor de regel, selecteer Braze extensie selecteert u vervolgens Send Purchase Event voor het actietype.

Voeg een de actietype gebeurtenis toe van het handelingstype van de Aankoop van de Stem door:sturen van de actieconfiguratie van de regelactie.

User Identification

Invoer
Beschrijving
External User ID
Lang, willekeurig en goed verdeeld UUID of GUID. Als u een andere methode kiest om uw gebruikers-id's een naam te geven, moeten deze ook lang, willekeurig en goed gedistribueerd zijn. Meer informatie over voorgestelde naamgevingsconventie voor gebruikersnaam.
Braze User ID
Gebruikersidentificatie 'Braze'.
User Alias
Een alias fungeert als alternatieve unieke gebruikersnaam. Gebruik aliassen om gebruikers met verschillende afmetingen te identificeren dan de gebruikers-id die u als hoofdgebruiker gebruikt.

Het alias-object van de gebruiker bestaat uit twee delen: een alias_name voor de id zelf en een alias_label die het type alias aangeven. Gebruikers kunnen meerdere aliassen met verschillende labels hebben, maar slechts één alias_naam per alias_label.
NOTE
Als u de gebeurtenis aan een gebruiker wilt koppelen, moet u het dialoogvenster External User ID in het veld Braze User Identifier of de User Alias sectie.

Purchase Data

Invoer
Beschrijving
Vereist
Product ID ​
Identificatiecode voor de aankoop. (bv. productnaam of productcategorie)
Ja
Purchase Time
Datum/tijd als tekenreeks in ISO 8601 of in yyyy-MM-dd'T'HH:mm:ss:SSSZ gebruiken.
Ja
Currency ​
Valuta als tekenreeks in ISO 4217 Alfabetische notatie valutacode.
Ja
Price ​
Prijs.
Ja
Quantity ​
Indien niet opgegeven, is de standaardwaarde 1. De maximumwaarde moet lager zijn dan 100.
App Identifier
De toepassings-id of app_id is een parameter die activiteit associeert met een specifieke app in uw toepassingsgroep. Hiermee wordt aangegeven met welke app in de toepassingsgroep u werkt. Meer informatie over de Typen API-id.
Purchase Properties ​
Een JSON-object dat aangepaste eigenschappen van de aankoop bevat.
NOTE
De Braze Send Event actie vereist slechts Event Name en Event Time op te geven, maar u moet zoveel mogelijk informatie opnemen in het veld met aangepaste eigenschappen. Voor meer informatie over de Braze gebeurtenisobject, verwijzen naar de officiële documentatie.

User Attributes

Gebruikerskenmerken kunnen een JSON-object zijn dat velden bevat waarmee een kenmerk met de opgegeven naam en waarde in het opgegeven gebruikersprofiel wordt gemaakt of bijgewerkt. De volgende eigenschappen worden ondersteund:

Gebruikerskenmerk
Beschrijving
First Name
Last Name
Phone
Email
Gender
Een van de volgende tekenreeksen: "M", "F", "O" (overige), "N" (niet van toepassing), "P" (niet van toepassing).
City
Country
Land als tekenreeks in ISO-3166-1 alpha-2 gebruiken.
Language
Taal als tekenreeks in ISO-639-1 gebruiken.
Date of Birth
Tekenreeks in de notatie "YYYY-MM-DD" (bijvoorbeeld 1980-12-21).
Time Zone
Naam tijdzone van IANA Time Zone Database (bijvoorbeeld 'America/New_York' of 'Eastern Time (VS en Canada)').
Facebook
Hash met id (string), like (array of strings), num_friends (integer).
Twitter
Hash met id (integer), screen_name (string, Twitter handle), followers_count (integer), friends_count (integer), statuses_count(integer).

Gegevens valideren binnen Braze validate

Als de gebeurtenisinzameling en Adobe Experience Platform de integratie is voltooid, u ziet de gebeurtenissen in het Braze console wanneer gebruikersprofielen weergeven. De nieuwe gebeurtenisgegevens die worden verzonden naar Braze wordt weerspiegeld in de Purchases van een bepaalde gebruiker overzicht, tabblad.

Volgende stappen

In deze handleiding wordt beschreven hoe conversiegebeurtenissen naar Braze het gebruiken van gebeurtenis door:sturen. Voor meer informatie over downstreamtoepassingen voor gebeurtenisgegevens die worden verzonden naar Braze, verwijst u naar de officiële documentatie.

Voor meer informatie over gebeurtenis die mogelijkheden in Experience Platform door:sturen, verwijs naar overzicht van gebeurtenissen doorsturen.

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