检索区段元数据 retrieving-segment-metadata

當Audience Manager傳送區段資訊給資料合作夥伴時,會使用數值ID識別這些物件。 身為資料合作夥伴,當您和客戶共用此資訊(或自行使用)時,實際的名稱和說明可在報表、儀表板或其他使用者介面(UI)。 資料合作夥伴可透過本節所述的手動或自動化方法,讓客戶可以使用這些易記名稱。

手動方法 manual-method

身為資料合作夥伴,您可能習慣透過手動程式從客戶取得對象中繼資料。 這可能包括附加到電子郵件的檔案,或是來自客戶透過 UI 您已為此目的建置和維護。 這些程式可以運作,但通常很麻煩、耗時,並且可能需要手動輸入資料。 這些方法通常用於協助讓整合快速上線運作,但長期而言無法提供最佳客戶體驗。 另外,您也可以使用 Audience Manager API 以自動取得區段中繼資料。

自動化方法 automated-method

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

步驟1:檢閱Audience ManagerAPI

開始使用REST API 區段包含一般需求、驗證、可用方法等資訊。 如果您尚未使用 Audience Manager API 之前。

步驟2:要求OAuth2存取認證

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

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

向每個整合的客戶請求下列內容:

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

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

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

参数
描述
destinationMappingId
此 Audience Manager 區段ID。
elementName
區段名稱。
elementDescription
簡要說明區段的一些文字。
elementStatus

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

  • active
  • inactive
  • deleted
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695