正在擷取區段中繼資料 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存取認證

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

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

向每個整合客戶請求下列專案:

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

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

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

參數
說明
destinationMappingId
Audience Manager區段識別碼。
elementName
區段名稱。
elementDescription
簡要說明區段的一些文字。
elementStatus

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

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