Trang này có hướng dẫn về cách tích hợp người bán vào quảng cáo của đối tác được quản lý (MPA) thông qua API Tạo doanh nghiệp của người bán.
Sau khi xác minh một người bán đủ điều kiện tham gia MPA thông qua API Điều kiện của người bán, bạn sẽ sử dụng API Tạo doanh nghiệp của người bán để tích hợp người bán đó.
Khi bạn gọi API Tạo doanh nghiệp của người bán bằng vendor_id
của người bán đủ điều kiện, các hành động sau đây sẽ tự động được thực hiện:
vendor_id=<child_business_external_id>
làm bộ lọcSau khi bạn tích hợp người bán vào MPA, người bán đó sẽ được xem là đối tác được quản lý.
Trước khi bạn tích hợp người bán, hãy đảm bảo bạn đã hoàn tất những bước sau:
Để gọi API Tạo doanh nghiệp của người bán, bạn sẽ cần có những quyền sau đây:
curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'asyncbatch=[
{
"method": "POST",
"relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses",
"name": "<ASYNC_SESSION_NAME>",
"body": "child_business_external_id=<VENDOR_ID>&line_of_credit_id=<LINE_OF_CREDIT_ID>&credit_limit=<CREDIT_LIMIT>&partition_type=<PARTITION_TYPE>&catalog_id=<PARENT_CATALOG_ID>&ad_account_currency=<AD_ACCOUNT_CURRENCY>&seller_targeting_countries=['COUNTRY_CODE1','COUNTRY_CODE2']&timezone_id=<TIMEZONE_ID>&name=<BUSINESS_MANAGER_NAME>&seller_external_website_url=<SELLER_EXTERNAL_WEBSITE_URL>&partner_facebook_page_url=<PARTNER_FACEBOOK_PAGE_&page_profile_image_url=<PROFILE_PIC_URL>&vertical=<VERTICAL>&partner_registration_countries=<PARTNER_REGISTRATION_COUNTRY>"
}
]' \
"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]
.
Tên | Mô tả |
---|---|
chuỗi | Bắt buộc. |
chuỗi số | Bắt buộc. |
chuỗi | Bắt buộc. |
chuỗi số | Bắt buộc. Bạn chỉ nên đặt trường này nếu giá trị Điều kiện: Khoản tín dụng có sẵn trong |
chuỗi enum | Bắt buộc. Đặt thành một trong những giá trị sau đây:
Giá trị mặc định: Phân bổ cố định hoặc phân bổ tín dụng không hạn chế. Giá trị đã đặt cho thông số |
chuỗi số | Bắt buộc.
|
chuỗi | Bắt buộc. |
chuỗi | Bắt buộc. |
bool | Không bắt buộc. Giá trị mặc định: |
chuỗi | Không bắt buộc. Tên sẽ chỉ định cho trang đã tạo cho người bán. Bỏ qua đặt thông số này khi Điều kiện: Tên trang phải đáp ứng yêu cầu của Facebook về tên trang. Giá trị mặc định: Tên trang Facebook của Đối tác được đặt cấu hình trong quá trình tích hợp API Quảng cáo của đối tác được quản lý trong Trung tâm cộng tác. |
chuỗi | Không bắt buộc Bỏ qua đặt thông số này khi Điều kiện:
Giá trị mặc định: Ảnh đại diện trên trang Facebook của Đối tác được đặt cấu hình trong quá trình tích hợp API Quảng cáo của đối tác được quản lý trong Trung tâm cộng tác. |
chuỗi | Bắt buộc. |
danh sách<string> | Bắt buộc. |
chuỗi | Không bắt buộc. |
chuỗi | Bắt buộc. |
chuỗi số | Bắt buộc. |
chuỗi enum | Bắt buộc.
|
{ "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.
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_MANAGED_PARTNER_BM_ID>\"}", "status": "COMPLETED", "id": "<ASYNC_SESSION_ID>" }
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:
Khi gửi yêu cầu đến API tích hợp người bán, bạn có thể nhận được một số phản hồi lỗi khác nhau. Hãy xem bài viết Cách xử lý lỗi để biết thêm thông tin.
Mã lỗi | Mã lỗi phụ | Thông báo lỗi |
---|---|---|
1800000 | 2310114 | Hoàn tất quy trình tích hợp quảng cáo của đối tác được quản lý trong Trung tâm cộng tác |
1800001 | 2310118 | ID nhà cung cấp {vendor_id} đã được sử dụng. Hãy nhập ID nhà cung cấp duy nhất chưa được sử dụng ở bất cứ nơi nào khác. |
1800002 | 2310138 | Tên doanh nghiệp {invalid_business_name} không phải là tên hợp lệ. Thay vào đó, hãy cân nhắc sử dụng {suggested_business_name}. Tên doanh nghiệp phải đáp ứng yêu cầu của Facebook về tên doanh nghiệp. |
1800002 | 2310139 | Tên doanh nghiệp {invalid_business_name} không phải là tên hợp lệ. Tên doanh nghiệp phải đáp ứng yêu cầu của Facebook về tên doanh nghiệp. |
1800003 | 2310133 | Nhập mã quốc gia đăng ký hợp lệ cho doanh nghiệp của đối tác này |
1800004 | 2310127 | Gỡ hoặc cập nhật các mã quốc gia không hợp lệ sau đây được liệt kê cho quốc gia đăng ký của đối tác: [{invalid_registration_country_codes}] |
1800006 | 2310141 | Gỡ hoặc cập nhật các mã quốc gia không hợp lệ sau đây mà bạn đã nhập: [{invalid_targeting_country_codes}] |
1800100 | 2310117 | Không thể sử dụng ID danh mục {catalog_id} mà bạn đã nhập để tạo phân khúc danh mục. Bạn có thể đi đến Công cụ quản lý thương mại để tìm đúng số ID danh mục có chứa mặt hàng của đối tác này. Hãy thử tích hợp lại đối tác bằng ID danh mục chính xác. |
1800101 | 2310116 | {business_id} của doanh nghiệp bạn không quản lý ID danh mục {catalog_id} mà bạn đã nhập. Hãy nhập ID danh mục mà doanh nghiệp của bạn quản lý. |
1800102 | 2310115 | Kiểm tra ID danh mục {catalog_id} mà bạn đã nhập. Nếu ID này chính xác và bạn cần có quyền truy cập vào danh mục này, hãy yêu cầu ai đó có toàn quyền kiểm soát truy cập vào phần Cài đặt cho doanh nghiệp trong Trình quản lý kinh doanh để cấp cho bạn quyền truy cập. Sau khi bạn chỉ định, hãy thử tích hợp lại đối tác. |
1800200 | 2310119 | Nhập ID hạn mức tín dụng mà bạn sẽ dùng để chia sẻ tín dụng với đối tác |
1800201 | 2310144 | ID hạn mức tín dụng {line_of_credit_id} mà bạn đã nhập không phải là ID hạn mức tín dụng hoặc tài khoản lập hóa đơn. Hãy nhập ID hạn mức tín dụng được liên kết với ID doanh nghiệp {marketplace_business_id}. Đây phải là hạn mức tín dụng mà doanh nghiệp của bạn dùng để chia sẻ tín dụng với đối tác. |
1800202 | 2310122 | Kiểm tra ID hạn mức tín dụng {line_of_credit_id} mà bạn đã nhập. Nếu ID này chính xác và bạn cần có quyền truy cập, hãy yêu cầu ai đó có toàn quyền kiểm soát truy cập vào phần Cài đặt cho doanh nghiệp trong Trình quản lý kinh doanh để cấp cho bạn quyền truy cập để quản lý tài chính. Hãy thử tích hợp lại đối tác sau khi bạn có quyền truy cập để quản lý tài chính. |
1800203 | 2310123 | Doanh nghiệp {business_id} của bạn không quản lý hạn mức tín dụng đã nhập {line_of_credit_id}. Hãy cung cấp ID hạn mức tín dụng hoặc tài khoản lập hóa đơn do doanh nghiệp của bạn quản lý. |
1800204 | 2310120 | Nhập đơn vị tiền tệ cho tài khoản quảng cáo. Bạn không thể thay đổi cài đặt này sau đó. |
1800205 | 2310145 | ID hạn mức tín dụng {line_of_credit_id} không hỗ trợ đơn vị tiền tệ đã nhập {ad_account_currency}. Hãy cập nhật đơn vị tiền tệ cho tài khoản quảng cáo của đối tác thành đơn vị tiền tệ mà hạn mức tín dụng hỗ trợ. |
1800206 | 2310121 | Nhập một giá trị hạn mức tín dụng lớn hơn 0 |
1800207 | 2310143 | Hạn mức tín dụng ${credit_limit} mà bạn đã nhập lớn hơn số dư tín dụng khả dụng là ${available_credit}. Hãy giảm hạn mức tín dụng đã chỉ định hoặc sử dụng ID hạn mức tín dụng khác có số dư cao hơn. |
1800305 | 2310149 | Nhập URL hình ảnh cho ảnh đại diện của đối tác. Hình ảnh phải có kích thước từ 180 x 180 pixel trở lên và nhỏ hơn 1MB. |
1800306 | 2310150 | Hình ảnh phải có kích thước từ 180 x 180 pixel trở lên và nhỏ hơn 1MB. Kiểm tra kích thước hình ảnh và URL {page_profile_image_url} rồi thử lại hoặc nhập URL hình ảnh mới. |
1800306 | 2310151 | Kiểm tra liên kết {page_profile_image_url} hoặc nhập liên kết mới |
1800307 | 2310148 | Hệ thống đã hết thời gian chờ xử lý URL hình ảnh {page_profile_image_url}. Hãy kiểm tra URL hình ảnh, thử yêu cầu lại hoặc nhập URL hình ảnh mới. |
1800311 | 2310181 | Tên trang {invalid_page_name} không hợp lệ. Thay vào đó, hãy cân nhắc sử dụng {suggested_page_name}. Tên trang phải đáp ứng yêu cầu của Facebook về tên trang. |
1800311 | 2310182 | Tên trang {invalid_page_name} không hợp lệ. Tên trang phải đáp ứng yêu cầu của Facebook về tên trang. |