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

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

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

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

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

使用案例

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

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

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

Braze 必要條件和護欄

您必須擁有 Braze 以使用其技術。 如果您沒有帳戶,請瀏覽至 開始使用頁面 於 Braze 以連線到 Braze Sales 並啟動帳戶建立程式。

API護欄

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

API 速率限制
User Track 每分鐘50,000個請求。
請參閱 User Track API檔案 以取得詳細資訊。
User Identify 每分鐘20,000個要求。
請參閱 User Identify API檔案 以取得詳細資訊。
注意

請參閱以下指南: Braze API限制 以取得有關其限制的其他詳細資料。

可記帳資料點

傳送其他自訂屬性至 Braze 可能會增加 Braze 資料點使用量。 請諮詢您的 Braze 帳戶管理員,然後再傳送其他自訂屬性。 請參閱 Braze 檔案: 可記帳資料點 以取得詳細資訊。

收集必要的設定詳細資料

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

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

建立密碼

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

安裝並設定 Braze 擴充功能

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

選取 擴充功能 左側導覽列中。 在 目錄 索引標籤,選取 安裝 在的卡片上 Braze 副檔名。

安裝 Braze 副檔名。

在下一個畫面中,輸入下列內容 設定值 您先前收集的 Braze:

  • Braze Rest端點URL:您可以輸入 Braze 在提供的輸入中將端點URL重設為純文字。
  • API金鑰:選取 秘密資料元素 您先前建立的檔案,其中包含 Braze api金鑰。

選取 儲存 完成後。

此 Braze 擴充功能組態頁面。

建立 Send Event 規則

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

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

使用者識別

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

使用者別名物件由兩部分組成:識別碼本身的alias_name,以及指示別名型別的alias_label。 使用者可以有多個具有不同標籤的別名,但每個alias_label只能有一個別名_name。
注意

若要將事件連結至使用者,您必須填寫 外部使用者ID 欄位,或 Braze使用者識別碼 欄位或 使用者別名 區段。

事件資料

輸入 說明 必填
活動名稱 ​ 事件名稱。
事件時間 ​ 日期時間為ISO 8601或中的字串 yyyy-MM-dd'T'HH:mm:ss:SSSZ 格式。
應用程式識別碼 應用程式識別碼或 app_id 是將活動與應用程式群組中特定應用程式建立關聯的引數。 它會指定您正在與應用程式群組互動的應用程式。 進一步瞭解 API識別碼型別.
事件屬​性 包含事件的自訂屬性的JSON物件。
注意

Braze傳送事件 動作只需要一個 事件名稱事件時間 ,但您應在自訂屬性欄位中儘可能加入更多資訊。 如需詳細資訊,請參閱 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 規則

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

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

使用者識別

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

使用者別名物件由兩部分組成:識別碼本身的alias_name,以及指示別名型別的alias_label。 使用者可以有多個具有不同標籤的別名,但每個alias_label只能有一個別名_name。
注意

若要將事件連結至使用者,您必須完成 外部使用者ID 欄位, Braze使用者識別碼 欄位,或 使用者別名 區段。

購買資料

輸入 說明 必填
產品 ID ​ 購買的識別碼。 (例如產品名稱或產品類別)
購買時間 ​ 日期時間為ISO 8601或中的字串 yyyy-MM-dd'T'HH:mm:ss:SSSZ 格式。
貨幣 ​ 貨幣作為字串,位於 ISO 4217 字母貨幣代碼格式。
價格 ​ 價格.
數量 ​ 若未提供,預設值將為1。 最大值必須小於100。
應用程式識別碼 應用程式識別碼或 app_id 是將活動與應用程式群組中特定應用程式建立關聯的引數。 它會指定您正在與應用程式群組互動的應用程式。 進一步瞭解 API識別碼型別.
購買屬​性 包含購買的自訂屬性的JSON物件。
注意

Braze傳送事件 動作只需要一個 事件名稱事件時間 ,但您應儘可能在自訂屬性欄位中包含更多資訊。 如需詳細資訊,請參閱 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

如果事件集合和 Adobe Experience Platform 整合成功,您將會在 Braze 主控台時間 檢視使用者設定檔. 具體而言,新事件資料傳送至 Braze 反映在 Purchases 特定使用者的部分 概覽標籤.

後續步驟

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

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

本頁內容