跳到內容
看看我們的新開發人員門戶並加入釺開發者社區!

用戶跟蹤

帖子

/用戶/跟蹤

核心端點

使用這個端點來記錄自定義事件、購買和更新用戶配置文件屬性。

看到我在郵遞員

速率限製

我們應用一個基地限速每分鍾50000個請求為所有客戶這個端點。manbetx万博全站客户端每個請求的/用戶/跟蹤端點可以包含多達75事件,75屬性更新,和75購買。每個組件(事件、屬性和購買數組),可以更新到75用戶最大的225個獨立的數據點。每次更新也可以屬於同一用戶的max 225更新單個用戶的請求。

請參閱我們的網頁API率限製詳情,聯係您的客戶經理成功如果你需要限製增加了。

請求體


            

             
              

               
1 2

               
內容類型:application / json授權:無記名YOUR-REST-API-KEY

              

             
            

            

             
              

               
1 2 3 4 5

               
{“屬性”:(可選,數組的屬性對象),“事件”:(可選,數組的事件對象),“購買”:(可選,數組的購買對象),}

manbetx万博全站客户端客戶使用服務器到服務器的API調用可能需要白名單rest.iad - 01. braze.com如果他們在防火牆後麵。

請求參數

參數 要求 數據類型 描述
屬性 可選 數組對象的屬性 看到用戶屬性對象
事件 可選 一係列的事件對象 看到事件對象
購買 可選 購買對象的數組 看到購買對象

使用時記住下麵的細微差別/用戶/跟蹤端點:

  • 當創建alias-only用戶通過這個端點,您必須顯式地設置_update_existing_only旗幟假。
  • 更新訂閱狀態與此端點都將更新用戶指定的external_id(如User1)和更新的訂閱狀態的任何用戶提供相同的電子郵件用戶(User1)。

事件跟蹤的示例請求主體


            

             
              

               
1 2 3 4 5 6 7 8 9

               
{“事件”:({“external_id”:“字符串”,“名稱”:“字符串”,“時間”:“字符串”}]}

示例請求


            

             
              

               
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17日18 19 20 21日22日23日24日25日26日27 28 29 30 31 32 33 34 35 36 37 38

               
curl——位置請求發布的https://rest.iad - 01. braze.com/users/track \——頭的application / json內容類型:\——頭的授權:無記名YOUR-API-KEY-HERE \ data-raw”{“屬性”:[{“external_id”:“user_identifier”、“string_attribute”:“水果”、“boolean_attribute_1”:真的,“integer_attribute”: 25歲的“array_attribute”:[“香蕉”、“蘋果”]}],“事件”:[{“external_id”:“user_identifier”、“app_id”:“app_identifier”、“名稱”:“watched_trailer”,“時間”:“2013 - 07 - 16 - t19:20:30 +一點”}],“購買”:[{“external_id”:“user_identifier”、“app_id”:“app_identifier”、“product_id”:“product_name”、“貨幣”:“美元”,“價格”:12.12,“數量”:6,“時間”:“2017 - 05 - 12 t18:47:12z”,“屬性”:{“integer_property”: 3,“string_property”:“拉塞爾”、“date_property”:“2014 - 02 - 02年t00:00:00z}}]}”

反應

當使用任何上述API請求時,您應該會收到一個以下三個一般的反應:

成功的消息

成功的消息會遇到以下響應:


            

             
              

               
1 2 3 4 5 6

               
{“消息”:“成功”,“attributes_processed”:(可選,整數),如果屬性是包括在的請求,這將返回一個整數的的數量的external_ids與屬性那是排隊來是加工過的,“events_processed”:(可選,整數),如果事件是包括在的請求,這將返回一個整數的的數量的事件那是排隊來是加工過的,“purchases_processed”:(可選,整數),如果購買是包括在的請求,這將返回一個整數的的數量的購買那是排隊來是加工過的,}

成功的與非致命錯誤消息

如果你的信息是成功的,但非致命錯誤,比如一個無效的事件對象的一長串的事件,那麼你將得到以下反應:


            

             
              

               
1 2 3 4 5 6 7 8

               
{“消息”:“成功”,“錯誤”:({<小錯誤消息>}]}

成功的消息,不受任何數據的一個錯誤錯誤數組仍將被處理。

與致命錯誤消息

如果你的消息都有一個致命的錯誤,你將獲得以下反應:


            

             
              

               
1 2 3 4 5 6 7 8

               
{“消息”:<致命錯誤消息>,“錯誤”:({<致命錯誤消息>}]}

致命錯誤響應代碼

以下狀態代碼和相關的請求將返回錯誤消息如果你遇到一個致命錯誤。下麵的錯誤代碼顯示沒有數據將被處理。

錯誤代碼 原因/原因
400錯誤請求 糟糕的語法。
401年未經授權 未知或失蹤的REST API鍵。
404沒有找到 未知的REST API鍵(如果提供)。
429速度有限 速率限製。
5 xx 內部服務器錯誤,你應該與指數倒扣重試。

如果你收到的錯誤“external_id列入黑名單,不允許提供”,你的要求可能包括一個“虛擬用戶”。有關更多信息,請參考垃圾郵件屏蔽。

用戶數據導入遺留

你可以提交數據通過釺API用戶尚未使用你的手機應用程序來生成一個用戶配置文件。如果用戶隨後使用應用程序的所有信息確認後通過SDK將合並現有的用戶配置文件創建通過API調用。任何用戶行為記錄匿名的SDK之前識別將丟失在合並與現有API-generated用戶配置文件。

分割工具將包括這些用戶無論他們與應用。如果你想排除用戶通過用戶上傳API尚未參與到應用程序,隻需添加過濾器:會話數> 0。

進行批量更新

如果你有一個用例需要進行批量更新用戶/跟蹤端點,我們建議添加批量更新標題,釺可以正確地識別、觀察,你的請求。

參考以下示例請求的X-Braze-Bulk標題:


            

             
              

               
1 2 3 4 5

               
curl——位置請求發布的https://rest.iad - 01. braze.com/users/track \——頭的application / json內容類型:\——頭的X-Braze-Bulk:真\——頭的授權:無記名YOUR-API-KEY-HERE \ data-raw”{“屬性”:[],“事件”:[],“購買”:[]}”

用例

考慮下麵的用例,你可以使用批量更新標題:

  • 每天工作,通過多個用戶的自定義屬性更新/用戶/跟蹤端點。
  • 一個特別的用戶數據回填腳本通過更新用戶信息/用戶/跟蹤端點。
編輯這個頁麵在GitHub上
這個頁麵是有用嗎?
新東西!
Baidu
map