推廣 API

追蹤和轉換規格

借助追蹤規格，您可記錄用戶對您的廣告採取的操作。此項功能不會針對某項操作優化廣告刊登，也不會根據已發生的操作向您的廣告帳戶收費。

在推廣 API v2.3 及更早版本中，轉換規格是用於優化 CPM 的廣告設定。這些規格會針對特定操作優化廣告刊登，並在轉換報告中顯示這些操作。從 v2.4 起，conversion_specs 為唯讀規格。使用廣告組合中的 optimization_goal，以選擇廣告刊登優化方式。

設定追蹤規格

您可結合任何出價類型和廣告創意使用。如需指定追蹤規格，您需要在廣告中新增名為 tracking_specs 的額外欄位。tracking_specs 欄位接受與操作規格相同的引數。如需建立廣告，請查看廣告建立流程。

預設追蹤規格

預設追蹤規格適用於下列廣告目標。如果您將某規格更改為預設規格，則系統會將其附加至現有規格，而不是覆寫現有規格。

如果您的目標是 NONE 或 App Install/Engagement Ads，則預設追蹤規格將被覆寫。如果您想使用預設值，則您必須將其加至您的自訂規格。

您可同時在規格中使用字串或陣列標記法，例如 'APPLICATION_ID' 或 ['APPLICATION_ID']。

  • CPM 指 billing_event=IMPRESSIONS 和 optimization_goal=IMPRESSIONS
  • CPC 指 billing_event=CLICKS 和 optimization_goal=CLICKS
  • oCPM 指 billing_event=IMPRESSIONS 和設定為操作的 optimization_goal
  • CPA 既指 billing_event，也指設定為操作的 optimization_goal
目標 廣告創意，出價類型 追蹤規格 說明

CANVAS_APP_
ENGAGEMENT

全螢幕展示應用程式互動廣告，當中包含 optimization_goal= APP_INSTALLS

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

請查看 app_engagement 和 post_engagement 的中繼規格

CANVAS_APP_
INSTALLS

全螢幕展示應用程式安裝廣告，其優化方式未設定為 optimization_goal= APP_INSTALLS

[{'action.type':
'app_engagement',
'application':
'APPLICATION_ID'}, {'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}]

請查看 app_engagement 和 post_engagement 的中繼規格

CONVERSIONS

專頁帖子連結和相片廣告，當中包含 promoted_object（設定為像素編號）和 optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

帖子互動和專頁讚好規格。特定專頁帖子連結點擊次數（如果僅有一個連結）、帖子的互動次數，以及用戶發佈動態或與專頁互動的次數

CONVERSIONS

專頁帖子連結和相片廣告，其優化方式未設定為 optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'},
{'action.type':'like',
'page':PAGE_ID}

轉換、帖子互動和專頁讚好規格。特定專頁帖子連結點擊次數（如果僅有一個連結）、帖子的互動次數，以及用戶發佈動態或與專頁互動的次數

CONVERSIONS

網域廣告，當中包含 promoted_object（設定為像素編號）和 optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

專頁讚好和連結點擊規格。特定專頁帖子連結點擊次數（如果僅有一個連結）、帖子的互動次數，以及用戶發佈動態或與專頁互動的次數。

CONVERSIONS

網域廣告，其優化方式未設定為 optimization_goal= OFFSITE_CONVERSIONS

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}, {'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

轉換、專頁讚好和連結點擊規格。特定專頁帖子連結點擊次數（如果僅有一個連結）、帖子的互動次數，以及用戶發佈動態或與專頁互動的次數。

EVENT_RESPONSES

活動廣告，其優化方式未設定為 optimization_goal= EVENT_RESPONSES

[{'action.type':'rsvp' ,
'response':'yes', 'event':'EVENT_ID'},
{'action.type':'rsvp' ,
'response':'maybe', 'event':'EVENT_ID'},
[{'action.type':'rsvp' ,
'response':'no', 'event':'EVENT_ID'}]

活動回覆（yes、maybe、no）次數。

EVENT_RESPONSES

活動廣告，當中包含 optimization_goal= EVENT_RESPONSES

空白（轉換規格將包括追蹤的操作）

活動回覆（yes、maybe、no）次數。

LINK_CLICKS

專頁帖子連結和相片廣告，當中包含任何出價選項

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

帖子互動。
離站網址連結、包含特定網址網域的連結、專頁中的離站連結和帖子中的離站連結之點擊次數。

LINK_CLICKS

網域廣告，當中包含 optimization_goal= LINK_CLICKS

{'action.type':'like',
'page':PAGE_ID}]

專頁讚好。
離站網址連結、包含特定網址網域的連結、專頁中的離站連結和帖子中的離站連結之點擊次數。

LINK_CLICKS

網域廣告，其優化方式未設定為 optimization_goal= LINK_CLICKS

{'action.type':
'link_click',
'object':'URL'}, {'action.type':'like',
'page':PAGE_ID}

網站點擊和專頁讚好。
離站網址連結、包含特定網址網域的連結、專頁中的離站連結和帖子中的離站連結之點擊次數。

MOBILE_APP_
ENGAGEMENT

流動應用程式互動廣告，當中包含任何出價選項

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
對於應用程式互動廣告，您必須使用 Facebook 應用程式編號明確指定追蹤規格：
[{'action.type': 'mobile_app_install', 'application': 'APP_ID'}, {'action.type':
'app_custom_event',
'application':APP_ID}]

請查看 post_engagement 的中繼規格，以及應用程式事件的發生次數。

MOBILE_APP_
INSTALLS

流動應用程式安裝廣告，當中包含任何出價選項

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}
對於應用程式安裝廣告，您必須使用 Facebook 應用程式編號明確指定追蹤規格：
[{'action.type':
'app_custom_event',
'application':APP_ID}, {'action.type': 'mobile_app_install', 'application': 'APP_ID'}]

請查看 post_engagement 的中繼規格，以及用戶透過流動應用程式安裝廣告安裝應用程式的次數（如有 iOS/Android 版本）和應用程式事件的發生次數。

NONE

任何廣告類型

請根據廣告類型
查看預設追蹤規格

PAGE_LIKES

專頁讚好廣告或專頁帖子廣告，當中包含任何出價選項

{'action.type':
'page_engagement', 'page':'PAGE_ID'}

請查看專頁互動的中繼規格

POST_ENGAGEMENT

專頁帖子廣告，其優化方式未設定為 optimization_goal= POST_ENGAGEMENT

{'action.type':
'post_engagement',
'post':'POST_ID', 'page':'PAGE_ID'}

請查看專頁帖子互動的中繼規格

POST_ENGAGEMENT

專頁帖子廣告，當中包含 optimization_goal= POST_ENGAGEMENT

空白

請查看專頁帖子互動的中繼規格

POST_ENGAGEMENT（測試中）

任何

{'action.type':
'dwell',
'post':'POST_ID', 'page':'PAGE_ID'}

此類廣告的一小部分擁有 dwell 追蹤類型，重點關注在廣告中停留的時間達到最小值的用戶。

PRODUCT_ CATALOG_SALES

動態產品廣告

{'action.type': 'post_engagement', 'page': PAGE_ID, 'post': POST_ID}

特定專頁帖子連結點擊次數（如果僅有一個連結）、帖子的互動次數，以及用戶發佈動態或與專頁互動的次數。您可指定與推廣物件中的商品組合不同的商品組合，但預設商品組合會是您在推廣物件中指定的商品系列。

中繼規格

您可使用單個規格為單個物件指定多種類型的操作。

物件 轉換規格 說明

應用程式

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

用戶發佈動態 app_story 或透過 app_use、app_install 和 credit_spent 與內容互動的次數。

專頁

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

用戶執行與特定專頁相關的下列任何操作之次數：簽到、回應、追蹤、讚好、讚好專頁帖子、提及、在專頁中發佈帖子、分享帖子、回答問題。這還包括用戶執行與特定專頁相關的下列任何操作之次數：點擊連結、瀏覽相片、播放原生 Facebook 影片。

專頁帖子

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

用戶執行與特定帖子相關的下列任何操作之次數：回應、追蹤問題、讚好、分享、回答問題。這還包括用戶執行下列任何操作之次數：點擊連結、讚好專頁、瀏覽相片、播放託管在 Facebook 上的影片或播放內嵌 Youtube 影片。對於非嵌入式影片，請使用 link_click。

自訂追蹤規格

如需定義您自己的追蹤規格，請使用操作規格框架。請查看參考文件中的操作規格部分。

操作（物件類型） 說明和追蹤規格詳情 追蹤或轉換規格

app_custom_event（應用程式）

應用程式中的自訂事件。
流動應用程式的自訂事件次數。

{'action.type':
'app_custom_event',
'application':APP_ID}

app_install（應用程式）

安裝應用程式。
全螢幕展示廣告或流動應用程式
的安裝次數

[{'action.type':'app_install',
'application':APP_ID},
{'action.type':
'mobile_app_install',
'application':APP_ID}]

app_use（應用程式）

應用程式使用次數。

{'action.type':'app_use',
'application':APP_ID}

簽到（地點）

在某地點簽到。
在此專頁的特定地點或任何子地點簽到的次數。

{'action.type':'checkin',
'page':PAGE_ID},
{'action.type':'checkin',
'page.parent:PAGE_ID}

回應（帖子）

回應帖子。
任何或特定專頁帖子的回應次數。

{'action.type':'comment',
'post.wall':PAGE_ID},
{'action.type':'comment',
'post':POST_ID,
'post.wall':PAGE_ID}

credit_spend（應用程式）

在應用程式中使用抵用金消費的實例。

'action.type':'credit_spent',
'application':APP_ID}

追蹤（問題）

訂閱物件。
某問題的回答或追蹤次數。

{'action.type':'vote', 'question':QUESTION_ID, 'question.creator':PAGE_ID}, {'action.type':'follow', 'question':QUESTION_ID, 'question.creator':PAGE_ID}

leadgen_quality_conversion（像素）

下漏斗潛在顧客轉換（客戶關係管理）事件。

{'action.type': 'leadgen_quality_conversion', 'fb_pixel': 'FACEBOOK_PIXEL_ID'}, {'action.type': 'leadgen_quality_conversion', 'dataset': 'OFFLINE_EVENT_SET_ID'}

讚好
（專頁和帖子）

讚好物件。
專頁或帖子的讚好次數。

{'action.type':'like',
'page':PAGE_ID}
, {'action.type':'like',
'post.wall':PAGE_ID}
, {'action.type':'like',
'post':POST_ID,
'post.wall':PAGE_ID}

link_click（專頁、帖子、網址、網址網域）

點擊連結。
離站網址連結、包含特定網址網域的連結、專頁中的離站連結和帖子中的離站連結之點擊次數。

{'action.type':['link_click'],
'object':['URL']},
{'action.type':['link_click'],
'object.domain':
['URL_DOMAIN']},
{'action.type':['link_click'],
'post.wall':['PAGE_ID']},
{'action.type':['link_click'],
'post':['POST_ID'],
'post.wall':['PAGE_ID']}

提及（專頁）

提及專頁。
專頁的提及次數。

{'action.type':'mention',
'object':PAGE_ID'}

offsite_conversion（像素）

離站轉換次數和累計收入。

{'action.type':
'offsite_conversion',
'fb_pixel':
'FACEBOOK_PIXEL_ID'}

photo_view（專頁）

瀏覽相片。專頁中任何或特定帖子分享的相片/影片/連結之
相片瀏覽
、video_plays 或 link_clicks 次數。

{'action.type':'photo_view', 'post.wall':PAGE_ID}
{'action.type':'photo_view', 'post':POST_ID,
'post.wall':PAGE_ID}

post（帖子）

分享動態。
用戶在專頁中發佈帖子的次數。

{'action.type':'post',
'post.wall':PAGE_ID}

receive_offer（優惠）

領取優惠。
領取特定優惠的人數。

{'action.type':'receive_offer',
'offer':OFFER_ID}

rsvp（活動）

回覆活動。
活動回覆（yes 和 maybe）次數。有效值為 yes、maybe 和 no。

{'action.type':'rsvp',
'event':EVENT_ID},

{'action.type':'rsvp',
'response':'yes',
'event':EVENT_ID},

{'action.type':'rsvp',
'response':'no',
'event':EVENT_ID},
{'action.type':'rsvp',
'response':'maybe',
'event':EVENT_ID}

tab_view（專頁）

瀏覽專頁標籤頁
特定專頁標籤頁的瀏覽次數。如果您想獲取所有標籤頁的瀏覽次數，只需指定專頁即可。

{'action.type':'tab_view',
'page.tab.name':
'PAGE_TAB_NAME', 'page':PAGE_ID},
{'action.type':'tab_view',
'page':PAGE_ID}

video_play（帖子）

觀看影片。
專頁中任何或特定影片帖子的影片觀看次數。

{'action.type':'video_play', 'post.wall':PAGE_ID},{'action.type':'video_play', 'post':POST_ID,
'post.wall':PAGE_ID}

範例

像素追蹤

透過在廣告的 tracking_specs 欄位指定追蹤像素，即可追蹤廣告中不同像素的表現。例如：

tracking_specs="[
  {'action.type':'offsite_conversion','fb_pixel':1},
  {'action.type':'offsite_conversion','fb_pixel':2},
  {'action.type':'offsite_conversion','fb_pixel':3}
]"

此欄位會追蹤像素「1」、「2」和「3」的表現。如果您僅希望優化像素「1」，請定義父廣告組合的 promoted_object。如果您不僅希望優化 CHECKOUT，還想追蹤 REGISTRATION 和 ADD_TO_CART 的數量，這種方法便很有用。

系統會自動追蹤透過在 promoted_object 中指定像素編號而優化的像素，因此您無需在 tracking_specs 中指定相同的像素。

使用轉換規格

conversion_specs 是適用於廣告的欄位。其格式為 {'action.type':'{ACTION}', ... }，當中每個操作均適用於一個物件。以下為各種廣告類型的轉換規格範例：

廣告類型 轉換規格

包含社交內容的網域廣告

{'action.type':'link_click', 'object':'URL'}

專頁讚好廣告

{'action.type':'like', 'page':PAGE_ID}

專頁帖子連結廣告

{'action.type':['link_click'], 'post': [POST_ID], 'post.wall':[PAGE_ID]}

所有其他專頁帖子廣告

{'action.type':'post_engagement', 'post':'POST_ID', 'page':'PAGE_ID'}

活動廣告

{'action.type':'rsvp' , 'response':'yes', 'event':'EVENT_ID'}

優惠廣告

{'action.type':'receive_offer', 'offer':OFFER_ID, 'offer.creator':PAGE_ID}

流動應用程式安裝廣告

N/A - 目標為 NONE 時，無法建立此類廣告。

流動應用程式互動廣告

N/A - 僅支援 CPC 和 CPM 出價類型

全螢幕展示應用程式安裝廣告

N/A - 目標為 NONE 時，無法建立此類廣告

全螢幕展示應用程式互動廣告

N/A - 目標為 NONE 時，無法建立此類廣告

部分轉換規格包含多個適用於單個物件的操作。這些稱為中繼規格。範例如下：

物件 轉換規格 說明

專頁

{"action.type":["page_engagement"], "page":["PAGE_ID"]}

用戶在特定專頁採取下列操作的次數：簽到、回應、追蹤、讚好、讚好專頁帖子、提及、在專頁中發佈帖子、分享帖子、回答問題。這包括用戶在特定專頁執行下列操作的次數：瀏覽相片、播放原生 Faacebook 影片。

專頁帖子

{"action.type":["post_engagement"], "post":["POST_ID"], "page":["PAGE_ID"]}

用戶在特定帖子執行下列某項操作的次數：回應、追蹤問題、讚好、分享、領取優惠、回答問題。這包括用戶執行下列操作的次數：點擊連結、讚好專頁、瀏覽相片、播放託管在 Facebook 上的影片或播放內嵌 Youtube 影片。對於非嵌入式視頻，請使用 link_click。

應用程式

{"action.type":["app_engagement"], "application":["APPLICATION_ID"]}

用戶發佈 app_story 或以 app_use、app_install 或 credit_spent 形式與內容互動的次數。