概覽

藉由 Pinterest 轉換 API，廣告客戶可透過伺服器對伺服器的連線方式，將轉換事件直接傳送給 Pinterest。接著，我們就能參考 Pinterest API 擷取到的轉換事件，在宣傳活動中重新鎖定目標對象，而廣告客戶可在轉換報告中檢視這些事件，更清楚掌握實際的轉換情形。

廣告客戶可透過 Pinterest 轉換 API 傳送以下事件：

網頁轉換事件

應用程式內轉換事件

離線轉換事件

系統會即時收到事件，或在事件發生及擷取後一小時內接收。此時段以外收到的事件，以及延遲處理的批次事件，都將計為離線轉換事件。

使用 Pinterest 轉換 API 及 Pinterest 標籤，有助於更清楚掌握擷取到的轉換事件。我們的最佳作法是同時使用兩種轉換事件擷取解決方案，確保您能全面掌握轉換宣傳活動成效的相關資訊。

Pinterest API

Pinterest 轉換 API 是 Pinterest API 系統中的其中一項產品。擁有 Pinterest Business 帳號的使用者可以使用 Pinterest 轉換 API，但無法因此而能存取適用範疇更廣的 Pinterest API。

Pinterest 開發者平台 提供 Pinterest 所有 API 產品的相關資訊。

開始使用

只要擁有 Pinterest Business 帳號就可存取 Pinterest 轉換 API。

開始使用前，您必須先產生存取憑證。存取憑證是由一串字元所組成，可驗證系統是否能收到請求，並將請求傳回給正確的使用者帳號。

存取憑證產生步驟：

登入您的 Pinterest 企業帳號

按一下頂端選單中的「廣告」，然後選擇「轉換」

選取左側導覽列中的「轉換存取憑證」頁面

按一下「產生新憑證」按鈕

複製新的存取憑證，返回設定程序。

如果您要存取並非自己所擁有的帳號，必須先設定企業存取區。

實作

轉換事件：Pinterest 標籤可擷取的所有事件類型，也可透過 Pinterest 轉換 API 取得。您可從我們的 Pinterest API 開發人員文件參閱完整的事件清單，進一步瞭解事件的重要性。

設定伺服器對伺服器的 API 整合，需要開發人員和網站擁有者的工程資源。技術開發人員的工作量會因以下項目而異：

您的開發人員對 API 整合的熟悉度。如果他們從未進行過 API 整合，就可能需要額外的作業。如果您執行了其他的轉換 API 的整合，則您的開發人員只需進行一些逐步變更。

我們會收到的追蹤事件數量，以及轉換階段的處理資料。

廣告客戶是否想要或需要使用第三方服務 (即 Shopify、GTM、Tellium) 進行整合。

若已使用 Pinterest 標籤

強烈建議您搭配使用 Pinterest 轉換 API 與 Pinterest 標籤，以確保取得最多的轉換事件。

如果您先前已設定過 Pinterest 標籤，必須確定轉換成效不會透過 Pinterest 標籤及 API 重複計算。

想要達到這個目的，您必須確定參數 event_id 已隨 Pinterest 標籤和 Pinterest 轉換 API 擷取到的轉換事件一併傳回。

系統會將 event_ids 判定為重複內容，只保留所接收到的第一個轉換事件。若要確保成功刪除重複資料，event_ids 必須符合以下條件：

相同轉換事件的 event_ids 必須一致：使用者瀏覽到某個網頁時，Pinterest 標籤和 Pinterest API 都會觸發網頁瀏覽轉換事件。兩個轉換事件必須傳回一致的 event_ids，系統才能辨識出這兩個是相同的轉換事件。

不同轉換事件的 event_ids 不得重複：使用者瀏覽到某個網頁時，Pinterest 標籤和 Pinterest API 都會觸發網頁瀏覽轉換事件。當使用者將 T 恤放入購物車，會觸發 Pinterest 標籤和 Pinterest API 傳送 AddToCart 事件。雖然同一事件觸發的 event_ids 必須相同，但頁面瀏覽事件和 AddToCart 事件傳送的 event_ids 不得重複。如此一來，系統才能將其認定為個別事件。

Pinterest 會根據該事件識別碼和 event_name，從記錄中移除所有重複的事件，不過前提是 (a) 事件不是在離線時發生 (action_source 並非離線)，而且 (b) Pinterest 在 48 小時內收到重複的事件。

驗證設定

完成 API 設定後，您可檢視以下項目，驗證是否已成功接收轉換事件：

回應碼：為您設定 API 整合的開發人員可查看轉換事件觸發後，隨各請求傳回的回應碼。

廣告管理員的「重複資料刪除」頁面：重複資料刪除後的轉換事件會顯示在廣告管理員的「重複資料刪除」頁面。查看「重複資料刪除」頁面的步驟如下：

• 登入您的 Pinterest 企業帳號
• 按一下頂端選單中的「廣告」，然後選擇「轉換」
• 選取左側導覽列中的「重複資料刪除」

品質與復原力

復原力是轉換 API 設定的狀態，允許最高層級的訊號比對和歸屬。隨著廣告產業政策不斷變動及發展，這些額外資料有助於我們為您提供更準確的報告。

復原力狀態

復原力狀態有兩類：良好和不良。您的復原力狀態會顯示在廣告管理員的「轉換健全狀態」區段。

復原力良好

選項 1：特定識別碼涵蓋率

標識碼涵蓋率

• 90% 以上的事件應該具備 IP/UA，
• 10% 以上的下層漏斗事件具有雜湊電子郵件或 MAID，
• 10% 以上的事件有外部 ID。

與標籤資料重疊 (如適用)

• 應透過 CAPI 接收 90%* 以上的標籤事件

或：

選項 2：達到基本符合率

CAPI 使用者符合率 60% 以上

與標籤資料重疊 (如適用)

應透過 CAPI 接收 90%* 以上的標籤事件

復原力不良

所有不良的設定。

復原力 ID 和訊號

請傳送以下訊號，以取得有復原力的廣告客戶狀態。

API ID/訊號	權重/排名
Client_ip_address + Client_user_agent	高
em	高
external_id	高
hashed_maid	高
click_id	高
fn + ln	低
ph	低
ge、bd、ct、st、zp、country	低

*根據符合率增加可能性的比重/排名

第三方實作

Pinterest 提供多種第三方整合，能在您採用 API 的過程中為您提供支援。

Google 代碼管理工具 - 伺服器端

將您的 Google 代碼管理工具帳號與 Pinterest 轉換 API 連結，即可瞭解 Pinterest 對您商店流量和產品銷售量的影響。

要使用這項整合，您需透過配合的雲端服務供應商以及具備伺服器端標記的專業知識，以部署伺服器容器。如需深入瞭解相關技術必備條件，請造訪開發人員網站。

Shopify

這項轉換 API 整合功能可讓 Pinterest 標籤更為完善，確保擁有高水準的資料覆蓋率和品質。只要安裝 Shopify 應用程式，不必額外執行其他操作，就能開始運用這項增強功能。您所做的變更會自動套用至商家的商店。

Tealium

有興趣使用 Tealium 的廣告客戶，可透過第三方直接設定轉換 API。Tealium 可建立範本，有助於促進與廣告客戶整合。

Tealium 學習中心提供了相關的實作流程概述。如對實作方式有任何疑問，您可透過 support [at] tealium.com (support[at]tealium[dot]com) 尋求支援。

如果您有興趣瞭解其他任何第三方整合方式，請聯絡銷售代表以取得更多資訊。

有限資料處理簡介

自 2023 年 1 月 1 日起，廣告客戶可善用「有限資料處理」標示，以遵循《加州隱私權法案》修訂的《加州消費者隱私權法案》(合稱為「CCPA」) 相關規範。廣告客戶設下此標示後，Pinterest 會限制特定資料的使用方式，以協助廣告客戶遵循使用者的隱私權設定。舉例而言，廣告客戶可針對根據 CCPA 明確表示不出售或分享個人資料的加州使用者，設下「有限資料處理」標示。廣告客戶使用「有限資料處理」標示後，Pinterest 就會針對所標示的加州使用者資料，依 CCPA 規定履行服務供應商的責任。

廣告客戶有責任尊重使用者不願分享資料的選擇，並在執行「有限資料處理」標示時確認使用者的居住地狀態。