DocumentazioneExperience PlatformTag

Estensione Braze Track Events API per l’inoltro degli eventi

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

Creato per:

  • Developer

Braze è una piattaforma di coinvolgimento dei clienti che potenzia in tempo reale le interazioni incentrate sul cliente tra consumatori e marchi. Utilizzo di Braze, è possibile effettuare le seguenti operazioni:

  • 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.

Il Braze Track Events API inoltro eventi consente di sfruttare i dati acquisiti in Adobe Experience Platform Edge Network e di inviarli a Braze sotto forma di eventi lato server che utilizzano Braze User Track API.

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

Casi d’uso

Utilizza questa estensione se desideri utilizzare i dati provenienti dalla rete Edge 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. Utilizzo di vari tag regole, questi dati vengono inviati alla rete Edge in tempo reale. Da qui, la Braze l'estensione di inoltro degli eventi invia automaticamente gli eventi rilevanti a Braze dal lato server.

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

Braze prerequisiti e protezioni prerequisites

È necessario disporre di Braze per utilizzare le sue tecnologie. Se non disponi di un account, accedi al Pagina Introduzione il Braze per connettersi a Braze Sales e avvia il processo di creazione dell’account.

Guardrail API

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

API
Limiti di velocità
User Track
50.000 richieste al minuto.
Consulta la sezione User Track Documentazione API per i dettagli.
User Identify
20.000 richieste al minuto.
Consulta la sezione User Identify Documentazione API per i dettagli.
NOTE
Consulta la guida su Braze Limiti API per maggiori dettagli sui limiti che impongono.

Punti dati fatturabili

Invio di attributi personalizzati aggiuntivi a Braze può aumentare il Braze consumo dei punti dati. Consulta con il tuo Braze account manager prima di inviare attributi personalizzati aggiuntivi. Consulta la sezione Braze documentazione su punti dati fatturabili per ulteriori informazioni.

Raccogliere i dettagli di configurazione richiesti configuration-details

Per collegare la rete Edge a Braze, sono necessari i seguenti input:

Tipo di chiave
Descrizione
Esempio
Braze Istanza
Endpoint REST associato a Braze account. Consulta la sezione Braze documentazione su istanze a titolo indicativo.
https://rest.iad-03.braze.com
Chiave API
Il Braze Chiave API associata al Braze account.
Consulta la sezione Braze documentazione sulla Chiave API REST a titolo indicativo.
YOUR-BRAZE-REST-API-KEY

Creare un segreto

Crea un nuovo segreto di inoltro eventi e imposta il valore su Braze Chiave API. Verrà utilizzato per autenticare la connessione al tuo account mantenendo protetto il valore.

Installare e configurare Braze estensione install

Per installare l'estensione: creare una proprietà di inoltro degli eventi oppure scegli una proprietà esistente da modificare.

Seleziona Estensioni nel menu di navigazione a sinistra. In Catalogo , seleziona Installa sulla scheda per Braze estensione.

Installare Braze estensione.

Nella schermata successiva, immettere quanto segue valori di configurazione che hai raccolto in precedenza da Braze:

  • URL endpoint materiale residuo brasato: puoi immettere il valore della Braze URL dell’endpoint rest come testo normale nell’input fornito.
  • Chiave API: seleziona la elemento dati segreto creato in precedenza, che contiene Braze Chiave API.

Al termine, seleziona Salva.

Il Braze pagina di configurazione dellestensione.

Creare un Send Event regola tracking-rule

Dopo aver installato l’estensione, crea un nuovo inoltro eventi regola e configurarne le condizioni come desiderato. Durante la configurazione delle azioni per la regola, seleziona la Braze , quindi seleziona Invia evento per il tipo di azione.

Aggiungi una configurazione dell’azione della regola di inoltro degli 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 su convenzione di denominazione ID utente consigliata.
ID utente Braze
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 una delle seguenti caselle: ID utente esterno o il Identificatore utente Braze o il Alias utente sezione.

Event Data (Dati evento)

Input
Descrizione
Obbligatorio
​ nome evento
Nome dell’evento.
Sì
Ora evento
Data-ora come stringa in ISO 8601 o in yyyy-MM-dd'T'HH:mm:ss:SSSZ formato.
Sì
Identificatore app
L’identificatore dell’app o app_id è un parametro che associa l’attività a una specifica app nel gruppo di app. Indica con quale app all’interno del gruppo di app stai interagendo. Ulteriori informazioni su Tipi di identificatori API.
​ proprietà evento
Oggetto JSON contenente le proprietà personalizzate dell’evento.
NOTE
Il Evento di invio brasatura l'azione richiede solo un Nome evento e Ora evento da specificare, ma è necessario includere quante più informazioni possibili nel campo delle proprietà personalizzate. Per ulteriori informazioni su Braze oggetto evento, fare riferimento al 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 ISO-3166-1 alfa-2 formato.
Lingua
Lingua come stringa in ISO-639-1 formato.
Data di nascita
Stringa in formato "AAAA-MM-GG" (ad esempio, 1980-12-21).
Fuso orario
Nome del fuso orario da Database del fuso orario IANA (ad esempio, 'America/New_York' o 'Ora orientale (Stati Uniti e 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).

Creare un Send Purchase Event regola purchase-rule

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

Aggiungi una configurazione dell’azione di inoltro degli eventi di tipo Azione acquisto brasato.

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 su convenzione di denominazione ID utente consigliata.
ID utente Braze
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 ID utente esterno campo, il Identificatore utente Braze o il Alias utente sezione.

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 ISO 8601 o in yyyy-MM-dd'T'HH:mm:ss:SSSZ formato.
Sì
​ valuta
Valuta come stringa in ISO 4217 Formato del codice valuta alfabetico.
Sì
​ del 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 una specifica app nel gruppo di app. Indica con quale app all’interno del gruppo di app stai interagendo. Ulteriori informazioni su Tipi di identificatori API.
​ Proprietà acquisto
Oggetto JSON contenente le proprietà personalizzate dell’acquisto.
NOTE
Il Evento di invio brasatura l'azione richiede solo un Nome evento e Ora evento da specificare, ma è necessario includere quante più informazioni possibili nel campo proprietà personalizzate. Per ulteriori informazioni su Braze oggetto evento, fare riferimento al 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 ISO-3166-1 alfa-2 formato.
Lingua
Lingua come stringa in ISO-639-1 formato.
Data di nascita
Stringa in formato "AAAA-MM-GG" (ad esempio, 1980-12-21).
Fuso orario
Nome del fuso orario da Database del fuso orario IANA (ad esempio, 'America/New_York' o 'Ora orientale (Stati Uniti e 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).

Convalidare i dati in Braze validate

Se la raccolta di eventi e Adobe Experience Platform integrazione riuscita, gli eventi all'interno del Braze console quando visualizzazione dei profili utente. In particolare, i nuovi dati evento inviati a Braze si riflette nel Purchases sezione di un utente particolare scheda panoramica.

Passaggi successivi

Questa guida illustra come inviare eventi di conversione a Braze utilizzando l’inoltro degli eventi. Per ulteriori dettagli sulle applicazioni a valle per i dati evento inviati a Braze, fare riferimento a documentazione ufficiale.

Per ulteriori informazioni sulle funzionalità di inoltro degli eventi in Experienci Platform, consulta panoramica sull’inoltro degli eventi.

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