行銷 API

商店廣告

商店廣告是協助您提高廣告成效的一種解決方案，我們會判斷潛在顧客較有可能在哪裡購買，再將他們引導至您的網站或商店。

準備工作

若要使用網站和商店轉換位置來建立商品目錄銷售或轉換廣告，您需要：

  • 透過 Facebook 和 Instagram 結帳的商店。
  • 與商店連結的 Facebook 粉絲專頁或 Instagram 帳號。
  • 與商店連結的目錄。請參閱目錄欄位說明文件，瞭解商務和廣告的必要欄位。
  • 商店廣告的商務資格。

步驟 1：建立行銷活動

首先，發出 POST 要求至 /act_{ad_account_id}/campaigns，以建立廣告行銷活動。

在這個階段，您必須透過目標欄位來設定廣告目標。就商店廣告而言，對於非成果導向廣告體驗（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/v21.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/v21.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/v21.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/v21.0/act_<AD_ACCOUNT_ID>/campaigns

步驟 2：建立廣告組合

對於商店廣告，您必須將廣告組合的目的地類型指定為 SHOP_AUTOMATIC。

  • 如果行銷活動的目標設定為 PRODUCT_CATALOG_SALES，您必須在 promoted_object 中提供商品組合編號，才能推廣該商品組合中的產品。
  • 如果行銷活動的目標設定為 CONVERSIONS，請將 promoted_object 定義為啟用站內結帳的商務帳號。

商店廣告的其他規定：

  • 商店廣告僅支援 PURCHASE 做為廣告組合（如果目標是 PRODUCT_CATALOG_SALES）或 Meta 像素（如果目標是 CONVERSIONS）中的轉換事件（CUSTOM_EVENT_TYPE）。
  • 商店廣告僅支援最佳化站外轉換（OFFSITE_CONVERSIONS 為 optimization_goal）。
  • 商店廣告僅支援無成本上限的出價策略。
  • 為了將商店廣告投放到商店，目標設定必須包含支援站內結帳的地區（目前為美國）受眾。
  • 為了將商店廣告投放到商店，廣告版位必須至少包含一個支援站內結帳的平台（目前為 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/v21.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/v21.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/v21.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/v21.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/v21.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/v21.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/v21.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/v21.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/v21.0/act_<AD_ACCOUNT_ID>/adsets

如需更多資訊，請參閱高效速成+ 購物行銷活動的跨管道轉換最佳化。

針對搭配使用商店廣告的高效速成+ 購物行銷活動建立廣告創意和廣告時，規格與單獨建立商店廣告相同。如需詳細資訊，請參閱上面的步驟 3：提供廣告創意。

商店廣告的商務資格

為了取得商店廣告的相關編號，您需要向客戶取得 catalog_management 權限。

若要為粉絲專頁建立商店廣告，粉絲專頁必須要有站內顯示商店。你可以使用下列指令執行此作業

curl -i -X GET \
"https://graph.facebook.com/v21.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/v21.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/v21.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\":[]}}"
            },
          ],
        }
      }
    ]
  }
}