本文介绍了如何使用 Management API 来管理 Google Analytics(分析)再营销受众群体。
简介
借助 Management API,您可以为 Google Analytics(分析)媒体资源 create
、get
、list
、update
和 patch
再营销受众群体。要详细了解再营销受众群体的工作原理,请参阅 Google Analytics(分析)中的再营销受众群体简介这一帮助中心文章。
使用情形
再营销受众群体资源支持 get
、list
、patch
和 update
,不过主要还是用于以下情形:
列出再营销受众群体
要列出某个媒体资源的所有再营销受众群体,请按以下步骤操作:
- 使用 Management API 或帐号浏览器来获取
accountId
和webPropertyId
。 - 对再营销受众群体资源执行
list
方法。
有关再营销受众群体资源 list
方法的详情,请参阅 API 参考。
创建新的再营销受众群体
要为某个媒体资源创建新的再营销受众群体,请按以下步骤操作:
- 使用 Management API 或帐号浏览器来获取
accountId
和webPropertyId
。 - 使用 Management API 或帐号浏览器获取
linkedViews []
媒体资源的数据视图(配置文件)ID。 - 使用 AdWords 关联集合来获取
linkedAdAccounts.linkedAccountId
的 AdWords 帐号 ID。linkedAdAccounts[]
媒体资源目前限制为只能使用一个linkedForeignAccount
。linkedAdAccounts[].type
可以设置为ADWORDS_LINKS
。
- 对于设置
includudeConditions
的segment
属性的选项,使用细分集合;如果创建基于状态的受众群体,请为excludeConditions
进行同样的操作。有关细分的定义,另请参阅细分参考。- 可以选择为
includeConditions
设置membershipDurationDays
和daysToLookBack
值 - 可以选择将
excludeConditions.exclusionDuration
设为PERMANENT
。
- 可以选择为
- 对再营销受众群体资源执行
insert
方法。
此 API 允许您创建两种类型的受众群体:SIMPLE
和 STATE_BASED
。对于 SIMPLE
受众群体,您只需要在构建 audienceDefinition
时将 segment
设为正值,且不使用 NOT 运算符(!
字符)即可。如果您希望加入排除条件,则必须定义 statebasedDefinition
;详情请参阅基于状态的受众群体。详细信息请参阅参考示例。
更新现有的再营销受众群体
要更新媒体资源现有的再营销受众群体,请按以下步骤操作:
- 如果已有再营销受众群体 ID,可以调用
get
,否则可以调用list
,并选择要更新的受众群体。 - 更新所有可写字段,然后调用
update
并传递更新的受众群体对象。