Trong nhiều trường hợp sử dụng, các doanh nghiệp cần truy cập vào tập dữ liệu pixel của một doanh nghiệp trong một doanh nghiệp khác (thường là agency), chẳng hạn như để quản lý quảng cáo, phân tích hiệu quả hoặc tải sự kiện lên.
Dưới đây là các tiện ích tích hợp API cần thiết để thiết lập mối quan hệ giữa pixel và doanh nghiệp là agency. Nếu doanh nghiệp tiếp nhận (agency) cũng quản lý quảng cáo cho khách hàng và cần sử dụng pixel đó cho tài khoản quảng cáo, hãy xem bước 3.
Ứng dụng phải có tính năng Quyền truy cập tiêu chuẩn để quản lý quảng cáo (quyền truy cập nâng cao). Ứng dụng cũng phải có các quyền sau:
business_management
ads_management
hoặc ads_read
và manage_pages
Bước này sẽ yêu cầu mã truy cập dành cho người dùng có các quyền cho ứng dụng nêu trên từ quản trị viên doanh nghiệp sở hữu pixel.
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
Tùy chọn và thông số cho yêu cầu này bao gồm:
Tên | Mô tả |
---|---|
loại: numeric | Bắt buộc. ID của doanh nghiệp là agency nhận được quyền truy cập vào pixel |
loại: list:string | Bắt buộc. Ví dụ: ['ANALYZE', 'UPLOAD', 'ADVERTISE'] Tác vụ mà agency được phép thực hiện trên pixel Giá trị có thể sử dụng: ANALYZE: Xem, phân tích và quảng cáo. UPLOAD: Tải dữ liệu chuyển đổi trên trang web lên tập dữ liệu này. ADVERTISE: Kết nối tài khoản quảng cáo với tập dữ liệu Facebook này. Sử dụng tập dữ liệu này cho mục đích quảng cáo. EDIT: Quản lý tập dữ liệu, chỉnh sửa cài đặt, phân tích và quảng cáo. (Quyền EDIT hiện đang bị hạn chế, hãy liên hệ với đại diện Meta để thêm ứng dụng của bạn vào danh sách cho phép) |
Chúng tôi xử lý yêu cầu dựa trên trạng thái của mối quan hệ với doanh nghiệp kia:
Nếu chia sẻ thành công pixel với doanh nghiệp, hệ thống sẽ trả về phản hồi sau:
{ success: true, }
Nếu yêu cầu đang chờ chấp nhận thỏa thuận chia sẻ, yêu cầu API sẽ trả về phản hồi sau kèm theo pending_request_id
. Khi doanh nghiệp tiếp nhận chấp nhận yêu cầu, pixel sẽ tự động được chia sẻ với doanh nghiệp đó. Xem bước 2 để chấp nhận/từ chối yêu cầu.
{ "success": true, "pending_request_id": "{request_id}" }
Lưu ý rằng bạn chỉ có thể chia sẻ pixel với số lượng doanh nghiệp giới hạn.
Sau khi khởi tạo yêu cầu chia sẻ pixel, doanh nghiệp là agency có thể nhận được yêu cầu thỏa thuận chia sẻ đang chờ xử lý, nếu agency chưa có mối quan hệ với doanh nghiệp sở hữu pixel. Quản trị viên của doanh nghiệp tiếp nhận có thể xem và chấp nhận yêu cầu này trên Trình quản lý kinh doanh.
Để phê duyệt hoặc từ chối yêu cầu thiết lập mối quan hệ bằng API, hãy lấy request_id
từ phản hồi lỗi ở Bước 1.
API sẽ yêu cầu mã truy cập dành cho người dùng từ quản trị viên của doanh nghiệp tiếp nhận có quyền business_mangement
hoặc ads_management permission
cho ứng dụng.
POST <request_id>?request_status="approve"
Khi thành công, API sẽ trả về phản hồi sau:
{ success: bool }
Tùy chọn và thông số cho yêu cầu này bao gồm:
Tên | Mô tả |
---|---|
loại: string | Bắt buộc. Liệu doanh nghiệp nhận được yêu cầu chia sẻ pixel sẽ phê duyệt hay từ chối yêu cầu đó. Giá trị có thể sử dụng: |
Nếu agency đang quản lý quảng cáo cho khách hàng và cần cho phép tài khoản quảng cáo riêng của khách hàng sử dụng tập dữ liệu pixel, hãy sử dụng API này.
Sau khi bạn chia sẻ pixel với một doanh nghiệp có quyền quảng cáo/phân tích, doanh nghiệp đó có thể cho phép các tài khoản quảng cáo trong doanh nghiệp sử dụng tập dữ liệu pixel cho mục đích quảng cáo.
API sẽ yêu cầu mã truy cập dành cho người dùng có quyền business_management
, ads_management
hoặc ads_read
từ quản trị viên doanh nghiệp.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
Tên | Mô tả |
---|---|
loại: numeric | Bắt buộc. Doanh nghiệp quản lý quảng cáo và có quyền truy cập vào pixel và tài khoản quảng cáo. Người dùng có mã truy cập được sử dụng phải có quyền quản trị đối với doanh nghiệp này. |
loại: numeric | Bắt buộc. Tài khoản quảng cáo được phép hoạt động trên pixel. |
Nếu bạn không còn cần kết nối giữa pixel và doanh nghiệp là agency nữa, hãy sử dụng API sau để xóa kết nối.
Delete <adspixel>/agencies?business=<agency_business_id>
API sẽ yêu cầu mã truy cập dành cho người dùng quản trị từ doanh nghiệp sở hữu pixel.
Khi thành công, API sẽ trả về phản hồi sau:
{ success: true }