市场营销 API

店铺引流广告

作为一种解决方案，店铺引流广告会自动将潜在客户引导至您的网站或店铺（具体取决于我们认为他们最可能下单购物的位置），从而帮助您提升广告表现。

前期准备

如要创建以网站和店铺作为转化发生位置的目录商品销量广告或转化广告，您需要拥有：

第 1 步：创建广告系列

首先向 /act_{ad_account_id}/campaigns 发送 POST 请求，创建您的广告系列。

在这个级别，您必须通过 objective 字段设置广告目标。对于店铺引流广告，非成效驱动型广告体验 (ODAX) 支持的目标是 PRODUCT_CATALOG_SALES 和 CONVERSIONS；ODAX 支持的目标是 OUTCOME_SALES。

  • 如果目标是 PRODUCT_CATALOG_SALES，promoted_object 是商品目录编号。请注意，必须将商品目录与站内店铺关联，才能在店铺引流广告中使用该商品目录。
  • 如果目标是 CONVERSIONS，promoted_object 字段并不是必要项。

非 ODAX 目标的示例

示例：创建以 PRODUCT_CATALOG_SALES 为目标的广告系列

curl \
  -F 'name=Product Catalog Sales Campaign' \
  -F 'objective=PRODUCT_CATALOG_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

示例：创建以 CONVERSIONS 为目标广告系列

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=CONVERSIONS' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

ODAX 目标的示例

示例：创建以 OUTCOME_SALES 为目标 PRODUCT_CATALOG_SALES 的广告系列

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'promoted_object={"product_catalog_id":"<PRODUCT_CATALOG_ID>"}' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]' \
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

示例：创建以 OUTCOME_SALES 为目标的 CONVERSIONS 广告系列

curl \
  -F 'name=Conversion Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=PAUSED' \
  -F 'special_ad_categories=[]'
  -F 'access_token=<ACCESS_TOKEN>' \ 
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

第 2 步：创建广告组

对于店铺引流广告，您必须将广告组的目标位置类型指定为 SHOP_AUTOMATIC。

  • 如果广告系列的目标设置为 PRODUCT_CATALOG_SALES，您必须在 promoted_object 中提供商品系列编号，才能推广该商品系列中的商品。
  • 如果广告系列的目标设置为 CONVERSIONS，请将 promoted_object 定义为已启用站内结账功能的电商账户。

店铺引流广告的其他要求：

  • 店铺引流广告仅支持将商品系列（如果目标是 PRODUCT_CATALOG_SALES）或 Meta Pixel 像素代码（如果目标是 CONVERSIONS）中的转化事件 (CUSTOM_EVENT_TYPE) 设置为 PURCHASE。
  • 店铺引流广告仅支持优化站外转化量（optimization_goal 为 OFFSITE_CONVERSIONS）。
  • 店铺引流广告仅支持没有费用上限的竞价策略。
  • 为了将店铺引流广告投放到店铺，定位必须包含支持站内结账功能的地区（目前是美国）的受众。
  • 为了将店铺引流广告投放到店铺，版位必须至少包含一个支持站内结账功能的平台（目前为 Facebook 和 Instagram）。

示例：创建一个店铺引流广告的广告组，该广告组从属于以 PRODUCT_CATALOG_SALES 为目标的广告系列，并按照 IMPRESSIONS 计费

curl \
  -F 'name=Product Catalog Sales Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]} }' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"product_set_id":"<PRODUCT_SET_ID>","custom_event_type": "PURCHASE"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

示例：创建一个店铺引流广告的广告组，该广告组从属于以 CONVERSIONS 为目标的广告系列，并按照 IMPRESSIONS 计费

curl \
  -F 'name=Conversion Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],
  "pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<D_ACCOUNT_ID>/adsets

第 3 步：提供创意

通过店铺引流广告的广告组，您可以创建以下内容：

店铺引流广告不支持以下内容：

  • 图片/视频广告（当广告系列的目标为 PRODUCT_CATALOG_SALES 时）
  • 精品栏广告格式
  • 将行动号召设置为向公共主页、Instagram 或 WhatsApp 发送消息
  • 将目标位置设置为应用、事件或即时体验（当目标是 CONVERSIONS 时）

轮播广告或图片/视频广告

您可以创建轮播广告，这与创建非店铺引流广告的方法相似。如果广告系列的目标是 CONVERSIONS，则您也可以创建图片/视频广告。

object_story_spec 中指定的 page_id 和/或 instagram_actor_id 必须至少有一个店铺属于您选择在广告组中推广的电商账户或您选择在广告系列中推广的目录。这些店铺还必须与同一个电商账户关联。

另外，对于店铺引流广告，您需要指定一个站内目标位置作为站外落地页的备选目标位置。如要完成此操作，请设置您创意的 asset_feed_spec 中的 onsite_destination 字段。

站内目标位置必须是以下其中一个：

  • 店铺的店面页面
    店铺必须属于您在广告组中推广的电商账户。

  • 商品系列
    商品系列必须属于您在广告组中推广的电商账户的目录，并且在库存商品中包含至少一个可见商品。

  • 商品
    商品必须属于您在广告组中推广的电商账户的目录。

示例：asset_feed_spec 中的 onsite_destinations 字段设置为店铺的店面页面

asset_feed_spec= {
  "onsite_destinations": [
    {
      "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
    }
  ]
}

示例：asset_feed_spec 中的 onsite_destinations 字段设置为商品系列

asset_feed_spec= {
  "onsite_destinations": [
    {
      "shop_collection_product_set_id": "<PRODUCT_SET_ID>"
    }
  ]
}

示例：asset_feed_spec 中的 onsite_destinations 字段设置为特定商品

asset_feed_spec= {
  "onsite_destinations": [
    {
      "details_page_product_id": "<PRODUCT_ID>"
    }
  ]
}

示例：图片广告的创意

curl \
  -F 'name=Sample Creative' \
  -F 'asset_feed_spec= {
        "onsite_destinations": [
          {
            "storefront_shop_id": "<SHOP_STOREFRONT_ID>"
          }
        ]
      }' \
  -F 'object_story_spec={ 
    "link_data": { 
      "image_hash": "<IMAGE_HASH>", 
      "link": "<OFFSITE_LANDING_URL>", 
      "message": "try it out" 
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id" : "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

采用轮播格式的进阶赋能型目录广告

如要创建用于推广商品系列中的商品的轮播广告，您可以按照进阶赋能型目录广告入门指南 - 第 3 步：提供广告创意中的步骤进行操作。

object_story_spec 中指定的 page_id 和/或 instagram_actor_id 必须至少有一个店铺属于您选择在广告组中推广的电商账户或您选择在广告系列中推广的目录。这些店铺还必须与同一个电商账户关联。

对于创意中的商品系列：

  • 如要设置以 PRODUCT_CATALOG_SALES 为目标的广告系列，则您选择的商品系列必须属于您在广告系列中设置的目录，并且必须与您选择在广告组中推广的商品系列相同。
  • 如要设置以 CONVERSIONS 为目标的广告系列，则您选择的商品系列必须属于您选择在广告组中推广的电商账户的目录。

店铺引流广告支持的其他功能包括各类店铺优化功能。如果我们认为相关功能可能会提高广告表现，我们将自动为您的广告添加不同的优化功能。如要启用这些功能，请将您创意的 asset_feed_spec 中的 shops_bundle 设置为 true（这包括自动商品标记和购买理由，以及未来可能执行的其他优化）。

目前支持的店铺优化功能包括：

  • 自动商品标记：我们可能会自动标记您广告中的商品。商品标记会直接将用户引导到您店铺中的相关商品页面。
  • 购买理由：我们可能会自动突显您店铺中的商品信息，例如“包邮”“热门”或“库存紧张”。我们也可能会添加现有的优惠，让顾客特价购买您店铺的精选商品。

如要启用自动商品标记功能，请将 object_story_spec 的 template_data 中的 automated_product_tags 设置为 true。如要启用购买理由功能，请将您创意的 asset_feed_spec 中的 reasons_to_shop 设置为 true。

示例：推广商品系列的轮播广告，该广告启用了完全自动店铺优化功能


选择启用 shops_bundle

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "shops_bundle": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

选择启用 automated_product_tags

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'object_story_spec={ 
    "template_data": {
      "automated_product_tags": true
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>"
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

选择启用 reasons_to_shop

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
        "reasons_to_shop": true
      }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    "instagram_actor_id": "<INSTAGRAM_ACTOR_ID>" 
  }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

注意：

  • 店铺引流广告不支持适用于进阶赋能型目录广告的类别。
  • “自动商品标记”优化功能仅在 Instagram 上受支持。

进阶赋能型目录素材

店铺引流广告还支持进阶赋能型目录素材。此功能可以根据账户中心账户最可能回应的内容，向不同的账户显示不同的格式和广告创意。

您可以按照进阶赋能型目录素材 - 第 3 步：提供广告创意中的指导来设置创意。

object_story_spec 中指定的 page_id 和/或 instagram_actor_id 必须至少有一个店铺属于您选择在广告组中推广的电商账户或您选择在广告系列中推广的目录。这些店铺还必须与同一个电商账户关联。

对于创意中的商品系列：

  • 如要设置以 PRODUCT_CATALOG_SALES 为目标的广告系列，则您选择的商品系列必须属于您在广告系列中设置的目录，并且必须与您选择在广告组中推广的商品系列相同。
  • 如要设置以 CONVERSIONS 为目标的广告系列，则您选择的商品系列必须属于您选择在广告组中推广的电商账户的目录。

示例：进阶赋能型目录素材

curl \
  -F 'name=Sample Creative' \
  -F 'product_set_id="<PRODUCT_SET_ID>"' \
  -F 'asset_feed_spec= {
    "optimization_type":"FORMAT_AUTOMATION",
    "ad_formats": ["CAROUSEL", "COLLECTION"],
    "images": [{"hash": "<CUSTOMIZED_IMAGE_HASH>"}],
    "descriptions": [{"text": "{{product.description}}", "From {{product.current_price}}", ...]
    } 
   }'\
  -F 'object_story_spec={ 
    "template_data": { 
      "call_to_action":  {
            "type": "SHOP_NOW"
          },
      "link": "<OFFSITE_LANDING_URL>",
      "multi_share_end_card": false,
      "name": "{{product.name}}"
    }, 
    "page_id": "<PAGE_ID>",
    “instagram_actor_id” : “<INSTAGRAM_ACTOR_ID>” 
  }' \
  -F 'degrees_of_freedom_spec={
      "creative_features_spec": {
        "standard_enhancements": {
          "enroll_status": "OPT_OUT"
        }
      }
    }' \ 
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

第 4 步：创建广告

最后，您可以创建引用广告创意的广告。

curl \
-F 'status=PAUSED' \
-F 'name=Test' \
-F 'adset_id=<ADSET_ID>' \
-F 'creative= {
       "creative_id": "<CREATIVE_ID>"
    },
}' \
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

店铺引流广告与进阶赋能型智能购物广告系列

我们支持将店铺引流广告与进阶赋能型智能购物广告系列结合使用，并相信这种做法可以进一步提升广告表现。

如要创建包含店铺引流广告的进阶赋能型智能购物广告系列，请按照进阶赋能型智能购物广告系列 - 第 2 步：创建广告系列中的步骤操作，先创建广告系列。

针对包含店铺引流广告的进阶赋能型智能购物广告系列，在创建广告组时，与仅针对店铺引流广告创建广告组的操作类似，请将 destination_type 设置为 SHOP_AUTOMATIC，并在 promoted_object 中指定电商账户。

curl \
  -F 'name=Advantage+ Shopping Adset' \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'daily_budget=15000' \
  -F 'bid_strategy=LOWEST_COST_WITHOUT_CAP' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'targeting={"geo_locations": {"countries":["US"]}}' \
  -F 'destination_type=SHOP_AUTOMATIC' \
  -F 'promoted_object={"omnichannel_object":{"onsite":[{"commerce_merchant_settings_id":"<COMMERCE_ACCOUNT_ID>"}],"pixel":[{"pixel_id": "<PIXEL_ID>","custom_event_type": "PURCHASE"}]}}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

详情请参阅进阶赋能型智能购物广告系列的跨渠道转化优化。

针对包含店铺引流广告的进阶赋能型智能购物广告系列，在创建创意和广告时，相关参数与单独针对店铺引流广告创建这些内容所使用的参数相同。详情请参阅上文的第 3 步：提供创意。

店铺引流广告的电商使用资格要求

为了获取相关编号以创建店铺引流广告，您需要从客户处获取 catalog_management 权限。

如要为公共主页创建店铺引流广告，该公共主页必须拥有站内可见的店铺。您可以通过以下代码获取这项信息

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{status,fb_page{id,name}},is_onsite_enabled,shop_status}&access_token=<PAGE_ACCESS_TOKEN>"

响应示例

{
  "id":"<commerce_account_id>",
  "shops": {
    "data": [
      {
        "fb_sales_channel": {
          "status": "STAGING",
          "fb_page": {
            "name": "Page 1",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_1>",
        "is_onsite_enabled": true,
        "shop_status": "INACTIVE"
      },
      {
        "fb_sales_channel": {
          "status": "ENABLED",
          "fb_page": {
            "name": "Page 2",
            "id": "<page_id>"
          }
        },
        "id": "<shop_id_2>",
        "is_onsite_enabled": true,
        "shop_status": "ACTIVE"
      }
    ],    
    // …
}

如果您想为该公共主页创建店铺引流广告，请检查 is_onsite_enabled 是否为 true，以及 shop_status 是否为 ACTIVE。如果是这两个值，您便可以按照本指南下文内容中的指导，为公共主页创建店铺引流广告。

获取电商编号以创建店铺引流广告

如要为公共主页创建店铺引流广告，您需要拥有以下编号：

您可以执行之前的查询，从而获取电商账户编号和店铺编号。

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,shops{id,fb_sales_channel{fb_page{id,name}}}&access_token=<PAGE_ACCESS_TOKEN>"

一个电商账户可能拥有多个店铺，如果您想要为特定公共主页创建店铺引流广告，需要使用该公共主页获取与其关联的店铺。

如要获取目录编号、商品系列编号和商品编号，请执行以下查询

curl -i -X GET \
"https://graph.facebook.com/v19.0/<PAGE_ID>/commerce_merchant_settings?fields=id,product_catalogs{id,product_sets}&access_token=<PAGE_ACCESS_TOKEN>"

响应示例

{
  "id": "<commerce_account_id>",
  "product_catalogs": {
    "data": [
      {
        "id": "<product_catalog_id>",
        "product_sets": {
          "data": [
            {
              "id": "<product_set_id>",
              "name": "Product Set 1",
              "filter": "{\"product_item_id\":{\"is_any\":[]}}"
            },
          ],
        }
      }
    ]
  }
}