Chia sẻ Meta Pixel giữa các doanh nghiệp

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.

Điều kiện tiên quyết: Yêu cầu về ứng dụng

Ứ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_readmanage_pages

Bước 1: Bắt đầu chia sẻ pixel với doanh nghiệp là agency

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ả

business

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

permitted_tasks

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, UPLOAD, ADVERTISE, EDIT

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:

  • Doanh nghiệp đã có mối quan hệ được phê duyệt. Chúng tôi chia sẻ pixel trực tiếp với những doanh nghiệp này.
  • Doanh nghiệp có mối quan hệ đang chờ xử lý. Chúng tôi thêm pixel vào yêu cầu để khi doanh nghiệp tiếp nhận phê duyệt yêu cầu này, chúng tôi sẽ chia sẻ pixel.
  • Doanh nghiệp không có bất kỳ mối quan hệ nào. Chúng tôi tạo thỏa thuận chia sẻ có đính kèm pixel để khi doanh nghiệp tiếp nhận phê duyệt yêu cầu này, chúng tôi sẽ chia sẻ pixel với doanh nghiệp đó.

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.

Bước 2: Chấp nhận yêu cầu đang chờ xử lý (nếu cầ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ả

request_status

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: APPROVE, DECLINE

Bước 3: Chia sẻ pixel với các tài khoản quảng cáo của doanh nghiệp là agency

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ả

business_id

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.

ad_account_id

loại: numeric

Bắt buộc.

Tài khoản quảng cáo được phép hoạt động trên pixel.

Bước 4: Xóa kết nối chia sẻ 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
}