Braze Track Events API 事件轉送擴充功能

Braze是客戶參與平台,可即時促進消費者與品牌之間以客戶為中心的互動。 使用Braze,您可以執行下列動作:

  • 根據使用者的語言偏好設定、位置偏好設定等,將資料(例如行銷訊息)傳遞給目標使用者,以提高轉換率並支援關鍵業務目標。
  • 在適當的時間以客戶偏好的語言跨多個管道傳送客戶個人化訊息,包括電子郵件、推播通知和應用程式內訊息。
  • 針對行銷和促銷活動的特定使用者,以增加常客的數量。
  • 研究使用者行為和模式,以自訂訊息鎖定特定對象,這可能有助於增加收入。

Braze Track Events API 事件轉送擴充功能可讓您運用Adobe Experience PlatformEdge Network中擷取的資料,並使用Braze User Track API以伺服器端事件的形式傳送給Braze。

本文說明擴充功能的使用案例、如何在您的事件轉送程式庫中安裝擴充功能,以及如何在事件轉送規則中運用其功能。

使用案例

如果您想要使用Braze中Edge Network的資料,以利用其客戶分析和目標定位功能,應使用此擴充功能。

例如,假設某個零售組織擁有多頻道實體(網站和行動裝置),且正在從其網站和行動平台擷取交易式或對話式輸入作為事件資料。 使用各種標籤規則,此資料會即時傳送至Edge Network。 從這裡,Braze事件轉送擴充功能會自動從伺服器端傳送相關事件至Braze。

傳送資料後,組織的分析團隊就可以運用Braze’s功能來處理資料集,並取得業務分析來產生圖表、儀表板或其他視覺效果,以通知業務利害關係人。 請參閱Braze 客戶頁面,以取得平台各種使用案例的詳細資訊。

Braze先決條件和護欄 prerequisites

您必須擁有Braze帳戶才能使用其技術。 如果您沒有帳戶,請瀏覽至Braze上的開始使用頁面以連線至Braze Sales並開始建立帳戶。

API護欄

擴充功能使用Braze的兩個API,其限制概述如下:

API
速率限制
User Track
每分鐘50,000個請求。
如需詳細資訊,請參閱User Track API檔案
User Identify
每分鐘20,000個請求。
如需詳細資訊,請參閱User Identify API檔案
NOTE
請參閱Braze API限制的指南,瞭解這些限制所強加的詳細資訊。

可記帳資料點

傳送其他自訂屬性至Braze可能會增加您的Braze資料點使用量。 請先洽詢您的Braze帳戶管理員,再傳送其他自訂屬性。 如需詳細資訊,請參閱有關可計費資料點的Braze檔案。

收集必要的設定詳細資料 configuration-details

若要將Edge Network連線到Braze,需要下列輸入:

金鑰型別
說明
範例
Braze執行個體
與Braze帳戶關聯的REST端點。 如需指引,請參閱執行個體上的Braze檔案。
https://rest.iad-03.braze.com
API金鑰
與Braze帳戶關聯的Braze API金鑰。
如需指引,請參閱REST API金鑰上的Braze檔案。
YOUR-BRAZE-REST-API-KEY

建立密碼

建立新的事件轉送密碼,並將值設定為您的Braze API金鑰。 這將用於驗證與您的帳戶的連線,同時保持值的安全。

安裝並設定Braze擴充功能 install

若要安裝擴充功能,請建立事件轉送屬性,或選擇現有的屬性來編輯。

在左側導覽中選取​ 擴充功能。 在​ 目錄 ​標籤中,選取Braze擴充功能的卡片上的​ 安裝

安裝Braze延伸模組。

在下一個畫面中,輸入您先前從Braze收集的下列組態值

  • Braze Rest端點URL:您可以在提供的輸入中,以純文字形式輸入Braze Rest端點URL的值。
  • API金鑰:選取您先前建立的機密資料元素,其中包含您的Braze API金鑰。

完成時選取​ 儲存

擴充功能組態頁面Braze。

建立Send Event規則 tracking-rule

安裝擴充功能後,請建立新的事件轉送規則,並視需要設定其條件。 設定規則的動作時,請選取​ Braze ​擴充功能,然後選取​ 傳送事件 ​作為動作型別。

新增事件轉送規則動作設定。

使用者識別

輸入
說明
外部使用者ID
長、隨機且分佈良好的UUID或GUID。 如果您選擇其他方法來為您的使用者ID命名,那麼這些ID也必須是長的、隨機的、分佈良好的。 深入瞭解建議的使用者ID命名慣例
硬碟使用者ID
釺焊使用者識別碼。
使用者別名
別名可作為替代的不重複使用者識別碼。 使用別名來識別與核心使用者ID不同維度的使用者。

使用者別名物件由兩部分組成:識別碼本身的alias_name,以及指示別名型別的alias_label。 使用者可以有多個具有不同標籤的別名,但每個alias_label只能有一個別名_名稱。
NOTE
若要將事件繫結至使用者,您必須填入外部使用者ID欄位、硬碟使用者識別碼欄位或使用者別名區段。

事件資料

輸入
說明
必填
事件名稱{​1}
事件的名稱。
事件時間
以ISO 8601或yyyy-MM-dd'T'HH:mm:ss:SSSZ格式作為字串的日期時間。
應用程式識別碼
應用程式識別碼或 app_id 是將活動與應用程式群組中特定應用程式相關聯的引數。 它會指定您正在與應用程式群組互動的應用程式。 深入瞭解API識別碼型別
事件屬性​
包含事件自訂屬性的JSON物件。
NOTE
Braze Send Event ​動作僅需要指定​ 事件名稱 ​和​ 事件時間,但您應在自訂屬性欄位中儘可能加入更多資訊。 如需Braze事件物件的詳細資訊,請參閱正式檔案

使用者屬性

使用者屬性可以是JSON物件,其中包含將使用指定使用者設定檔上提供的名稱和值來建立或更新屬性的欄位。 支援下列屬性:

使用者屬性
說明
名字
姓氏
電話
電子郵件
性別
下列其中一個字串:「M」、「F」、「O」(其他)、「N」(不適用)、「P」(不想說)。
城市
國家/地區
國家/地區以ISO-3166-1 alpha-2格式作為字串。
語言
ISO-639-1格式的字串語言。
出生日期
「YYYY-MM-DD」格式的字串(例如,1980-12-21)。
時區
來自IANA時區資料庫的時區名稱(例如,「美洲/紐約」或「東部時間(美國和加拿大)」)。
Facebook
雜湊包含任何ID (字串)、like (字串陣列)、num_friends (整數)。
Twitter
雜湊包含下列專案的任一id (整數)、screen_name (字串、Twitter控制代碼)、followers_count (整數)、friends_count (整數)、statuses_count (整數)。

建立Send Purchase Event規則 purchase-rule

安裝擴充功能後,請建立新的事件轉送規則,並視需要設定其條件。 設定規則的動作時,請選取​ Braze ​擴充功能,然後為動作型別選取​ 傳送購買事件

新增Braze Purchase動作型別事件轉寄規則動作設定。

使用者識別

輸入
說明
外部使用者ID
長、隨機且分佈良好的UUID或GUID。 如果您選擇其他方法來為您的使用者ID命名,那麼這些ID也必須是長的、隨機的、分佈良好的。 深入瞭解建議的使用者ID命名慣例
硬碟使用者ID
釺焊使用者識別碼。
使用者別名
別名可作為替代的不重複使用者識別碼。 使用別名來識別與核心使用者ID不同維度的使用者。

使用者別名物件由兩部分組成:識別碼本身的alias_name,以及指示別名型別的alias_label。 使用者可以有多個具有不同標籤的別名,但每個alias_label只能有一個別名_名稱。
NOTE
若要將事件連結到使用者,您必須完成外部使用者ID欄位、硬碟使用者識別碼欄位或使用者別名區段。

購買資料

輸入
說明
必填
產品識別碼{​1}
購買的識別碼。 (例如產品名稱或產品類別)
購買時間
以ISO 8601或yyyy-MM-dd'T'HH:mm:ss:SSSZ格式作為字串的日期時間。
貨幣{​1}
ISO 4217英文字母貨幣代碼格式的字串貨幣。
價​格
價格。
數​量
若未提供,預設值將為1。 最大值必須小於100。
應用程式識別碼
應用程式識別碼或 app_id 是將活動與應用程式群組中特定應用程式相關聯的引數。 它會指定您正在與應用程式群組互動的應用程式。 深入瞭解API識別碼型別
購買屬性​
包含購買的自訂屬性的JSON物件。
NOTE
Braze Send Event ​動作只需要指定​ 事件名稱 ​和​ 事件時間,但您應在自訂屬性欄位中儘可能加入更多資訊。 如需Braze事件物件的詳細資訊,請參閱正式檔案

使用者屬性

使用者屬性可以是JSON物件,其中包含將使用指定使用者設定檔上提供的名稱和值來建立或更新屬性的欄位。 支援下列屬性:

使用者屬性
說明
名字
姓氏
電話
電子郵件
性別
下列其中一個字串:「M」、「F」、「O」(其他)、「N」(不適用)、「P」(不想說)。
城市
國家/地區
國家/地區以ISO-3166-1 alpha-2格式作為字串。
語言
ISO-639-1格式的字串語言。
出生日期
「YYYY-MM-DD」格式的字串(例如,1980-12-21)。
時區
來自IANA時區資料庫的時區名稱(例如,「美洲/紐約」或「東部時間(美國和加拿大)」)。
Facebook
雜湊包含任何ID (字串)、like (字串陣列)、num_friends (整數)。
Twitter
雜湊包含下列專案的任一id (整數)、screen_name (字串、Twitter控制代碼)、followers_count (整數)、friends_count (整數)、statuses_count (整數)。

驗證Braze中的資料 validate

如果事件集合和Adobe Experience Platform整合成功,您會在檢視使用者設定檔時,在Braze主控台中看到事件。 具體來說,傳送至Braze的新事件資料會反映在特定使用者的概觀標籤的Purchases區段中。

後續步驟

本指南說明如何使用事件轉送將轉換事件傳送至Braze。 有關傳送至Braze之事件資料的下游應用程式的詳細資訊,請參閱正式檔案

如需Experience Platform中事件轉送功能的詳細資訊,請參閱事件轉送概觀

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