自定義事件
自定義事件是用戶采取的操作或關於用戶的更新。它們最適合跟蹤應用程序中高價值的用戶交互。記錄一個自定義事件可以觸發任何數量和類型的後續活動，並啟用對該事件的最近和頻率所列出的分割過濾器。
管理自定義事件
要在儀表板中創建和管理自定義事件，請轉到管理設置>自定義事件．在此頁麵中，您可以查看、管理或屏蔽現有的自定義事件，也可以創建一個新事件。如果阻塞一個自定義事件，則不會收集有關該事件的數據，現有數據將不可用，除非重新激活，並且阻塞的事件將不會顯示在過濾器或圖表中。
記錄自定義事件
下麵列出了用於記錄自定義事件的各種平台的方法。在這些頁麵中，您還可以找到關於如何向自定義事件添加屬性和數量的文檔。
定製事件存儲
所有數據都存儲在用戶配置文件，包括自定義事件元數據(第一次/最後一次發生、總數，以及30天內X在Y中的位置)，隻要每個概要文件存在，就會無限期保留活躍的．
自定義事件分割過濾器
下表顯示了可用於按自定義事件分割用戶的過濾器。
| 分割的選擇 | 下拉過濾器 | 輸入選項 |
|---|---|---|
| 檢查自定義事件是否發生超過X次 | 超過 | 數量 |
| 檢查自定義事件是否發生少於X次 | 不到 | 數量 |
| 檢查自定義事件是否發生正好X次 | 完全 | 數量 |
| 檢查自定義事件是否最後發生在X日期之後 | 後 | 時間 |
| 檢查自定義事件是否最後發生X日期之前 | 之前 | 時間 |
| 檢查自定義事件是否最後發生超過X天前 | 超過 | 天數(正數) |
| 檢查自定義事件是否最後發生不到X天前 | 不到 | 天數(正數) |
| 檢查自定義事件是否發生超過X(最大= 50)次 | 超過 | 在過去Y天(Y = 1,3,7,14,21,30) |
| 檢查自定義事件是否發生少於X (Max = 50)次 | 不到 | 在過去Y天(Y = 1,3,7,14,21,30) |
| 檢查自定義事件是否發生正好X (Max = 50)次 | 完全 | 在過去Y天(Y = 1,3,7,14,21,30) |
定製事件分析
Braze注意到這些事件發生的次數，以及每個用戶最後一次執行這些事件進行分段的時間。在自定義事件頁中，您可以查看每個自定義事件發生的總頻率，以及隨著時間的推移按段進行更詳細的分析。這對於查看您的活動如何影響自定義事件活動非常有用，方法是查看Braze覆蓋在時間序列上的灰色線，以指示活動最後一次發送的時間。
增加自定義屬性可用於在類似自定義事件的用戶操作上保留計數器。但是，您將無法查看時間序列中的自定義屬性數據。不需要用時間序列分析的用戶動作應該用這種方法記錄下來。
自定義事件分析沒有顯示?
注意，用自定義事件數據創建的段不能顯示創建之前的曆史數據。
定製事件屬性
使用自定義事件屬性，您可以設置自定義事件和購買的屬性。然後，可以使用這些屬性進一步限定觸發器條件，增加消息傳遞中的個性化，跟蹤轉換，並通過原始數據導出生成更複雜的分析。
屬性值應該是一個對象，其中鍵是屬性名，值是屬性值。屬性名必須是小於或等於255個字符的非空字符串，沒有前導的美元符號($)。
屬性值可以是以下任何數據類型:
| 數據類型 | 描述 |
|---|---|
| 數字 | 作為整數或浮點數 |
| 布爾值 | |
| 日期時間 | 格式為iso - 8601或yyyy-MM-dd 'HH: mm: ss: SSSZ格式。在數組中不支持。 |
| 字符串 | 255個字符或更少。 |
| 數組 | 數組不能包含日期時間。 |
| 對象 | 對象將作為字符串被攝取。 |
| 嵌套對象 | 在其他對象內部的對象。有關更多信息，請參見本文中關於嵌套對象． |
包含數組或對象值的事件屬性對象可以具有高達50KB的事件屬性有效負載。
例如，如果電子商務應用程序希望在用戶放棄購物車時向其發送消息，它還可以通過添加用戶購物車的“購物車值”的自定義事件屬性來提高活動的個性化。
每個自定義事件或購買可以有多達256個不同的自定義事件屬性。如果記錄的自定義事件或購買的屬性超過256個，則隻捕獲前256個屬性供使用。
中還支持嵌套的自定義事件屬性基於動作的交付或轉換處理:
自定義事件屬性還可以用於消息傳遞模板中的個性化。任何活動使用基於動作的交付通過觸發器，事件可以使用該事件的自定義事件屬性進行消息傳遞個性化。如果遊戲應用想要向已經完成某個關卡的用戶發送消息，它可以使用用戶完成該關卡所需時間的屬性進一步個性化消息。在此示例中，消息針對三個不同的段進行了個性化處理條件邏輯．自定義事件屬性調用time_spent，可以通過調用包含在消息中{{event_properties。$ {time_spent}}}．
使用模板化自定義事件屬性觸發的應用程序內消息(例如，{{event_properties。$ {time_spent}}})將失敗，如果沒有互聯網連接將不顯示。
您可以更改自定義事件屬性的數據類型，但請注意改變數據類型數據收集完成後。
當進行API調用並使用“is blank”過濾器時，特定的自定義事件屬性如果被排除在調用之外，則被認為是“空白”的。比如，如果你要包括“event_property”:“，那麼你的用戶就會被認為是“非空白”的。
在訂閱使用方麵，自定義事件屬性支持使用過濾器進行分割X自定義事件屬性在Y天或X在Y天購買物業除了由自定義事件本身計算的數據點外，都作為單獨的數據點進行計數。
畫布條目屬性和事件屬性
您可以利用canvas_entry_properties而且event_properties在你的Canvas用戶旅程中。看看畫布條目屬性和事件屬性了解更多信息和示例。
對於原始的畫布編輯器和畫布流，您不能使用event_properties在前置信息步驟中。相反，你必須使用canvas_entry_properties或添加帶有相應事件的操作路徑步驟之前Message步驟，包括event_properties．
帆布條目屬性是基於操作或api觸發的畫布映射的屬性。請注意,canvas_entry_properties對象的最大大小限製為50 KB。
特別是對於應用內消息渠道，canvas_entry_properties如果你在原始編輯器中啟用了持久化條目屬性(作為之前早期訪問的一部分)，則隻能在Canvas Flow和原始畫布編輯器中引用。
對於Canvas Flow消息傳遞，canvas_entry_properties可以在任何消息步驟的液體中使用。當引用以下屬性時使用此液體:canvas_entry_properties $ {property_name}．注意，要以這種方式使用，事件必須是自定義事件或購買事件。
例如，考慮以下請求:\ " canvas_entry_properties \ ":{\“product_name \”,\“鞋\”,\“product_price \”:79.99}．你可以在Liquid的信息中添加“鞋子”這個詞{{canvas_entry_properties。$ {product_name}}}．
對於用原始編輯器創建的畫布，canvas_entry_properties隻能在畫布的第一個完整步驟中引用。
事件屬性是指為自定義事件和購買設置的屬性。這些event_properties可以在活動中使用基於行動的交付以及畫布。
在Canvas Flow中，自定義事件和購買事件屬性可以在Liquid中的任何Message步驟中使用，該步驟緊隨Action Paths步驟之後。對於Canvas Flow，請確保使用{{event_properties。$ {property_name}}}如果引用這些event_properties．這些事件必須是自定義事件或購買事件，才能在Message組件中以這種方式使用。
對於最初的Canvas編輯器，event_properties不能在計劃的完整步驟中使用。但是，你可以使用event_properties在基於動作的Canvas的第一個完整步驟中，即使整個步驟是預定的。
在操作路徑後麵的第一個消息步驟中，您可以使用event_properties與動作路徑中引用的事件相關。這些event_properties隻有當用戶真正采取了行動(沒有轉到Everyone Else組)時才能使用。在此操作路徑和消息步驟之間可以有其他步驟(不是另一個操作路徑或消息步驟)。
嵌套對象
可以使用嵌套對象(位於另一個對象中的對象)將嵌套JSON數據作為自定義事件和購買的屬性發送。此嵌套數據可用於在消息中模板化個性化信息、觸發消息發送和分段。
限製
用法示例
API請求體
以下是一個/用戶/跟蹤例如“創建播放列表”自定義事件。一旦創建了播放列表，為了捕獲播放列表的屬性，我們將發送一個API請求，該請求將“歌曲”作為一個屬性，以及歌曲的嵌套屬性數組。
12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22
．.．"properties": {"songs": [{"title": " smell Like Teen Spirit"， "artist": "Nirvana"， "album": {"name": "Nevermind"， "yearReleased": "1991"}}， {"title": "While My Guitar Gently Weeps"， "artist": "the Beatles"， "album": {"name": "the Beatles"， "yearReleased": "1968"}}]}…
以下是一個/用戶/跟蹤帶有“Ordered”自定義事件的示例。一旦訂單完成，為了捕獲該訂單的屬性，我們將發送一個API請求，其中列出“r_details”作為一個屬性，以及該訂單的嵌套屬性。
12 3 4 5 6 7 8 9 10 11 12
．.．"properties": {"r_details": {"name": "McDonalds"， "identifier": "12345678"， "location";{"city": "Montclair"， "state": "NJ"}}}…
液體模板
下麵的Liquid模板示例展示了如何引用從前麵的API請求中保存的嵌套屬性，並在您的Liquid消息傳遞中使用它們。使用Liquid和點表示法，遍曆嵌套數據，以找到希望包含在消息中的特定節點。
由“已創建播放列表”事件觸發的消息中的Liquid模板:
{{event_properties。${歌曲}[0].album.name}}:“無所謂”{{event_properties。${歌曲}[1].title}}《當我的吉他輕輕地哭泣》
由" Ordered "事件觸發的消息中的Liquid模板:
{{event_properties。$ {r_details} .location.city}}:“蒙特克萊爾”
消息引發
若要使用這些屬性觸發活動，請選擇自定義事件或購買，並添加嵌套的屬性過濾器。注意，應用程序內消息還不支持消息觸發。
從" Created Playlist "事件中觸發帶有嵌套屬性的活動:
觸發條件歌[].album.yearReleased“is”“1968”將匹配一個事件，其中任何歌曲都在1968年發行了專輯。我們用括號表示［］用於遍曆數組，並匹配if任何遍曆數組中的項與事件屬性匹配。
從" Ordered "事件中觸發帶有嵌套屬性的活動:
r_details.name:“麥當勞”r_details.location.city:“蒙特克萊爾”
如果事件屬性包含［］或．字符，通過將塊括在雙引號中來轉義它們。例如,“歌曲[].album .yearReleased”是否將事件與文字屬性匹配“[].album歌曲”．
分割
使用段的擴展基於嵌套的事件屬性來劃分用戶。分割使用與觸發相同的符號(參見消息引發）.
事件的財產分割
事件屬性分段允許您不僅基於所獲取的自定義事件，而且基於與這些事件關聯的屬性來鎖定用戶。該功能在分割購買和自定義事件時添加了額外的過濾選項。
這些分割過濾器包括:
- 在過去的Y天裏使用屬性Y做了X次值為V的自定義事件。
- 在過去的Y天內購買過價值V X次的房產Y。
- 增加在1、3、7、14、21和30天內分割的能力。
與段的擴展，使用的段是實時更新的，支持無限數量的段，提供最多30天的曆史回顧，並產生數據點。由於額外的數據點費用，您必須聯係您的CSM為您的自定義事件打開事件屬性。一旦得到批準，就可以在下麵的儀表板中添加其他屬性管理設置>自定義事件>管理屬性並在活動或Canvas生成器的目標步驟中使用。
常見問題
這是否會消耗額外的數據點?
添加此功能後，我們對數據點的收費方式沒有變化。
可以發送多少嵌套數據?
如果事件的一個或多個屬性包含嵌套數據，則事件上所有組合屬性的最大負載為50 KB。任何超過該大小限製的請求都將被拒絕。
自定義事件屬性存儲
定製事件屬性旨在幫助您提高目標定位精度，並使消息感覺更加個性化。自定義事件屬性可以在Braze中存儲短期和長期。
如果你想分割事件屬性的值，你有兩個選擇:
- 30天內:Braze支持人員可以基於Braze段內特定事件屬性值的頻率和近時性啟用事件屬性分割。如果您想利用segment內的事件屬性，請聯係您的Braze客戶主管或客戶成功經理。注意，此選項將影響數據使用。
- 30天內及以後:要涵蓋短期和長期事件屬性分割，您可以使用段的擴展．該特性使您能夠基於過去一年跟蹤的自定義事件和事件屬性進行分段。注意，此選項不會影響數據使用。
Braze的成功和支持團隊可以根據您的具體需求幫助推薦最佳方法。
在GithHub上編輯此頁