检索区段元数据

当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访问凭据

要进行API调用,您需要客户端ID和密钥。 在集成设置过程中,您可以从集成专家处获取客户端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

在此页面上