再营销受众群体开发者指南

本文介绍了如何使用 Management API 来管理 Google Analytics（分析）再营销受众群体。

注意 ：使用此 API 时，您必须遵守 Google Analytics（分析）广告功能政策，包括有关敏感类别的规则。

简介

借助 Management API，您可以为 Google Analytics（分析）媒体资源 create、get、delete、list、update 和 patch 再营销受众群体。要详细了解再营销受众群体的工作原理，请参阅 Google Analytics（分析）中的再营销受众群体简介这一帮助中心文章。

用例

再营销受众群体资源支持 get、delete、list、patch 和 update，但主要用例如下：

• 列出再营销受众群体。
• 创建新的再营销受众群体。
• 更新现有再营销受众群体。

注意 ：如果您没有启用代码来收集相应的数据，您的再营销受众群体将为空，再营销广告系列无法投放。首先，在 Google Analytics（分析）媒体资源设置中启用广告功能。

列出再营销受众群体

要列出某个媒体资源的所有再营销受众群体，请按以下步骤操作：

1. 使用 Management API 或帐号浏览器检索 accountId 和 webPropertyId。
2. 执行再营销受众群体资源的 list 方法。

请参阅 API 参考文档，详细了解再营销受众群体资源的 list 方法。

创建新的再营销受众群体

要为某个媒体资源创建新的再营销受众群体，请按以下步骤操作：

1. 使用 Management API 或帐号浏览器检索 accountId 和 webPropertyId。
2. 使用 Management API 或帐号浏览器获取 linkedViews [] 媒体资源的数据视图（配置文件）ID。
3. 使用 Google Ads 关联集合来获取 linkedAdAccounts.linkedAccountId 的 Google Ads 帐号 ID。
   • linkedAdAccounts[] 属性目前只能使用一个 linkedForeignAccount。
   • linkedAdAccounts[].type 可以设置为 ADWORDS_LINKS、DBM_LINKS、MCC_LINKS 或 OPTIMIZE。
4. 使用 Segments 集合获取用于设置 includeConditions 的 segment 属性的选项，如果要创建基于状态的受众群体，请为 excludeConditions 执行相同的操作。有关细分的定义，另请参阅细分参考。
   • includeConditions 可以选择性地包含 membershipDurationDays 和 daysToLookBack 的值
   • 可以选择将 excludeConditions.exclusionDuration 设置为 PERMANENT。
5. 对再营销受众群体资源执行 insert 方法。

您可以使用该 API 创建两种类型的受众群体：SIMPLE 和 STATE_BASED。对于 SIMPLE 受众群体，您只需构造包含正 segment 的 audienceDefinition，而不使用 NOT 运算符（! 字符）。如果要添加排除条件，您必须定义 statebasedDefinition；如需了解详情，请参阅基于状态的受众群体。如需了解详情，请参阅参考示例。

注意 ：您可以定义 audienceDefinition 或 stateBasedAudienceDefinition，并将 audienceType 设置为相应的值。对再营销受众群体还有 2000 个这一上限。自动创建再营销受众群体时，请务必谨慎。

更新现有的再营销受众群体

要更新媒体资源现有的再营销受众群体，请按以下步骤操作：

1. 如果您已有再营销受众群体 ID，则可以调用 get；否则，您可以调用 list 并选择要更新的受众群体。
2. 更新所有可写字段，然后调用 update 并传入更新后的受众群体对象。

注意 ：受众群体一经创建，其 audienceType 便无法再更改。换句话说，如果受众群体具有 audienceDefinition 的值，则您无法使用 stateBasedAudienceDefinition 的值调用 update。如需了解详情，请参阅基于状态的受众群体。如需了解详情，请参阅参考示例。