市场营销 API
返回中文(简体)
文档已更新。
中文(简体) 译文尚未完成。
英语更新时间：2021年5月10日

追踪和转化参数

通过追踪参数，您可以记录用户对您的广告采取的操作。此功能既不会针对某操作优化广告投放，也不会根据发生的操作向您的广告帐户收费。

在市场营销 API v2.3 及更早版本中，转化参数是针对优化千次展示费用的广告设置。这类参数会针对特定操作优化广告投放，并在转化报告中展示这些操作。从 v2.4 开始，conversion_specs 为只读参数。您需要通过广告组层级的 optimization_goal 选择广告投放优化方式。

设置追踪参数

您可结合任何竞价类型和广告创意使用。如要指定追踪参数，您必须在广告中添加名为 tracking_specs 的额外字段。tracking_specs 字段接受与操作参数相同的参数。如要创建广告，请参阅广告创建。

默认追踪参数

下列广告目标将适用默认追踪参数。如果您更改默认参数，则更改会添加到现有参数中，而不是覆盖现有参数。

如果您的目标为 NONE 或 App Install/Engagement Ads，则默认追踪参数将被覆盖。如果您想使用默认参数，则必须将其添加到您的自定义参数中。

您可以在参数中使用字符串或数组标注，如 'APPLICATION_ID' 或 ['APPLICATION_ID']。

  • 千次展示费用表示 billing_event=IMPRESSIONS、optimization_goal=IMPRESSIONS
  • 单次点击费用表示 billing_event=CLICKS、optimization_goal=CLICKS
  • 优化后的千次展示费用表示 billing_event=IMPRESSIONS、optimization_goal 设置为单个操作
  • 单次操作费用表示 billing_event 和 optimization_goal 均设置为单个操作
目标 广告创意，竞价类型 追踪参数 说明

CANVAS_APP_
ENGAGEMENT

应用使用率全屏广告，包含 optimization_goal= APP_INSTALLS 设置

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

请参阅 app_engagement 和 post_engagement 元参数

CANVAS_APP_
INSTALLS

应用安装全屏广告，优化方式未设置为 optimization_goal= APP_INSTALLS

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

请参阅 app_engagement 和 post_engagement 元参数

转化

公共主页帖子链接广告和照片广告，其中已将 promoted_object 设置为某个 Pixel 像素代码编号，且包含 optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

参数设置为帖文互动和公共主页获赞数。特定公共主页帖子链接点击量（如果只有一个链接），帖子收到的互动数量，以及用户发布动态或与主页互动的次数

转化

公共主页帖子链接广告和照片广告，优化方式未设置为 optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

参数设置为转化、帖文互动和公共主页获赞数。特定公共主页帖子链接点击量（如果只有一个链接），帖子收到的互动数量，以及用户发布动态或与主页互动的次数

转化

域广告，其中已将 promoted_object 设置为某 Pixel 像素代码编号，且包含 optimization_goal= OFFSITE_CONVERSIONS 设置

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

参数设置为公共主页获赞数和链接点击量。特定公共主页帖子链接点击量（如果只有一个链接），帖子收到的互动数量，以及用户发布动态或与公共主页互动的次数。

转化

域广告，优化方式未设置为 optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

参数设置为转化、公共主页获赞数和链接点击量。特定公共主页帖子链接点击量（如果只有一个链接），帖子收到的互动数量，以及用户发布动态或与公共主页互动的次数。

EVENT_RESPONSES

活动广告，优化方式未设置为 optimization_goal= EVENT_RESPONSES

[{'action.type':'rsvp' ,
'response':'yes', 'event':'EVENT_ID'},
{'action.type':'rsvp' ,
'response':'maybe', 'event':'EVENT_ID'},
[{'action.type':'rsvp' ,
'response':'no', 'event':'EVENT_ID'}]

活动回复（yes、maybe、no）次数。

EVENT_RESPONSES

活动广告，包含 optimization_goal= EVENT_RESPONSES 设置

空（转化参数将包含追踪的操作）

活动回复（yes、maybe、no）次数。

LINK_CLICKS

使用任意竞价选项的公共主页帖子链接广告和照片广告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

帖文互动。
站外网址链接、包含特定网址域名的链接、公共主页中的站外链接、帖子包含的站外链接获得的点击次数。

LINK_CLICKS

包含 optimization_goal= LINK_CLICKS 设置的域广告

{'action.type':'like',
'page':PAGE_ID}]

公共主页获赞数。
站外网址链接、包含特定网址域名的链接、公共主页中的站外链接、帖子包含的站外链接获得的点击次数。

LINK_CLICKS

优化方式未设置为 optimization_goal= LINK_CLICKS 的域广告

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

网站点击量、公共主页获赞数。
站外网址链接、包含特定网址域名的链接、公共主页中的站外链接、帖子包含的站外链接获得的点击次数。

MOBILE_APP_
ENGAGEMENT

使用任意竞价选项的移动应用互动式广告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
对于应用互动式广告，您必须使用 Facebook 应用编号明确指定追踪参数：
[{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type':
'app_custom_event',
'application':APP_ID}]

请参阅 post_engagement 元参数。此外，还包括应用事件的发生次数。

MOBILE_APP_
INSTALLS

使用任意竞价选项的移动应用安装广告

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
对于应用安装广告，您必须使用 Facebook 应用编号明确指定追踪参数：
[{'action.type':
'app_custom_event',
'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]

请参阅 post_engagement 元参数。此外，还包括用户通过移动应用安装广告安装应用的次数（如果有 iOS/Android 版应用），以及应用事件的发生次数。

无

任何广告类型

请参阅根据广告类型区分的
默认追踪参数

PAGE_LIKES

使用任意竞价类型的公共主页点赞广告或公共主页帖子广告

{'action.type':
'page_engagement', 'page':'PAGE_ID'}

请参阅公共主页互动元参数

POST_ENGAGEMENT

公共主页帖子广告，优化方式未设置为 optimization_goal= POST_ENGAGEMENT

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

请参阅公共主页帖文互动元参数

POST_ENGAGEMENT

公共主页帖子广告，包含 optimization_goal= POST_ENGAGEMENT 设置

空

请参阅公共主页帖文互动元参数

POST_ENGAGEMENT（测试中）

任意

{'action.type':
'dwell',
'post':'POST_ID', 'page':'PAGE_ID'}

一小部分这类广告有 dwell 追踪类型，重点关注在广告中停留的时间最短的用户。

PRODUCT_ CATALOG_SALES

动态商品广告

{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}

特定公共主页帖子的链接点击量（如果只有一个链接）、帖子收到的互动数量、用户发布动态或与公共主页互动的次数。您可以指定与推广对象中的商品系列不同的商品系列，但默认的是您在推广对象中指定的商品系列。

元参数

您可以使用单个参数为单个对象指定多种类型的操作。

对象 转化参数 说明

应用程序

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

用户发布动态 app_story 或通过 app_use、app_install、credit_spent 操作与内容互动的次数。

公共主页

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

用户执行与特定公共主页相关的下列任意操作的次数：签到、评论、关注、为公共主页点赞、为公共主页帖子点赞、提及、在公共主页中发布帖子、分享帖子、回答问题。这还包括用户执行与特定公共主页相关的下列任意操作的次数：点击链接、查看照片、播放 Facebook 原生视频。

公共主页帖子

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

用户执行与特定帖子相关的下列任意操作的次数：评论、关注问题、点赞、分享、回答问题。这还包括用户执行下列任意操作的次数：点击链接、为公共主页点赞、查看照片、播放由 Facebook 托管的视频或内联 Youtube 视频。对于非嵌入式视频，请使用 link_click。

自定义追踪参数

要定义自己专属的追踪参数，请使用操作参数框架。详情请参阅参考文档下的操作参数部分。

操作（对象类型） 说明（追踪参数详情） 追踪或转化参数

app_custom_event（应用程序）

应用程序的自定义事件。
移动应用中发生的自定义事件数量。

{'action.type':
'app_custom_event',
'application':APP_ID}

app_install（应用程序）

安装应用。
全屏广告或移动应用
获得的安装次数

[{'action.type':'app_install',
'application':APP_ID},
{'action.type':
'mobile_app_install',
'application':APP_ID}]

app_use（应用程序）

应用的使用次数。

{'action.type':'app_use',
'application':APP_ID}

checkin（地点）

在某地点签到。
在公共主页的特定地点签到或任何下属地点签到的次数。

{'action.type':'checkin',
'page': PAGE_ID},
{'action.type':'checkin',
'page.parent:PAGE_ID}

comment（帖子）

评论帖子。
任何或特定公共主页帖子获得的评论数量。

{'action.type':'comment',
'post.wall':PAGE_ID},
{'action.type':'comment',
'post':POST_ID,
'post.wall':PAGE_ID}

credit_spend（应用程序）

在应用中花费点数的情况。

'action.type':'credit_spent',
'application':APP_ID}

follow（问题）

订阅某对象。
回答或关注某问题的次数。

{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}

leadgen_quality_conversion（像素）

下层漏斗线索转化 (CRM) 事件。

{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}

like
（公共主页、帖子）

为某对象点赞。
公共主页或帖子获得的点赞数量。

{'action.type':'like',
'page':PAGE_ID}
, {'action.type':'like',
'post.wall':PAGE_ID}
, {'action.type':'like',
'post':POST_ID,
'post.wall':PAGE_ID}

link_click（公共主页、帖子、网址和网址域名）

点击链接。
站外网址链接、包含特定网址域名的链接、公共主页中的站外链接、帖子包含的站外链接获得的点击次数。

{'action.type':['link_click'],
'object':['URL']},
{'action.type':['link_click'],
'object.domain':
['URL_DOMAIN']},
{'action.type':['link_click'],
'post.wall':['PAGE_ID']},
{'action.type':['link_click'],
'post':['POST_ID'],
'post.wall':['PAGE_ID']}

mention（主页）

提及公共主页。
公共主页提及次数。

{'action.type':'mention',
'object':PAGE_ID'}

offsite_conversion（像素）

站外转化的数量和累计收入。

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}

photo_view（公共主页）

查看照片。
公共主页中任何或特定帖子分享的
照片/视频/链接获得的照片查看、video_plays 或 link_clicks 次数。

{'action.type':'photo_view', 'post.wall':PAGE_ID}
{'action.type':'photo_view', 'post':POST_ID,
'post.wall':PAGE_ID}

post（帖子）

分享动态。
用户在公共主页中发帖的次数。

{'action.type':'post',
'post.wall':PAGE_ID}

receive_offer（优惠）

领取优惠。
领取特定优惠的用户数量。

{'action.type':'receive_offer',
'offer':OFFER_ID}

rsvp（活动）

回复活动。
活动回复（yes 和 maybe）次数。有效值包括 yes、maybe 和 no。

{'action.type':'rsvp',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'yes',
'event': EVENT_ID},

{'action.type':'rsvp',
'response':'no',
'event': EVENT_ID},
{'action.type':'rsvp',
'response':'maybe',
'event': EVENT_ID}

tab_view（公共主页）

浏览公共主页选项卡
特定公共主页选项卡的浏览次数。如果您想获得所有选项卡的浏览次数，只需指定相关公共主页即可。

{'action.type':'tab_view',
'page.tab.name':
'PAGE_TAB_NAME', 'page':PAGE_ID},
{'action.type':'tab_view',
'page':PAGE_ID}

video_play（帖子）

观看视频。
公共主页中任何或特定视频帖子获得的视频观看次数。

{'action.type':'video_play', 'post.wall':PAGE_ID},{'action.type':'video_play', 'post':POST_ID,
'post.wall':PAGE_ID}

示例

像素追踪

您可以追踪广告中不同像素的表现，只需在广告的 tracking_specs 字段指定追踪像素即可。例如：

tracking_specs="[
  {'action.type':'offsite_conversion','fb_pixel':1},
  {'action.type':'offsite_conversion','fb_pixel':2},
  {'action.type':'offsite_conversion','fb_pixel':3}
]"

此字段会追踪像素“1”、“2”和“3”的表现。如果您只想针对像素“1”进行优化，请指定父广告组的 promoted_object。如果不仅想要针对 CHECKOUT 进行优化，还想追踪 REGISTRATION 和 ADD_TO_CART 事件的数量，这种方法就很实用。

系统会自动追踪通过在 promoted_object 中指定像素编号进行优化的像素，因此您无需在 tracking_specs 中指定相同的像素。

使用转化参数

conversion_specs 是适用于广告层级的字段。其格式为 {'action.type':'{ACTION}', ... }，其中的每个操作都适用于一个对象。各种广告类型的转化参数示例如下：

广告类型 转化参数

包含社交内容的域广告

{'action.type':'link_click', 'object':'URL'}

公共主页点赞广告

{'action.type':'like', 'page':PAGE_ID}

公共主页帖子链接广告

{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}

其他所有公共主页帖子广告

{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}

活动广告

{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}

优惠广告

{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}

移动应用安装广告

不适用 - 目标为 NONE 时，无法创建这类广告。

移动应用互动式广告

不适用 - 仅支持单次点击费用和千次展示费用竞价类型

应用安装全屏广告

不适用 - 目标为 NONE 时，无法创建这类广告

应用互动式全屏广告

不适用 - 目标为 NONE 时，无法创建这类广告

某些转化参数包含适用于单个对象的多个操作。这些参数即称为元参数。示例如下：

对象 转化参数 说明

公共主页

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

用户在特定公共主页中采取下列操作的次数：签到、评论、关注、为公共主页点赞、为公共主页帖子点赞、提及、在公共主页中发帖、分享帖子、回答问题。这包括用户在特定公共主页中执行下列操作的次数：查看照片、播放 Facebook 原生视频。

公共主页帖子

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

用户在特定公共帖子中采取下列任意操作的次数：评论、关注问题、为公共帖子点赞、分享、领取优惠、回答问题。这还包括用户执行下列操作的次数：点击链接、为公共主页点赞、查看照片、播放由 Facebook 托管的视频或内联 Youtube 视频。对于非嵌入式视频，使用 link_click。

应用程序

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

用户发布 app_story 或以 app_use、app_install 或 credit_spent 操作的形式与内容互动的次数。