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