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

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

简介

借助 Management API,您可以为 Google Analytics(分析)媒体资源 creategetlistupdatepatch 再营销受众群体。要详细了解再营销受众群体的工作原理,请参阅 Google Analytics(分析)中的再营销受众群体简介这一帮助中心文章。

使用情形

再营销受众群体资源支持 getlistpatchupdate,不过主要还是用于以下情形:

列出再营销受众群体

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

  1. 使用 Management API 或帐号浏览器来获取 accountIdwebPropertyId
  2. 对再营销受众群体资源执行 list 方法。

有关再营销受众群体资源 list 方法的详情,请参阅 API 参考。

创建新的再营销受众群体

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

  1. 使用 Management API 或帐号浏览器来获取 accountIdwebPropertyId
  2. 使用 Management API 或帐号浏览器获取 linkedViews [] 媒体资源的数据视图(配置文件)ID。
  3. 使用 AdWords 关联集合来获取 linkedAdAccounts.linkedAccountId 的 AdWords 帐号 ID。
    • linkedAdAccounts[] 媒体资源目前限制为只能使用一个 linkedForeignAccount
    • linkedAdAccounts[].type 可以设置为 ADWORDS_LINKS
  4. 对于设置 includudeConditionssegment 属性的选项,使用细分集合;如果创建基于状态的受众群体,请为 excludeConditions 进行同样的操作。有关细分的定义,另请参阅细分参考
  5. 对再营销受众群体资源执行 insert 方法。

此 API 允许您创建两种类型的受众群体:SIMPLESTATE_BASED。对于 SIMPLE 受众群体,您只需要在构建 audienceDefinition 时将 segment 设为正值,且不使用 NOT 运算符! 字符)即可。如果您希望加入排除条件,则必须定义 statebasedDefinition;详情请参阅基于状态的受众群体。详细信息请参阅参考示例

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

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

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