TikTok網站事件API擴充功能總覽

TikTok events API是安全的Edge Network API介面,可讓您直接與TikTok共用您網站上使用者動作的資訊。 您可以使用Adobe Experience Platform Edge Network Web Events API擴充功能,運用事件轉送規則,將資料從TikTok傳送至TikTok。

TikTok必要條件 prerequisites

若要設定TikTok網頁事件API以使用TikTok事件API,您必須產生TikTok畫素代碼並存取權杖。

您必須擁有商務帳戶的有效TikTok,才能使用合作夥伴設定建立TikTok畫素。 移至TikTok 企業註冊頁面進行註冊並建立帳戶(如果尚未建立帳戶)。

您必須登入您的企業帳戶,才能使用合作夥伴設定來設定TikTok Pixel。 請依照下列步驟執行此操作:

  1. 瀏覽至​ Assets ​索引標籤並選取​Event
  2. 在Web事件底下,選取​Manage
  3. 選擇「Set Up Web Events」。
  4. 選取​ Partner Setup ​作為您的連線方法。

如需如何設定畫素的詳細資訊,請參閱開始使用PixelTikTok指南。

成功建立畫素後,您就可以產生存取權杖。 若要這麼做,請導覽至「畫素」並選取「Settings」標籤。 在Events API底下,選取​Generate Access Token

請參閱TikTok 快速入門手冊,以取得如何設定畫素程式碼和存取Token的詳細資訊。

安裝及設定TikTok網頁事件API擴充功能 install

若要安裝擴充功能,請在左側導覽中選取​Extensions。 在​ Catalog ​索引標籤中,選取​TikTok Web Events API Extension,然後選取​Install

顯示TikTok擴充卡醒目提示安裝的擴充功能目錄。

在下一個畫面中,輸入您先前從TikTok廣告管理員產生的下列設定值:

  • Pixel Code
  • Access Token

完成後,選取​Save

TikTok Web事件API擴充功能的TikTok設定畫面。

設定事件轉送規則 config-rule

設定好所有資料元素後,您就可以開始建立事件轉送規則,以判斷將事件傳送至TikTok的時間和方式。

在您的事件轉送屬性中建立新的規則。 在​ Actions ​底下,新增動作並將擴充功能設為​TikTok Web Events API Extension。 若要將Edge Network事件傳送至TikTok,請將​ Action Type ​設為​Send TikTok Web Events API Event。

正在資料收集UI中為Send TikTok Web Events API Event規則選取TikTok動作型別。

選取後,會顯示其他控制項以進一步設定事件,如下所述。 完成後,選取「Keep Changes」以儲存規則。

Web Events and Parameters

Web事件和引數包含有關事件的一般資訊。 TikTok整合工具支援標準事件,且可用於報表、轉換最佳化及建立對象。

輸入
說明
活動名稱
事件的名稱。 這些動作具有預先定義的名稱,由TikTok建立,是必要欄位。 請參閱TikTok 行銷API檔案,以取得支援事件的詳細資訊。
事件時間
以ISO 8601或yyyy-MM-dd'T'HH:mm:ss:SSSZ格式作為字串的日期時間。 這是必填欄位。
事件 ID
廣告商產生的唯一ID可指出每個事件。 這是選用欄位,用於重複資料刪除。

顯示輸入欄位之範例資料的Web Events and Parameters區段。

User Context Parameters

使用者內容引數包含用來比對Web訪客事件與TikTok位使用者的客戶資訊。 包含多種型別的相符資料,可讓您提高目標定位和最佳化模型的準確性。

輸入
說明
IP位址
瀏覽器的非雜湊公用IP位址。 支援IPv4和IPv6位址。 可辨識IPv6位址的完整和壓縮形式。
使用者代理
來自使用者裝置的非雜湊使用者代理。
電子郵件
與轉換事件相關之連絡人的電子郵件地址。
電話
雜湊處理前,電話號碼必須是E164格式[+][country code][area code][local phone number]
Cookie ID
如果您使用Pixel SDK,將會在啟用Cookie的情況下,自動在_ttp Cookie中儲存唯一識別碼。 _ttp值可以擷取並用於此欄位。
外部 ID
任何唯一識別碼,例如使用者ID、外部Cookie ID等,都必須使用SHA256進行雜湊處理。
TikTok點按ID
每次在ttclid上選取廣告時,都會新增至登陸頁面URL的TikTok。
頁面 URL
事件時的頁面URL。
頁面反向連結URL
頁面反向連結的URL。

顯示輸入欄位之範例資料的User Context Parameters區段。

Properties Parameters

使用屬性引數來設定其他支援的屬性。

輸入
說明
價格
單一料號的成本。
數量
在事件中購買的專案數。 這必須是大於0的正數。
內容型別
必須將productproduct_group的值指派給content_type物件屬性,這取決於當您設定產品目錄時如何設定資料摘要。
內容ID
產品專案的唯一識別碼。
內容類別
頁面/產品的類別。
內容名稱
頁面/產品的名稱。
貨幣
事件中購買專案的貨幣。 這以ISO-4217表示。
價值
訂單的總價。 此值將等於價格*數量。
說明
專案或頁面的說明。
查詢
用來查詢產品的文字字串。
狀態
訂單、料號或服務的狀態。 例如,「submitted」。

顯示輸入欄位之範例資料的Properties Parameters區段。

事件重複資料刪除 deduplication

如果您同時使用TikTok pixel SDK和TikTok Web事件API擴充功能,將相同的事件傳送至TikTok,則需要設定TikTok畫素以進行重複資料刪除。

如果從使用者端和伺服器傳送的相異事件型別沒有任何重疊,則不需要重複資料刪除。 若要確保您的報表不會受到負面影響,您必須確定已針對TikTok畫素SDK和TikTok網頁事件API擴充功能共用的任何單一事件,進行重複資料刪除。

傳送共用事件時,請確定每個事件都包含畫素ID、事件ID和名稱。 相隔五分鐘內送達的重複事件將會合併。 如果第一個事件中沒有資料欄位,則會與後續事件結合。 我們將移除48小時內收到的所有重複事件。

如需此程式的詳細資訊,請參閱有關TikTok事件重複資料刪除檔案。

後續步驟

本指南說明如何使用TikTok網頁事件API擴充功能,將伺服器端事件資料傳送至TikTok。 如需Adobe Experience Platform中事件轉送功能的詳細資訊,請參閱事件轉送概觀

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743