API Marketing

Chiến dịch mua sắm Advantage+

Chiến dịch mua sắm Advantage+ là một giải pháp giúp các nhà quảng cáo thương mại điện tử và bán lẻ trực tiếp đến người tiêu dùng cũng như nhà quảng cáo thương hiệu có thể tăng hiệu suất, hiệu quả và tính cá nhân hóa. Loại chiến dịch này mang lại khả năng kiểm soát linh hoạt hơn các đòn bẩy như nội dung, tùy chọn nhắm mục tiêu, vị trí quảng cáo và ngân sách, đồng thời tăng cơ hội tối ưu hóa các chiến dịch thúc đẩy lượt chuyển đổi.

Thay vì chạy nhiều chiến dịch với đối tượng theo phân khúc, chiến dịch mua sắm Advantage+ cho phép bạn kết hợp tất cả đối tượng cho thị trường cụ thể vào một cấu trúc chiến dịch duy nhất. Nhờ vậy, bạn có thể tạo và quản lý dễ dàng, đồng thời giảm tình trạng chồng chéo đối tượng.

Thiết lập chiến dịch theo cách thủ công so với chiến dịch mua sắm Advantage+

Thiết lập chiến dịch thông thường theo cách thủ côngChiến dịch mua sắm Advantage+

Nhiều chiến dịch thông thường

Thay thế danh mục thông thường


Nhắm mục tiêu thủ công theo 7 đòn bẩy nhắm mục tiêu


Nhắm mục tiêu tự động, quy trình tự động hóa giúp tăng hiệu quả thiết lập chỉ với 1 quốc gia đầu vào


Phân bổ ngân sách chặt chẽ trong nhiều chiến dịch


Ngân sách linh động trong 1 chiến dịch


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


Hỗ trợ cả quảng cáo động lẫn quảng cáo tĩnh với tối đa 150 cách kết hợp nội dung


Tài liệu này trình bày các bước bạn cần thực hiện để thiết lập tiện ích tích hợp cho chiến dịch mua sắm Advantage+. Bạn sẽ cần:

  1. Xác định khách hàng hiện có
  2. Tạo chiến dịch
  3. Xác minh việc tạo chiến dịch
  4. Tạo nhóm quảng cáo
  5. Cung cấp nội dung và tạo quảng cáo
  6. Đặt giới hạn độ tuổi tối thiểu và trường hợp loại trừ theo vị trí địa lý (Xem tài liệu tham khảo về Chế độ kiểm soát tài khoản quảng cáo)

Tìm hiểu thêm về mô hình Tối ưu hóa chuyển đổi chéo kênh cho chiến dịch mua sắm Advantage+.

Bước 1: Xác định khách hàng hiện có của bạn

Với chiến dịch mua sắm Advantage+, bạn có thể xác định khách hàng hiện có của mình dưới dạng một tập hợp các ID đối tượng tùy chỉnh. Khách hàng hiện có là những người dùng đã quen thuộc với doanh nghiệp/sản phẩm của bạn. Sau khi thiết lập định nghĩa này, bạn có thể dùng định nghĩa để chia nhỏ ngân sách cho chiến dịch mua sắm Advantage+ nhằm giới hạn chi tiêu cho khách hàng hiện có. Chúng tôi cũng sẽ cung cấp cho bạn các số liệu báo cáo hiệu quả của chiến dịch trong những phân khúc khác nhau này.

Bạn có thể xác định quảng cáo bằng cách gửi yêu cầu POST đến điểm cuối /act_{ad_account_id}. Bạn sẽ cần thêm thông số sau đây để thiết lập định nghĩa này:

Thông sốMô tả

existing_customers

Mảng<string>

Mảng ID đối tượng tùy chỉnh mà tài khoản quảng cáo có quyền truy cập. Hiện tại, các nguồn được hỗ trợ cho đối tượng tùy chỉnh là trang web, hoạt động trong ứng dụng, danh sách khách hàng, danh mục và hoạt động offline.


Để biết thông tin về cách tạo đối tượng tùy chỉnh, hãy tham khảo trang này.

Ví dụ

curl -X POST \
  -F 'existing_customers=[<CUSTOM_AUDIENCE_ID>, <CUSTOM_AUDIENCE_ID>]' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>

Để biết thêm thông tin về cách theo dõi đối tượng mới và đối tượng hiện tại trong các công cụ theo dõi của bên thứ ba, hãy xem bài viết Thông số URL loại đối tượng.

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

Trước tiên, hãy tạo chiến dịch quảng cáo của bạn. Để thực hiện, hãy gửi yêu cầu POST đến /act_{ad_account_id}/campaigns.

Thông số


Thông sốMô tả

name
chuỗi

Bắt buộc
Tên của chiến dịch mua sắm Advantage+

objective
enum

Bắt buộc
Mục tiêu của chiến dịch. Hãy chỉ định OUTCOME_SALES cho loại quảng cáo này

special_ad_categories

danh sách<Object>

Bắt buộc
Các hạng mục quảng cáo đặc biệt được liên kết với chiến dịch mua sắm Advantage+

adlabels

danh sách<Object>

Không bắt buộc
Các nhãn quảng cáo được liên kết với chiến dịch mua sắm Advantage+

buying_type
chuỗi

Không bắt buộc
Chiến dịch mua sắm Advantage+ chỉ hỗ trợ giá trị AUCTION

execution_options

danh sách<enum>

Không bắt buộc
Giá trị mặc định: set. Dưới đây là những tùy chọn khác:

  • validate_only: khi bạn chỉ định tùy 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 tùy chọn này. Khi bạn sử dụng tùy 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 lệnh gọi 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.

smart_promotion_type
enum

Bắt buộc
Để chỉ định đây là chiến dịch mua sắm Advantage+, bạn phải đặt kiểu quảng bá thông minh là AUTOMATED_SHOPPING_ADS

status
enum

Không bắt buộc
Tùy chọn hợp lệ: PAUSED và ACTIVE.


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

Ví dụ về tạo chiến dịch

curl -X POST \
  -F 'name=Advantage+ Shopping Campaign' \
  -F 'objective=OUTCOME_SALES' \
  -F 'status=ACTIVE' \
  -F 'special_ad_categories=[]' \
  -F 'smart_promotion_type=AUTOMATED_SHOPPING_ADS' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/campaigns

Cập nhật

Bạn có thể cập nhật Chiến dịch bằng cách gửi yêu cầu POST đến /{campaign_id}.

Thông số


Thông sốMô tả

name
chuỗi

Tên của chiến dịch mua sắm Advantage+

special_ad_categories

danh sách<Object>

Các hạng mục quảng cáo đặc biệt được liên kết với chiến dịch mua sắm Advantage+

adlabels

danh sách<Object>

Các nhãn quảng cáo được liên kết với chiến dịch mua sắm Advantage+

execution_options

danh sách<enum>

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

  • validate_only: khi bạn chỉ định tùy 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 tùy chọn này. Khi bạn sử dụng tùy 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 lệnh gọi 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.

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

ID dòng đơn hàng

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.

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

curl -X POST \
  -F 'name=Advantage+ Shopping Update Sample Campaign' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<CAMPAIGN_ID>

Bước 3: Xác minh việc tạo chiến dịch

Để xác minh rằng bạn đã tạo thành công chiến dịch mua sắm Advantage+, bạn có thể gửi yêu cầu GET đến /<AD_CAMPAIGN_ID> cùng với trường smart_promotion_type.

Chiến dịch mua sắm Advantage+ hợp lệ sẽ trả về giá trị trường là AUTOMATED_SHOPPING_ADS.

Ví dụ

curl -X GET -G \
  -d 'fields=smart_promotion_type' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_CAMPAIGN_ID>

Phản hồi

{
  "smart_promotion_type": "AUTOMATED_SHOPPING_ADS",
  "id": <AD_CAMPAIGN_ID>
}

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

Khi đã có chiến dịch quảng cáo, hãy tạo nhóm quảng cáo của bạn. Mỗi chiến dịch mua sắm Advantage+ chỉ được liên kết với một nhóm quảng cáo.

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

Thông số


Thông sốMô tả

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

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

name
chuỗi

Bắt buộc
Tên của chiến dịch mua sắm Advantage+

promoted_object
Đối tượng

Bắt buộc
Đối tượng được quảng cáo 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 mua sắm Advantage+, hãy cung cấp:

  • pixel_id và
  • custom_event_type: Nhóm quảng cáo mua sắm Advantage+ hỗ trợ các sự kiện sau đây: PURCHASE, ADD_TO_CART, INITIATED_CHECKOUT, ADD_PAYMENT_INFO, ADD_TO_WISHLIST, CONTENT_VIEW, COMPLETE_REGISTRATION, DONATE, START_TRIAL, SUBSCRIBE, SEARCH, OTHER. Không hỗ trợ sự kiện chuyển đổi khách hàng.

Tìm hiểu thêm về mô hình tối ưu hóa chuyển đổi chéo kênh cho chiến dịch mua sắm Advantage+.

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

Bắt buộc
Cấu trúc nhắm mục tiêu của nhóm quảng cáo mua sắm Advantage+. Bạn chỉ được phép chỉ định geo_locations.

geo_locations
mảng

Bắt buộc
Dùng để giới hạn đối tượng của nhóm quảng cáo theo

daily_budget
int64

Không bắt buộc
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_time và start_time) dài hơn 24 giờ.


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

lifetime_budget
int64

Không bắt buộc
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.

end_time
datetime

Bắt buộc khi bạn chỉ định lifetime_budget.
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. Nhãn thời gian UNIX theo giờ UTC


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

optimization_goal
enum

Không bắt buộc
Chọn OFFSITE_CONVERSIONS làm mục tiêu tối ưu hóa để tăng tối đa số lượt chuyển đổi. Chọn VALUE làm mục tiêu tối ưu hóa nếu bạn muốn tăng tối đa giá trị chuyển đổi. Trong Trình quản lý quảng cáo, chúng tôi hiển thị Giá trị cao nhất là chiến lược giá thầu của bạn.

bid_strategy
enum

Không bắt buộc

  • LOWEST_COST_WITHOUT_CAP: Facebook sẽ tự động đặt giá thầu thay mặt bạn và đem lại cho bạn kết quả có chi phí thấp nhất. Tự động tăng giá thầu hiệu quả (nếu cần) để đạt được kết quả mà bạn muốn dựa trên optimization_goal cụ thể. Đây là bid_strategy mặc định khi optimization_goal là OFFSITE_CONVERSION hoặc VALUE.
  • LOWEST_COST_WITH_MIN_ROAS: Tùy chọn đặt giá thầu cụ thể để tối ưu hóa giá trị. Bạn phải chỉ định một roas_average_floor. Đây là mức lợi nhuận tối thiểu mà bạn muốn đạt được khi chi tiêu cho quảng cáo. Hãy xem phần Đặt giá thầu theo lợi nhuận tối thiểu trên chi tiêu quảng cáo.
  • COST_CAP: Đạt được kết quả tốt nhất có thể trong khi chúng tôi nỗ lực đáp ứng mức chi phí trên mỗi hành động mà bạn đã đặt. Bạn phải cung cấp một con số giới hạn trong trường bid_amount. Lưu ý: Chúng tôi không đảm bảo sẽ luôn tuân thủ giới hạn chi phí. Hãy xem phần Giới hạn chi phí.

bid_amount

Bắt buộc nếu bid_strategy là COST_CAP.

bid_constraints
đối tượng JSON

Không bắt buộc

  • optimization_goal phải là VALUE.
  • bid_strategy phải là LOWEST_COST_WITH_MIN_ROAS.
  • Chiến lược đặt giá thầu theo ROAS tối thiểu sử dụng bid_constraints để chuyển "ROAS floor" (ROAS sàn), nhưng bạn không thể dùng với bid_constraints. Thay vào đó, hãy sử dụng roas_average_floor. Hãy xem phần Đặt giá thầu theo lợi nhuận tối thiểu trên chi tiêu quảng cáo.
  • Phạm vi hợp lệ của roas_average_floor là [100, 10000000], tính toàn bộ. Tức là phạm vi hợp lệ của "minimum ROAS" (ROAS tối thiểu) là [0.01, 1000.0] hoặc [1%, 100000.0%], tính toàn bộ.

billing_event
enum

Bắt buộc
Sự kiện lập hóa đơn cho nhóm quảng cáo. Chỉ hỗ trợ IMPRESSIONS đối với chiến dịch mua sắm Advantage+.

existing_customer_budget_percentage
số

Không bắt buộc
Chỉ định tỷ lệ phần trăm ngân sách tối đa có thể chi tiêu cho khách hàng hiện có được liên kết với tài khoản quảng cáo này. Giá trị càng thấp có thể dẫn đến chi phí trên mỗi lượt chuyển đổi càng cao. Giá trị hợp lệ nằm trong khoảng từ 0 đến 100.

adlabels

danh sách<Object>

Không bắt buộc

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

start_time
datetime

Không bắt buộc.
Thời gian bắt đầu của nhóm quảng cáo. Nhãn thời gian UNIX theo giờ UTC


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

time_start
datetime

Không bắt buộc

Thời gian bắt đầu

time_stop
datetime

Không bắt buộc

Thời gian kết thúc

attribution_spec

danh sách<Đối tượng JSON>

Không bắt buộc
Quy cách phân bổ chuyển đổi dùng để phân bổ chuyển đổi nhằm tối ưu hóa.

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

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Ad Set' \
  -F 'campaign_id=<CAMPAIGN_ID>' \
  -F 'promoted_object={ "pixel_id": "<PIXEL_ID>", "CUSTOM_EVENT_TYPE": "PURCHASE" }' \
  -F 'daily_budget=<NUM>' \
  -F 'existing_customer_budget_percentage=<NUM>' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'targeting={"geo_locations": {"countries": ["US"]}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adsets

Cập nhật

Bạn có thể cập nhật Nhóm quảng cáo bằng cách gửi yêu cầu POST đến /{ad_set_id}.

Thông số


Thông sốMô tả

adlabels

danh sách<Object>

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

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_time và start_time) dài hơn 24 giờ.


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

existing_customer_budget_percentage
số

Chỉ định tỷ lệ phần trăm ngân sách tối đa có thể chi tiêu cho khách hàng hiện có được liên kết với tài khoản quảng cáo này. Giá trị càng thấp có thể dẫn đến chi phí trên mỗi lượt chuyển đổi càng cao. Giá trị hợp lệ nằm trong khoảng từ 0 đến 100.

end_time
datetime

Thời gian kết thúc, bắt buộc khi bạn chỉ định lifetime_budget.


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.


Nhãn thời gian UNIX theo giờ UTC.

execution_options

danh sách<enum>

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

  • validate_only: khi bạn chỉ định tùy 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 tùy chọn này. Khi bạn sử dụng tùy 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 lệnh gọi 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.

start_time
datetime

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 theo giờ UTC.


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

status
enum

Tùy chọn bạn có thể sử dụng để cập nhật:

  • ACTIVE
  • PAUSED
  • DELETED
  • ARCHIVED

Nếu 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.

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.

time_start
datetime

Thời gian bắt đầu

time_stop
datetime

Thời gian kết thúc

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

Cấu trúc nhắm mục tiêu cho nhóm quảng cáo của bạn. Giá trị hợp lệ để nhắm mục tiêu là geo_locations.

geo_locations
mảng

Bắt buộc
Dùng để giới hạn đối tượng của nhóm quảng cáo theo

attribution_spec

danh sách<Đối tượng JSON>

Không bắt buộc
Quy cách phân bổ chuyển đổi dùng để phân bổ chuyển đổi nhằm tối ưu hóa.

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

curl -X POST \
  -F 'name=Advantage+ Shopping Sample Updated Ad Set' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_SET_ID>

Bước 5: 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ố


Thông sốMô tả

name
chuỗi

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

adset_id
int64

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

creative
AdCreative

Bắt buộc
Quy cách nội dung hoặc ID của nội dung quảng cáo mà quảng cáo này sẽ sử dụng. Sau đây là các trường hợp lệ:

  • object_story_spec
  • product_set_id
  • use_page_actor_override
  • creative_id

Bạn có thể đọc thêm về nội dung tại đây


Cung cấp nội dung theo định dạng sau đây: {"creative_id": <CREATIVE_ID>}


Hoặc cung cấp quy cách nội dung:

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

status
enum

Không bắt buộc
Chỉ trạng thái ACTIVE và PAUSED là hợp lệ trong quá trình tạo. 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í.

adlabels

danh sách<Object>

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

execution_options

danh sách<enum>

Không bắt buộc
Giá trị mặc định: set.

  • validate_only: khi bạn chỉ định tùy 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 tùy chọn này. Bạn luôn phải chỉ định tùy chọn này cùng với validate_only. Khi bạn chỉ định các tùy chọn nêu trên, 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 tùy chọn này. Khi bạn sử dụng tùy 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 lệnh gọi 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.

Ví dụ về tạo quảng cáo

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Ad' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/ads

Trường nội dung

Để biết danh sách đầy đủ các trường Nội dung quảng cáo, hãy xem tại đây.

TrườngMô tả

object_story_spec
AdCreativeObjectStorySpec

Bắt buộc
Dùng thông số này nếu bạn 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. ID Trang và nội dung để tạo bài viết mới không đăng trên trang.

use_page_actor_override
AdCreative

Bắt buộc
Nếu giá trị là true, chúng tôi sẽ hiển thị trang Facebook được liên kết với quảng cáo mua sắm Advantage.

Ví dụ về tạo nội dung

curl -X POST \
  -F 'object_story_spec=<SPEC>' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/act_<AD_ACCOUNT_ID>/adcreatives

Cập nhật

Bạn có thể cập nhật Quảng cáo bằng cách gửi yêu cầu POST đến /{ad_id}.

Thông số


Thông sốMô tả

name
chuỗi

Tên mới của quảng cáo

adlabels

danh sách<Object>

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

execution_options

danh sách<enum>

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

  • validate_only: khi bạn chỉ định tùy 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 tùy chọn này. Bạn luôn phải chỉ định tùy chọn này cùng với validate_only. Khi bạn chỉ định các tùy chọn nêu trên, 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 tùy chọn này. Khi bạn sử dụng tùy 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 lệnh gọi 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

Sau đây là các tùy chọn:

  • 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. Các trường hợp lệ là object_story_spec, asset_feed_spec và use_page_actor_override. Bạn có thể xem những trường này tại đây. Bạn có thể đọc thêm về nội dung tại đây


Cung cấp nội dung theo định dạng sau đây:

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

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

curl -X POST \
  -F 'name=Advantage+ Shopping campaign Sample Update Ad' \
  -F 'creative={"name": <NAME>, "object_story_spec": <SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v19.0/<AD_ID>

Tìm hiểu thêm