Tạo và chạy chiến dịch quảng cáo

Trang này cung cấp các bước tạo chiến dịch quảng cáo cho đối tác được quản lý (người bán) mà bạn đã tích hợp vào quảng cáo của đối tác được quản lý.

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

Trước khi bạn tạo và chạy chiến dịch quảng cáo cho đối tác của mình, hãy đảm bảo bạn đã hoàn tất các bước sau:

Quyền bắt buộc

Để gọi API Tạo quảng cáo của người bán, người dùng sẽ cần có những quyền sau đây:

Quản trị viên doanh nghiệp của người bán

Nhắm mục tiêu các vị trí thuộc diện kiểm soát của Đạo luật Dịch vụ kỹ thuật số (DSA) (Liên minh châu Âu)

Đối với các chiến dịch quảng cáo nhắm mục tiêu đến Liên minh châu Âu và/hoặc những lãnh thổ liên quan, các trường dsa_payor và dsa_beneficiary là bắt buộc. Thông tin được cung cấp trong 2 trường này sẽ hiển thị với người dùng cuối để cho biết ai là bên thanh toán cho quảng cáo và ai là bên thụ hưởng của quảng cáo.

Thông tin bên thụ hưởng và bên thanh toán là thông tin bắt buộc đối với tất cả chiến dịch nhắm mục tiêu đến Liên minh châu Âu và các lãnh thổ liên quan. Nếu các trường này không được cung cấp, nhà quảng cáo sẽ không thể tạo chiến dịch MPA và API sẽ trả về phản hồi không thành công với các mã lỗi được liệt kê dưới đây.

Lệnh gọi API Tạo quảng cáo của người bán

Yêu cầu

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
       { 
         "method": "POST", 
         "relative_url": "act_<ACCOUNT_ID>/managed_partner_ads", 
         "name": "create1", 
         "body": "lifetime_budget=10000&start_time=1598286074&end_time=1598286074&override_targeting_countries=['US','UK']&use_marketplace_template=true&product_set_id=<PRODUCT_SET_ID>" 
       }, 
     ]' \
  "https://graph.facebook.com/v21.0"

Hệ thống sẽ trả về ngay phản hồi cho lệnh gọi API kèm theo ASYNC_SESSION_ID. Trong khi yêu cầu này tiếp tục được xử lý, hệ thống sẽ thăm dò ASYNC_SESSION_ID cho đến khi đạt trạng thái cuối cùng là [COMPLETED|FAILED].

Thông số

Tên	Mô tả
`conversion_domain` chuỗi	Bắt buộc. Đặt miền chuyển đổi trong quy trình tạo quảng cáo. Trường `conversion_domain` phải khớp với cấu hình Meta Pixel. Trường này chỉ nên chứa miền cấp một và cấp hai, chứ không phải URL đầy đủ. Ví dụ: facebook.com.
`custom_event_type` enum	Không bắt buộc. Một sự kiện trong ứng dụng để tối ưu hóa cho cả quảng cáo tìm kiếm khách hàng tiềm năng và quảng cáo nhắm mục tiêu lại. Giá trị:`CONTENT_VIEW`, `ADD_TO_CART`, `PURCHASE` Điều kiện: Bạn chỉ có thể chỉ định trường này khi `use_marketplace_template` là `true` và `use_seller_template` là `false`.
`dsa_payor` chuỗi (tối đa 512 ký tự)	Không bắt buộc. Bên thanh toán của chiến dịch. Lưu ý: Trường này là Bắt buộc đối với các chiến dịch nhắm mục tiêu đến Liên minh châu Âu và/hoặc những lãnh thổ liên quan.
`dsa_beneficiary` chuỗi (tối đa 512 ký tự)	Không bắt buộc. Bên thụ hưởng của chiến dịch. Lưu ý: Trường này là Bắt buộc đối với các chiến dịch nhắm mục tiêu đến Liên minh châu Âu và/hoặc những lãnh thổ liên quan.
`end_time` datetime	Bắt buộc. Thời gian kết thúc cho chiến dịch quảng cáo, theo nhãn thời gian UNIX UTC.
`lifetime_budget` chuỗi số	Bắt buộc. Ngân sách của chiến dịch bằng đơn vị tiền tệ của tài khoản quảng cáo. Trong lĩnh vực quảng cáo, tỷ lệ bù trừ có thể là 1 hoặc 100 (đối với đơn vị tiền tệ có khái niệm cent). Ví dụ: `lifetime_budget = 1` bằng USD (tỷ lệ bù trừ là 100) nghĩa là 1/100 (tỷ lệ bù trừ) = $0,01 (1 cent). `lifetime_budget = 1` bằng JPY (tỷ lệ bù trừ là 1) nghĩa là 1/1 (tỷ lệ bù trừ) = ¥1 (1 Yên).
`override_creative_text` chuỗi	Bắt buộc. Phần thân nội dung.
`override_targeting_countries` danh sách<strings>	Không bắt buộc. Quốc gia nhắm mục tiêu trong chiến dịch. Giá trị này sẽ ghi đè quốc gia đã đặt trong quá trình tạo doanh nghiệp của người bán đối với cả quảng cáo tìm kiếm khách hàng tiềm năng và quảng cáo nhắm mục tiêu lại.
`product_set_id` chuỗi số	Không bắt buộc. ID nhóm sản phẩm trong danh mục sản phẩm của người bán mà chiến dịch này sẽ quảng bá trên tất cả quảng cáo.
`start_time` datetime	Bắt buộc. Thời gian bắt đầu cho chiến dịch quảng cáo, theo nhãn thời gian UNIX UTC.
`use_marketplace_template` bool	Không bắt buộc. Chỉ định trường này để tạo chiến dịch bằng mẫu mặc định có sẵn trên toàn cầu cho tất cả người bán. Điều kiện: Phải sử dụng `use_marketplace_template` hoặc `use_seller_template`, nhưng không được sử dụng cả hai.
`use_seller_template` bool	Không bắt buộc. Chỉ định trường này để tạo chiến dịch bằng mẫu tùy chỉnh được áp dụng cho người bán. Điều kiện: Phải sử dụng `use_marketplace_template` hoặc `use_seller_template`, nhưng không được sử dụng cả hai.

Phản hồi

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

Sử dụng ASYNC_SESSION_ID để lấy ID tương ứng của người bán được tích hợp vào quảng cáo của đối tác được quản lý.

Xem phần Cách thăm dò phiên không đồng bộ cho phản hồi để biết thêm thông tin.

Phản hồi thành công

Nếu trạng thái là COMPLETED, dữ liệu thu được khi thăm dò phiên không đồng bộ sẽ có dạng như sau:

{
  "result": "{\"id\":\"<NEWLY_CREATED_CAMPAIGN_ID>\"}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

Phản hồi không thành công

Nếu trạng thái là FAILED, dữ liệu thu được khi thăm dò phiên không đồng bộ sẽ có dạng như sau:

Mã lỗi

Mã lỗi	Mã lỗi phụ	Mô tả
1800011	2310154	Bài viết chứa nội dung quảng cáo là do một ứng dụng ở chế độ đang phát triển tạo. Bài viết phải ở chế độ công khai thì mới tạo được quảng cáo này.
1800103	2310155	Trình quản lý kinh doanh {seller_business_id} bị thiếu phân khúc danh mục được chia sẻ. Nguyên nhân có thể do việc tích hợp một phần. Bạn có thể sử dụng Trung tâm cộng tác để chia sẻ tài sản và thêm phân khúc danh mục hoặc bạn có thể dùng API Xóa người bán để xóa người bán rồi tích hợp lại bằng API Tích hợp người bán không đồng bộ. Bạn cũng có thể liên hệ với đối tác trên Meta để được trợ giúp.
1800104	2310156	ID {product_set_id} mà bạn đã nhập không phải là ID nhóm sản phẩm. Hãy nhập ID nhóm sản phẩm được liên kết với ID danh mục {catalog_id}.
1800105	2310157	ID {product_set_id} mà bạn đã nhập không phải là ID nhóm sản phẩm dành cho phân khúc danh mục của doanh nghiệp. Hãy nhập ID nhóm sản phẩm được liên kết với ID danh mục {catalog_id}.
1800208	2310152	Tài khoản quảng cáo của doanh nghiệp này đã bị vô hiệu hóa do vi phạm Chính sách quảng cáo hoặc các tiêu chuẩn khác của chúng tôi. Để tìm hiểu thêm, hãy chuyển đến mục Quan hệ hợp tác trong Trung tâm cộng tác, chọn Đối tác được quản lý và tab Vấn đề về chất lượng. Bạn cũng có thể liên hệ với đối tác trên Meta để được trợ giúp hoặc để kháng nghị.
1800209	2310153	Tài khoản quảng cáo {account_id} đã nhập không được tạo bằng quảng cáo của đối tác được quản lý. Hãy nhập ID tài khoản đã tạo cho doanh nghiệp này khi tích hợp doanh nghiệp vào quảng cáo của đối tác được quản lý.
1800308	2310137	Trình quản lý kinh doanh {seller_business_id} cho doanh nghiệp này bị thiếu Trang người bán. Nguyên nhân có thể do việc tích hợp một phần. Bạn có thể dùng API Xóa người bán để xóa người bán rồi tích hợp lại bằng API Tích hợp người bán không đồng bộ. Bạn cũng có thể liên hệ với đối tác trên Meta để được trợ giúp.
1800309	2310159	Trang người bán của doanh nghiệp này đã bị vô hiệu hóa vì có thể vi phạm Chính sách quảng cáo hoặc các tiêu chuẩn khác của chúng tôi nên không thể dùng để chạy quảng cáo. Để tìm hiểu thêm, hãy chuyển đến mục Quan hệ hợp tác trong Trung tâm cộng tác, chọn Đối tác được quản lý và tab Vấn đề về chất lượng. Bạn cũng có thể liên hệ với đối tác trên Meta để được trợ giúp hoặc để kháng nghị.
1800400	2310161	Ngân sách chiến dịch đã nhập quá nhỏ. Theo mẫu được sử dụng, ngân sách tối thiểu phải là {minimum_budget}.
1800402	2310160	Ngân sách tìm kiếm khách hàng tiềm năng và nhắm mục tiêu lại đã nhập không bằng 100%. Hãy nhập tỷ lệ ngân sách cho các chiến dịch tìm kiếm khách hàng tiềm năng và chiến dịch nhắm mục tiêu lại sao cho tổng số là 100%. Ngoài ra, hãy đảm bảo cả chiến dịch tìm kiếm khách hàng tiềm năng và chiến dịch nhắm mục tiêu đều được xác định trong mẫu.
1800500	2310166	Bạn đang cố gắng sử dụng API quảng cáo của đối tác được quản lý (MPA) để cập nhật chiến dịch không phải là chiến dịch MPA. Hãy kiểm tra chiến dịch bạn đã nhập ({campaign_id}) hoặc sử dụng API khác.
1800501	2310168	ID chiến dịch đã nhập ({campaign_id}) không thuộc về tài khoản quảng cáo. Hãy kiểm tra ID rồi thử lại.
1800700	2310172	Nhập cá nhân hoặc tổ chức thanh toán cho nhóm quảng cáo này.
1800701	2310171	Nhập cá nhân hoặc tổ chức hưởng lợi từ nhóm quảng cáo này.