文件Experience Platform來源連接器指南

[Beta]{class="badge informative"}

Didomi

Last update: Fri Aug 01 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
AVAILABILITY
Didomi來源是測試版。 閱讀來源概觀中的條款與條件，以取得有關使用測試版標籤之來源的詳細資訊。

Didomi是同意和偏好設定管理平台，可協助組織跨網站、應用程式和內部工具收集、管理和強制執行使用者有關個人資料的選擇。

Adobe Experience Platform支援透過來源聯結器系統，從各種外部系統擷取資料，包括雲端儲存空間、資料庫和Didomi等應用程式。 使用來源驗證外部系統、管理流入Experience Platform的資料，並確保以一致的結構化方式擷取您的客戶資料。

使用Didomi來源將來自Didomi同意和偏好設定管理平台的即時使用者同意和偏好設定資料串流到Experience Platform。 透過Didomi來源，您可以在Experience Platform中集中並處理同意資料，藉此保持您的客戶設定檔和下游工作流程相容且為最新狀態。

Didomi資料處理架構。

先決條件

完成下列先決條件步驟，成功將您的Didomi帳戶連線至Experience Platform。

IP位址允許清單

將來源連線至Experience Platform之前，您必須先將區域特定的IP位址新增至允許清單。 如需詳細資訊，請參閱允許清單IP位址以連線至Experience Platform的指南以瞭解詳細資訊。

在Experience Platform上設定許可權

您必須同時為您的帳戶啟用​ 檢視來源 ​和​ 管理來源 ​許可權，才能將您的Didomi帳戶連線至Experience Platform。 請聯絡您的產品管理員以取得必要許可權。 如需詳細資訊，請閱讀存取控制UI指南。

收集Adobe API認證

若要安全地將Didomi連線到Experience Platform，您必須使用您的Adobe API認證進行驗證。 這些憑證對於設定webhook和設定資料擷取至關重要。

閱讀Experience Platform API快速入門的指南，瞭解如何成功呼叫Experience Platform API。

建立Experience Platform結構描述

TIP
如果您已經有現有的XDM結構描述，可以略過此步驟。

Experience Data Model (XDM)結構描述 ​定義了您將從Didomi傳送到Experience Platform的資料結構（例如使用者ID、同意目的）。

若要建立結構描述，請在Experience Platform UI的左側導覽中選取結構描述，然後選取​ 建立結構描述。 接著，選取​ 標準 ​作為結構描述型別，然後選取​ 手動 ​以手動建立欄位。 選取結構描述的基底類別，並提供結構描述的名稱。

建立後，新增任何必填欄位以更新結構。 請確定至少一個欄位是身分欄位，以通知Experience Platform您的主要身分值。 最後，請確定您已啟用設定檔切換功能，才能成功儲存資料。

create-schema

如需詳細資訊，請閱讀在UI中建立結構描述的指南。

建立資料集

TIP
如果您已經有現有的資料集，可以略過此步驟。

Experience Platform中的​ 資料集 ​是用來根據您定義的結構描述儲存傳入的資料。

若要建立資料集，請在Experience Platform UI的左側導覽中選取資料集，然後選取​ 建立資料集。 接著，選取​ 從結構描述建立資料集，然後選取要與新資料集建立關聯的結構描述。

建立資料集

在Didomi主控台上設定HTTP Webhook

Webhooks可讓您訂閱使用者與其同意偏好設定互動時，在Didomi平台上觸發的事件。 當發生相關事件時 — 例如，當使用者給予或撤銷同意時 — Didomi會傳送包含JSON裝載的即時HTTP POST要求至您設定的webhook端點。

didomi-console

為確保與Experience Platform相容，您的webhook必須符合以下要求。

欄位
說明
範例
用戶端密碼
與您的Adobe API認證相關聯的秘密金鑰。
d8f3b2e1-4c9a-4a7f-9b2e-8f1c3d2a1b6e
API金鑰
用於驗證Adobe服務請求的公開API金鑰。
授權型別
應用程式從授權伺服器取得存取權杖的方法。 將此值設定為client_credentials。
client_credentials
範圍
授權範圍會定義應用程式向API提供者請求的特定許可權或存取層級。
openid,AdobeID,read_organizations,additional_info.projectedProductContext,session
驗證標頭
Adobe權杖請求所需的其他標頭。
{"Content-type": "application/x-www-form-urlencoded"}
權杖URL
您的Adobe權杖端點。
https://ims-na1.adobelogin.com/ims/token/v3
端點 URL
最終的Adobe聯結器URL （于設定結束時提供）。
https://dcs.adobedc.net/collection/your-adobe-endpoint-id

接下來，為您的webhook設定下列選項。

欄位
說明
值
請求標頭
webhook的自訂標頭。 確定您包含x-adobe-flow-id。 您可以在建立資料流後擷取此值。
{"Content-Type": "application/json", "Cache-Control": "no-cache", "x-adobe-flow-id": "{DATAFLOW_ID}"}
Flatten
必須檢查此屬性，因為它確保webhook資料會以一般物件傳送。
啟用
事件型別
選取應觸發Didomi的event.*事件特定群組（user.*或webhook）。 使用event.*追蹤同意或偏好設定變更，並使用user.*追蹤使用者設定檔更新。 需要選取此專案，才能確保只將相容的事件傳送至Adobe。 Adobe僅支援每個資料流一個結構描述，因此選取這兩種事件型別可能會導致擷取錯誤。

支援的事件型別清單包括：

  • Event.created
  • Event.updated
  • Event.deleted
  • User.created
  • User.updated
  • User.deleted

下載範例裝載檔案 download-the-sample-payload-file

根據您選取的事件群組，直接從​ 主控台下載適當的 ​範例裝載檔案Didomi。 此檔案代表資料結構，並將在Adobe的結構描述和對應步驟中使用。

事件群組
要下載的範例檔案
篩選選項
event.*
下載event.created的範例
僅篩選event.*個事件
user.*
下載user.created的範例
僅篩選user.*個事件

將您的Didomi帳戶連線至Experience Platform

閱讀連線 Didomi 至Experience Platform的指南，瞭解如何建立來源連線，以及將Didomi的同意和偏好設定資料擷取至Experience Platform。

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089