高效速成+ 應用程式行銷活動(舊稱為自動化應用程式廣告)使用機器學習和自動化系統為您的應用程式安裝廣告帶來更多成果。此解決方案可協助您擴展行銷活動,並最終提高您的工作效率。
一般應用程式廣告與高效速成+ 應用程式行銷活動:
手動應用程式廣告 | 高效速成+ 應用程式行銷活動 |
---|---|
1 個行銷活動 多個廣告組合 多個廣告 | 1 個行銷活動 1 個廣告組合 多個廣告 |
仰賴手動調整。 | 仰賴機器學習調整。 |
手動測試最多 50 個廣告創意組合。 | 手動測試最多 50 個廣告創意組合。 |
針對 iOS 14 用戶的 SKAdNetwork 高效速成+ 應用程式行銷活動現已推出。
若要使用高效速成+ 應用程式行銷活動,您需要:
ads_management
和 ads_read
您必須取得授權,才能向提供廣告資金的廣告帳號發出 GET
和 POST
呼叫。
傳送 POST
要求至 /act_{ad_account_id}/campaigns
,並使用下列必要和選用參數:
參數 | 說明 | ||||
---|---|---|---|---|---|
adlabels 物件清單 | 與高效速成+ 應用程式行銷活動相關聯的廣告標籤。選用項目。 | ||||
buying_type 字串 | 高效速成+ 應用程式行銷活動目前僅支援 | ||||
execution_options 列舉清單 | 預設值:
如果呼叫通過驗證或審核,回應會是 | ||||
is_skadnetwork_attribution 字串 | 識別 SKAdsNetwork 行銷活動。選用項目 | ||||
name 字串 | 高效速成+ 應用程式行銷活動的名稱。 | ||||
objective 列舉 | 這是行銷活動目標。請為這類型的廣告指定 | ||||
promoted_object 物件 | 此廣告組合在其所有廣告中宣傳的物件。針對高效速成+ 應用程式行銷活動,請提供 如果您的最佳化目標不是
如果 is_skadnetwork_attribution 設為 true,則為必要項目。 | ||||
smart_promotion_type 物件清單 | 若要指定此為高效速成+ 應用程式行銷活動,智慧促銷活動類型應設為 | ||||
special_ad_categories 物件清單 | 高效速成+ 應用程式行銷活動目前不支援特殊廣告類別。請將此項目指定為空白清單,像這樣 | ||||
status 列舉 | 有效選項為: 如果此狀態為 | ||||
topline_id 數值字串或整數 | 標題編號。選用項目。 |
curl -X POST \
-F 'name=Advantage+ app campaigns sample campaign' \
-F 'objective=APP_INSTALLS' \
-F 'status=ACTIVE' \
-F 'special_ad_categories=[]' \
-F 'smart_promotion_type=SMART_APP_PROMOTION' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_{ad-account-id}/campaigns
如果您已有行銷活動,並想要加以更新,請參閱推出後:更新行銷活動。
您可以選擇檢查是否已成功建立高效速成+ 應用程式行銷活動。若要檢查,請傳送 GET
要求至 /{ad-campaign-id}
,並包含 smart_promotion_type
欄位。有效的高效速成+ 應用程式行銷活動會傳回 SMART_APP_PROMOTION
。
curl -X GET -G \
-d 'fields="smart_promotion_type"' \
-d 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/{ad-campaign-id}
回應範例(如果已建立有效的高效速成+ 應用程式行銷活動):
{ "smart_promotion_type": "SMART_APP_PROMOTION", "id": {ad-campaign-id} }
有了廣告行銷活動後,請建立廣告組合。廣告組合是共用相同單日預算或總經費、排程、出價類型、出價資訊和目標設定資料的一組廣告。
若要建立廣告組合,請傳送 POST
要求至 /act_{ad_account_id}/adsets
。您可以包含下列參數:
參數 | 說明 | ||||
---|---|---|---|---|---|
物件清單 | 指定與此物件相關聯的標籤清單。 選用項目。 | ||||
整數 | 如果 此廣告組合的出價上限或目標成本。最低成本出價策略中使用的出價上限定義為您想要根據 如果指定了廣告層級 針對美元、歐元等幣別,出價金額的單位為分,針對日元、韓元等幣別,出價金額為基本單位。出價金額是針對各幣別,最小值為 1 美分。其他幣別的最小出價金額為所提供美元值的等值。 | ||||
物件清單 | 如果 類似廣告組合預算,最低廣告投資報酬率(ROAS)出價會使用此參數來提供 ROAS 底限,但您不能使用 | ||||
列舉 | 選擇此廣告組合的出價策略,以配合您特定的業務目標。每種策略各有優缺點,可能適用於特定的 針對高效速成+ 應用程式行銷活動,可使用下列策略:
| ||||
billing_event 列舉 | 此廣告組合所使用的帳單事件。針對自動化應用程式廣告,請指定 | ||||
campaign_id 數值字串或整數 | 您想要新增此廣告組合之有效高效速成+ 應用程式行銷活動的廣告行銷活動編號。必要項目。 | ||||
列舉 | 此廣告組合所使用的行銷活動歸因類型。
當一個行銷活動有多個廣告組合時,所有廣告組合的行銷活動歸因類型應相同。 建立 iOS 14+ 行銷活動時,此為必要欄位。 | ||||
int64 | 以您的帳號幣別定義的單日預算,僅適用於持續時間(
| ||||
日期時間 | 指定 使用 例如: | ||||
int64 | 以您的帳號幣別定義的總經費。若指定此參數,也必須指定
| ||||
name 字串 | 高效速成+ 應用程式行銷活動廣告組合的名稱。必要項目。 | ||||
optimization_goal 列舉 | 廣告組合的最佳化目標。高效速成+ 應用程式行銷活動支援下列最佳化目標:
| ||||
promoted_object 物件 | 此廣告組合在其所有廣告中宣傳的物件。針對高效速成+ 應用程式行銷活動,請提供 如果您的最佳化目標不是
對 SKAdNetwork 行銷活動以外的所有行銷活動為必要項目。對 SKAdNetwork 行銷活動為選用項目。 | ||||
列舉 | 只有 | ||||
日期時間 | 組合的開始時間。例如: | ||||
目標設定物件 | 高效速成+ 應用程式行銷活動廣告組合的目標設定結構。有效的目標設定選項為 例如: { "geo_location": { "countries": [“US”] }, "locales": [8] } 高效速成+ 應用程式行銷活動不支援作業系統目標設定,但 SKAdsNetwork 高效速成+ 應用程式行銷活動只會將目標鎖定 iOS14.5+ 用戶。 必要項目。 | ||||
日期時間 | 開始刊登此廣告組合的時間。 | ||||
日期時間 | 停止刊登此廣告組合的時間。 |
參數 | 說明 |
---|---|
陣列 | 透過必要引數 countries,用來限制廣告組合的廣告受眾。有效值: |
陣列 | 鎖定使用某地點非常用語言的用戶。若要使用此欄位,請提供語言的編號,例如德文是 5。如需詳細資訊,請參閱目標設定搜尋:地區設定。 |
curl -X POST \
-F 'name=Advantage+ app campaigns sample ad set' \
-F 'campaign_id={campaign-id}' \
-F 'optimization_goal=APP_INSTALLS' \
-F 'promoted_object={ "application_id": "{app-id}", "object_store_url": "{store-object-id} }' \
-F 'daily_budget=<num>' \
-F 'billing_event=IMPRESSIONS' \
-F 'targeting={"geo_locations": {"countries": ["US"]}}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_{ad-account-id}/adsets
如果您已有廣告組合,並想要加以更新,請參閱推出後:更新廣告組合。
您必須在廣告組合層級指定最佳化目標、出價策略和自訂事件類型。下表列舉這些欄位的有效組合。
最佳化目標 | 出價策略 | 自訂事件類型 |
---|---|---|
|
| 不適用。 |
|
|
|
|
| 所有標準應用程式事件,包括 |
|
|
|
curl -X POST \ -F 'name=Advantage+ app campaigns sample campaign' \ -F 'objective=APP_INSTALLS' \ -F 'status=ACTIVE' \ -F 'special_ad_categories=[]' \ -F 'smart_promotion_type=SMART_APP_PROMOTION' \ -F 'is_skadnetwork_attribution=true' \ -F 'promoted_object={ "application_id": "{app-id}", "object_store_url": "{object-store-url}" }' \ -F 'access_token={access-token}' \ https://graph.facebook.com/act_{ad-account-id}/campaigns
有了廣告組合後,可以發佈至 /act_{ad_account_id}/ads
端點來建立廣告。您可以包含下列參數:
參數 | 說明 |
---|---|
int64 | 必要項目。 |
物件清單 | 選用項目。 |
AdCreative | 必要項目。 您可以使用下列格式來提供廣告創意: { "creative_id": {creative-id} } 提供廣告創意規格: { "creative": { \"name\": \"<NAME>\", \"object_story_spec\": <SPEC> } } |
列舉清單 | 選用項目。
如果呼叫通過驗證或審核,回應會是 |
字串 | 必要項目。 |
AdCreative 類型:列舉 | 必要項目。 |
參數 | 說明 |
---|---|
AdAssetFeedSpec | 使用 用於廣告版位素材客製化和多國語言廣告,以自訂顯示於不同廣告版位或不同語言的廣告創意素材。格式化為 JSON 字串。 可用欄位:
如需各欄位的詳細資訊,請參閱素材摘要選項。 |
AdCreativeObjectStorySpec | 必要項目。 如果您想要在廣告中附加圖像或影片,或想要使用輪播廣告格式,可以使用此參數。如果您想要建立新的未發佈粉絲專頁貼文,並將貼文轉換成廣告,也可以使用此參數。 可用欄位:
|
AdCreative | 如果設為 |
如果您提供格式為廣告創意規格的廣告創意:
curl -X POST \
-F 'name=Advantage+ app campaigns sample ad' \
-F 'adset_id={adset-id}' \
-F 'creative={"name": {name}, "object_story_spec": {specifications}}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_{ad-account-id}/ads
如果您想要使用 creative_id
,必須先透過 /adcreatives
呼叫來提供您的廣告創意:
curl -X POST \
-F 'object_story_spec={object-story-specifications}' \
-F 'asset_feed_spec={asset-feed-specifications}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_act_{ad-account-id}/adcreatives
成功後,上一個呼叫會傳回 creative_id
,您可以用在 /ads
呼叫中:
curl -X POST \
-F 'name=Advantage+ app campaigns sample ad' \
-F 'adset_id={adset-id}' \
-F 'creative={creative-id}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_{ad-account-id}/ads
如果您已有廣告,並想要加以更新,請參閱推出後:更新廣告。
curl -X POST \
-F 'name=Advantage+ app campaigns static image/video sample ad' \
-F 'adset_id={adset-id}' \
-F 'creative={
"media_type": "SINGLE_IMAGE",
"object_story_spec": {
"instagram_actor_id": "{instagram-actor-id}",
"page_id": "{page-id}",
"link_data": {
"call_to_action": {
"type": "INSTALL_MOBILE_APP"
},
"image_hash": "{image-hash}",
"link": "{link}",
"message": "{message}",
"name": "{name}"
}
}
}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_{ad-account-id}/ads
當您想要自訂顯示在不同廣告版位中的廣告創意素材。如需詳細資訊,請查看廣告版位素材客製化頁面。
curl -X POST \
-F 'object_story_spec={
"instagram_actor_id": "{instagram-actor-id}",
"page_id": "{page-id}"
}' \
-F 'asset_feed_spec={
"ad_formats": [
"SINGLE_IMAGE"
],
"asset_customization_rules": [
{
"customization_spec": {
"publisher_platforms": [
"facebook"
],
"facebook_positions": [
"feed",
"instream_video"
]
},
"image_label": {
"name": "{image-label1}"
}
},
{
"customization_spec": {
"publisher_platforms": [
"instagram"
],
"instagram_positions": [
"stream"
]
},
"image_label": {
"name": "{image-label2}"
}
}
],
"bodies": [
{
"text": "{text}"
}
],
"call_to_action_types": [
"INSTALL_MOBILE_APP"
],
"images": [
{
"hash": "{image-hash1}",
"adlabels": [
{
"name": "{image-label1}"
}
]
},
{
"hash": "{image-hash2}",
"adlabels": [
{
"name": "{image-label2}"
}
]
}
],
"link_urls": [
{
"website_url": "{website-url}",
"display_url": "{display-url}",
"deeplink_url": "{deeplink-url}"
}
],
"titles": [
{
"text": "{title}"
}
]
}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_act_{ad-account-id}/adcreatives
當您想要自訂廣告創意的不同部分,例如廣告的圖像、影片、文字和主體,以觸及不同語言的用戶。如需詳細資訊,請查看多國語言廣告頁面。
curl -X POST \
-F 'object_story_spec={
"instagram_actor_id": "{instagram-actor-id}",
"page_id": "{page-id}"
}' \
-F 'asset_feed_spec={
"ad_formats": [
"SINGLE_IMAGE"
],
"asset_customization_rules": [
{
"is_default": true,
"customization_spec": {
"locales": [
24
]
},
"title_label": {
"name": "{title-label-english}"
},
"body_label": {
"name": "{body-label-english}"
},
"link_url_label": {
"name": "{link-label-english}"
},
"image_label": {
"name": "{image-label1}"
}
},
{
"customization_spec": {
"locales": [
9,
44
]
},
"title_label": {
"name": "{title-label-french}"
},
"body_label": {
"name": "{body-label-french}"
},
"link_url_label": {
"name": "{link-label-french}"
},
"image_label": {
"name": "{image-label2}"
}
}
],
"bodies": [
{
"text": "Primary Text in English",
"adlabels": [
{
"name": "{body-label-english}"
}
]
},
{
"text": "Primary Text in French",
"adlabels": [
{
"name": "{body-label-french}"
}
]
}
],
"call_to_action_types": [
"INSTALL_MOBILE_APP"
],
"images": [
{
"hash": "{image-hash1}",
"adlabels": [
{
"name": "{image-label1}"
}
]
},
{
"hash": "{image-hash2}",
"adlabels": [
{
"name": "{image-label2}"
}
]
}
],
"link_urls": [
{
"website_url": "{website-url}",
"display_url": "{display-url}",
"deeplink_url": "{deeplink-url}",
"adlabels": [
{
"name": "{link-label-english}"
}
]
},
{
"website_url": "{website-url}",
"display_url": "{display-url}",
"deeplink_url": "{deeplink-url}",
"adlabels": [
{
"name": "{link-label-french}"
}
]
}
],
"titles": [
{
"text": "English Title",
"adlabels": [
{
"name": "{title-label-english}"
}
]
},
{
"text": "French Title",
"adlabels": [
{
"name": "{title-label-french}"
}
]
}
]
}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_act_{ad-account-id}/adcreatives
當您想要提供超過 1 個主要文字或標題。
curl -X POST \
-F 'object_story_spec={
"instagram_actor_id": "{instagram-actor-id}",
"page_id": "{page-id}"
}' \
-F 'asset_feed_spec={
"asset_feed_spec": {
"optimization_type": "DEGREES_OF_FREEDOM",
"bodies": [
{
"text": "Primary Text 1"
},
{
"text": "Primary Text 2"
},
{
"text": "Primary Text 3"
},
{
"text": "Primary Text 4"
},
{
"text": "Primary Text 5"
}
],
"call_to_action_types": [
"INSTALL_MOBILE_APP"
],
"images": [
{
"hash": "{image-hash}"
}
],
"link_urls": [
{
"website_url": "{website-url}",
"display_url": "{display-url}",
"deeplink_url": "{deeplink-url}"
}
],
"titles": [
{
"text": "Title 1"
},
{
"text": "Title 2"
},
{
"text": "Title 3"
},
{
"text": "Title 4"
},
{
"text": "Title 5"
}
]
}
}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_act_{ad-account-id}/adcreatives
curl -X POST \
-F 'object_story_spec={
"instagram_actor_id": "{instagram-actor-id}",
"page_id": "{page-id}"
}' \
-F 'asset_feed_spec={
"ad_formats": [
"SINGLE_IMAGE"
],
"asset_customization_rules": [
{
"customization_spec": {
"publisher_platforms": [
"facebook"
],
"facebook_positions": [
"feed",
"instream_video"
]
},
"image_label": {
"name": "{image-label1}"
},
"body_label": {
"name": "{body-label1}"
},
"title_label": {
"name": "{title-label1}"
}
},
{
"customization_spec": {
"publisher_platforms": [
"instagram"
],
"instagram_positions": [
"stream"
]
},
"image_label": {
"name": "{image-label2}"
},
"body_label": {
"name": "{body-label2}"
},
"title_label": {
"name": "{title-label2}"
}
}
],
"bodies": [
{
"text": "Primary Text 1",
"adlabels": [
{
"name": "{body-label1}"
},
{
"name": "{body-label2}"
}
]
},
{
"text": "Primary Text 2",
"adlabels": [
{
"name": "{body-label1}"
},
{
"name": "{body-label2}"
}
]
},
{
"text": "Primary Text 3",
"adlabels": [
{
"name": "{body-label1}"
},
{
"name": "{body-label2}"
}
]
},
{
"text": "Primary Text 4",
"adlabels": [
{
"name": "{body-label1}"
},
{
"name": "{body-label2}"
}
]
},
{
"text": "Primary Text 5",
"adlabels": [
{
"name": "{body-label1}"
},
{
"name": "{body-label2}"
}
]
}
],
"call_to_action_types": [
"INSTALL_MOBILE_APP"
],
"images": [
{
"hash": "{image-hash1}",
"adlabels": [
{
"name": "{image-label1}"
}
]
},
{
"hash": "{image-hash2}",
"adlabels": [
{
"name": "{image-label2}"
}
]
}
],
"link_urls": [
{
"website_url": "{website-url}",
"display_url": "{display-url}",
"deeplink_url": "{deeplink-url}"
}
],
"titles": [
{
"text": "Title 1",
"adlabels": [
{
"name": "{title-label1}"
},
{
"name": "{title-label2}"
}
]
},
{
"text": "Title 2",
"adlabels": [
{
"name": "{title-label1}"
},
{
"name": "{title-label2}"
}
]
},
{
"text": "Title 3",
"adlabels": [
{
"name": "{title-label1}"
},
{
"name": "{title-label2}"
}
]
},
{
"text": "Title 4",
"adlabels": [
{
"name": "{title-label1}"
},
{
"name": "{title-label2}"
}
]
},
{
"text": "Title 5",
"adlabels": [
{
"name": "{title-label1}"
},
{
"name": "{title-label2}"
}
]
}
]
}' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/act_act_{ad-account-id}/adcreatives
推出高效速成+ 應用程式行銷活動後,您可能需要更新或讀取廣告物件。請參閱下文,瞭解如何執行這些動作。如需廣告洞察報告的相關資訊,請參閱我們的素材摘要規格:洞察報告文件。
如果您需要更新自動化應用程式廣告行銷活動,請傳送 POST
要求至 /{campaign_id}
。您可以在 API 呼叫中使用下列參數:
參數 | 說明 |
---|---|
物件清單 | 應與高效速成+ 應用程式行銷活動相關聯的廣告標籤。 |
列舉清單 | 預設值:
如果呼叫通過驗證或審核,回應為 |
字串 | 您想要為高效速成+ 應用程式行銷活動設定的新名稱。 |
列舉 | 您可以在更新 API 呼叫中使用下列狀態:
如果廣告行銷活動設為 |
數值字串或整數 | 標題編號。 |
curl -X POST \
-F 'name=Advantage+ app campaigns Update Sample Campaign' \
-F 'status=PAUSED' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/{campaign-id}
如果您需要更新自動化應用程式廣告的廣告組合,請傳送 POST
要求至 /{ad_set_id}
。您可以在 API 呼叫中使用下列參數:
參數 | 說明 |
---|---|
物件清單 | 指定與此物件相關聯的標籤清單。選用項目。 |
整數 | 如果 此廣告組合的出價上限或目標成本。最低成本出價策略中使用的出價上限定義為您想要根據 如果指定了廣告層級 針對美元、歐元等幣別,出價金額的單位為分,針對日元、韓元等幣別,出價金額為基本單位。出價金額是針對各幣別,最小值為 1 美分。其他幣別的最小出價金額為所提供美元值的等值。 |
列舉 | 選擇此廣告組合的出價策略,以配合您特定的業務目標。每種策略各有優缺點,可能適用於特定的 若要更新高效速成+ 應用程式行銷活動組合,可使用下列策略:
如果您啟用行銷活動預算最佳化,請在上層行銷活動設定 |
int64 | 以您的帳號幣別定義的單日預算,僅適用於持續時間( |
日期時間 | 結束時間,指定 使用單日預算建立廣告組合時,請指定 |
列舉清單 | 選用項目。 預設值:
如果呼叫通過驗證或審核,回應為 |
int64 | 以您的帳號幣別定義的總經費。若指定此參數,也必須指定 |
物件 | 有特定行銷活動目標時為必要項目。 此廣告組合在其所有廣告中宣傳的物件。 如果您的最佳化目標不是
|
日期時間 | 組合的開始時間。必須以 UTC UNIX 時間戳記提供。例如: |
列舉 | 可用於更新的選項:
|
日期時間 | 開始刊登此廣告組合的時間。 |
日期時間 | 停止刊登此廣告組合的時間。 |
curl -X POST \
-F 'name=Advantage+ app campaigns sample updated ad set' \
-F 'bid_strategy=LOWEST_COST_WITH_BID_CAP' \
-F 'bid_amount=200' \
-F 'access_token={access-token}' \
https://graph.facebook.com/v21.0
/{ad-set-id}
如果您需要更新自動化應用程式廣告的廣告,請傳送 POST
要求至 /{ad_id}
。您可以在 API 呼叫中使用下列參數:
參數 | 說明 |
---|---|
字串 | 廣告的名稱。 |
物件清單 | 與此廣告相關聯的廣告標籤。 |
列舉清單 | 選用項目。 預設值:
如果呼叫通過驗證或審核,回應為 |
列舉 | 選項包括:
在測試期間,建議將廣告設為 |
AdCreative | 此廣告所使用之廣告創意的廣告創意規格。您可以在「廣告創意欄位」中找到有效欄位。請提供如下的廣告創意規格: { "creative": { \"name\": \"<NAME>\", \"object_story_spec\": <SPEC> } } |
curl -X POST \ -F 'name=Advantage+ app campaigns sample update ad' \ -F 'creative={"name": {name}, "object_story_spec": {specifications}}' \ -F 'access_token={access-token}' \ https://graph.facebook.com/{ad-id}