互動自訂廣告受眾

根據曾經在 Facebook 或 Instagram 上與您的內容互動的用戶，建立自訂廣告受眾。目前支援的廣告受眾類型包括粉絲專頁、Instagram 商業檔案、名單型廣告、即時體驗廣告、購物和擴增實境。

本指南以粉絲專頁互動廣告受眾為例來說明 API。Facebook 會持續增加與粉絲專頁互動的用戶，以更新粉絲專頁互動的自訂廣告受眾。首次建立此廣告受眾時，Facebook 會以用戶清單預先填入，這些用戶在指定的留存期間，已經和您的粉絲專頁有所互動。

自 2018 年 9 月起，我們不再支援用於網站自訂廣告受眾、應用程式、互動自訂廣告受眾，以及離線轉換資料廣告受眾的 subtype。但其中有個例外，影片的互動自訂廣告受眾目前仍支援 subtype。
如果您是在歐洲境內建立廣告受眾，或將目標設定為歐洲用戶，請參閱 2020 年 12 月 2 日不分版本變更。

建立廣告受眾

若要建立互動自訂廣告受眾，您的廣告帳號必須在廣告管理員中接受自訂廣告受眾的服務條款。

若要建立廣告受眾，根據 page_engaged 事件列出與您粉絲專頁互動的用戶：

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

參數

名稱	說明
`name` 字串	必要項目。自訂廣告受眾名稱。
`rule` JSON 物件	必要項目。定義廣告受眾的規則。此規則採用與網站自訂廣告受眾相同的語法。

互動自訂廣告受眾是一種自訂廣告受眾類型。如需瞭解所有可用欄位，請參閱自訂廣告受眾參考資料。

備註：每個廣告帳號最多可建立 500 個互動自訂廣告受眾。

互動規則

您可以利用廣告受眾規則，決定是否讓 Facebook 將某用戶加入自訂廣告受眾。

在規則的 event_sources 中指定 type 和 id 欄位，以表示互動物件的 type 和 id。id 欄位接受單一物件編號，或是相同類型的編號陣列。

以下是支援的事件來源和對應的互動物件編號：

page：Facebook 粉絲專頁編號。
lead：名單型廣告表單編號。
ig_lead_generation：名單型廣告表單編號。
canvas：全螢幕互動廣告編號。
ig_business：Instagram 商業簡介編號。
shopping_page：Facebook 商店粉絲專頁編號。
shopping_ig：Instagram 商店編號。
ar_experience：使用 AR 特效的即時體驗。
ar_effects：您擁有的 Facebook 或 Instagram 特效。這不包括廣告中使用的特效。

每項規則都包含 object_id 和 event_name。

粉絲專頁

將 object_id 設為您的粉絲專頁編號。在 event_name 之下，使用下列其中一項互動事件：

page_engaged：在 Facebook 或 Messenger 上造訪過您的粉絲專頁，或是與您任何粉絲專頁內容或廣告互動過的用戶。這是範圍最廣泛的互動類型，包括其他所有互動類型。
page_visited：曾經造訪過您的粉絲專頁的用戶。
page_liked：目前對您的粉絲專頁按讚的用戶（請參閱有關留存率和粉絲專頁按讚相關規則的詳細資訊。）
page_messaged：曾傳送訊息至您的粉絲專頁的用戶。
page_cta_clicked：曾在您的粉絲專頁上點擊任何行動呼籲按鈕的用戶（例如「聯絡我們」或「來去逛逛」）。
page_or_post_save：曾儲存您的粉絲專頁或任何粉絲專頁貼文的用戶。
page_post_interaction：曾與您的任何粉絲專頁貼文互動的用戶。互動包括傳達心情（即按讚、大心、哈、哇、嗚、怒）、分享、留言、點擊連結或滑動輪播廣告。

名單型廣告

請將 object_id 設為 FORM_ID，並設定 rule，以追蹤下列其中一項名單型廣告事件：

lead_generation_submitted：已填妥表單並送出的所有用戶。
lead_generation_dropoff：所有在未送出之前即關閉表單的用戶。這些用戶可能已填寫或尚未填寫任何欄位。
lead_generation_opened：已開啟名單型廣告表單的所有用戶，無論是否送出表單。

即時體驗

將 object_id 設為 "CANVAS_ID"。rule 應追蹤下列其中一項事件：

instant_shopping_document_open
instant_shopping_document_pause
instant_shopping_document_resume
instant_shopping_document_close
instant_shopping_did_scroll
instant_shopping_element_click
instant_shopping_element_impression

Instagram 商業簡介

object_id 應為 "INSTAGRAM_BUSINESS_PROFILE_ID"，而 rule 應追蹤下列其中一項 Instagram 商業簡介事件：

ig_business_profile_all：造訪過您的 Instagram 商業簡介，或是與您 Instagram 商業簡介的任何內容或廣告互動過的用戶。這是範圍最廣泛的互動類型，包括其他所有互動類型。這是 ig_business_profile_engaged、ig_user_messaged_business 與 ig_user_messaged_business 的聯集。
ig_business_profile_engaged：曾與您的 Instagram 商業簡介互動，或與您的任何 Instagram 商業簡介內容或廣告互動的用戶。
ig_user_messaged_business：傳訊到您 Instagram 商業簡介的用戶。
ig_business_profile_visit：造訪過您 Instagram 商業簡介的用戶。
ig_business_profile_ad_saved：儲存過您 Instagram 商業簡介自主內容或廣告的用戶。
ig_ad_like
ig_ad_comment
ig_ad_share
ig_ad_save
ig_ad_cta_click
ig_ad_carousel_swipe
ig_organic_like
ig_organic_comment
ig_organic_share
ig_organic_save
ig_organic_swipe
ig_organic_carousel_swipe

目前不支援建立 Instagram 媒體創作者類型的影片互動自訂廣告受眾。

購物

購物互動規則應追蹤下列其中一項事件：

VIEW_CONTENT：瀏覽過您產品詳細資訊頁面的用戶。此選項適用於全球各地。
ADD_TO_CART：已將您的產品加入購物車的用戶。此選項只適用於已啟用結帳功能的商家和美國境內的消費者。
PURCHASE：購買過您產品的用戶。此選項只適用於已啟用結帳功能的商家和美國境內的消費者。

若要建立規則來新增瀏覽過您產品的用戶，請參閱下方範例：

curl -i -X POST
-F 'name="test_api"'\
-F 'rule= {
	"inclusions": {
		"operator": "or",
		"rules": [
			{
				"event_sources": [
					{
						"id": "<ID>",
						"type": "shopping_ig"
					}
				]
				"retention_seconds": <RETENTION_SECONDS>,
				"filter": {
					"operator": "and",
					"filters": [
						{
						"field":"event",
						"operator":"eq",
						"value": "VIEW_CONTENT"
						}
					]
				}
			}
		]
	}
}
-F 'access_token=<ACCESS_TOKEN>' \
https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

有鑑於新的隱私規定，page_messaged 和 ig_user_messaged_business 參數可能不適用於歐洲地區。

擴增實境

擴增實境互動自訂廣告受眾可以包含兩個部分：AR 體驗和 AR 特效。

對於 AR 體驗互動自訂廣告受眾，請將 object_id 設為 AR 廣告資料容器編號，對於已存檔的 event_name，請使用 ar_camera_open 或 camera_cta_click。
對於 AR 特效互動自訂廣告受眾，請將 object_id 設為 AR 特效編號，並在 event_name 欄位使用 ar_effect_open。

留存天數上限

為遵循法律和隱私規定，我們允許針對每種事件來源類型設定不同的留存天數上限：

名單型廣告：90 天
Instagram 商業簡介：730 天
粉絲專頁：730 天
- 備註：不會留存粉絲專頁按讚廣告受眾
即時體驗（先前稱為全螢幕互動廣告）：730 天
購物：365 天。提供 2020 年 4 月後的資料。
擴增實境：365 天

包含排除區塊的互動規則

互動廣告受眾規則與網站自訂廣告受眾規則相容。因此這類規則可以包含多項包含和排除規則。將至少符合一項規則的用戶新增至廣告受眾。

在下列範例中，我們建立的廣告受眾會包含造訪過粉絲專頁或與粉絲專頁互動過的用戶，但會排除點擊過行動呼籲按鈕的用戶：

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       },
       "exclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_cta_clicked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

如需詳細資訊，請參閱網站自訂廣告受眾。

多重規則

互動廣告受眾可以有多項規則，而系統會將符合至少一項規則的用戶新增至廣告受眾。以下範例所建立的廣告受眾包含曾經傳訊給粉絲專頁或點擊過行動呼籲按鈕的用戶：

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 },
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

多個粉絲專頁

規則不限於單一粉絲專頁。每條規則的目標對象都可以是不同的粉絲專頁，而且只要用戶與其中至少一個粉絲專頁互動，即可將用戶新增至廣告受眾。

下列廣告受眾範例包含至少造訪過三個粉絲專頁其中一個的所有用戶：

curl -X POST \
  -F 'name="My Test Engagement Custom Audience"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               },
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 31536000,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_engaged"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences

關於「自訂廣告受眾」的詳細資訊，請參閱自訂廣告受眾參考資料。

粉絲專頁按讚留存與規則

不會留存粉絲專頁按讚廣告受眾（retention_seconds=0）。此外，粉絲專頁按讚規則不能與其他粉絲專頁事件合併。

以下舉例說明建立粉絲專頁按讚廣告受眾：

curl -X POST \
  -F 'name="Page Likes Audience Name"' \
  -F 'rule={
       "inclusions": {
         "operator": "or",
         "rules": [
           {
             "event_sources": [
               {
                 "id": "<PAGE_ID>",
                 "type": "page"
               }
             ],
             "retention_seconds": 0,
             "filter": {
               "operator": "and",
               "filters": [
                 {
                   "field": "event",
                   "operator": "eq",
                   "value": "page_liked"
                 }
               ]
             }
           }
         ]
       }
     }' \
  -F 'prefill=1' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/customaudiences