擷取區段中繼資料

當Audience Manager傳送區段資訊給資料合作夥伴時,會使用數值ID識別這些物件。 身為資料合作夥伴,當您與客戶共用此資訊(或由您親自處理)時,實際名稱和說明可為報表、控制面板或其他使用者介面(UI)中的客戶提供更好的體驗。 資料合作夥伴可透過本節所述的手動或自動化方法,為客戶提供這些好記的名稱。

手動方法

身為資料合作夥伴,您可能習慣透過手動程式從客戶取得對象中繼資料。 這可能包括附加至電子郵件或來自客戶的檔案,這些檔案會透過您為此目的建立和維護的UI新增該資料。 這些程式可以運作,但通常繁瑣、耗時,而且可能需要手動輸入資料。 這些方法通常可協助讓整合快速啟動及執行,但長期而言無法提供最佳的客戶體驗。 或者,您也可以使用Audience Manager API自動取得區段中繼資料。

自動方法

Audience Manager 提供一組REST API, 可讓您自動擷取區段中繼資料。使用API,您可以建立作業,以排程間隔或自動擷取區段中繼資料,無論何時處理Audience Manager資料並尋找新的區段ID。 如需詳細資訊,請參閱下列步驟。

步驟1:檢閱Audience ManagerAPI

REST API快速入門一節包含有關一般需求、驗證、可用方法等的資訊。 如果您之前未使用Audience Manager API,這是開始使用的好地方。

步驟2:要求OAuth2存取憑證

您需要用戶端ID和密碼才能進行API呼叫。 在整合設定程式期間,您可以向整合專員取得用戶端ID和機密。 您也可以在amsupport@adobe.com向Audience Manager Customer Care發送電子郵件請求。

步驟3:從每個整合的客戶收集客戶特定資訊

向每個整合客戶要求下列事項:

  • 用戶名:這適用於具有與特定整合相關聯之目的地唯讀權限的受限使用者。
  • 密碼:用戶密碼。
  • 目標ID:這是與為特定伺服器對伺服器整合所建立之目標相關聯的ID(整數)。

步驟4:使用API呼叫擷取區段中繼資料

完成上述步驟後,您可以使用GET方法來擷取區段中繼資料。 如需範例要求和回應,請參閱傳回目標對應。 此呼叫會傳回JSON物件中以索引鍵值配對格式的區段資料。 下表列出回應中傳回的部分重要區段屬性。

參數 說明

destinationMappingId

Audience Manager區段ID。

elementName

區段名稱。

elementDescription

簡短說明區段的部分文字。

elementStatus

區段對應的目前狀態。 返回的狀態選項包括:

  • active
  • inactive
  • deleted

本頁內容