高效速成+ 購物行銷活動

高效速成+ 購物行銷活動是一種解決方案，可協助直接對消費者行銷的電子商務和零售業及品牌廣告商能夠達成更好的成效、更強的個人化和更高的效率。這種行銷活動提供更大的靈活性來控制廣告創意、目標設定、版位和預算等作法，並提供更多機會來最佳化促進轉換的行銷活動。

高效速成+ 購物行銷活動可讓您將特定市場的所有廣告受眾合併在單一行銷活動架構中，而不需要分眾進行多項行銷活動。這樣不但能簡化建立和管理程序，還能減少廣告受眾重疊的情況。

手動行銷活動設定與高效速成+ 購物行銷活動的比較

手動 BAU 行銷活動設定	高效速成+ 購物行銷活動
多項 BAU 行銷活動	BAU 行銷組合替換
使用 7 種目標設定作法進行手動目標設定	自動化目標設定，輸入 1 個國家／地區即可自動提高設定效率
預算精確分配在多項行銷活動	預算在 1 項行銷活動內流動
最多測試 50 種廣告創意組合	允許動態和靜態廣告，最多可達 150 種廣告創意組合

本文件說明設定高效速成+ 購物行銷活動整合時，所需遵循的步驟。您需要：

定義現有顧客
建立行銷活動
驗證行銷活動建立
建立廣告組合
提供廣告創意並建立廣告
設定最低年齡限制和地理位置排除項目（請參閱「廣告帳號控制項」參考文件）

深入瞭解高效速成+ 購物行銷活動跨管道轉換最佳化。

步驟 1：定義現有顧客

高效速成+ 購物行銷活動可讓您將現有顧客定義成自訂廣告受眾編號集合。您的現有顧客是已經熟悉您的業務/產品的用戶。設定此定義後，您可以用它來細分高效速成+ 購物行銷活動的預算，以限制花費在現有顧客的成本。我們也會為您提供衡量指標報告，分析行銷活動在這些不同族群之間的成效。

您可以發佈至 /act_{ad_account_id} 端點來定義廣告。您需要包含下列參數來設定此定義：

參數說明

參數	說明
`existing_customers` 陣列 <string>	廣告帳號有權存取的自訂廣告受眾編號陣列。目前支援的自訂廣告受眾來源包括網站、應用程式活動、顧客清單、目錄和離線活動。若要瞭解如何建立自訂廣告受眾，請參閱此頁面。

existing_customers

陣列 <string>

廣告帳號有權存取的自訂廣告受眾編號陣列。目前支援的自訂廣告受眾來源包括網站、應用程式活動、顧客清單、目錄和離線活動。

若要瞭解如何建立自訂廣告受眾，請參閱此頁面。

範例

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>

如需在第三方追蹤工具中追蹤新受眾和現有受眾的相關資訊，請參閱廣告受眾類型網址參數。

步驟 2：建立行銷活動

首先請建立您的廣告行銷活動，傳送 POST 要求至 /act_{ad_account_id}/campaigns。

參數

參數	說明
`name` 字串	必要項目高效速成+ 購物行銷活動的名稱
`objective` 列舉	必要項目行銷活動的目標。請為此類型的廣告指定 `OUTCOME_SALES`
`special_ad_categories` 清單<Object>	必要項目與高效速成+ 購物行銷活動相關聯的特殊廣告類別
`adlabels` 清單<Object>	選用項目與高效速成+ 購物行銷活動相關聯的廣告標籤
`buying_type` 字串	選用項目高效速成+ 購物行銷活動僅支援 `AUCTION` 值
`execution_options` 清單<enum>	選用項目預設值：`set`。其他選項為： `validate_only`：指定此選項時，API 呼叫不會執行變異，而是針對每個欄位的值執行驗證規則。 `include_recommendations`：此選項無法單獨使用。使用此選項時，會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊，但前提是要有針對此規格的建議存在。如果呼叫通過驗證或審核，回應會是 `{"success": true}`。如果呼叫未通過，將傳回錯誤和更多詳細資料。
`smart_promotion_type` 列舉	必要項目若要指定此為高效速成+ 購物行銷活動，智慧促銷活動類型應設為 `AUTOMATED_SHOPPING_ADS`
`status` 列舉	選用項目有效選項為：`PAUSED` 和 `ACTIVE`。如果此狀態為 `PAUSED`，其所有在線上的廣告組合和廣告都會暫停，並呈現有效狀態 `CAMPAIGN_PAUSED`

行銷活動建立範例

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

更新

您可以傳送 POST 要求至 /{campaign_id}，以更新行銷活動。

參數

參數	說明
`name` 字串	高效速成+ 購物行銷活動的名稱
`special_ad_categories` 清單<Object>	與高效速成+ 購物行銷活動相關聯的特殊廣告類別
`adlabels` 清單<Object>	與高效速成+ 購物行銷活動相關聯的廣告標籤
`execution_options` 清單<enum>	預設值：`set`。其他選項為： `validate_only`：指定此選項時，API 呼叫不會執行變異，而是針對每個欄位的值執行驗證規則。 `include_recommendations`：此選項無法單獨使用。使用此選項時，會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊，但前提是要有針對此規格的建議存在。如果呼叫通過驗證或審核，回應會是 `{"success": true}`。如果呼叫未通過，將傳回錯誤和更多詳細資料。
`topline_id` 數值字串或整數	標題編號
`status` 列舉	您可以在更新 API 呼叫中使用下列狀態： `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` 如果廣告行銷活動設為 `PAUSED`，其有效的子物件會暫停，並呈現有效狀態 `CAMPAIGN_PAUSED`。

行銷活動更新範例

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CAMPAIGN_ID>

步驟 3：驗證行銷活動建立

若要驗證您是否已成功建立高效速成+ 購物行銷活動，您可以傳送 GET 要求至 /<AD_CAMPAIGN_ID>，並使用欄位 smart_promotion_type。

有效的高效速成+ 購物行銷活動會傳回欄位值 AUTOMATED_SHOPPING_ADS。

範例

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>

回應

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

步驟 4：建立廣告組合

有了廣告行銷活動後，請建立廣告組合。每個高效速成+ 購物行銷活動只能有一個相關聯的廣告組合。

若要建立廣告組合，請傳送 POST 要求至 /act_{ad_account_id}/adsets。

參數

參數	說明
`campaign_id` 字串	必要項目要新增此廣告組合的有效高效速成+ 購物行銷活動。
`name` 字串	必要項目高效速成+ 購物行銷活動的名稱
`promoted_object` 物件	必要項目此廣告組合在其所有廣告中推廣的物件。針對高效速成+ 購物行銷活動，請提供： `pixel_id` 和 `custom_event_type`：高效速成+ 購物廣告組合支援下列事件：`PURCHASE`、`ADD_TO_CART`、`INITIATED_CHECKOUT`、`ADD_PAYMENT_INFO`、`ADD_TO_WISHLIST`、`CONTENT_VIEW`、`COMPLETE_REGISTRATION`、`DONATE`、`START_TRIAL`、`SUBSCRIBE`、`SEARCH`、`OTHER`。不支援顧客轉換事件。深入瞭解高效速成+ 購物行銷活動跨管道轉換最佳化。
`targeting` 目標設定物件	必要項目高效速成+ 購物廣告組合的目標設定架構。僅限指定 `geo_locations`。
`geo_locations` 陣列	必要項目用於限制廣告組合的廣告受眾，透過以下方式： `countries` - 國家／地區目標設定。需要 2 位字母 ISO 3166 格式代碼陣列。範例： { "geo_locations": { "countries": [“US”] }, } `regions` - 州、省或地區。請參閱目標設定搜尋：地區瞭解可用的值。限制：200。範例： { "geo_locations": { "regions": [{"key":"3847"}] }, }
`daily_budget` int64	選用項目以您的帳號幣別定義的單日預算，僅適用於持續時間（`end_time` 與 `start_time` 之間的時間差）超過 24 小時的廣告組合。 `daily_budget` 或 `lifetime_budget` 必須大於 0。
`lifetime_budget` int64	選用項目以您的帳號幣別定義的總經費。若指定此參數，也必須指定 `end_time`。 `daily_budget` 或 `lifetime_budget` 必須大於 0。
`end_time` 日期時間	指定 `lifetime_budget` 時的必要項目。使用 `daily_budget` 建立廣告組合時，請指定 `end_time=0`，將廣告組合設為持續進行而無結束日期。UTC UNIX 時間戳記範例：`2015-03-12 23:59:59-07:00` 或 `2015-03-12 23:59:59 PDT`。
`optimization_goal` 列舉	選用項目選擇 `OFFSITE_CONVERSIONS` 為最佳化目標，以獲得最高轉換次數。如果您想要獲得最高轉換價值，請選擇 `VALUE` 為最佳化目標。在廣告管理員中，我們將「最高價值」顯示為您的出價策略。
`bid_strategy` 列舉	選用項目 `LOWEST_COST_WITHOUT_CAP`：Facebook 會自動代表您出價並算出您的最低成本結果。我們會根據您提供的 `optimization_goal`，視需求自動提高您的有效出價，盡可能讓結果符合您的期望。當 optimization_goal 為 `OFFSITE_CONVERSION` 或 `VALUE` 時，這是預設 `bid_strategy`。 `LOWEST_COST_WITH_MIN_ROAS`：價值最佳化的特定出價選項。您必須指定 `roas_average_floor`，這是廣告花費要達到的最低投資報酬率。請參閱最低廣告主投資報酬率出價。 `COST_CAP`：我們努力達到您設定之每次行動成本的情況下，盡可能獲得最多結果。您必須在 `bid_amount` 欄位中提供上限數值。注意：我們無法保證一定能符合成本上限限制。請參閱成本上限。
`bid_amount`	bid_strategy 為 `COST_CAP` 時的必要項目。
`bid_constraints` JSON 物件	選用項目 `optimization_goal` 必須是 `VALUE`。 `bid_strategy` 必須是 `LOWEST_COST_WITH_MIN_ROAS`。最低 ROAS 出價使用 `bid_constraints` 來傳遞「ROAS 門檻」，但您不能搭配 `bid_constraints` 使用，請改用 `roas_average_floor`。請參閱最低廣告主投資報酬率出價。 `roas_average_floor` 的有效範圍為 `[100, 10000000]`（含）。這表示「最低 ROAS」的有效範圍是 `[0.01, 1000.0]` 或 `[1%, 100000.0%]`（含）。
`billing_event` 列舉	必要項目廣告組合的計費事件。高效速成+ 購物行銷活動僅支援 `IMPRESSIONS`。
`existing_customer_budget_percentage` 數值	選用項目指定可花費在與此廣告帳號相關聯之現有顧客的預算最大百分比。愈低的值可能會導致每次轉換成本愈高。有效值介於 0-100 之間。
`adlabels` 清單<Object>	選用項目指定與此物件相關聯的標籤清單。
`start_time` 日期時間	選用項目。組合的開始時間。UTC UNIX 時間戳記範例：`2015-03-12 23:59:59-07:00` 或 `2015-03-12 23:59:59 PDT`。
`time_start` 日期時間	選用項目時間開始
`time_stop` 日期時間	選用項目時間停止
`attribution_spec` 清單<JSON Object>	選用項目用於歸因轉換以進行最佳化的轉換歸因規格。

廣告組合建立範例

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

更新

您可以傳送 POST 要求至 /{ad_set_id}，以更新廣告組合。

參數

參數	說明
`adlabels` 清單<Object>	指定與此物件相關聯的標籤清單。此欄位為選用項目。
`daily_budget` int64	以您的帳號幣別定義的單日預算，僅適用於持續時間（`end_time` 與 `start_time` 之間的時間差）超過 24 小時的廣告組合。 `daily_budget` 或 `lifetime_budget` 必須大於 0。
`existing_customer_budget_percentage` 數值	指定可花費在與此廣告帳號相關聯之現有顧客的預算最大百分比。愈低的值可能會導致每次轉換成本愈高。有效值介於 0-100 之間。
`end_time` 日期時間	結束時間，指定 `lifetime_budget` 時的必要項目。範例：`2015-03-12 23:59:59-07:00` 或 `2015-03-12 23:59:59 PDT` 使用單日預算建立廣告組合時，請指定 `end_time=0`，將廣告組合設為持續進行而無結束日期。 UTC UNIX 時間戳記。
`execution_options` 清單<enum>	預設值：`set`。其他選項為： `validate_only`：指定此選項時，API 呼叫不會執行變異，而是針對每個欄位的值執行驗證規則。 `include_recommendations`：此選項無法單獨使用。使用此選項時，會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊，但前提是要有針對此規格的建議存在。如果呼叫通過驗證或審核，回應會是 `{"success": true}`。如果呼叫未通過，將傳回錯誤和更多詳細資料。
`start_time` 日期時間	組合的開始時間。必須以 UTC UNIX 時間戳記提供。範例：`2015-03-12 23:59:59-07:00` 或 `2015-03-12 23:59:59 PDT`。
`status` 列舉	可用於更新的選項： `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` 如果設為 `PAUSED`，其所有在線上的廣告都會暫停，並呈現有效狀態 `ADSET_PAUSED`。
`lifetime_budget` int64	以您的帳號幣別定義的總經費。若指定此參數，也必須指定 `end_time`。 `daily_budget` 或 `lifetime_budget` 必須大於 0。
`time_start` 日期時間	時間開始
`time_stop` 日期時間	時間停止
`targeting` 目標設定物件	廣告組合的目標設定架構。目標設定的有效值為 `geo_locations`。
`geo_locations` 陣列	必要項目用於限制廣告組合的廣告受眾，透過以下方式： `countries` - 國家／地區目標設定。需要 2 位字母 ISO 3166 格式代碼陣列。範例： { "geo_locations": { "countries": [“US”] }, } `regions` - 州、省或地區。請參閱目標設定搜尋：地區瞭解可用的值。限制：200。範例： { "geo_locations": { "regions": [{"key":"3847"}] }, }
`attribution_spec` 清單<JSON Object>	選用項目用於歸因轉換以進行最佳化的轉換歸因規格。

廣告組合更新範例

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_SET_ID>

步驟 5：提供廣告創意並建立廣告

有了廣告組合後，可以發佈至 /act_{ad_account_id}/ads 端點來建立廣告。您可以包含下列參數

參數

參數	說明
`name` 字串	必要項目廣告的名稱
`adset_id` int64	必要項目廣告組合的編號，建立時需要此編號。
`creative` AdCreative	必要項目此廣告所要使用之廣告創意的廣告創意規格或編號。有效欄位為： `object_story_spec` `product_set_id` `use_page_actor_override` `creative_id` 您可以在這裡進一步瞭解廣告創意請以下列格式提供廣告創意：`{"creative_id": <CREATIVE_ID>}` 或提供廣告創意規格： { "creative": { "name": <NAME>, "object_story_spec": <SPEC>, "product_set_id": <PRODUCT_SET_ID> } }
`status` 列舉	選用項目建立期間只有 `ACTIVE` 和 `PAUSED` 有效。在測試期間，建議將廣告設為 `PAUSED` 狀態，以免產生非預期的費用。
`adlabels` 清單<Object>	選用項目與此廣告相關聯的廣告標籤
`execution_options` 清單<enum>	選用項目預設值：`set`。 `validate_only`：指定此選項時，API 呼叫不會執行變異，而是針對每個欄位的值執行驗證規則。 `synchronous_ad_review`：此選項不應單獨使用，應一律與 `validate_only` 一起指定。指定這些選項後，API 呼叫會執行廣告完整性驗證（包括訊息語言檢查、圖像 20% 文字規則等等），以及驗證邏輯。 `include_recommendations`：此選項無法單獨使用。使用此選項時，會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊，但前提是要有針對此規格的建議存在。如果呼叫通過驗證或審核，回應會是 `{"success": true}`。如果呼叫未通過，將傳回錯誤和更多詳細資料。

廣告建立範例

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

廣告創意欄位

如需「廣告創意」欄位的完整清單，請參閱此文件。

欄位	說明
`object_story_spec` AdCreativeObjectStorySpec	必要項目如果您想要建立新的贊助式專頁貼文，並將貼文轉換成廣告，可以使用此欄位。用來建立新贊助式專頁貼文的粉絲專頁編號和內容。
`use_page_actor_override` AdCreative	必要項目如果設為 `true`，我們會顯示與高效速成購物廣告相關聯的 Facebook 粉絲專頁。

建立廣告創意範例

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

更新

您可以傳送 POST 要求至 /{ad_id}，以更新廣告。

參數

參數	說明
`name` 字串	廣告的新名稱
`adlabels` 清單<Object>	與此廣告相關聯的廣告標籤。
`execution_options` 清單<enum>	預設值：`set`。其他選項為： `validate_only`：指定此選項時，API 呼叫不會執行變異，而是針對每個欄位的值執行驗證規則。 `synchronous_ad_review`：此選項不應單獨使用，應一律與 `validate_only` 一起指定。指定這些選項後，API 呼叫會執行廣告完整性驗證（包括訊息語言檢查、圖像 20% 文字規則等等），以及驗證邏輯。 `include_recommendations`：此選項無法單獨使用。使用此選項時，會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊，但前提是要有針對此規格的建議存在。如果呼叫通過驗證或審核，回應會是 `{"success": true}`。如果呼叫未通過，將傳回錯誤和更多詳細資料。
`status` 列舉	選項包括： `ACTIVE` `PAUSED` `DELETED` `ARCHIVED` 在測試期間，建議將廣告設為 `PAUSED` 狀態，以免產生非預期的費用。
`creative` AdCreative	此廣告所使用之廣告創意的廣告創意規格。有效欄位為 `object_story_spec`、`asset_feed_spec` 和 `use_page_actor_override`，您可以在這裡查看。您可以在這裡進一步瞭解廣告創意請以下列格式提供廣告創意： { "creative": { "name": <NAME>, "object_story_spec": <SPEC>, "product_set_id": <PRODUCT_SET_ID> } }

廣告更新範例

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>