DocumentazioneExperience PlatformTag

Estensione Braze Track Events API per l’inoltro degli eventi

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

Creato per:

  • Sviluppatore

Braze è una piattaforma di customer engagement che potenzia in tempo reale le interazioni incentrate sul cliente tra consumatori e marchi. Utilizzando Braze, è possibile:

  • Consegna di dati (come messaggi di marketing) a utenti mirati in base alle loro preferenze linguistiche, di posizione e altro ancora, per aumentare i tassi di conversione e supportare obiettivi aziendali chiave.
  • Invia ai clienti messaggi personalizzati su più canali, tra cui e-mail, notifiche push e messaggi in-app, al momento giusto e nelle lingue preferite.
  • Puoi indirizzare l’attività a specifici utenti per campagne di marketing e promozionali per aumentare il numero di clienti frequenti.
  • Studiare il comportamento e i modelli degli utenti per indirizzare tipi di pubblico specifici con messaggi personalizzati, che potrebbero contribuire ad aumentare i ricavi.

L'estensione Braze Track Events API inoltro eventi consente di sfruttare i dati acquisiti nell'Edge Network di Adobe Experience Platform e di inviarli a Braze sotto forma di eventi lato server utilizzando l'API Braze User Track.

Questo documento descrive i casi di utilizzo dell'estensione, come installarla nelle librerie di inoltro degli eventi e come utilizzarne le funzionalità in una regola di inoltro degli eventi.

Casi d’uso

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

Ad esempio, considera un’organizzazione di vendita al dettaglio con una presenza multicanale (sito web e mobile) e che acquisisce input transazionali o conversazionali come dati evento dal proprio sito web e dalle piattaforme mobili. Utilizzando varie regole di tag, questi dati vengono inviati all'Edge Network in tempo reale. Da qui, l'estensione di inoltro eventi Braze invia automaticamente eventi rilevanti a Braze dal lato server.

Una volta inviati i dati, i team di analisi dell'organizzazione possono quindi sfruttare le funzionalità di Braze’s per elaborare i set di dati e ricavare informazioni aziendali utili per generare grafici, dashboard o altre visualizzazioni per informare le parti interessate. Per ulteriori dettagli sui vari casi d'uso della piattaforma, consulta la pagina Braze clienti.

Braze prerequisiti e guardrail prerequisites

Per utilizzare le tecnologie è necessario disporre di un account Braze. Se non si dispone di un account, passare alla pagina Introduzione in Braze per connettersi a Braze Sales e avviare il processo di creazione dell'account.

Guardrail API

L'estensione utilizza due delle API di Braze e i relativi limiti sono descritti di seguito:

API
Limiti di velocità
User Track
50.000 richieste al minuto.
Per ulteriori informazioni, consulta la User Track documentazione API.
User Identify
20.000 richieste al minuto.
Per ulteriori informazioni, consulta la User Identify documentazione API.
NOTE
Per ulteriori dettagli sui limiti imposti, consulta la guida sui Braze limiti API.

Punti dati fatturabili

L'invio di attributi personalizzati aggiuntivi a Braze può aumentare il consumo di punti dati di Braze. Rivolgiti al tuo account manager Braze prima di inviare attributi personalizzati aggiuntivi. Per ulteriori informazioni, consulta la documentazione di Braze su punti dati fatturabili.

Raccogliere i dettagli di configurazione richiesti configuration-details

Per connettere l'Edge Network a Braze, sono necessari i seguenti input:

Tipo di chiave
Descrizione
Esempio
Istanza Braze
Endpoint REST associato all'account Braze. Consulta la documentazione di Braze su istanze.
https://rest.iad-03.braze.com
Chiave API
La chiave API Braze associata all'account Braze.
Per ulteriori informazioni, consulta la documentazione di Braze nella chiave REST API.
YOUR-BRAZE-REST-API-KEY

Creare un segreto

Crea un nuovo segreto per l'inoltro degli eventi e imposta il valore sulla tua Braze chiave API. Verrà utilizzato per autenticare la connessione al tuo account mantenendo protetto il valore.

Installa e configura l'estensione Braze 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 Braze.

Installa lestensione Braze.

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

  • URL endpoint REST Braze: è possibile immettere il valore dell'URL dell'endpoint rest Braze come testo normale nell'input fornito.
  • Chiave API: seleziona l'elemento dati segreto creato in precedenza, che contiene la tua chiave API Braze.

Al termine, seleziona Salva.

Pagina di configurazione dellestensione Braze.

Crea una regola Send Event tracking-rule

Dopo aver installato l'estensione, crea una nuova regola di inoltro eventi e configurane le condizioni come desiderato. Durante la configurazione delle azioni per la regola, seleziona l'estensione Braze, quindi seleziona Invia evento per il tipo di azione.

Aggiungi una configurazione dellazione della regola di inoltro eventi.

Identificazione utente

Input
Descrizione
ID utente esterno
UUID o GUID lungo, casuale e ben distribuito. Se scegli un metodo diverso per denominare gli ID utente, questi devono anche essere lunghi, casuali e ben distribuiti. Ulteriori informazioni sulla convenzione di denominazione ID utente suggerita.
Braze ID utente
Braze dell’identificatore utente.
Alias utente
Un alias funge da identificatore utente univoco alternativo. Utilizza gli alias per identificare gli utenti in base a dimensioni diverse rispetto all’ID utente core.

L'oggetto alias utente è costituito da due parti: un alias_name per l'identificatore stesso e un alias_label che indica il tipo di alias. Gli utenti possono avere più alias con etichette diverse, ma un solo nome_alias per etichetta_alias.
NOTE
Per associare l'evento a un utente è necessario compilare il campo ID utente esterno, il campo Braze User Identifier o la sezione Alias utente.

Dati evento

Input
Descrizione
Obbligatorio
Nome evento ​
Nome dell’evento.
Sì
Ora evento
Data-ora come stringa in formato ISO 8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Sì
Identificatore app
L'identificatore dell'app o app_id è un parametro che associa l'attività a un'app specifica nel gruppo di app. Indica con quale app all’interno del gruppo di app stai interagendo. Ulteriori informazioni sui tipi di identificatore API.
Proprietà evento ​
Oggetto JSON contenente le proprietà personalizzate dell’evento.
NOTE
L'azione Invia Braze evento richiede solo un Nome evento e una Ora evento da specificare, ma è necessario includere il maggior numero possibile di informazioni nel campo delle proprietà personalizzate. Per informazioni dettagliate sull'oggetto evento Braze, consulta la documentazione ufficiale.

Attributi utente

Gli attributi utente possono essere un oggetto JSON contenente campi che creeranno o aggiorneranno un attributo con il nome e il valore forniti nel profilo utente specificato. Sono supportate le seguenti proprietà:

Attributo utente
Descrizione
Nome
Cognome
Telefono
E-mail
Genere
Una delle seguenti stringhe: "M", "F", "O" (altro), "N" (non applicabile), "P" (preferibilmente non dire).
Città
Paese
Paese come stringa in formato ISO-3166-1 alpha-2.
Lingua
Lingua come stringa in formato ISO-639-1.
Data di nascita
Stringa in formato "AAAA-MM-GG" (ad esempio, 1980-12-21).
Fuso orario
Nome del fuso orario da IANA Time Zone Database (ad esempio, 'America/New_York' o 'Eastern Time (US & Canada)').
Facebook
Hash contenente uno qualsiasi di id (stringa), mi piace (matrice di stringhe), num_amici (numero intero).
Twitter
Hash contenente uno qualsiasi di id (integer), screen_name (stringa, handle di Twitter), followers_count (integer), friends_count (integer), statuses_count(integer).

Crea una regola Send Purchase Event purchase-rule

Dopo aver installato l'estensione, crea una nuova regola di inoltro eventi e configurane le condizioni come desiderato. Durante la configurazione delle azioni per la regola, seleziona l'estensione Braze, quindi seleziona Invia evento di acquisto per il tipo di azione.

Aggiungi una configurazione dellazione della regola di inoltro eventi di tipo Azione acquisto Braze.

Identificazione utente

Input
Descrizione
ID utente esterno
UUID o GUID lungo, casuale e ben distribuito. Se scegli un metodo diverso per denominare gli ID utente, questi devono anche essere lunghi, casuali e ben distribuiti. Ulteriori informazioni sulla convenzione di denominazione ID utente suggerita.
Braze ID utente
Braze dell’identificatore utente.
Alias utente
Un alias funge da identificatore utente univoco alternativo. Utilizza gli alias per identificare gli utenti in base a dimensioni diverse rispetto all’ID utente core.

L'oggetto alias utente è costituito da due parti: un alias_name per l'identificatore stesso e un alias_label che indica il tipo di alias. Gli utenti possono avere più alias con etichette diverse, ma un solo nome_alias per etichetta_alias.
NOTE
Per collegare l'evento a un utente, è necessario completare il campo ID utente esterno, il campo ID utente Braze o la sezione Alias utente.

Dati di acquisto

Input
Descrizione
Obbligatorio
ID prodotto ​
Identificatore per l’acquisto. (ad esempio, nome del prodotto o categoria del prodotto)
Sì
Tempo di acquisto
Data-ora come stringa in formato ISO 8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ.
Sì
Valuta ​
Valuta come stringa in formato ISO 4217 Codice valuta alfabetico.
Sì
Prezzo ​
Prezzo.
Sì
Quantità ​
Se non viene specificato, il valore predefinito sarà 1. Il valore massimo deve essere inferiore a 100.
Identificatore app
L'identificatore dell'app o app_id è un parametro che associa l'attività a un'app specifica nel gruppo di app. Indica con quale app all’interno del gruppo di app stai interagendo. Ulteriori informazioni sui tipi di identificatore API.
Proprietà acquisto ​
Oggetto JSON contenente le proprietà personalizzate dell’acquisto.
NOTE
L'azione Invia Braze evento richiede solo un Nome evento e una Ora evento da specificare, ma è necessario includere il maggior numero possibile di informazioni nel campo delle proprietà personalizzate. Per informazioni dettagliate sull'oggetto evento Braze, consulta la documentazione ufficiale.

Attributi utente

Gli attributi utente possono essere un oggetto JSON contenente campi che creeranno o aggiorneranno un attributo con il nome e il valore forniti nel profilo utente specificato. Sono supportate le seguenti proprietà:

Attributo utente
Descrizione
Nome
Cognome
Telefono
E-mail
Genere
Una delle seguenti stringhe: "M", "F", "O" (altro), "N" (non applicabile), "P" (preferibilmente non dire).
Città
Paese
Paese come stringa in formato ISO-3166-1 alpha-2.
Lingua
Lingua come stringa in formato ISO-639-1.
Data di nascita
Stringa in formato "AAAA-MM-GG" (ad esempio, 1980-12-21).
Fuso orario
Nome del fuso orario da IANA Time Zone Database (ad esempio, 'America/New_York' o 'Eastern Time (US & Canada)').
Facebook
Hash contenente uno qualsiasi di id (stringa), mi piace (matrice di stringhe), num_amici (numero intero).
Twitter
Hash contenente uno qualsiasi di id (integer), screen_name (stringa, handle di Twitter), followers_count (integer), friends_count (integer), statuses_count(integer).

Convalida dati in Braze validate

Se la raccolta di eventi e l'integrazione di Adobe Experience Platform sono state completate correttamente, gli eventi verranno visualizzati nella console Braze durante la visualizzazione dei profili utente. Nello specifico, i nuovi dati evento inviati a Braze si riflettono nella sezione Purchases della scheda panoramica di un utente specifico.

Passaggi successivi

Questa guida illustra come inviare eventi di conversione a Braze tramite l'inoltro di eventi. Per ulteriori dettagli sulle applicazioni downstream per i dati evento inviati a Braze, consulta la documentazione ufficiale.

Per ulteriori informazioni sulle funzionalità di inoltro degli eventi in Experience Platform, consulta la panoramica sull'inoltro degli eventi.

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