嵌套的自定義屬性

嵌套的自定義屬性允許您定義一組屬性的另一個屬性的屬性。換句話說,當你定義一個自定義屬性對象,您可以定義一組對象的附加屬性。

例如,假設你想定義一個自定義屬性的用戶配置文件favorite_book。這個自定義屬性可以被定義為一個對象嵌套的屬性標題,作者,publishing_date,如下所示:

          

           

            

             
1 2 3 4 5
             
“favorite_book”:{“標題”:“霍比特人”,“作者”:“J.R.R.托爾金”,“publishing_date”:“1937”}
            
           
          

這個嵌套數據允許您創建段使用信息從一個定製的屬性對象,和個性化你的消息使用一個自定義屬性對象和液體。

對象可以包含自定義屬性數據類型,如:

• 數字
• 字符串
• 布爾值
• 數組
• 時間
• 其他對象
• 對象的數組

限製

• 嵌套的自定義屬性用於自定義屬性發送通過釺SDK或API。
• 合作夥伴不支持數組對象。我們建議不要使用這個功能啟用了合作夥伴集成的工作區。
• 對象的最大大小50 KB。
• 關鍵的名字和字符串值大小限製為255個字符。
• 關鍵名稱不能包含空格。

API的例子

• 創建
• 更新
• 刪除

            

             

              

               
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
               
{“屬性”:({“external_id”:“user_id”,“most_played_song”:{“song_name”:“Solea”,“artist_name”:“邁爾斯·戴維斯”,“album_name”:“西班牙的草圖”,“類型”:“爵士樂”,“play_analytics”:{“數”:1000年,“top_10_listeners”:真正的}}}]}
              
             
            

            

             

              

               
1 2 3 4 5 6 7 8 9 10 11
               
{“屬性”:({“external_id”:“user_id”,“_merge_objects”:真正的,“most_played_song”:{“year_released”:1960年}}]}
              
             
            

            

             

              

               
1 2 3 4 5 6 7 8 9 10 11
               
“most_played_song”:{“song_name”:“Solea”,“artist_name”:“邁爾斯·戴維斯”,“album_name”:“西班牙的草圖”,“year_released”:1960年,“類型”:“爵士樂”,“play_analytics”:{“數”:1000年,“top_10_listeners”:真正的}}
              
             
            

            

             

              

               
1 2 3 4 5 6 7 8
               
{“屬性”:({“external_id”:“user_id”,“most_played_song”:零}]}
              
             
            

SDK示例

• android sdk
• 斯威夫特sdk
• web sdk

            

             

              

               
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
               
瓦爾json=JSONObject()。把(“song_name”,“Solea”)。把(“artist_name”,“邁爾斯·戴維斯”)。把(“album_name”,“西班牙的草圖”)。把(“類型”,“爵士樂”)。把(“play_analytics”,JSONObject()。把(“數”,1000年)。把(“top_10_listeners”,真正的))釺。getCurrentUser{用戶- >用戶。setCustomUserAttribute(“most_played_song”,json)}
              
             
            

            

             

              

               
1 2 3 4 5 6
               
瓦爾json=JSONObject()。把(“year_released”,1960年)釺。getCurrentUser{用戶- >用戶。setCustomUserAttribute(“most_played_song”,json,真正的)}
              
             
            

            

             

              

               
1 2 3
               
釺。getCurrentUser{用戶- >用戶。unsetCustomUserAttribute(“most_played_song”)}
              
             
            

            

             

              

               
1 2 3 4 5 6 7 8 9 10 11 12
               
讓json:(字符串:任何?]=(“song_name”:“Solea”,“artist_name”:“邁爾斯·戴維斯”,“album_name”:“西班牙的草圖”,“類型”:“爵士樂”,“play_analytics”:(“數”:1000年,“top_10_listeners”:真正的,),]釺。用戶。setCustomAttribute(關鍵:“most_played_song”,字典:json)
              
             
            

            

             

              

               
1 2 3 4 5
               
讓json:(字符串:任何?]=(“year_released”:1960年]釺。用戶。setCustomAttribute(關鍵:“most_played_song”,字典:json,合並:真正的)
              
             
            

            

             

              

               
1
               
釺。用戶。unsetCustomAttribute(關鍵:“most_played_song”)
              
             
            

            

             

              

               
1 2 3 4 5 6 7 8 9 10 11 12
               
進口*作為釺從”@braze / web-sdk”;常量json={”song_name”:”Solea”,”artist_name”:”邁爾斯·戴維斯”,”album_name”:”西班牙的草圖”,”類型”:”爵士樂”,”play_analytics”:{”數”:1000年,”top_10_listeners”:真正的}};釺。getUser()。setCustomUserAttribute(”most_played_song”,json);
              
             
            

            

             

              

               
1 2 3 4 5 6
               
進口*作為釺從”@braze / web-sdk”;常量json={”year_released”:1960年};釺。getUser()。setCustomUserAttribute(”most_played_song”,updatedJson,真正的);
              
             
            

            

             

              

               
1 2
               
進口*作為釺從”@braze / web-sdk”;釺。getUser()。setCustomUserAttribute(”most_played_song”,零);
              
             
            

獲取日期作為對象屬性

獲取日期作為對象屬性,你必須使用美元的時間關鍵。在接下來的例子中,一個重要的日期對象用於捕獲對象屬性的集合,生日和wedding_anniversary。這些日期的值是一個對象美元的時間關鍵。

          

           

            

             
1 2 3 4 5 6 7 8 9 10 11
             
{“屬性”:({“external_id”:“time_with_nca_test”,“important_dates”:{“生日”:{“$”:“1980 - 01 - 01 t19:20:30z”},“wedding_anniversary”:{“$”:“2020 - 05 - 28 - t19:20:30z”}}}]}
            
           
          

注意,對於嵌套的自定義屬性,如果大於或小於0 3000年,釺在用戶不存儲這些值。

液體模板

以下液體模板示例展示了如何引用自定義屬性的對象屬性保存前在您的消息傳遞API請求和使用它們。

使用custom_attribute個性化標簽,點符號來訪問一個對象上的屬性。指定對象的名稱(和位置在數組如果引用一個對象數組),緊隨其後的是一個點(段),其次是屬性名。

{{custom_attribute。$ {most_played_song} [0] .artist_name}}——“邁爾斯·戴維斯”
{{custom_attribute。$ {most_played_song} [0] .song_name}}——“Solea”
{{custom_attribute。$ {most_played_song} [0] .play_analytics.count}}——“1000”

分割

您可以構建基於嵌套段進一步目標用戶自定義屬性。,過濾部分基於自定義屬性的對象,然後指定屬性名稱的路徑和相關價值你想段。如果你不確定這條路是什麼樣子,你可以生成一個模式和使用嵌套對象資源管理器釺填充路徑。

添加一條通往你的財產之後,點擊驗證驗證路徑字段中的值是有效的。

play_analytics.count是一個數字,你可以選擇一個比較下數量類別。

多目標分割

使用多目標分割創建一個段匹配多個標準在一個對象中。這限定用戶到段如果他們有至少一個對象數組,匹配所有指定的標準。例如,用戶隻會匹配這部分如果他們的關鍵不是空白,如果數量超過0。

您還可以使用複製液體為段功能來生成液體為這段代碼並使用一個消息。例如,假設你有帳戶對象數組和一段目標客戶與活躍的應稅帳戶。manbetx万博全站客户端讓顧客賬戶目標manbetx万博全站客户端作出貢獻與他們的一個活躍和應稅帳戶,您需要創建一個消息推動。

          

           

            

             
1 2 3 4 5 6 7
             
{%分配segmented_nested_objects = " |分割:“%}{%分配obj_array = {{custom_attribute。${賬戶}}}%}{%在obj_array obj %}{%如果obj (“account_type”) = =應稅和obj[“活躍”]= = true %}{%分配segmented_nested_objects = obj_array |片:forloop。index0 | concat: segmented_nested_objects |反向%}{% endif %} {% endfor %}