用戶導入

釺提供多種方式導入用戶數據平台:sdk, api,雲數據攝入、技術合作夥伴集成,華禾投資。

REST API

您可以使用銅焊的用戶跟蹤REST API端點來記錄自定義事件,用戶屬性,為用戶購買。看到用戶跟蹤端點為更多的信息。

雲數據攝入

您可以使用釺的雲數據攝入導入和維護用戶屬性。看到雲數據攝入為更多的信息。

CSV

您還可以上傳和更新通過CSV文件的用戶配置文件用戶導入頁麵。該特性支持記錄和更新用戶屬性的名字和電子郵件等,除了自定義屬性,如鞋碼。有兩種不同的方式可以方法導入CSV:進口的external_id或與用戶別名。

進口與外部ID

導入客戶數據時,您需要指定每個客戶獨特的標識符,也被稱為external_id。開始前CSV進口重要的是要了解你的工程團隊將如何確定用戶在釺。通常這是一個數據庫ID在內部使用。這應該結合釺SDK將如何識別用戶的移動和網絡,並確保每個客戶將有一個用戶配置文件內釺在他們的設備。閱讀更多關於釺用戶配置文件生命周期。

當你提供一個external_id在導入,釺將更新相同的任何現有的用戶external_id或者創建一個新發現的用戶external_id如果沒有找到一個。

下載:CSV導入模板

進口與用戶別名

目標用戶沒有一個external_id,您可以導入用戶與用戶的別名列表。別名作為另一個唯一的用戶標識符,並且可以幫助如果你想市場匿名用戶沒有注冊或讓一個帳戶與你的應用程序。

如果你上傳或更新用戶配置文件的別名,你必須有以下兩列在你的CSV:

• user_alias_name:一個惟一的用戶標識符;一個替代external_id。
• user_alias_label:一個共同的標簽組用戶的別名。

當你提供一個user_alias_name和user_alias_label在導入,釺將更新相同的任何現有的用戶user_alias_name和user_alias_label。如果一個用戶沒有發現,釺將創建一個新發現的用戶user_alias_name集。

下載:CSV別名導入模板

進口與釺ID

更新現有的用戶配置文件中使用一個內部釺釺ID值,而不是一個external_id或user_alias_name/user_alias_label值,您可以通過指定braze_id作為列標題。

這可以幫助如果你有導出用戶數據通過我們從釺CSV導出選項內分割並希望這些現有用戶添加一個新的自定義屬性。

構建你的CSV

有幾個數據類型在釺。在導入通過CSV或更新用戶配置文件,可以創建或更新默認用戶屬性或自定義屬性。

• 默認的用戶屬性保留鍵在釺。例如,first_name或電子郵件。
• 自定義屬性自定義您的業務。例如,旅遊預訂應用程序可能有一個定製的屬性last_destination_searched。

釺接受用戶數據標準CSV格式的文件大小為500 mb。請參考前麵的部分進口可下載的CSV模板。

數據點注意事項

每一塊客戶通過CSV數據導入將覆蓋現有的價值用戶配置文件,並將計算數據點,除了外部id和空白值。

• 外部id上傳通過CSV不會消耗數據點。如果你上傳一個CSV段現有釺用戶通過上傳隻有外部id,可以不消費數據點。如果你添加額外的用戶數據,如電子郵件或電話號碼在你的進口,這將覆蓋現有的用戶數據、消費數據點。
  • CSV進口用於分割(進口由external_id、braze_id或user_alias_name作為唯一字段)不會消耗數據點。
• 空白值不會覆蓋現有的值在用戶配置文件,你不需要在CSV文件中包含所有現有的用戶屬性。
• 更新email_subscribe,push_subscribe,subscription_group_id,或subscription_state,將不會計算在數據點消費。

默認用戶數據列標題

導入自定義數據

任何頭不完全匹配的默認用戶數據將在釺創建一個自定義屬性。

以下數據類型是接受用戶導入:

• Datetime(必須存儲在iso - 8601格式)
• 布爾(真/假)
• 數字(整數或浮點數沒有空格或逗號,花車必須使用一段時間”。“十進製分隔符)
• 字符串(沒有逗號)
• 空白(空白值不會覆蓋現有的值在用戶配置文件,你不需要在CSV文件中包含所有現有的用戶屬性)。

更新訂閱組狀態

您可以添加用戶到電子郵件或短信訂閱組通過用戶導入。這對於SMS尤其有用,因為用戶必須注冊到一個短信訂閱組通過發信息說短信通道。有關更多信息,請參考短信訂閱組。

如果你更新訂閱組狀態,你必須有以下兩列在你的CSV:

• subscription_group_id:id的訂閱組。
• subscription_state:可用值沒訂閱(不是在訂閱組)訂閱(訂閱組)。

導入CSV

導航到CSV文件導入用戶導入頁麵在用戶部分。在下方的文本框,最近進口,將會有一個表,列出了20你最近進口的,文件名,文件的行數,成功導入的行數,總線在每個文件,每個進口的狀態。

上麵的盒子,導入CSV,將包含進口方向和一個按鈕開始導入。點擊選擇CSV文件並選擇您感興趣的文件,然後單擊開始上傳。銅焊將上傳文件並檢查列標題以及每一列的數據類型。

下載CSV模板,參考部分進口與外部ID或進口與用戶別名在這個頁麵。

上傳完成後,您將看到一個模態的預覽您的文件的內容。所有的信息在這個表是基於前幾行中的值的CSV文件。列標題,標準屬性將被寫在正常文本,而自定義屬性將斜體和類型在括號。也將有一個簡短的摘要文件的頂部彈出。

您可以導入多個CSV在同一時間。CSV進口將同時運行,因此更新的順序並不保證是串行的。如果您需要進口CSV運行一個接一個,你應該等到一個CSV導入已經完成之前上傳第二個。

如果釺通知一些畸形在您的文件上傳,這些錯誤會顯示與總結。例如,如果您的文件包括一個畸形的行,那麼這個錯誤將會在預覽時導入文件。所以,可以導入一個文件錯誤,但導入不能取消或回滾一次開始。查看預覽,如果你發現任何錯誤,取消進口和修改文件。重要的是要檢查完整的CSV文件在上傳之前,銅焊不掃描每一行輸入文件的預覽。這意味著錯誤可以存在這釺不趕在生成這個預覽。

畸形的一排排缺乏外部ID不會被導入。所有其他錯誤可以進口,但是可能會幹擾過濾時創建一個段。有關更多信息,跳過的故障排除部分。

當你滿意上傳,開始導入。彈出將關閉和進口將在後台開始。你可以跟蹤它的進展用戶導入頁麵,將每5秒刷新,或按刷新按鈕的最近進口盒子。

下行處理,你會看到導入的進度;完成完成後狀態會改變。你仍然可以使用其他釺儀表板在進口,進口時,你會收到通知開始和結束。

如果導入過程遇到一個錯誤,一個黃色的警告圖標旁邊將顯示整個文件中的行數。懸停在圖標上可以看到細節為什麼某些行失敗了。導入完成後,所有數據將被添加到現有的資料,或新概要文件將被創建。

用戶導入CSVλ

您可以使用我們的serverless S3λCSV導入腳本上傳用戶屬性的平台。這個解決方案是一個CSV上傳,你總是把你的CSV為S3 bucket、通過我們的API和腳本上傳它。

估計執行時間與100萬行一個文件應該5分鍾左右。看到用戶屬性CSV釺導入為更多的信息。

分段

用戶導入創建和更新用戶配置文件,也可以用來創建片段。要創建一個段,選擇自動生成一段從用戶導入CSV開始導入。

你可以設置部分的名稱或接受默認,這是您的文件的名稱。文件被用來創建一個段將有一個鏈接到查看段一次導入已經完成。

過濾器用於創建段選擇用戶創建或更新選擇導入和可用的所有其他過濾器在編輯頁麵。

HTML數據剝離

在攝入期間釺不清潔的HTML數據。當導入數據到釺,特別是用於個性化使用在web瀏覽器中,確保它是剝奪了HTML、JavaScript或任何其他腳本標記可能會被惡意利用的呈現在一個web瀏覽器。

另外,對於HTML,您可以使用銅焊的液體過濾器(strip_htmlHTML轉義呈現文本。例如:

• 輸入
• 輸出

            

             

              

               
1
               
{{“< em > < / em >讀<強>尤利西斯> < /強大?”& #124年;strip_html}}
              
             
            

            

             

              

               
1
               
你讀過《尤利西斯》嗎?
              
             
            

故障排除

失蹤的行

有幾個原因的用戶數量可能不匹配的總進口行你的CSV文件:

• 重複的外部id:如果有重複的外部ID列,那麼這可能會導致畸形或unimported行即使行正確格式化。在某些情況下,這可能不是一個特定的錯誤報告。檢查是否有重複的外部id CSV。如果是,刪除重複並嚐試再次上傳。
• 重音字符:你的CSV可能有名稱或屬性,包括口音。確保您的文件是utf - 8編碼,以防止任何問題。

畸形的行

必須有一個標題行以正確導入數據。每一行必須有相同數量的細胞作為標題行。或多或少的長度值的行比標題行將被排除在進口。逗號分隔的值將被解釋為一個分離器,可以導致這個錯誤拋出。此外,所有的數據必須是utf - 8編碼。

如果你的CSV文件行空白行和進口低於總線路在CSV文件中,這可能不會顯示導入的問題,因為空白行不需要進口。檢查正確的行數,進口並確保它匹配用戶的數量你試圖導入。

多種數據類型

釺預計每個值在一列相同的數據類型。值屬性的數據類型不匹配會導致分割錯誤。

格式不正確的日期

日期不iso - 8601不會被解讀為日期時間格式導入。

字符串的報價

值封裝在單引號(“)或雙引號(" ")將閱讀作為字符串在導入。

數據導入自定義屬性

如果你看到一個默認的用戶數據(例如,電子郵件或first_name)進口作為一個自定義屬性,檢查你的情況和間距CSV文件。例如,First_name將被導入作為一個自定義屬性,而first_name會正確地導入到“first name”字段用戶的概要文件。