Chiến dịch ứng dụng Advantage+

Chiến dịch ứng dụng Advantage+ (trước đây gọi là Quảng cáo ứng dụng tự động) sử dụng công nghệ máy học và hệ thống tự động hóa để cải thiện kết quả của quảng cáo cài đặt ứng dụng. Với giải pháp này, bạn có thể mở rộng quy mô chiến dịch và cuối cùng là nâng cao hiệu quả công việc.

Quảng cáo ứng dụng thông thường so với chiến dịch ứng dụng Advantage+:

Quảng cáo ứng dụng thủ côngChiến dịch ứng dụng Advantage+
1 chiến dịch
Nhiều nhóm quảng cáo
Nhiều quảng cáo
1 chiến dịch
1 nhóm quảng cáo
Nhiều quảng cáo

Phụ thuộc vào nội dung điều chỉnh thủ công.

Phụ thuộc vào nội dung điều chỉnh của công nghệ máy học.

Thử nghiệm thủ công tối đa 50 cách kết hợp nội dung.

Thử nghiệm thủ công tối đa 50 cách kết hợp nội dung.

Hiện đã có chiến dịch ứng dụng Advantage+ trên SKAdNetwork nhắm mục tiêu đến người dùng iOS 14.

Trước khi bạn bắt đầu

Để sử dụng chiến dịch ứng dụng Advantage+, bạn cần có:

  • Một tài khoản nhà phát triển trên Facebook
  • Các quyền sau đây: ads_managementads_read

Bạn phải được phép thực hiện các lệnh gọi GETPOST đến tài khoản quảng cáo dùng để nạp tiền cho quảng cáo của mình.

Bước 1: Tạo chiến dịch

Gửi yêu cầu POST đến /act_{ad_account_id}/campaigns kèm theo các thông số bắt buộc và không bắt buộc sau đây:

Thông sốMô tả
adlabels
danh sách đối tượng

Nhãn quảng cáo được liên kết với chiến dịch ứng dụng Advantage+. Không bắt buộc.

buying_type
chuỗi

Hiện tại, chiến dịch ứng dụng Advantage+ chỉ hỗ trợ buying_type AUCTION. Bắt buộc.

execution_options
danh sách giá trị enum

Giá trị mặc định: set. Sau đây là những lựa chọn khác:

  • validate_only: khi bạn chỉ định lựa chọn này, lệnh gọi API không biến đổi mà sẽ triển khai các quy tắc xác thực dựa trên giá trị của từng trường.
  • include_recommendations: bạn không thể sử dụng riêng lựa chọn này. Khi bạn sử dụng lựa chọn này, hệ thống sẽ bổ sung các đề xuất về cấu hình của đối tượng quảng cáo. Phản hồi sẽ có một phần riêng là đề xuất (chỉ khi có đề xuất cho quy cách này).

Nếu lệnh gọi vượt qua quy trình xác thực hoặc xét duyệt, phản hồi sẽ là {"success": true}. Nếu không vượt qua quy trình này, hệ thống sẽ trả về lỗi kèm thêm thông tin chi tiết. Không bắt buộc.

is_skadnetwork_attribution
chuỗi

Xác định chiến dịch trên SKAdsNetwork. Không bắt buộc

name
chuỗi

Tên của chiến dịch ứng dụng Advantage+.

objective
enum

Đây là mục tiêu chiến dịch. Hãy chỉ định APP_INSTALLS cho loại quảng cáo này. Bắt buộc.

promoted_object
đối tượng

Đối tượng được quảng bá trên mọi quảng cáo thuộc nhóm quảng cáo này. Đối với chiến dịch ứng dụng Advantage+, hãy cung cấp application_idobject_store_url.


Nếu mục tiêu tối ưu hóa của bạn không phải là APP_INSTALLS, hãy cung cấp:

Sự kiện tiêu chuẩnSự kiện tùy chỉnh

application_id, object_store_urlcustom_event_type

application_id, object_store_url, custom_event_str và chỉ định custom_event_type = OTHER

Bắt buộc nếu is_skadnetwork_attribution được đặt là true.

smart_promotion_type
danh sách đối tượng

Để chỉ định đây là Chiến dịch ứng dụng Advantage+, bạn phải đặt kiểu quảng bá thông minh là SMART_APP_PROMOTION. Không bắt buộc.

special_ad_categories
danh sách đối tượng

Chiến dịch ứng dụng Advantage+ hiện không hỗ trợ hạng mục quảng cáo đặc biệt. Vui lòng chỉ định đây là một danh sách trống, có dạng như []. Bắt buộc.

status
enum

Lựa chọn hợp lệ: PAUSEDACTIVE.

Nếu trạng thái này là PAUSED, tất cả quảng cáo cũng như nhóm quảng cáo đang hoạt động sẽ bị tạm dừng và có trạng thái hiệu lực là CAMPAIGN_PAUSED. Bắt buộc.

topline_id
chuỗi số hoặc số nguyên

ID dòng đơn hàng. Không bắt buộc.

Ví dụ về lệnh gọi tạo chiến dịch

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

Nếu bạn muốn cập nhật chiến dịch mình đang có, hãy xem phần Sau khi ra mắt, Cập nhật chiến dịch.

Bước 2: Xác minh việc tạo chiến dịch (không bắt buộc)

Nếu muốn, bạn có thể kiểm tra xem mình đã tạo thành công Chiến dịch ứng dụng Advantage+ hay chưa. Để thực hiện việc đó, hãy gửi yêu cầu GET đến /{ad-campaign-id} kèm theo trường smart_promotion_type. Nếu Chiến dịch ứng dụng Advantage+ hợp lệ, hệ thống sẽ trả về SMART_APP_PROMOTION.

Ví dụ về lệnh gọi xác minh chiến dịch

curl -X GET -G \
  -d 'fields="smart_promotion_type"' \
  -d 'access_token={access-token}' \
https://graph.facebook.com/v21.0/{ad-campaign-id}

Phản hồi mẫu nếu Chiến dịch ứng dụng Advantage+ được tạo là hợp lệ:

{
  "smart_promotion_type": "SMART_APP_PROMOTION",
  "id": {ad-campaign-id}
}

Bước 3: Tạo nhóm quảng cáo

Sau khi bạn tạo chiến dịch quảng cáo, hãy tạo nhóm quảng cáo. Nhóm quảng cáo là một nhóm gồm các quảng cáo có chung dữ liệu về ngân sách hàng ngày/trọn đời, lịch chạy, loại giá thầu, thông tin giá thầu và lựa chọn nhắm mục tiêu.

Để tạo nhóm quảng cáo, hãy gửi yêu cầu POST đến /act_{ad_account_id}/adsets. Bạn có thể thêm các thông số sau đây:

Thông sốMô tả

adlabels

danh sách đối tượng

Chỉ định danh sách các nhãn được liên kết với đối tượng này.

Không bắt buộc.

bid_amount

số nguyên

Bắt buộc nếu bid_strategy được đặt là LOWEST_COST_WITH_BID_CAP.

Giới hạn giá thầu hoặc chi phí mục tiêu của nhóm quảng cáo này. Giới hạn giá thầu dùng trong chiến lược giá thầu chi phí thấp nhất được xác định là giá thầu tối đa bạn muốn trả cho một kết quả dựa trên optimization_goal của bạn. Với chi phí mục tiêu dùng trong chiến lược giá thầu chi phí mục tiêu, thường thì Facebook sẽ đặt giá thầu để đáp ứng mục tiêu của bạn và duy trì mức chi tiêu ổn định.


Nếu bạn chỉ định bid_amount ở cấp độ quảng cáo, việc cập nhật giá trị này sẽ ghi đè giá thầu cấp quảng cáo trước đó.


Đơn vị của giá thầu là cent đối với các đơn vị tiền tệ như USD, EUR và là đơn vị cơ bản đối với các đơn vị tiền tệ như JPY, KRW. Giá thầu được dùng cho mỗi sự kiện và có giá trị tối thiểu là 1 cent Mỹ. Giá thầu tối thiểu tính theo các đơn vị tiền tệ khác có giá trị tương đương với giá trị tính theo Đô la Mỹ đã cung cấp.

bid_constraints

danh sách đối tượng

Bắt buộc nếu bid_strategy được đặt là lowest_cost_with_min_roas.

Tương tự như ngân sách nhóm quảng cáo, việc lựa chọn đặt giá thầu theo Lợi nhuận trên chi tiêu quảng cáo (ROAS) ở mức tối thiểu sẽ sử dụng thông số này để cung cấp ROAS sàn. Tuy nhiên, bạn không thể sử dụng bid_amount với bid_constraints.

bid_strategy

enum

Chọn chiến lược giá thầu cho nhóm quảng cáo này sao cho phù hợp với mục tiêu kinh doanh cụ thể của bạn. Mỗi chiến lược đều có ưu nhược điểm và có thể sử dụng được cho một số optimization_goals. Hãy xem bài viết Tổng quan về phương thức đặt giá thầu, Chiến lược giá thầu để biết thêm thông tin.


Đối với chiến dịch ứng dụng Advantage+, bạn có thể sử dụng các chiến lược sau đây:

  • LOWEST_COST_WITHOUT_CAP
  • LOWEST_COST_WITH_BID_CAP
  • LOWEST_COST_WITH_MIN_ROAS
Bắt buộc.
billing_event
enum

Sự kiện lập hóa đơn mà nhóm quảng cáo này đang sử dụng. Đối với Quảng cáo ứng dụng tự động, hãy chỉ định IMPRESSIONS. Bắt buộc.

campaign_id
chuỗi số hoặc số nguyên

ID của chiến dịch ứng dụng Advantage+ hợp lệ mà bạn muốn thêm nhóm quảng cáo này. Bắt buộc.

campaign_attribution

enum

Loại phân bổ chiến dịch mà nhóm quảng cáo này sử dụng.


  • Nếu bạn muốn sử dụng giao thức Đo lường sự kiện tổng hợp của Meta, hãy đặt trường này là AEM.
  • Nếu muốn sử dụng SKAdNetwork của Apple, bạn phải đặt trường này là SKADNETWORK.

Trong trường hợp một chiến dịch có nhiều nhóm quảng cáo, loại phân bổ chiến dịch của mọi nhóm quảng cáo phải giống nhau.

Đây là trường bắt buộc khi tạo chiến dịch trên iOS 14 trở lên.

daily_budget

int64

Ngân sách hàng ngày được xác định bằng đơn vị tiền tệ của tài khoản, chỉ dành cho những nhóm quảng cáo có khoảng thời gian (thời gian chênh lệch giữa end_timestart_time) dài hơn 24 giờ.

daily_budget hoặc lifetime_budget phải lớn hơn 0.

Không bắt buộc.

end_time

ngày giờ

Bắt buộc khi lifetime_budget được chỉ định.

Khi tạo một nhóm quảng cáo có daily_budget, hãy chỉ định end_time=0 để đặt nhóm quảng cáo là chạy liên tục mà không có ngày kết thúc. Thời gian phải ở định dạng nhãn thời gian UNIX UTC.


Ví dụ: 2015-03-12 23:59:59-07:00 hoặc 2015-03-12 23:59:59 PDT.

lifetime_budget

int64

Ngân sách trọn đời, được xác định bằng đơn vị tiền tệ của tài khoản. Nếu chỉ định thông số này, bạn cũng phải chỉ định end_time.

daily_budget hoặc lifetime_budget phải lớn hơn 0.

Không bắt buộc.
name
chuỗi

Tên của nhóm quảng cáo thuộc chiến dịch ứng dụng Advantage+. Bắt buộc.

optimization_goal
enum

Mục tiêu tối ưu hóa của nhóm quảng cáo. Chiến dịch ứng dụng Advantage+ hỗ trợ các mục tiêu tối ưu hóa sau đây:

  • APP_INSTALLS: Tối ưu hóa cho những người có nhiều khả năng sẽ cài đặt ứng dụng của bạn hơn.
  • OFFSITE_CONVERSIONS: Tối ưu hóa cho những người có nhiều khả năng sẽ chuyển đổi trên trang web của bạn hơn.
  • APP_INSTALLS_AND_OFFSITE_CONVERSIONS: Tối ưu hóa cho những người có nhiều khả năng sẽ cài đặt ứng dụng và chuyển đổi trên trang web của bạn hơn.
  • VALUE: Tối ưu hóa cho tổng giá trị mua hàng tối đa trong khoảng thời gian phân bổ được chỉ định.
Bắt buộc.
promoted_object
đối tượng

Đối tượng được quảng bá trên mọi quảng cáo thuộc nhóm quảng cáo này. Đối với chiến dịch ứng dụng Advantage+, hãy cung cấp application_idobject_store_url.


Nếu mục tiêu tối ưu hóa của bạn không phải là APP_INSTALLS, hãy cung cấp:

Sự kiện tiêu chuẩnSự kiện tùy chỉnh

application_id, object_store_urlcustom_event_type

application_id, object_store_url, custom_event_str và chỉ định custom_event_type = OTHER

Bắt buộc đối với tất cả chiến dịch, ngoại trừ Chiến dịch trên SKAdNetwork. Không bắt buộc đối với Chiến dịch trên SKAdNetwork.

status

enum

Bạn chỉ có thể tạo khi trạng thái là ACTIVEPAUSED. Còn đối với các trạng thái khác, bạn chỉ có thể cập nhật. Nếu một nhóm quảng cáo được đặt là PAUSED, tất cả quảng cáo đang hoạt động thuộc nhóm đó sẽ bị tạm dừng và có trạng thái hiệu lực là ADSET_PAUSED.

Bắt buộc.

start_time

ngày giờ

Thời gian bắt đầu của nhóm quảng cáo. Ví dụ: 2015-03-12 23:59:59-07:00 hoặc 2015-03-12 23:59:59 PDT. Thông số này phải ở định dạng nhãn thời gian UNIX UTC.

targeting

đối tượng nhắm mục tiêu

Cấu trúc nhắm mục tiêu của nhóm quảng cáo thuộc Chiến dịch ứng dụng Advantage+. Lựa chọn nhắm mục tiêu hợp lệ geo_locationslocales. Hãy xem phần Trường nhắm mục tiêu.


Ví dụ:

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

Chiến dịch ứng dụng Advantage+ không hỗ trợ nhắm mục tiêu theo hệ điều hành. Tuy nhiên, chiến dịch ứng dụng Advantage+ trên SKAdsNetwork sẽ chỉ nhắm mục tiêu đến người dùng iOS 14.5 trở lên.

Bắt buộc.

time_start

ngày giờ

Thời gian bắt đầu chạy nhóm quảng cáo này.

time_stop

ngày giờ

Thời gian dừng chạy nhóm quảng cáo này.

Trường nhắm mục tiêu

Thông sốMô tả

geo_locations

mảng

Dùng để giới hạn đối tượng của nhóm quảng cáo thông qua đối số bắt buộc là countries. Giá trị hợp lệ: countries. Một mảng mã theo định dạng ISO 3166 gồm 2 chữ số.

Bắt buộc.

locales

mảng

Nhắm mục tiêu đến những người có ngôn ngữ khác với ngôn ngữ phổ biến cho một vị trí. Để sử dụng trường này, hãy cung cấp ID cho ngôn ngữ đó, chẳng hạn như 5 cho tiếng Đức. Hãy xem bài viết Tìm kiếm nhắm mục tiêu, Ngôn ngữ để biết thêm thông tin.

Ví dụ về lệnh gọi tạo nhóm quảng cáo

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

Nếu bạn muốn cập nhật nhóm quảng cáo mình đang có, hãy xem phần Sau khi ra mắt, Cập nhật nhóm quảng cáo.

Khả năng tương thích tối ưu hóa

Ở cấp độ nhóm quảng cáo, bạn phải chỉ định mục tiêu tối ưu hóa, chiến lược giá thầu và loại sự kiện tùy chỉnh. Bảng sau đây trình bày những cách hợp lệ để kết hợp các trường này.

Mục tiêu tối ưu hóaChiến lược giá thầuLoại sự kiện tùy chỉnh

APP_INSTALLS

LOWEST_COST_WITHOUT_CAPLOWEST_COST_WITH_BID_CAP

Không áp dụng.

APP_INSTALLS_AND_OFFSITE_CONVERSIONS

LOWEST_COST_WITHOUT_CAP

PURCHASE

OFFSITE_CONVERSIONS

LOWEST_COST_WITHOUT_CAPLOWEST_COST_WITH_BID_CAP

Tất cả sự kiện tiêu chuẩn trong ứng dụng, bao gồm cả PURCHASE, ADD_TO_CART, INITIATED_CHECKOUT và hơn thế nữa.

VALUE

LOWEST_COST_WITHOUT_CAPLOWEST_COST_WITH_MIN_ROAS

PURCHASE

Ví dụ về lệnh gọi tạo nhóm quảng cáo trên 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

Bước 4: Cung cấp nội dung và tạo quảng cáo

Khi đã có nhóm quảng cáo, bạn có thể tạo quảng cáo bằng cách gửi yêu cầu POST đến điểm cuối /act_{ad_account_id}/ads. Bạn có thể thêm các thông số sau đây:

Thông sốMô tả

adset_id

int64

Bắt buộc.
ID của nhóm quảng cáo.

adlabels

danh sách đối tượng

Không bắt buộc.
Nhãn quảng cáo được liên kết với quảng cáo này.

creative

AdCreative

Bắt buộc.
Quy cách nội dung của nội dung quảng cáo mà quảng cáo này sẽ sử dụng. Các trường hợp lệ là object_story_spec, asset_feed_specuse_page_actor_override. Hãy xem phần Trường nội dung để biết thêm thông tin.


Bạn có thể cung cấp nội dung ở định dạng sau đây:

{
  "creative_id":  {creative-id}
}

Cung cấp quy cách nội dung:

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

execution_options

danh sách giá trị enum

Không bắt buộc.
Giá trị mặc định: set.
Sau đây là những lựa chọn khác:

  • validate_only: khi bạn chỉ định lựa chọn này, lệnh gọi API không biến đổi mà sẽ triển khai các quy tắc xác thực dựa trên giá trị của từng trường.
  • synchronous_ad_review: bạn không thể sử dụng riêng lựa chọn này. Bạn luôn phải chỉ định lựa chọn này cùng với validate_only. Khi bạn chỉ định những lựa chọn này, lệnh gọi API sẽ tiến hành xác thực Tính toàn vẹn của quảng cáo, bao gồm cả việc kiểm tra ngôn ngữ tin nhắn, quy tắc văn bản chiếm 20% hình ảnh, v.v. cũng như logic xác thực.
  • include_recommendations: bạn không thể sử dụng riêng lựa chọn này. Khi bạn sử dụng lựa chọn này, hệ thống sẽ bổ sung các đề xuất về cấu hình của đối tượng quảng cáo. Phản hồi sẽ có một phần riêng là đề xuất (chỉ khi có đề xuất cho quy cách này).

Nếu lệnh gọi vượt qua quy trình xác thực hoặc xét duyệt, phản hồi sẽ là {"success": true}. Nếu không vượt qua quy trình này, hệ thống sẽ trả về lỗi kèm thêm thông tin chi tiết.

name

chuỗi

Bắt buộc.
Tên của quảng cáo.

status

AdCreative

loại: enum

Bắt buộc.
Lựa chọn hợp lệ trong quá trình tạo: ACTIVEPAUSED. Trong quá trình thử nghiệm, bạn nên đặt trạng thái của quảng cáo là PAUSED để không vô tình phát sinh chi phí.

Trường nội dung

Thông sốMô tả

asset_feed_spec

AdAssetFeedSpec

Bắt buộc khi sử dụng /adcreatives.

Dùng cho tính năng Tùy chỉnh tài sản theo vị tríQuảng cáo đa ngôn ngữ để tùy chỉnh tài sản nội dung hiển thị ở nhiều vị trí quảng cáo hoặc nhiều ngôn ngữ. Thông số này có định dạng là chuỗi JSON.


Trường có sẵn:

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

Hãy tham khảo bài viết Lựa chọn cho nguồn cấp dữ liệu tài sản để biết thêm thông tin về từng trường.

object_story_spec

AdCreativeObjectStorySpec
Bắt buộc.

Dùng trong trường hợp bạn muốn đính kèm hình ảnh/video vào một quảng cáo hoặc bạn muốn sử dụng định dạng quảng cáo quay vòng. Bạn cũng có thể dùng thông số này nếu muốn tạo một bài viết mới không đăng trên Trang và biến bài viết đó thành quảng cáo.


Trường có sẵn:

use_page_actor_override

AdCreative

Nếu thông số này được đặt là true, chúng tôi sẽ hiển thị trang Facebook liên kết với Quảng cáo ứng dụng.

Ví dụ về lệnh gọi tạo quảng cáo

Nếu bạn cung cấp nội dung ở định dạng quy cách nội dung:

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

Nếu muốn dùng creative_id, trước tiên, bạn phải cung cấp nội dung bằng lệnh gọi /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

Khi thành công, lệnh gọi trước đó sẽ trả về creative_id mà bạn có thể sử dụng trong lệnh gọi /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

Nếu bạn muốn cập nhật quảng cáo mình đang có, hãy xem phần Sau khi ra mắt, Cập nhật quảng cáo.

Ví dụ về ảnh/video tĩnh

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

Ví dụ về tùy chỉnh tài sản theo vị trí

Khi bạn muốn tùy chỉnh tài sản nội dung hiển thị ở nhiều vị trí quảng cáo. Hãy truy cập vào trang Tùy chỉnh tài sản theo vị trí để biết chi tiết.

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

Ví dụ về quảng cáo đa ngôn ngữ

Khi bạn muốn tùy chỉnh các phần khác nhau của nội dung quảng cáo, chẳng hạn như hình ảnh, video, văn bản và nội dung của quảng cáo để tiếp cận những người nói ngôn ngữ khác. Hãy truy cập vào trang Quảng cáo đa ngôn ngữ để biết chi tiết.

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

Ví dụ về nhiều văn bản

Khi bạn muốn cung cấp nhiều Tiêu đề hoặc Văn bản chính.

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

Ví dụ về tùy chỉnh tài sản theo vị trí + nhiều văn bản

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

Sau khi ra mắt

Sau khi ra mắt chiến dịch ứng dụng Advantage+, bạn có thể cần cập nhật hoặc đọc các đối tượng quảng cáo. Hãy xem cách thực hiện những thao tác đó trong phần dưới đây. Đối với thông tin chi tiết về quảng cáo, hãy xem tài liệu Quy cách nguồn cấp dữ liệu tài sản, Thông tin chi tiết của chúng tôi.

Cập nhật chiến dịch

Nếu bạn cần cập nhật chiến dịch Quảng cáo ứng dụng tự động, hãy gửi yêu cầu POST đến /{campaign_id}. Bạn có thể sử dụng các thông số sau đây trong lệnh gọi API:

Thông sốMô tả

adlabels

danh sách đối tượng

Nhãn quảng cáo phải được liên kết với Chiến dịch ứng dụng Advantage+.

execution_options

danh sách giá trị enum

Giá trị mặc định: set. Dưới đây là những lựa chọn khác hiện có:

  • validate_only: khi bạn chỉ định lựa chọn này, lệnh gọi API không biến đổi mà sẽ triển khai các quy tắc xác thực dựa trên giá trị của từng trường.
  • include_recommendations: bạn không thể sử dụng riêng lựa chọn này. Khi bạn sử dụng lựa chọn này, hệ thống sẽ bổ sung các đề xuất về cấu hình của đối tượng quảng cáo. Phản hồi sẽ có một phần riêng là đề xuất (chỉ khi có đề xuất cho quy cách này).

Nếu lệnh gọi vượt qua quy trình xác thực hoặc xét duyệt, phản hồi sẽ là {"success": true}. Nếu không vượt qua quy trình này, hệ thống sẽ trả về lỗi kèm thêm thông tin chi tiết.

name

chuỗi

Tên mới mà bạn muốn đặt cho Chiến dịch ứng dụng Advantage+.

status

enum

Bạn có thể sử dụng trạng thái sau đây cho lệnh gọi API cập nhật:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Nếu một chiến dịch quảng cáo được đặt là PAUSED, các đối tượng con đang hoạt động thuộc chiến dịch đó sẽ bị tạm dừng và có trạng thái hiệu lực là CAMPAIGN_PAUSED.

topline_id

chuỗi số hoặc số nguyên

ID dòng đơn hàng.

Ví dụ về cập nhật chiến dịch

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}

Cập nhật nhóm quảng cáo

Nếu bạn cần cập nhật nhóm quảng cáo cho Quảng cáo ứng dụng tự động, hãy gửi yêu cầu POST đến /{ad_set_id}. Bạn có thể sử dụng các thông số sau đây trong lệnh gọi API:

Thông sốMô tả

adlabels

danh sách đối tượng

Chỉ định danh sách các nhãn được liên kết với đối tượng này. Không bắt buộc.

bid_amount

số nguyên

Bắt buộc nếu bid_strategy được đặt là LOWEST_COST_WITH_BID_CAP.

Giới hạn giá thầu hoặc chi phí mục tiêu của nhóm quảng cáo này. Giới hạn giá thầu dùng trong chiến lược giá thầu chi phí thấp nhất được xác định là giá thầu tối đa bạn muốn trả cho một kết quả dựa trên optimization_goal của bạn. Với chi phí mục tiêu dùng trong chiến lược giá thầu chi phí mục tiêu, thường thì Facebook sẽ đặt giá thầu để đáp ứng mục tiêu của bạn và duy trì mức chi tiêu ổn định.


Nếu bạn chỉ định bid_amount ở cấp độ quảng cáo, việc cập nhật giá trị này sẽ ghi đè giá thầu cấp quảng cáo trước đó.


Đơn vị của giá thầu là cent đối với các đơn vị tiền tệ như USD, EUR và là đơn vị cơ bản đối với các đơn vị tiền tệ như JPY, KRW. Giá thầu được dùng cho mỗi sự kiện và có giá trị tối thiểu là 1 cent Mỹ. Giá thầu tối thiểu tính theo các đơn vị tiền tệ khác có giá trị tương đương với giá trị tính theo Đô la Mỹ đã cung cấp.

bid_strategy

enum

Chọn chiến lược giá thầu cho nhóm quảng cáo này sao cho phù hợp với mục tiêu kinh doanh cụ thể của bạn. Mỗi chiến lược đều có ưu nhược điểm và có thể sử dụng được cho một số optimization_goals. Hãy xem bài viết Tổng quan về phương thức đặt giá thầu, Chiến lược giá thầu để biết thêm thông tin.

Để cập nhật nhóm quảng cáo thuộc Chiến dịch ứng dụng Advantage+, bạn có thể sử dụng các chiến lược sau đây:

  • LOWEST_COST_WITHOUT_CAP
  • LOWEST_COST_WITH_BID_CAP

Nếu bạn bật tính năng Tối ưu hóa ngân sách chiến dịch, hãy đặt bid_strategy ở cấp độ chiến dịch chính.

daily_budget

int64

Ngân sách hàng ngày được xác định bằng đơn vị tiền tệ của tài khoản, chỉ dành cho những nhóm quảng cáo có khoảng thời gian (thời gian chênh lệch giữa end_timestart_time) dài hơn 24 giờ. daily_budget hoặc lifetime_budget phải lớn hơn 0.

end_time

ngày giờ

Thời gian kết thúc, bắt buộc khi lifetime_budget được chỉ định. Thông số này phải ở định dạng nhãn thời gian UNIX UTC. Ví dụ: 2015-03-12 23:59:59-07:00 hoặc 2015-03-12 23:59:59 PDT.


Khi tạo một nhóm quảng cáo có ngân sách hàng ngày, hãy chỉ định end_time=0 để đặt nhóm quảng cáo là chạy liên tục mà không có ngày kết thúc.

execution_options

danh sách giá trị enum

Không bắt buộc.

Giá trị mặc định: set. Sau đây là những lựa chọn khác:

  • validate_only: khi bạn chỉ định lựa chọn này, lệnh gọi API không biến đổi mà sẽ triển khai các quy tắc xác thực dựa trên giá trị của từng trường.
  • include_recommendations: bạn không thể sử dụng riêng lựa chọn này. Khi bạn sử dụng lựa chọn này, hệ thống sẽ bổ sung các đề xuất về cấu hình của đối tượng quảng cáo. Phản hồi sẽ có một phần riêng là đề xuất (chỉ khi có đề xuất cho quy cách này).

Nếu lệnh gọi vượt qua quy trình xác thực hoặc xét duyệt, phản hồi sẽ là {"success": true}. Nếu không vượt qua quy trình này, hệ thống sẽ trả về lỗi kèm thêm thông tin chi tiết.

lifetime_budget

int64

Ngân sách trọn đời, được xác định bằng đơn vị tiền tệ của tài khoản. Nếu chỉ định thông số này, bạn cũng phải chỉ định end_time. daily_budget hoặc lifetime_budget phải lớn hơn 0.

promoted_object

đối tượng

Bắt buộc đối với một số mục tiêu chiến dịch.

Đối tượng được quảng bá trên mọi quảng cáo thuộc nhóm quảng cáo này.


Nếu mục tiêu tối ưu hóa của bạn không phải là APP_INSTALLS, các lựa chọn hiện có bao gồm:

  • custom_event_type
  • custom_event_str (nếu custom_event_type = OTHER)

start_time

ngày giờ

Thời gian bắt đầu của nhóm quảng cáo. Thông số này phải ở định dạng nhãn thời gian UNIX UTC. Ví dụ: 2015-03-12 23:59:59-07:00 hoặc 2015-03-12 23:59:59 PDT.

status

enum

Lựa chọn hiện có để bạn cập nhật:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

time_start

ngày giờ

Thời gian bắt đầu chạy nhóm quảng cáo này.

time_stop

ngày giờ

Thời gian dừng chạy nhóm quảng cáo này.

Ví dụ về cập nhật nhóm quảng cáo

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}

Cập nhật quảng cáo

Nếu bạn cần cập nhật quảng cáo cho Quảng cáo ứng dụng tự động, hãy gửi yêu cầu POST đến /{ad_id}. Bạn có thể sử dụng các thông số sau đây trong lệnh gọi API:

Thông sốMô tả

name

chuỗi

Tên của quảng cáo.

adlabels

danh sách đối tượng

Nhãn quảng cáo được liên kết với quảng cáo này.

execution_options

danh sách giá trị enum

Không bắt buộc.

Giá trị mặc định: set. Sau đây là những lựa chọn khác:

  • validate_only: khi bạn chỉ định lựa chọn này, lệnh gọi API không biến đổi mà sẽ triển khai các quy tắc xác thực dựa trên giá trị của từng trường.
  • synchronous_ad_review: bạn không thể sử dụng riêng lựa chọn này. Bạn luôn phải chỉ định lựa chọn này cùng với validate_only. Khi bạn chỉ định những lựa chọn này, lệnh gọi API sẽ tiến hành xác thực tính toàn vẹn của quảng cáo, bao gồm cả việc kiểm tra ngôn ngữ tin nhắn, quy tắc văn bản chiếm 20% hình ảnh, v.v. cũng như logic xác thực.
  • include_recommendations: bạn không thể sử dụng riêng lựa chọn này. Khi bạn sử dụng lựa chọn này, hệ thống sẽ bổ sung các đề xuất về cấu hình của một đối tượng. Phản hồi sẽ có một phần riêng là đề xuất (chỉ khi có đề xuất cho quy cách này).

Nếu lệnh gọi vượt qua quy trình xác thực hoặc xét duyệt, phản hồi sẽ là {"success": true}. Nếu không vượt qua quy trình này, hệ thống sẽ trả về lỗi kèm thêm thông tin chi tiết.

status

enum

Các lựa chọn gồm:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Trong quá trình thử nghiệm, bạn nên đặt trạng thái của quảng cáo là PAUSED để không vô tình phát sinh chi phí.

creative

AdCreative

Quy cách nội dung của nội dung quảng cáo mà quảng cáo này sẽ sử dụng. Bạn có thể xem các trường hợp lệ ở phần Trường nội dung. Cung cấp quy cách nội dung như sau:

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

Ví dụ về cập nhật quảng cáo

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}