您可以通过此 API 在 Facebook 上轻松创建、衡量和优化视频及轮播广告。请参阅 Facebook for Business 下的“轮播广告”部分。如需获取广告支持的视频格式,请参阅广告主帮助中心下的“视频”部分。
如需在 VIDEO_VIEWS
目标中创建视频广告并优化竞价以覆盖更多受众,请按以下步骤操作:
使用现有视频编号以及上传到 Facebook 的视频创建视频广告。
您需要:
pages_read_engagement
和 ads_management
权限act_{ad-account-id}/advideos
端点的视频
curl \
-F 'name=Sample Creative' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
如需面向新兴市场中的非智能手机扩大或推出品牌营销活动,或要创建简单的视频,请尝试使用图像幻灯片(需要至少 3 张图像)。将图像上传到视频素材中。例如:
curl \
-F 'slideshow_spec={
"images_urls": [
"<IMAGE_URL_1>",
"<IMAGE_URL_2>",
"<IMAGE_URL_3>"
],
"duration_ms": 2000,
"transition_ms": 200
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph-video.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/advideos
Open In Graph API Explorer
将 objective 设为 VIDEO_VIEWS
:
curl -X POST \
-F 'name="Video Views campaign"' \
-F 'objective="OUTCOME_ENGAGEMENT"' \
-F 'status="PAUSED"' \
-F 'special_ad_categories=[]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/campaigns
Open In Graph API Explorer
请参阅参考文档:广告系列、以 PHP 编写的广告目标和以 Python 编写的广告目标。
如果您的目标是得到最低的单次观看费用,则应将广告系列的视频播放量目标与广告组的 optimization_goal=THRUPLAY
配对。您可以将 bidding_event
设为 IMPRESSIONS
或 THRUPLAY
,按展示次数或视频观看量支付费用。请参阅 CPV 竞价。
curl \
-F 'name=A CPV Ad Set' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'daily_budget=500' \
-F 'start_time=2024-05-06T04:45:29+0000' \
-F 'end_time=2024-06-06T04:45:29+0000' \
-F 'billing_event=THRUPLAY' \
-F 'optimization_goal=THRUPLAY' \
-F 'bid_amount=100' \
-F 'targeting={
"device_platforms": ["mobile"],
"geo_locations": {"countries":["US"]},
"publisher_platforms": ["facebook"]
}' \
-F 'status=PAUSED' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adsets
Open In Graph API Explorer
相较针对视频观看量优化的覆盖和频次购买的 CPV 而言,具有 optimization_goal=THRUPLAY
的广告组的单次观看费用较低。结束日期必须为将来的日期。请参阅参考资料:广告组。
使用现有广告组和广告创意:
curl -X POST \
-F 'name="My Ad"' \
-F 'adset_id="<AD_SET_ID>"' \
-F 'creative={
"creative_id": "<CREATIVE_ID>"
}' \
-F 'status="PAUSED"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads
Open In Graph API Explorer
如果广告系列目标为 VIDEO_VIEWS
,则广告会默认获取合适的追踪参数,这些参数定义了针对广告追踪的操作。例如,视频观看量:
{'action.type':'video_view','post':'POST_ID','post.wall':'PAGE_ID'}
请参阅广告管理工具:我的广告系列和参考资料:广告。
如需创建视频广告,以便提升品牌知名度,请参阅品牌知名度博客。
要让视频覆盖更多人,请将广告系列的视频观看量目标设为覆盖和频次。您需要创建预估并加以保存,然后将其分配到广告组。
遵循视频观看量创建中的步骤操作,但将覆盖和频次应用于广告组。额外指定以下参数:
-F "rf_prediction_id=<RESERVATION_ID>" \
为鼓励用户从了解某个品牌转变为使用某个品牌,请参阅轮播广告格式的视频创意。
视频广告再营销能为广告主提供支持,帮助其使用 Facebook 和 Instagram 上的原生视频或付费视频定位特定自定义受众。使用此功能将用户从了解某个品牌推向更深的营销漏斗目标,例如喜爱并考虑加以使用。请参阅研究:有效创意组合。
您需要在包含视频的公共主页上拥有广告主权限才能针对该视频创建受众。
对于受众,请设置 subtype=ENGAGEMENT
。然后编写适用于要创建的受众的规则。每条规则都有一个 object_id
(例如,视频编号)和 event_name
。event_name
可以是以下其中一项:
video_watched
:用户观看视频总计至少 3 秒或几乎看完的次数,以先发生的情况为准。video_completed
:视频观看进度达 95% 的次数,包括跳跃播放到这一进度的次数。video_view_10s
:用户观看视频至少 10 秒的次数,时长不足 10 秒的视频几乎被看完的情况也计算在内。 video_view_15s
:用户观看视频总计至少 15 秒或几乎看完的次数,以先发生的情况为准。video_view_25_percent
:视频观看进度达 25% 的次数,包括跳跃播放到这一进度的次数。video_view_50_percent
:视频观看进度达 50% 的次数,包括跳跃播放到这一进度的次数。video_view_75_percent
:视频观看进度达 75% 的次数,包括跳跃播放到这一进度的次数。您可以组合使用视频,根据各种视频和操作创建受众。例如,受众可以包含观看视频 A 达 3 秒的用户,以及看完视频 B 和 C 的用户。
以下代码将创建由过去 14 天观看视频 1 达 3 秒以上的用户,以及看完视频 2 的用户组成的受众。由于设置了 prefill=true
,所以系统会在创建受众前,自动将其填充为观看者。
curl \
-F 'name=Video Ads Engagement Audience' \
-F 'subtype=ENGAGEMENT' \
-F 'description=Users who watched my video' \
-F 'prefill=1' \
-F 'rule=[
{"object_id":"%video_id_1","event_name":"video_watched"},
{"object_id":"%video_id_2","event_name":"video_completed"}
]' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/customaudiences
Open In Graph API Explorer
2015 年 10 月 16 日以后的视频观看量支持回填。
具有行动号召 (CTA) 的视频可提示用户了解详情并访问网站上的特定页面。如果主要目标是提升视频观看量或品牌知名度,且次要目标是提升站外点击量,此功能可改善广告效果。您应为后者应用视频链接式广告。行动号召 (CTA) 的呈现方式:
您仅可将具有行动号召 (CTA) 的视频用于以下广告目标:
PAGE_LIKES
LINK_CLICKS
CONVERSIONS
VIDEO_VIEWS
BRAND_AWARENESS
请参阅将视频扩展用于其他目标。以下代码将创建具有 GET_DIRECTIONS
行动召唤的视频广告:
curl \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"video_data": {
"call_to_action": {
"type": "GET_DIRECTIONS",
"value": {
"link": "fbgeo:\/\/37.48327, -122.15033, \"1601 Willow Rd Menlo Park CA\""
}
},
"image_url": "<THUMBNAIL_URL>",
"link_description": "Come check out our new store in Menlo Park!",
"video_id": "<VIDEO_ID>"
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
详细了解视频在 Facebook 上的表现,并更明智地做出关于视频内容的决策。我们目前仅提供用户开始观看视频情况下的指标。其中包括视频观看量、独立视频观看量、平均视频观看时长以及受众留存率。了解用户在视频的哪个部分停止观看,以及用户可能认为哪些部分最有意思。
使用广告成效分析 API。响应包含各种视频指标。
检索按视频类型(例如自动播放视频、点击播放视频)分组的视频广告统计数据。在 action_breakdowns
中加入 action_video_type
。action_video_type
的预期值为 total
、click_to_play
和 auto_play
。
我们目前正在对 action_video_type
选项进行小范围测试。如要通过细分数据确定客户,请查看广告账户的 CAN_USE_VIDEO_METRICS_BREAKDOWN
。
curl -G \
-d 'action_breakdowns=action_video_type' \
-d 'date_preset=last_30_days' \
-d 'fields=actions,video_avg_pct_watched_actions,video_complete_watched_actions' \
-d 'access_token= <ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/insights
Open In Graph API Explorer
响应包含 action_type
设置为 video_view
并包含 action_video_type
键的多个对象:
{ "data": [ { "actions": [ ... { "action_type": "video_play", "value": 9898 }, { "action_type": "video_view", "action_video_type": "total", "value": 921129 }, { "action_type": "video_view", "action_video_type": "auto_play", "value": 915971 }, { "action_type": "video_view", "action_video_type": "click_to_play", "value": 5158 } ], "video_avg_pct_watched_actions": [ { "action_type": "video_view", "action_video_type": "total", "value": 60.59 }, { "action_type": "video_view", "action_video_type": "auto_play", "value": 60.47 }, { "action_type": "video_view", "action_video_type": "click_to_play", "value": 80.63 } ], "video_complete_watched_actions": [ { "action_type": "video_view", "action_video_type": "total", "value": 156372 }, { "action_type": "video_view", "action_video_type": "auto_play", "value": 154015 }, { "action_type": "video_view", "action_video_type": "click_to_play", "value": 2357 } ], "date_start": "2014-12-26", "date_stop": "2015-03-25" } ], "paging": { "cursors": { "before": "MA==", "after": "MA==" } } }
请参阅广告成效分析 API
在动态中提供更多创意空间,引导用户前往网站或移动应用,实现转换。您可通过两种方式创建轮播广告:
Facebook 快拍不支持轮播广告。
在创建广告创意的同时创建轮播广告公共主页帖子。在 object_story_spec
中指定公共主页帖子内容,该参数根据 adcreatives
创建公共主页隐藏帖。请参阅广告创意。例如:
curl \
-F 'name=Sample Creative' \
-F 'object_story_spec={
"link_data": {
"child_attachments": [
{
"description": "$8.99",
"image_hash": "<IMAGE_HASH>",
"link": "https:\/\/www.link.com\/product1",
"name": "Product 1",
"video_id": "<VIDEO_ID>"
},
{
"description": "$9.99",
"image_hash": "<IMAGE_HASH>",
"link": "https:\/\/www.link.com\/product2",
"name": "Product 2",
"video_id": "<VIDEO_ID>"
},
{
"description": "$10.99",
"image_hash": "<IMAGE_HASH>",
"link": "https:\/\/www.link.com\/product3",
"name": "Product 3"
}
],
"link": "<URL>"
},
"page_id": "<PAGE_ID>"
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
响应为创意编号:
{"id":"<CREATIVE_ID>"}
创建公共主页隐藏帖。child_attachments
是链接对象数组。在每个链接对象中,picture
、name
和 description
是非必要项。只需拥有公共主页访问口令就能在公共主页上发布这些内容。
curl -X GET \
-d 'message="Browse our latest products"' \
-d 'published=0' \
-d 'child_attachments=[
{
"link": "<APP_STORE_URL>",
"name": "Product 1",
"description": "$4.99",
"image_hash": "<IMAGE_HASH>"
},
{
"link": "<APP_STORE_URL>",
"name": "Product 2",
"description": "$4.99",
"image_hash": "<IMAGE_HASH>"
},
{
"link": "<APP_STORE_URL>",
"name": "Product 3",
"description": "$4.99",
"image_hash": "<IMAGE_HASH>"
},
{
"link": "<APP_STORE_URL>",
"name": "Product 4",
"description": "$4.99",
"image_hash": "<IMAGE_HASH>"
}
]' \
-d 'caption="WWW.EXAMPLE.COM"' \
-d 'link="http://www.example.com/products"' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<PAGE_ID>/posts
Open In Graph API Explorer
然后,借助公共主页隐藏帖提供广告创意。将 id
用作广告创意中的 object_story_id
。
curl -X POST \
-F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
视频轮播广告可在子附件中加入“说明”,用于自定义结束画面中的显示网址:
"child_attachments": [ { "link": "https://www.facebookmarketingdevelopers.com/", "name": "Facebook Marketing Developers", "description": "Facebook Marketing Developers", "call_to_action": { "type": "APPLY_NOW", "value": { "link_title": "Facebook Marketing Developers" } }, "video_id": "123", "caption": "mycustomlinkcaption.com" }, ]
如需获取子附件的详细信息,请使用编号并参阅图谱 API > 视频 > 参考文档以执行调用。
限制:
child_attachment
中指定相同的应用商店链接。您不必在 call_to_action:{'value':{'link':... }}}
中再次指定该链接例如,如需创建轮播广告以提升移动应用安装量:
\
curl -X POST \
-F 'name="Carousel app ad"' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"link_data": {
"message": "My message",
"link": "http://www.example.com/appstoreurl",
"caption": "WWW.ITUNES.COM",
"name": "The link name",
"description": "The link description",
"child_attachments": [
{
"link": "http://www.example.com/appstoreurl",
"image_hash": "<IMAGE_HASH>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {
"app_link": "<DEEP_LINK>"
}
}
},
{
"link": "http://www.example.com/appstoreurl",
"image_hash": "<IMAGE_HASH>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {
"app_link": "<DEEP_LINK>"
}
}
},
{
"link": "http://www.example.com/appstoreurl",
"image_hash": "<IMAGE_HASH>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {
"app_link": "<DEEP_LINK>"
}
}
},
{
"link": "http://www.example.com/appstoreurl",
"image_hash": "<IMAGE_HASH>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {
"app_link": "<DEEP_LINK>"
}
}
}
],
"multi_share_optimized": true
}
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
您只能以与相关移动应用关联的 Facebook 公共主页的身份发布帖子。而且,您必须使用公共主页访问口令。
curl \
-F 'message=My description' \
-F 'link=<APP_STORE_URL>' \
-F 'caption=WWW.ITUNES.COM' \
-F 'child_attachments=[
{
"link": "<APP_STORE_URL>",
"image_hash": "<IMAGE_HASH_I>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"}
}
},
{
"link": "<APP_STORE_URL>",
"image_hash": "<IMAGE_HASH_I>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"}
}
},
{
"link": "<APP_STORE_URL>",
"image_hash": "<IMAGE_HASH_I>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"}
}
},
{
"link": "<APP_STORE_URL>",
"image_hash": "<IMAGE_HASH_I>",
"call_to_action": {
"type": "USE_MOBILE_APP",
"value": {"app_link":"<DEEP_LINK_I>","link_title":"<LINK_TITLE_I>"}
}
}
]' \
-F 'multi_share_optimized=1' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/<PAGE_ID>/feed
使用响应中的 id
创建广告创意:
curl -X POST \
-F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
下方是 iOS 上的轮播广告,显示了所述字段的显示效果。
名称 | 描述 |
---|---|
类型:对象 | 轮播广告所需的链接对象数组,包含 2-10 个元素。您至少应使用 3 个对象才能获得最佳表现;2 个对象可实现轻量级集成,且使用 2 个对象可获得次优广告成效。 |
类型:字符串 | 帖子随附的链接网址或应用商店网址。必要。 |
类型:网址 | 与链接关联的预览图像。宽高比为 1:1 并达到 458x458 像素的最低要求即可获得最佳显示效果。必须指定 |
类型:字符串 | 与图库中链接关联的预览图像的哈希值;使用 1:1 宽高比且达到 458x458 像素的最低要求时可获得最佳显示效果。必须指定 |
类型:字符串 | 链接预览的标题。如果未指定,则会使用关联公共主页的标题。通常只截取前面 35 个字符。您应设置唯一的 |
类型:字符串 | 价格、折扣或网站网域。如果未指定,则会提取并使用来自关联公共主页的内容。通常只截取前面 30 个字符。 |
类型:对象 | 可选的行动号召。请参阅行动号召。您无需在 |
类型:字符串 | 广告视频的编号。可用于任何子元素中。如果已指定,则必须同时设置 |
类型:字符串 | 帖子的正文,也称为状态消息。 |
类型:字符串 | “查看更多”链接的网址。必要。 |
类型:字符串 | 在“查看更多”链接中显示的网址。不适用于移动应用轮播广告 |
类型:布尔值 | 如果设置为 |
类型:布尔值 | 如果设置为 |
使用 actions_breakdown=['action_carousel_card_id', 'action_carousel_card_name']
按每个商品分组轮播广告操作。每个 child_attachment
都有不同的图卡编号。action_carousel_card_id
和 action_carousel_card_name
仅可用于轮播广告。
按卡获取以下统计数据:
website_ctr
:指定 fields=['website_ctr']
时可用app_install
、app_use
、apps.uses
、credit_spent
、mobile_app_install
、tab_view
、link_click
、mobile_app_install
、app_custom_event.*
、offsite_conversion.*
:指定 fields=['actions']
时可用。不可对卡细分数据执行其他操作。
curl -G \
-d 'action_breakdowns=["action_type","action_carousel_card_id"]' \
-d 'level=ad' \
-d 'date_preset=last_30_days' \
-d 'time_increment=all_days' \
-d 'breakdowns=placement' \
--data-urlencode 'filtering=[
{
"field": "action_type",
"operator": "IN",
"value": ["link_click"]
}
]' \
-d 'fields=impressions,inline_link_clicks,actions,website_ctr' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/insights
Open In Graph API Explorer
响应:
{ ... "website_ctr": [ { "action_carousel_card_id": "1", "action_type": "link_click", "value": 51.401869158878 }, { "action_carousel_card_id": "2", "action_type": "link_click", "value": 50.980392156863 } ], "placement": "mobile_feed", "date_start": "2015-05-25", "date_stop": "2015-05-28" }
您还可请求 cost_per_action_type
,按操作类型获取成本细分数据:
curl -G \
-d 'action_breakdowns=["action_type","action_carousel_card_name"]' \
-d 'level=ad' \
-d 'breakdowns=placement' \
-d 'fields=impressions,campaign_name,cost_per_action_type' \
-d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/insights
Open In Graph API Explorer
响应示例:
{ "data": [ { "impressions": "1862555", "campaign_name": "My Campaign", "cost_per_action_type": [ { "action_carousel_card_name": "My Carousel Card 1", "action_type": "app_custom_event.fb_mobile_activate_app", "value": 0.093347346315861 }, { "action_carousel_card_name": "My Carousel Card 2", "action_type": "app_custom_event.fb_mobile_activate_app", "value": 0.38324089579301 }, ... ], } ] }
action_report_time=impression
轮播广告细分数据指标有误。 action_report_time=conversion
轮播广告细分数据指标有误。如果您仅选择 right_hand_column
作为版位,则只能在广告组中使用单个视频或轮播广告格式。我们不支持仅选择了一个 right_hand_column
版位的视频格式。请参阅高级定位和版位。
例如,创建一个广告组并使用 right_hand_column
作为唯一版位:
curl \
-F 'name=RHS only Ad Set' \
-F 'campaign_id=<CAMPAIGN_ID>' \
-F 'daily_budget=500' \
-F 'start_time=2017-11-21T15:41:36+0000' \
-F 'end_time=2017-11-28T15:41:36+0000' \
-F 'billing_event=IMPRESSIONS' \
-F 'optimization_goal=LINK_CLICKS' \
-F 'bid_amount=100' \
-F 'targeting={
"device_platforms": ["mobile"],
"geo_locations": {"countries":["US"]},
"publisher_platforms": ["facebook"] ,
"facebook_positions": ["right_hand_column"] ,
}' \
-F 'status=PAUSED' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adsets
Open In Graph API Explorer
提供包含视频的广告创意:
curl \
-F 'name=Sample Creative' \
-F 'object_story_spec={
"page_id": "<PAGE_ID>",
"video_data": {"image_url":"<THUMBNAIL_URL>","video_id":"<VIDEO_ID>"}
}' \
-F 'access_token=ACCESS_TOKEN' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
或为广告创意提供全屏广告格式:
curl \
-F 'image_hash=<IMAGE_HASH>' \
-F 'object_story_spec={
"link_data": {
"call_to_action": {"type":"LEARN_MORE"},
"image_hash": "<IMAGE_HASH>",
"link": "CANVAS_LINK",
"name": "Creative message"
},
"page_id": "<PAGE_ID>"
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/adcreatives
Open In Graph API Explorer
如果您尝试借助广告组和广告创意创建广告,请使用以下代码:
curl \
-F 'name=My Ad' \
-F 'adset_id=<AD_SET_ID>' \
-F 'creative={"creative_id":"<CREATIVE_ID>"}' \
-F 'status=ACTIVE' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0
/act_<AD_ACCOUNT_ID>/ads
Open In Graph API Explorer
如果收到错误代码,则应提供支持的创意或更改目标受众。