事件對象
本文解釋了不同組件的一個事件對象,如何使用這個對象,從例子。
事件對象是什麼?
一個事件對象是一個對象,可以通過API發生特定事件時。事件對象被安置在一個事件數組。事件數組中的每一個事件對象代表一個定製事件的發生特定用戶在指定的時間價值。事件對象有許多不同的字段允許您自定義的設置和使用事件屬性信息,數據收集、和個性化。
你可以查看如何設置自定義事件為一個特定的平台通過閱讀平台集成指南中開發人員指南。住在你可以找到這些信息跟蹤自定義事件頁麵下分析選項卡的各種平台。我們已經聯係了給你。
跟蹤定製事件的文章:
對象的身體
1 2 3 4 5 6 7 8 9 10 11 12 13 14
{/ /一個的“external_id”或“user_alias”或“braze_id”是要求“external_id”:(可選,字符串),外部用戶ID,“user_alias”:(可選,用戶別名對象),用戶別名對象,“braze_id”:(可選,字符串)釺用戶標識符,“app_id”:(可選,字符串)看到應用程序標識符,“名稱”:(需要,字符串)的的名字的的事件,“時間”:(需要,datetime作為字符串在ISO8601年或在“yyyy-MM-dd 'HH: mm: ss: SSSZ”格式),“屬性”:(可選,屬性對象)屬性的的事件/ /設置這國旗來真正的將把的API在“隻更新”模式。/ /當使用一個“user_alias”,“隻更新”模式是總是真正的。“_update_existing_only”:(可選,布爾型)/ /看到後筆記關於匿名推令牌進口}
更新現有的配置文件隻
如果你想在釺隻更新現有的用戶配置文件,你應該通過_update_existing_only關鍵的價值真正的你的請求。如果省略該值,釺會創建一個新的用戶配置文件external_id不存在。
如果你創建一個alias-only通過的用戶配置文件/用戶/跟蹤端點,_update_existing_only必須設置為假。如果省略這個值,那麼將不會創建alias-only概要文件。
事件屬性對象
購買自定義事件和事件屬性。屬性的值應該是一個對象的鍵屬性的名稱和值的屬性值。屬性名必須非空字符串小於或等於255字符,沒有美元符號($)。
下麵的屬性值可以是任何數據類型:
| 數據類型 | 描述 |
|---|---|
| 數字 | 作為整數或浮點數 |
| 布爾值 | |
| 日期時間 | 格式化為字符串iso - 8601或yyyy-MM-dd 'HH: mm: ss: SSSZ格式。不支持數組內。 |
| 字符串 | 255個字符或更少。 |
| 數組 | 數組不能包含日期時間。 |
| 對象 | 對象將被吸收為字符串。 |
事件屬性對象包含數組或對象值可以有一個事件屬性有效載荷高達50 KB。
事件屬性的持久性
事件屬性是用於過濾和液體個性化,消息由父母觸發事件。默認情況下,他們不堅持釺用戶配置文件。使用事件屬性值分割,請參考自定義事件,詳細說明了各種方法長期存儲事件屬性值。
事件示例請求
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
帖子https://YOUR_REST_API_URL/users/track內容類型:application / json授權:持票人YOUR-REST-API-KEY{“事件”:({“external_id”:“user1”,“app_id”:“你的應用id”,“名稱”:“watched_trailer”,“時間”:“2013 - 07 - 16 - t19:20:30 + 01:00”},{“external_id”:“user1”,“app_id”:“你的應用id”,“名稱”:“rented_movie”,“時間”:“2013 - 07 - 16 - t19:20:45 + 01:00”,“屬性”:{“電影”:“可悲的蛋”,“導演”:“丹·亞曆山大”}},{“user_alias”:{“alias_name”:“device123”,“alias_label”:“my_device_identifier”},“app_id”:“你的應用id”,“名稱”:“watched_trailer”,“時間”:“2013 - 07 - 16 - t19:20:50 + 01:00”}]}
事件對象
使用提供的示例中,我們可以看到,有人最近看了預告片,然後租了一部電影。雖然我們不能去運動,部分用戶基於這些特性,我們可以使用這些屬性在戰略上用的形式發票,發送一個自定義的消息通過通道使用液體。例如,“你好貝絲,謝謝你租悲傷的蛋通過丹·亞曆山大電影,這裏有一些建議根據你的租金…”
編輯這個頁麵在GitHub上