高效速成+ 應用程式行銷活動

高效速成+ 應用程式行銷活動(舊稱為自動化應用程式廣告)使用機器學習和自動化系統為您的應用程式安裝廣告帶來更多成果。此解決方案可協助您擴展行銷活動,並最終提高您的工作效率。

一般應用程式廣告與高效速成+ 應用程式行銷活動:

手動應用程式廣告高效速成+ 應用程式行銷活動
1 個行銷活動
多個廣告組合
多個廣告
1 個行銷活動
1 個廣告組合
多個廣告

仰賴手動調整。

仰賴機器學習調整。

手動測試最多 50 個廣告創意組合。

手動測試最多 50 個廣告創意組合。

針對 iOS 14 用戶的 SKAdNetwork 高效速成+ 應用程式行銷活動現已推出。

準備工作

若要使用高效速成+ 應用程式行銷活動,您需要:

您必須取得授權,才能向提供廣告資金的廣告帳號發出 GETPOST 呼叫。

步驟 1:建立行銷活動

傳送 POST 要求至 /act_{ad_account_id}/campaigns,並使用下列必要和選用參數:

參數說明
adlabels
物件清單

與高效速成+ 應用程式行銷活動相關聯的廣告標籤。選用項目。

buying_type
字串

高效速成+ 應用程式行銷活動目前僅支援 buying_type AUCTION必要項目。

execution_options
列舉清單

預設值:set。其他選項為:

  • validate_only:指定此選項時,API 呼叫不會執行變異,而是針對每個欄位的值執行驗證規則。
  • include_recommendations:此選項無法單獨使用。使用此選項時,會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊,但前提是要有針對此規格的建議存在。

如果呼叫通過驗證或審核,回應會是 {"success": true}。如果呼叫未通過,則會傳回錯誤和更多詳細資料。選用項目。

is_skadnetwork_attribution
字串

識別 SKAdsNetwork 行銷活動。選用項目

name
字串

高效速成+ 應用程式行銷活動的名稱。

objective
列舉

這是行銷活動目標。請為這類型的廣告指定 APP_INSTALLS必要項目。

promoted_object
物件

此廣告組合在其所有廣告中宣傳的物件。針對高效速成+ 應用程式行銷活動,請提供 application_idobject_store_url


如果您的最佳化目標不是 APP_INSTALLS,請提供:

標準事件自訂事件

application_idobject_store_urlcustom_event_type

application_idobject_store_urlcustom_event_str,並指定 custom_event_type = OTHER

如果 is_skadnetwork_attribution 設為 true,則為必要項目。

smart_promotion_type
物件清單

若要指定此為高效速成+ 應用程式行銷活動,智慧促銷活動類型應設為 SMART_APP_PROMOTION選用項目。

special_ad_categories
物件清單

高效速成+ 應用程式行銷活動目前不支援特殊廣告類別。請將此項目指定為空白清單,像這樣 []必要項目。

status
列舉

有效選項為:PAUSEDACTIVE

如果此狀態為 PAUSED,其所有上線的廣告組合和廣告都會暫停,且有效狀態為 CAMPAIGN_PAUSED必要項目。

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

如果您已有行銷活動,並想要加以更新,請參閱推出後:更新行銷活動

步驟 2:驗證行銷活動建立流程(選用)

您可以選擇檢查是否已成功建立高效速成+ 應用程式行銷活動。若要檢查,請傳送 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}
}

步驟 3:建立廣告組合

有了廣告行銷活動後,請建立廣告組合。廣告組合是共用相同單日預算或總經費、排程、出價類型、出價資訊和目標設定資料的一組廣告。

若要建立廣告組合,請傳送 POST 要求至 /act_{ad_account_id}/adsets。您可以包含下列參數:

參數說明

adlabels

物件清單

指定與此物件相關聯的標籤清單。

選用項目。

bid_amount

整數

如果 bid_strategy 設為 LOWEST_COST_WITH_BID_CAP,則為必要項目。

此廣告組合的出價上限或目標成本。最低成本出價策略中使用的出價上限定義為您想要根據 optimization_goal 為成果支付的最高出價。目標成本出價策略中使用的目標成本可讓 Facebook 出價達成您的平均目標,並隨著您的花費保持成本穩定。


如果指定了廣告層級 bid_amount,更新此值會覆寫先前的廣告層級出價。


針對美元、歐元等幣別,出價金額的單位為分,針對日元、韓元等幣別,出價金額為基本單位。出價金額是針對各幣別,最小值為 1 美分。其他幣別的最小出價金額為所提供美元值的等值。

bid_constraints

物件清單

如果 bid_strategy 設為 lowest_cost_with_min_roas,則為必要項目。

類似廣告組合預算,最低廣告投資報酬率(ROAS)出價會使用此參數來提供 ROAS 底限,但您不能使用 bid_amount 搭配 bid_constraints

bid_strategy

列舉

選擇此廣告組合的出價策略,以配合您特定的業務目標。每種策略各有優缺點,可能適用於特定的 optimization_goals。如需詳細資訊,請參閱出價總覽:出價策略


針對高效速成+ 應用程式行銷活動,可使用下列策略:

  • LOWEST_COST_WITHOUT_CAP
  • LOWEST_COST_WITH_BID_CAP
  • LOWEST_COST_WITH_MIN_ROAS
必要項目。
billing_event
列舉

此廣告組合所使用的帳單事件。針對自動化應用程式廣告,請指定 IMPRESSIONS必要項目。

campaign_id
數值字串或整數

您想要新增此廣告組合之有效高效速成+ 應用程式行銷活動的廣告行銷活動編號。必要項目。

campaign_attribution

列舉

此廣告組合所使用的行銷活動歸因類型。


  • 如果您想要使用 Meta 的彙總事件成效衡量,請將此欄位設為 AEM
  • 如果您想要使用 Apple 的 SKAdNetwork,則此欄位應設為 SKADNETWORK

當一個行銷活動有多個廣告組合時,所有廣告組合的行銷活動歸因類型應相同。

建立 iOS 14+ 行銷活動時,此為必要欄位。

daily_budget

int64

以您的帳號幣別定義的單日預算,僅適用於持續時間(end_timestart_time 之間的時間差)超過 24 小時的廣告組合。

daily_budgetlifetime_budget 必須大於 0。

選用項目。

end_time

日期時間

指定 lifetime_budget 時為必要項目。

使用 daily_budget 建立廣告組合時,請指定 end_time=0,將廣告組合設為持續進行而無結束日期。時間應以 UTC UNIX 時間戳記提供。


例如:2015-03-12 23:59:59-07:002015-03-12 23:59:59 PDT

lifetime_budget

int64

以您的帳號幣別定義的總經費。若指定此參數,也必須指定 end_time

daily_budgetlifetime_budget 必須大於 0。

選用項目。
name
字串

高效速成+ 應用程式行銷活動廣告組合的名稱。必要項目。

optimization_goal
列舉

廣告組合的最佳化目標。高效速成+ 應用程式行銷活動支援下列最佳化目標:

  • APP_INSTALLS:針對較有可能安裝您應用程式的用戶最佳化。
  • OFFSITE_CONVERSIONS:針對較有可能在您網站中進行轉換的用戶最佳化。
  • APP_INSTALLS_AND_OFFSITE_CONVERSIONS:針對較有可能安裝您的應用程式並在您網站中進行轉換的用戶最佳化。
  • VALUE:針對指定歸因期間內最大的總購買價值最佳化。
必要項目。
promoted_object
物件

此廣告組合在其所有廣告中宣傳的物件。針對高效速成+ 應用程式行銷活動,請提供 application_idobject_store_url


如果您的最佳化目標不是 APP_INSTALLS,請提供:

標準事件自訂事件

application_idobject_store_urlcustom_event_type

application_idobject_store_urlcustom_event_str,並指定 custom_event_type = OTHER

對 SKAdNetwork 行銷活動以外的所有行銷活動為必要項目。對 SKAdNetwork 行銷活動為選用項目。

status

列舉

只有 ACTIVEPAUSED 為建立時的有效狀態。其他狀態可用於更新。如果廣告組合設為 PAUSED,其所有上線的廣告都會暫停,且有效狀態為 ADSET_PAUSED

必要項目。

start_time

日期時間

組合的開始時間。例如:2015-03-12 23:59:59-07:002015-03-12 23:59:59 PDT。必須以 UTC UNIX 時間戳記提供。

targeting

目標設定物件

高效速成+ 應用程式行銷活動廣告組合的目標設定結構。有效的目標設定選項為 geo_locationslocales。請參閱目標設定欄位


例如:

{
   "geo_location": {
     "countries": [“US”]
     },
   "locales": [8]
}

高效速成+ 應用程式行銷活動不支援作業系統目標設定,但 SKAdsNetwork 高效速成+ 應用程式行銷活動只會將目標鎖定 iOS14.5+ 用戶。

必要項目。

time_start

日期時間

開始刊登此廣告組合的時間。

time_stop

日期時間

停止刊登此廣告組合的時間。

目標設定欄位

參數說明

geo_locations

陣列

透過必要引數 countries,用來限制廣告組合的廣告受眾。有效值:countries2 位數 ISO 3166 格式代碼陣列。

必要項目。

locales

陣列

鎖定使用某地點非常用語言的用戶。若要使用此欄位,請提供語言的編號,例如德文是 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

如果您已有廣告組合,並想要加以更新,請參閱推出後:更新廣告組合

最佳化相容性

您必須在廣告組合層級指定最佳化目標、出價策略和自訂事件類型。下表列舉這些欄位的有效組合。

最佳化目標出價策略自訂事件類型

APP_INSTALLS

LOWEST_COST_WITHOUT_CAPLOWEST_COST_WITH_BID_CAP

不適用。

APP_INSTALLS_AND_OFFSITE_CONVERSIONS

LOWEST_COST_WITHOUT_CAP

PURCHASE

OFFSITE_CONVERSIONS

LOWEST_COST_WITHOUT_CAPLOWEST_COST_WITH_BID_CAP

所有標準應用程式事件,包括 PURCHASEADD_TO_CARTINITIATED_CHECKOUT 等等。

VALUE

LOWEST_COST_WITHOUT_CAPLOWEST_COST_WITH_MIN_ROAS

PURCHASE

SKAdNetwork 組合建立呼叫範例

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

步驟 4:提供廣告創意並建立廣告

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

參數說明

adset_id

int64

必要項目。
廣告組合的編號。

adlabels

物件清單

選用項目。
與此廣告相關聯的廣告標籤。

creative

AdCreative

必要項目。
此廣告所使用之廣告創意的廣告創意規格。有效欄位為 object_story_specasset_feed_specuse_page_actor_override。如需詳細資訊,請參閱廣告創意欄位


您可以使用下列格式來提供廣告創意:

{
  "creative_id":  {creative-id}
}

提供廣告創意規格:

{
  "creative": {
    \"name\": \"<NAME>\", 
    \"object_story_spec\": <SPEC>
  }
}

execution_options

列舉清單

選用項目。
預設值:set
其他選項為:

  • validate_only:指定此選項時,API 呼叫不會執行變異,而是針對每個欄位的值執行驗證規則。
  • synchronous_ad_review:此選項不應單獨使用,應一律與 validate_only 一起指定。指定這些選項後,API 呼叫會執行廣告完整性驗證(包括訊息語言檢查、圖像 20% 文字規則等等),以及驗證邏輯。
  • include_recommendations:此選項無法單獨使用。使用此選項時,會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊,但前提是要有針對此規格的建議存在。

如果呼叫通過驗證或審核,回應會是 {"success": true}。如果呼叫未通過,將傳回錯誤和更多詳細資料。

name

字串

必要項目。
廣告的名稱。

status

AdCreative

類型:列舉

必要項目。
建立期間的有效選項:ACTIVEPAUSED。在測試期間,建議將廣告設為 PAUSED 狀態,以免產生非預期的費用。

廣告創意欄位

參數說明

asset_feed_spec

AdAssetFeedSpec

使用 /adcreatives 時的必要項目。

用於廣告版位素材客製化多國語言廣告,以自訂顯示於不同廣告版位或不同語言的廣告創意素材。格式化為 JSON 字串。


可用欄位:

  • images
  • videos
  • carousels
  • bodies
  • call_to_action_types
  • titles
  • descriptions
  • link_urls
  • ad_formats
  • optimization_type
  • asset_customization_rules

如需各欄位的詳細資訊,請參閱素材摘要選項

object_story_spec

AdCreativeObjectStorySpec
必要項目。

如果您想要在廣告中附加圖像或影片,或想要使用輪播廣告格式,可以使用此參數。如果您想要建立新的未發佈粉絲專頁貼文,並將貼文轉換成廣告,也可以使用此參數。


可用欄位:

  • page_id數值字串)- 必要項目。Facebook 粉絲專頁的編號。未發佈的粉絲專頁貼文會建立在此粉絲專頁上。用戶必須具備此粉絲專頁的管理員或編輯角色
  • instagram_actor_id數值字串)- 選用項目。要發佈限時動態的 Instagram 用戶帳號。
  • link_data - 按照應用程式廣告:建立中的指示來指定行動呼籲、相片和輪播廣告。
  • video_data - 按照應用程式廣告:使用影片建立中的指示來指定影片。

use_page_actor_override

AdCreative

如果設為 true,我們會顯示與應用程式廣告相關聯的 Facebook 粉絲專頁。

廣告建立流程呼叫範例

如果您提供格式為廣告創意規格的廣告創意:

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 呼叫中使用下列參數:

參數說明

adlabels

物件清單

應與高效速成+ 應用程式行銷活動相關聯的廣告標籤。

execution_options

列舉清單

預設值:set。其他可用的選項為:

  • validate_only:指定此選項時,API 呼叫不會執行變異,而是針對每個欄位的值執行驗證規則。
  • include_recommendations:此選項無法單獨使用。使用此選項時,會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊,但前提是要有針對此規格的建議存在。

如果呼叫通過驗證或審核,回應為 {"success": true}。如果呼叫未通過,則會傳回錯誤和更多詳細資料。

name

字串

您想要為高效速成+ 應用程式行銷活動設定的新名稱。

status

列舉

您可以在更新 API 呼叫中使用下列狀態:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

如果廣告行銷活動設為 PAUSED,其有效的子物件會暫停,且有效狀態為 CAMPAIGN_PAUSED

topline_id

數值字串或整數

標題編號。

行銷活動更新範例

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 呼叫中使用下列參數:

參數說明

adlabels

物件清單

指定與此物件相關聯的標籤清單。選用項目。

bid_amount

整數

如果 bid_strategy 設為 LOWEST_COST_WITH_BID_CAP,則為必要項目。

此廣告組合的出價上限或目標成本。最低成本出價策略中使用的出價上限定義為您想要根據 optimization_goal 為成果支付的最高出價。目標成本出價策略中使用的目標成本可讓 Facebook 出價達成您的平均目標,並隨著您的花費保持成本穩定。


如果指定了廣告層級 bid_amount,更新此值會覆寫先前的廣告層級出價。


針對美元、歐元等幣別,出價金額的單位為分,針對日元、韓元等幣別,出價金額為基本單位。出價金額是針對各幣別,最小值為 1 美分。其他幣別的最小出價金額為所提供美元值的等值。

bid_strategy

列舉

選擇此廣告組合的出價策略,以配合您特定的業務目標。每種策略各有優缺點,可能適用於特定的 optimization_goals。如需詳細資訊,請參閱出價總覽:出價策略

若要更新高效速成+ 應用程式行銷活動組合,可使用下列策略:

  • LOWEST_COST_WITHOUT_CAP
  • LOWEST_COST_WITH_BID_CAP

如果您啟用行銷活動預算最佳化,請在上層行銷活動設定 bid_strategy

daily_budget

int64

以您的帳號幣別定義的單日預算,僅適用於持續時間(end_timestart_time 之間的時間差)超過 24 小時的廣告組合。daily_budgetlifetime_budget 必須大於 0。

end_time

日期時間

結束時間,指定 lifetime_budget 時為必要項目。必須以 UTC UNIX 時間戳記提供。例如:2015-03-12 23:59:59-07:002015-03-12 23:59:59 PDT


使用單日預算建立廣告組合時,請指定 end_time=0,將廣告組合設為持續進行而無結束日期。

execution_options

列舉清單

選用項目。

預設值:set。其他選項為:

  • validate_only:指定此選項時,API 呼叫不會執行變異,而是針對每個欄位的值執行驗證規則。
  • include_recommendations:此選項無法單獨使用。使用此選項時,會包含有關廣告物件配置的建議。回應中會包含個別的建議區塊,但前提是要有針對此規格的建議存在。

如果呼叫通過驗證或審核,回應為 {"success": true}。如果呼叫未通過,則會傳回錯誤和更多詳細資料。

lifetime_budget

int64

以您的帳號幣別定義的總經費。若指定此參數,也必須指定 end_timedaily_budgetlifetime_budget 必須大於 0。

promoted_object

物件

有特定行銷活動目標時為必要項目。

此廣告組合在其所有廣告中宣傳的物件。


如果您的最佳化目標不是 APP_INSTALLS,可用的選項包括:

  • custom_event_type
  • custom_event_str(如果 custom_event_type = OTHER

start_time

日期時間

組合的開始時間。必須以 UTC UNIX 時間戳記提供。例如:2015-03-12 23:59:59-07:002015-03-12 23:59:59 PDT

status

列舉

可用於更新的選項:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

time_start

日期時間

開始刊登此廣告組合的時間。

time_stop

日期時間

停止刊登此廣告組合的時間。

廣告組合更新範例

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 呼叫中使用下列參數:

參數說明

name

字串

廣告的名稱。

adlabels

物件清單

與此廣告相關聯的廣告標籤。

execution_options

列舉清單

選用項目。

預設值:set。其他選項為:

  • validate_only:指定此選項時,API 呼叫不會執行變異,而是針對每個欄位的值執行驗證規則。
  • synchronous_ad_review:此選項不應單獨使用,應一律與 validate_only 一起指定。指定這些選項後,API 呼叫會執行廣告完整性驗證(包括訊息語言檢查、圖像 20% 文字規則等等),以及驗證邏輯。
  • include_recommendations:此選項無法單獨使用。使用此選項時,會包含有關物件配置的建議。回應中會包含個別的建議區塊,但前提是要有針對此規格的建議存在。

如果呼叫通過驗證或審核,回應為 {"success": true}。如果呼叫未通過,則會傳回錯誤和更多詳細資料。

status

列舉

選項包括:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

在測試期間,建議將廣告設為 PAUSED 狀態,以免產生非預期的費用。

creative

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}