互動自訂廣告受眾

根據與您 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