市场营销 API

受众类型网址参数

Urchin 追踪模块* (UTM) 是一个标准化的系统，通过目标网址参数传送来自广告点击的信息，以用于分析。这意味着，在用户点击广告时，请求网址中将包含 Google Analytics 等网页插件可提取的参数。

Meta 允许广告主在广告管理工具的广告创建流程中，在追踪部分下的广告层级指定 UTM 参数。通常，如果广告系列允许针对与单个广告组关联的每种受众类型设置多个不同的网址参数，则广告的每个广告系列可以拥有多个广告组。但是，对于进阶赋能型智能购物广告，同时用于再营销和寻找潜在用户的每个广告系列仅拥有一个广告组。

现在，进阶赋能型智能购物广告将支持针对自定义受众类型 — 新受众 (prospecting) 和现有受众 (retargeting) 设置网址参数，以便为广告展示提供更多背景信息。更确切地说，我们允许您为 custom_audience_info 字段配置三 (3) 个值，以启用受众类型网址参数：audience_type_param_name、new_cusomter_tag 和 existing_customer_tag。

仅当设置现有自定义受众后，此功能才可用。完成现有自定义受众设置之后，就可以在进阶赋能型智能购物广告部分图卡的广告账户设置中设置这些参数。

参数

custom_audience_info 字段将扩展 /act_AD_ACCOUNT_ID 节点。

名称描述

custom_audience_info

必要。
值：audience_type_param_name 和 new_customer_tag 或 existing_customer_tag
。为了成功执行 POST 调用，必须添加 audience_type_param_name 和 new_customer_tag 参数或 existing_customer_tag 参数。

custom_audience_info 字段

名称描述

audience_type_param_name

字符串

必要。
值：audience_type
网址的字段名称。应是一个包含字母、数字或下划线的非空字符串。

new_customer_tag

字符串

可选。
值：prospecting
新客户的字段值。应是一个包含字母、数字或下划线的非空字符串。

existing_customer_tag

字符串

可选。
值：retargeting
现有客户的字段值。应是一个包含字母、数字或下划线的非空字符串。

示例

检索自定义受众信息

请求

curl -X GET -G \
  -d 'fields=custom_audience_info' \
  -d 'access_token=ACCESS_TOKEN' \
https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID

响应

{
  "custom_audience_info": {
    "audience_type_param_name": "audience_type",
    "new_customer_tag": "prospecting",
    "existing_customer_tag": "retargeting"
  },
  "id": "act_AD_ACCOUNT_ID"
}

新建自定义受众信息

curl -i -X POST \
  -H 'Content-Type: application/json' \
  -d '{"custom_audience_info": {"audience_type_param_name": "audience_type", "new_customer_tag": "prospecting", "existing_customer_tag": "retargeting"}}' \
  // Note: new_customer_tag and existing_customer_tag are both shown here for example only
  -d 'access_token=ACCESS_TOKEN' \
  https://graph.facebook.com/v19.0/act_AD_ACCOUNT_ID

* Urchin 已被 Google 收购，并转变为 Google Analytics