市场营销 API

Reels 广告

创建以可用 Reels 版位为重点的 Meta 广告，了解我们广告运营的最佳实践。

前提条件

  • 您之前已创建 Facebook 应用
  • 您了解市场营销 API 并已启用 Facebook 登录

如果您不满足这些前提条件，请参阅我们的开发者文档。

沙盒测试

Meta 提供了一个测试环境，此环境实际上并不支持投放广告，但您可以在其中执行以下操作：

  • 在“工具”部分，将市场营销 API 作为产品添加到 Meta 应用中，以便使用我们的 API 创建和编辑广告，无需支付任何费用
  • 创建广告账户以使用市场营销 API

阅读我们的测试最佳实践。

第 1 步：访问资产

访问口令是识别用户、应用或公共主页的非明文字符串，应用可用访问口令来执行图谱 API 调用。您可查看口令的过期时间及生成口令的应用。Meta 应用上的市场营销 API 调用需要包含访问口令。

获取具有必要权限的访问口令：

  • ads_management：在选定的广告账户中更改

  • ads_read：读取广告数据

  • read_insights：读取表现成效分析

使用系统访问口令，因为它们的有效期更长。

其他授权层

要访问市场营销 API 端点，您需要创建业务应用。业务应用需要额外一层图谱 API 授权，即访问级别。在应用审核期间，您的应用还必须请求特定的权限和功能。如果使用您应用的用户在该应用中没有身份，或在已认领该应用的企业中没有身份，则您必须先完成公司验证。

如果您的应用正在管理其他用户的广告账户，则需要：

  • ads_read 的高级访问级别

及/或

  • ads_management 的高级访问级别

第 2 步：获取广告账户

获取您广告主的广告账户，并允许他们选择用于创建广告的账户。

通过我们的业务管理 API，您可以查看企业可以访问的所有广告账户。这将返回企业拥有的所有广告账户。请注意，您需要拥有应用和用户级别的 business_management 权限。请参阅业务资产管理 API。

调用示例

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/v21.0/<BUSINESS_ID>/owned_ad_accounts"

第 3 步：创建广告系列

广告系列是广告账户中最高级别的组织结构，代表广告主的单个目标。这些对象包含您的广告目标和一个或多个广告组。这有助于优化和衡量每个广告目标的成效。请点击此处详细了解如何创建、阅读、更新和删除广告系列。

调用示例

curl -X POST \
  -F 'name="My campaign"' \
  -F 'objective="OUTCOME_TRAFFIC"' \
  -F 'status="PAUSED"' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/campaigns

第 4 步：目标定义

要使广告主能够触及特定群体，请在 API 请求中指定以下参数：

  • 人口统计数据（年龄、性别、地点）
  • 兴趣爱好
  • 行为

这样就能触及最有可能对您的产品或服务感兴趣的潜在客户。

调用示例

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=My Custom Audience' \
  -F 'subtype=CUSTOM' \
  -F 'description=People who live in New York, aged 25-40, interested in technology' \
  -F 'customer_file_source=USER_PROVIDED_ONLY' \
  -F 'targeting_spec={
        "geo_locations": {
          "countries": ["US"],
          "regions": [{"key": "4081"}]  # New York region key
        },
        "age_min": 25,
        "age_max": 40,
        "interests": [{"id": "6003139266461", "name": "Technology"}]
      }' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/customaudiences

第 5 步：创建广告组

广告组可以有一个或多个广告。广告组中包含的所有广告应具有相同的目标受众设置、预算、收费、优化目标和时长。

您可以设置预算、排期、定位、出价策略和版位选项。广告组允许微调广告如何以及在何处投放给特定受众群体，从而优化效果并实现营销目标。

关键参数：

  • 受众定位标准
  • 单日预算或总预算
  • 用于控制广告展示时间的排期选项

更多完整信息请点击此处。

您可以选择包含 Instagram 和 Facebook Reels 广告的手动版位，或默认选择自动版位。如果您没有为某个特定的版位字段指定内容，系统会甄选该字段的所有可能默认位置。

调用示例

curl -X POST \
  -F 'access_token=YOUR_ACCESS_TOKEN' \
  -F 'name=Reels Ad Set' \
  -F 'campaign_id=YOUR_CAMPAIGN_ID' \
  -F 'daily_budget=5000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=REACH' \
  -F 'start_time=2024-07-10T10:00:00-0700' \
  -F 'end_time=2024-07-20T10:00:00-0700' \
  -F 'targeting={"geo_locations":{"countries":["US"]},"age_min":18,"age_max":65}' \
  -F 'promoted_object={"page_id":"YOUR_PAGE_ID"}' \
  -F 'status=PAUSED' \
  -F 'instagram_actor_id=YOUR_INSTAGRAM_ACTOR_ID' \
  -F 'publisher_platforms=["instagram"]' \
  -F 'instagram_positions=["reels"]' \
  https://graph.facebook.com/v21.0/act_YOUR_AD_ACCOUNT_ID/adsets

版位定位：Reels 可用位置、相容的目标和优化目标

publisher_platformsfacebook_position 或 instagram position相容的目标optimization_goal
instagram

reels、profile_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

instagram

reels、profile_reels

 OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

instagram

reels、profile_reels

 OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

instagram

reels、profile_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

VISIT_INSTAGRAM_PROFILE

instagram

reels、profile_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

POST_ENGAGEMENT

REACH

IMPRESSIONS

REMINDERS_SET

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

instagram

reels、profile_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

facebookfacebook_reels

OUTCOME_APP_PROMOTION

LINK_CLICKS

OFFSITE_CONVERSIONS

APP_INSTALLS

facebookfacebook_reels

OUTCOME_AWARENESS

REACH

IMPRESSIONS

AD_RECALL_LIFT

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

facebookfacebook_reels

OUTCOME_LEADS

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

LEAD_GENERATION

QUALITY_LEAD

facebookfacebook_reels

OUTCOME_TRAFFIC

LINK_CLICKS

LANDING_PAGE_VIEWS

REACH

CONVERSATIONS

IMPRESSIONS

QUALITY_CALL

facebookfacebook_reels

OUTCOME_ENGAGEMENT

CONVERSATIONS

LINK_CLICKS

THRUPLAY

TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

POST_ENGAGEMENT

REACH

IMPRESSIONS

EVENT_RESPONSES

QUALITY_CALL

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

PAGE_LIKES

facebookfacebook_reels

OUTCOME_SALES

OFFSITE_CONVERSIONS

LANDING_PAGE_VIEWS

LINK_CLICKS

REACH

IMPRESSIONS

CONVERSATIONS

QUALITY_CALL

限制

相容的目标 + optimization_goal 组合 Facebook Reels 符合条件吗？ Instagram 符合条件吗？

OUTCOME_AWARENESS + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_TRAFFIC + VISIT_INSTAGRAM_PROFILE

❌

✅

OUTCOME_TRAFFIC + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + TWO_SECOND_CONTINUOUS_VIDEO_VIEWS

✅

❌

OUTCOME_ENGAGEMENT + EVENT_RESPONSES

✅

❌

OUTCOME_ENGAGEMENT + REMINDERS_SET

❌

✅

OUTCOME_ENGAGEMENT + QUALITY_CALL

✅

❌

OUTCOME_ENGAGEMENT + PAGE_LIKES

✅

❌

OUTCOME_SALES + QUALITY_CALL

✅

❌

第 6 步：选择创意

广告创意是广告的视觉和文本组成部分，支持以下广告格式：

  • 图片
  • 视频
  • 轮播
  • 实现自定义广告设计

使用我们的创意流程自动化设计元素并优化效果。

重新利用现有 Reels 作为广告创意

用户可以提供新资产或重新利用 Instagram 账户中现有 Reels 作为广告创意。

您可以使用现有的符合推广条件的自然 Instagram 或 Facebook Reels 创建广告，只要这些广告满足以下条件：

  • 不到 90 秒
  • 具有全屏 (9:16) 垂直宽高比
  • 不含第三方受版权保护的音乐、GIF、互动贴图或相机滤镜
  • 未分享到 Facebook

如要将自然 Instagram Reels 重新用作新广告系列的广告创意，请完成以下步骤：

  1. 获取 Instagram 业务账户编号，该编号需要连接到 Facebook 公共主页

    • GET/{ad_account_id}/connected_instagram_accounts或
    • GET/{business_id}/instagram_business_accounts

  2. 找到您想要推广的 Reels

    • GET/{ig-business-account-user-id}/media

  3. 提供广告创意

    • 与其在创意规范中指定 instagram_actor_id，不如将 instagram_user_id 设置为 Instagram 用户编号
    • 将 source_instagram_media_id 指定为素材编号
    • （可选）更新您推广活动的 call_to_action

使用 boost_eligibility_info字段作为一种方便高效的方式，来确定资产是否符合以广告形式速推的条件，还可以使用 boost_ads_list 来追踪与相应广告相关的速推后 Instagram 广告信息。

调用示例

curl -i -X POST \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT>/adcreatives?object_id=<PAGE_ID>
&instagram_user_id=<IG_USER_ID>
&source_instagram_media_id=<IG_ORGANIC_MEDIA_ID>
&call_to_action="{'type':'LEARN_MORE','value':{'link': '<YOUR_LINK>'}}"
&access_token=<API_ACCESS_TOKEN>

Gen AI 创意工具箱

您可以自动生成生动多样化的广告元素，例如：图片、视频和文字。这些 AI 驱动的工具可根据受众偏好定制内容并增强创意多样性，从而帮助优化广告效果。广告创建流程将大幅提高互动率，同时提供更优质的广告系列。

第 7 步：预览广告

使用下表列出的 Facebook 和 Instagram Reels 格式预览广告：

  • 广告编号
  • 广告创意编号
  • 广告创意规范
发布平台 广告格式

Facebook

DESKTOP_FEED_STANDARD、FACEBOOK_STORY_MOBILE、INSTANT_ARTICLE_STANDARD、INSTREAM_VIDEO_DESKTOP、INSTREAM_VIDEO_MOBILE、MARKETPLACE_DESKTOP、MARKETPLACE_MOBILE、MOBILE_FEED_BASIC、MOBILE_FEED_STANDARD、RIGHT_COLUMN_STANDARD、SUGGESTED_VIDEO_DESKTOP、SUGGESTED_VIDEO_MOBILE、WATCH_FEED_MOBILE、FACEBOOK_REELS_BANNER、FACEBOOK_REELS_BANNER_DESKTOP、FACEBOOK_REELS_MOBILE、FACEBOOK_REELS_POSTLOOP、FACEBOOK_REELS_STICKER、FACEBOOK_STORY_STICKER_MOBILE、WATCH_FEED_HOME

Instagram

INSTAGRAM_STANDARD、INSTAGRAM_STORY、INSTAGRAM_EXPLORE_CONTEXTUAL、INSTAGRAM_EXPLORE_IMMERSIVE、INSTAGRAM_EXPLORE_GRID_HOME、INSTAGRAM_FEED_WEB、INSTAGRAM_FEED_WEB_M_SITE、INSTAGRAM_PROFILE_FEED、INSTAGRAM_REELS、INSTAGRAM_REELS_OVERLAY、INSTAGRAM_SEARCH_CHAIN、INSTAGRAM_SEARCH_GRID、INSTAGRAM_STORY_CAMERA_TRAY、INSTAGRAM_STORY_WEB、INSTAGRAM_STORY_WEB_M_SITE

调用示例

curl -X POST \
  'https://graph.facebook.com/v21.0/act_{ad_account_id}/adpreviews' \
  -F 'access_token={your_access_token}' \
  -F 'creative={
        "object_story_spec": {
            "instagram_actor_id": "{instagram_actor_id}",
            "video_data": {
                "video_id": "{video_id}",
                "title": "Check out our new product!",
                "description": "Exciting new features and benefits.",
                "call_to_action": {
                    "type": "LEARN_MORE",
                    "value": {
                        "link": "https://www.example.com/product"
                    }
                }
            }
        }
    }' \
  -F 'ad_format=INSTAGRAM_REELS'

第 8 步：广告投放排期

要使用市场营销 API 预订广告，请创建广告版本库对象并将您的广告组对象链接到广告创意。使用 /act_{ad_account_id}/ads 提交您的广告对象，并验证回复，确保成功预订。在这个步骤，您的广告设置完成，可根据提供的配置准备投放。

调用示例

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

第 9 步：查看效果

使用成效分析 API 从广告账户获取广告指标：

  • act_<AD_ACCOUNT_ID>/insights
  • <CAMPAIGN_ID>/insights
  • <ADSET_ID>/insights
  • <AD_ID>/insights

如果您在 Instagram 和 Facebook 上投放广告系列，请添加 breakdowns=publisher_platform 以分别查看 Facebook 和 Instagram 版位的统计数据，如下面调用示例所示。按版位级别细分成效分析时，您能够看到 Instagram 和 Facebook Reels 版位的广告效果。

调用示例

curl -X GET \
  'https://graph.facebook.com/v21.0/{ad_account_id}/insights' \
  -F 'access_token={your_access_token}' \
  -F 'level=campaign' \
  -F 'fields=campaign_name,impressions,clicks,spend' \
  -F 'breakdowns=publisher_platform,platform_position' \
  -F 'filtering=[{"field":"platform_position","operator":"IN","value":["instagram_reels"]}]' \
  -F 'time_range={"since":"2024-06-01","until":"2024-06-30"}'

重要注意事项

ODAX（成效驱动型广告体验目标验证）支持的新目标

  • OUTCOME_APP_PROMOTION
  • OUTCOME_AWARENESS
  • OUTCOME_ENGAGEMENT
  • OUTCOME_LEADS
  • OUTCOME_SALES
  • OUTCOME_TRAFFIC

流量限制

市场营销 API 有自己的流量限制逻辑，并独立于所有图谱 API 流量限制之外。影响市场营销 API 流量限制配额的功能是广告管理标准权限。默认情况下，您在将市场营销 API 产品添加到应用面板时，会获得标准访问级别，而这会让您拥有市场营销 API 的开发级别访问权限。如要增加速率限制配额，请升级到高级访问级别。

创意基础知识

Reels 广告有助博取客户关注并使其付诸行动，从而推动业务成效增长。当您以合适方式制作广告时，甚至可以取得更佳效果。

1. 以 9:16 的视频格式创建，让视频吸睛夺目：Reels 是一种沉浸式的全屏视频格式。为使创意适合这种格式，建议以视频为主导，并将其调整为 9:16 格式。

2. 在安全区制作，让信息清晰可见：在安全区内创建内容，这样您的叠加文字贴图、行动号召或重要营销信息就不会被 Reels 用户界面遮挡。请不要在 9:16 创意底部 35% 的区域内放置文字、徽标和其他关键元素。

3. 制作有声内容，让视频趣味十足：音频（无论是音乐、旁白还是音效）是增加 Reels 的互动性和娱乐性的关键因素。