創建一個目錄

通過目錄,您可以參考釺活動通過非用戶數據液體。

創建一個目錄包含非用戶數據的CSV文件導入釺。這允許您訪問這些信息來豐富你的消息。你可以把任何類型的數據到一個目錄。這些數據通常是某種形式的元數據從貴公司產品信息等電子商務業務,或為教育課程信息提供者。

一旦進口這些信息,你可以訪問消息以類似的方式訪問自定義屬性或自定義事件屬性通過液體。

準備你的CSV文件

在創建一個目錄之前,一定要先準備好你的CSV文件是否上傳你喜歡的目錄創建方法。

創建CSV文件時注意這些指導方針。第一列的CSV文件必須是一個頭的id,每一項的id必須是唯一的。所有其他列名稱必須是唯一的。另外,以下限製適用於目錄CSV文件:

• 最多30個字段(列)
• 最多250個字符的字段(列)名稱
• 最大CSV文件大小的2 GB (Pro)
• 最大CSV文件大小為100 MB(免費)
• 最大字段值(細胞)的5000個字符
• 隻有字母、數字、連字符和下劃線id和標頭值

確保你編碼CSV文件使用utf - 8格式以CSV文件成功上傳你的下一步。我們還建議您在CSV文件格式所有文本為小寫。

選擇你的方法

創建一個目錄,去數據設置>目錄。

點擊創建新目錄,然後選擇上傳CSV或創建在瀏覽器。

方法1:上傳CSV

1. 拖拽文件上傳區,或點擊上傳CSV並選擇您的文件。
   
   
   
2. 選擇下列每一列的數據類型之一:布爾值、數字,字符串,或時間。
   
   
   
3. 給你的目錄名稱。請記住以下要求目錄名稱:
   • 必須是唯一的
   • 最多250個字符
   • 隻能包含數字、字母、連字符和下劃線
     
     
4. (可選的)目錄添加一個描述。
   
   
5. 點擊流程目錄創建目錄。

請注意,您不能使用模板目錄的名字。例如,你不能有以下的目錄名稱,否則調用會失敗。

          

           

            

             
1
             
{%catalog_itemscustom_attribute。${目錄}item1,第二條%}
            
           
          

你也可以選擇更新CSV文件後選擇在瀏覽器中創建一個目錄。點擊更新目錄>上傳CSV,然後選擇是否更新、添加或刪除項目目錄。

方法2:創建在瀏覽器

1. 輸入一個名稱為您的目錄。請記住以下要求你的目錄名稱:
   • 必須是唯一的
   • 最多250個字符
   • 隻能包含數字、字母、連字符和下劃線
     
     
     
2. (可選)輸入一個描述你的目錄。
   
   
3. 從列表中選擇您剛剛創建的目錄目錄頁麵更新目錄。
   
   
4. 點擊更新目錄>添加字段添加你的領域。然後,輸入字段名並使用下拉選擇數據類型。在有必要的時候重複這樣做。
   
   
   
5. 接下來,單擊更新目錄>添加項目將一個條目添加到你的目錄,進入信息根據您以前添加的字段。然後,單擊保存項目或保存並添加另一個繼續添加您的項目。
   

你也可以選擇上傳一個CSV文件後選擇在瀏覽器中創建一個目錄。

示例目錄

對於本教程,我們使用一個目錄列出了兩場比賽,他們的成本,一個圖像的鏈接。

在這個例子中,我們將創建目錄,上傳一個CSV文件。的數據類型id,標題,價格,image_link是字符串,字符串、數字和字符串。

接下來,我們將命名這個目錄並單擊“games_catalog”流程目錄按鈕。然後,釺會檢查你的目錄目錄創建之前任何錯誤。

請注意,您不能編輯這個名字一旦創建了目錄。你可以刪除一個目錄和reupload更新版本使用相同的目錄名稱。

在一個消息中使用目錄

您可以使用目錄在你所有的消息渠道,包括拖放編輯器中的任何地方,隻要支持液體。

步驟1:添加個性化的類型

在消息您所選擇的作曲家,單擊+圖標以打開添加個性化模態和選擇目錄項為個性化的類型。然後,選擇你的目錄名稱。使用前麵的例子中,我們將選擇遊戲目錄。

我們可以立即看到以下液體預覽:

          

           

            

             
1
             
{%catalog_items遊戲%}
            
           
          

步驟2:選擇目錄項

接下來,是時候添加你的目錄項!使用下拉菜單,選擇目錄項和顯示的信息。此信息對應的列在你上傳的CSV文件用於生成目錄。

例如,參考我們的遊戲故事的標題和價格,我們可以選擇id的故事》(1234)和請求的目錄項標題和價格顯示的信息。

          

           

            

             
1 2 3
             
{%catalog_items遊戲1234年%}得到{{項目(0]。標題}}僅為{{項目(0]。價格}}!
            
           
          

這顯示為以下:

獲得故事隻有7.49美元!

目錄通過API

你可以利用我們的目錄的端點管理不斷增長的數據和信息。

管理目錄

您可以創建一個目錄使用創建目錄端點。

當你建立更多的目錄,您還可以使用目錄列表端點返回一個工作區目錄的列表。

管理目錄項

除了管理你的目錄,您還可以使用異步和同步端點管理目錄項。這包括編輯和刪除目錄項的能力,和列表目錄項的細節。

例如,如果你想編輯一個單獨的目錄項,您可以使用/目錄/ catalog_name /項目/ item_id端點。

額外的用例

多個項目

你不是局限於一個項目在一個單一的消息!簡單地插入額外的目錄項和信息顯示使用添加個性化模態。注意,您隻能添加三個目錄項。

看看這個示例,我們添加id三場比賽,故事、Teslagrad Acaratus,目錄項並選擇標題為信息顯示。

我們可以進一步個性化信息通過添加一些文本圍繞我們的液體:

          

           

            

             
1 2
             
得到最終的三{%catalog_items遊戲1234年1235年1236年%}{{項目(0]。標題}},{{項目(1]。標題}},{{項目(2]。標題}}今天!
            
           
          

這將返回以下:

終極三國故事,Teslagrad, Acaratus今天!

使用圖像

你也可以參考圖像目錄在您的消息傳遞。為此,使用目錄標記和項物體在液體中圖像領域。

例如,添加image_link從我們的遊戲目錄為故事我們的促銷信息,選擇id為目錄項場和image_link為信息顯示字段。這增加了液體標記圖像字段如下:

          

           

            

             
1 2 3
             
{%catalog_items遊戲1234年%}{{項目(0]。image_link}}
            
           
          

這是這是什麼樣子當液體呈現:

模板目錄項

您還可以使用模板動態目錄項基於自定義屬性。例如,假設一個用戶自定義屬性願望列表遊戲id的數組,其中包含從你的目錄。

          

           

            

             
1 2 3 4 5 6 7 8
             
{“屬性”:({“external_id”:“user_id”,“願望列表”:(“1234”,“1235”]}]}
            
           
          

使用液體模板,您可以動態地退出願望列表在您的消息id,然後使用它們。要做到這一點,分配一個變量您的自定義屬性,然後使用添加個性化模態提取一個特定的項目從數組中。

例如,要讓用戶知道的故事(一個項目在我們的目錄,他們希望)在出售,作曲家我們可以添加以下信息:

          

           

            

             
1 2 3 4
             
{%分配願望列表={{custom_attribute$ {。願望列表}}}%}{%catalog_items遊戲{{願望列表[0]}}%}得到{{項目(0]。標題}}現在,就{{項目(0]。價格}}!
            
           
          

這將顯示如下:

得到現在的故事,隻有7.49美元!

使用的模板,您可以為每個用戶呈現一個不同的目錄項基於個人的自定義屬性,事件屬性,或任何其他模板化領域。

上傳一個CSV

你可以上傳一個CSV新的目錄項的添加、更新或目錄項。刪除一個條目列表,你可以上傳一個CSV項id刪除它們。

使用液體

你也可以手動拚湊目錄液體邏輯。然而,請注意,如果你輸入一個ID,不存在,釺仍將返回一個條目數組沒有對象。我們建議您包括錯誤處理,如檢查數組的大小和使用如果聲明中占一個空數組。

管理目錄

當你創造更多的目錄,你可以利用目錄的端點管理不斷增長的數據和信息。這包括創建、編輯和刪除目錄條目,列出目錄項的細節。

限製

下表描述了應用在一個目錄層次的局限性:

存儲限製

免費版

免費版本的存儲限製目錄是100 MB。你可以有無限的東西隻要在100 MB。選擇將有助於這個大小限製。更複雜的一個選擇是,將占用更多的存儲空間。

專業目錄

在公司層麵,目錄的存儲限製Pro將基於目錄數據的大小:5 GB, 10 GB或15 GB。注意,免費版的存儲(100 MB)包含在每一個計劃。