市场营销 API

广告创意

利用 Facebook 广告与现有客户建立联系，同时面向新客户开展营销。每个指南都对 Facebook 广告产品进行了说明，可助您实现广告目标。广告单元具有多种类型以及各种外观、版位和创意选项。如需获取有关广告单元的创意内容指南，请参阅 Facebook 广告发布指南。

创意

广告创意是一个对象，其中包含用于视觉呈现广告的所有数据。在 API 中，可创建的 Facebook 广告类型多样，点击此处即可了解所有类型。

现在，如果您的广告系列以“公共主页帖文互动”为目标，则您可以创建广告，推广相关公共主页发布的帖子。这类广告又被称为公共主页帖子广告。公共主页帖子广告需要名为 object_story_id 的字段，此字段是公共主页帖子的 id 属性。如需详细了解，请参阅参考资料的“广告创意”部分。

广告创意包含三个部分：

  • 广告创意本身，由创意对象的视觉属性定义
  • 广告投放的版位
  • 每个版位的广告单元预览

如要创建广告创意对象，请执行以下调用：

curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives
  
Open In Graph API Explorer

API 调用的响应是创意对象的 id。请妥善保存，广告对象需要用到这一编号：

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/v20.0/act_<AD_ACCOUNT_ID>/ads
  
Open In Graph API Explorer

限制

创意的文本、��像尺寸和宽高比以及其他方面均存在限制。请参阅广告发布指南。

读取

在广告 API 中，对于想要检索的每个字段，您都需要明确地发出请求，id 除外。每个对象的参考文档都有关于读回对象的介绍，并列出了可读取的字段。就创意而言，可读取的字段与创建创意对象和 id 时所指定的字段相同。

curl -G \
  -d 'fields=name,object_story_id' \
  -d 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v20.0/<CREATIVE_ID>Open In Graph API Explorer

版位

版位是广告在 Facebook 的展示位置，如桌面端动态、移动端动态或右边栏。请参阅广告产品指南。

我们鼓励您在各种可用版位中投放广告。Facebook 的广告竞拍旨在向最有可能以最低成本提高广告系列成效的版位提供广告展示。

利用这种优化策略的最简单方式就是将这个字段留空。您还可以在广告组的 target_spec 中选择特定版位。

此示例包含一个公共主页帖子广告。可用版位包括移动端动态、桌面端动态以及 Facebook 右边栏。使用 API 时，请参阅版位选项。如果将 desktopfeed 和 rightcolumn 选作 page_type，则系统会在桌面端动态和右边栏版位投放广告。此广告组下创建的任何广告都只能在桌面版版位投放。

curl -X POST \
  -F 'name=Desktop Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'daily_budget=10000' \
  -F 'targeting={ 
    "geo_locations": {"countries":["US"]}, 
    "publisher_platforms": ["facebook","audience_network"] 
  }' \
  -F 'optimization_goal=LINK_CLICKS' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'bid_amount=1000' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adsets
  

Open In Graph API Explorer

预览广告

您可以通过两种方式预览广告：通过广告预览 API，或使用广告预览插件。

通过使用 API 生成预览的方法有三种：

  1. 使用广告编号
  2. 使用广告创意编号
  3. 提供创意参数

根据预览 API 参考文档，API 调用的最低要求是：

curl -G \
  --data-urlencode 'creative="<CREATIVE_SPEC>"' \
  -d 'ad_format="<AD_FORMAT>"' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer

创意参数是由创建广告创意所需的每个字段和值组成的数组。

目前，广告创意调用如下所示：

curl -X POST \
  -F 'name="Sample Promoted Post"' \
  -F 'object_story_id="<PAGE_ID>_<POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/adcreatives

Open In Graph API Explorer

获取 object_story_id，并在预览 API 调用中加以使用：

curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=<AD_FORMAT>' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews


Open In Graph API Explorer

ad_format 的可用值与 page_types 略有不同。但在此处所述的情形下，我们选择了桌面端动态和 Facebook 右边栏。这需要您发出两次 API 调用，以便为每个版位生成预览：


curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=DESKTOP_FEED_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews
  
Open In Graph API Explorer
curl -G \
  -d 'creative={"object_story_id":"<PAGE_ID>_<POST_ID>"}' \
  -d 'ad_format=RIGHT_COLUMN_STANDARD' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v20.0/act_<AD_ACCOUNT_ID>/generatepreviews

Open In Graph API Explorer

响应是一个 24 小时内有效的 iFrame。

查看更多