Tích hợp phương thức Đăng nhập bằng Facebook với API Báo cáo v2 trên Audience Network

Đăng nhập bằng Facebook là một phương thức mới cho phép truy cập dữ liệu API Báo cáo trên Audience Network. Phương thức này sẽ thay thế phương thức sao chép và dán mã người dùng hệ thống từng được sử dụng trong giao diện Trình quản lý kiếm tiền. Phương thức này giúp tăng cường bảo mật cho quá trình cấp quyền truy cập vào dữ liệu của bạn do mã của Trình quản lý kiếm tiền có nguy cơ bị lộ ra ngoài doanh nghiệp.

Tài liệu này chủ yếu cung cấp hướng dẫn cho tiện ích tích hợp API báo cáo trực tiếp, Đối tác đo lường di động, Đối tác trung gian và các đối tác khác của Facebook đang tìm cách truy cập dữ liệu API Báo cáo thay mặt nhà phát hành.

Tôi đang sử dụng bên thứ ba để nhận dữ liệu API Báo cáo

Nếu đang sử dụng đối tác hiện có (Đối tác đo lường di động hoặc Đối tác trung gian), bạn không cần phải viết mã. Hãy đảm bảo rằng đối tác của bạn tích hợp quy trình Đăng nhập bằng Facebook. Bạn sẽ phải nhấp vào tùy chọn "Đăng nhập bằng Facebook" và chọn tài sản mà bạn muốn cấp quyền truy cập bằng mã sẽ tạo.

Nếu bạn chọn TẤT CẢ tài sản, mã sẽ cấp quyền truy cập vào tất cả tài sản trong Doanh nghiệp miễn là người dùng đã tạo mã có quyền truy cập vào tài sản đó trong Trình quản lý kinh doanh.

Quyền

Nếu cần sử dụng trực tiếp API Báo cáo, trước tiên, bạn sẽ phải tạo một ứng dụng trên Facebook và lấy các quyền cần thiết. Ứng dụng của bạn sẽ cần có quyền read_audience_network_insights để truy cập dữ liệu API Báo cáo trên Audience Network. Để lấy quyền này cho ứng dụng của bạn, doanh nghiệp cần phải được tích hợp với Audience Network.

• Sau khi được tích hợp vào Trình quản lý kiếm tiền, hãy chuyển đến trang Facebook Developers rồi bắt đầu tạo ứng dụng kinh doanh mới

• Chọn doanh nghiệp mới tạo trong trường tài khoản kinh doanh

Bây giờ, ứng dụng của bạn đã được tích hợp với Audience Network và có thể sử dụng quyền read_audience_network_insights. Nếu bạn không nhìn thấy read_audience_network_insights, hãy đảm bảo rằng ứng dụng được liên kết với Doanh nghiệp có quyền truy cập vào Tài khoản kinh doanh của Trình quản lý kiếm tiền.

Nếu bạn từng được cấp read_insights permission thông qua phương thức Đăng nhập bằng Facebook, quyền này vẫn sẽ hoạt động nhưng bạn nên chuyển sang quyền read_audience_network_insights.

Phương thức truy cập API Báo cáo sẽ khác nhau tùy thuộc vào loại tiện ích tích hợp mà bạn có. Vui lòng làm theo hướng dẫn áp dụng cho trường hợp của bạn:

• Tích hợp API trực tiếp mà không có giao diện người dùng
• Tích hợp API trực tiếp qua giao diện người dùng

Tích hợp API trực tiếp mà không có giao diện người dùng

Nếu có một tiện ích tích hợp API Báo cáo (trực tiếp) tùy chỉnh không có bất kỳ giao diện tương tác/người dùng nào và bạn chỉ sử dụng tiện ích tích hợp này để truy vấn dữ liệu cho doanh nghiệp của mình, bạn có thể sử dụng hướng dẫn dưới đây để lấy quyền truy cập vào API Báo cáo.

Tạo mã người dùng thông qua Trình khám phá API Đồ thị

1. Nếu bạn đang sử dụng "API Marketing" trong ứng dụng, hãy bỏ qua bước này. Nếu chưa, hãy làm theo hướng dẫn về cách lấy quyền read_audience_network_insights
2. Đi đến Trình khám phá API Đồ thị
3. Chọn ứng dụng
4. Chọn quyền `read_audience_network_insights` (bạn có thể tìm thấy quyền này trong phần Quyền > Trang nhóm sự kiện) rồi nhấp vào "Tạo mã truy cập".
1. Giờ đây, bạn có thể truy cập dữ liệu API Báo cáo trên Audience Network trong thời gian ngắn bằng mã này thay vì mã từ Trình quản lý kiếm tiền
2. Tuyên bố miễn trừ trách nhiệm: mã này sẽ hết hạn sau 2 giờ, bạn cần chuyển mã này thành Mã truy cập dài hạn thông qua hướng dẫn bên dưới.

Chuyển mã này thành Mã truy cập dài hạn

1. Đi đến Trình gỡ lỗi mã truy cập
2. Chèn mã của bạn rồi nhấn vào "Gỡ lỗi"
3. Cuộn xuống phần cuối bảng chứa tất cả thông tin mã, nhấp vào nút "Mã truy cập mở rộng"

4. Sao chép mã nhận được

Giờ đây, bạn có thể truy cập dữ liệu API Báo cáo trên Audience Network bằng mã này.

Tích hợp API trực tiếp qua giao diện người dùng

Hướng dẫn dưới đây hữu ích cho nhà phát hành và đối tác có giao diện người dùng riêng có thể đặt nút Đăng nhập bằng Facebook. Hướng dẫn này hữu ích cho các nhà phát hành sẵn sàng truy cập vào dữ liệu của chính mình, cũng như các đối tác muốn truy cập dữ liệu kiếm tiền của nhà phát hành khác sau khi được cho phép.

Bạn cũng có thể xem video minh họa toàn bộ hướng dẫn bên dưới, bao gồm bước cấp quyền nêu trên:

Đã xảy ra lỗi

Chúng tôi đã gặp sự cố khi phát video này.

Tìm hiểu thêm

• Trên cổng thông tin dành cho Nhà phát triển, chọn ứng dụng kinh doanh mà bạn mới tạo trong các bước trước đó
• Thêm sản phẩm "Đăng nhập bằng Facebook" mới vào ứng dụng này

• Chọn "Web" rồi làm theo các bước tích hợp

• Chèn URL trang web mà bạn sẽ hiển thị trải nghiệm Đăng nhập bằng Facebook của mình. Đảm bảo URL này hỗ trợ giao thức HTTPS

• Ở cuối các bước tích hợp, chúng tôi sẽ cung cấp cho bạn mã mẫu để tích hợp phương thức Đăng nhập bằng Facebook trên trang web của mình. Bạn có thể sao chép mã này. Tuy nhiên, hãy sử dụng quyền "read_audience_network_insights" mới được cấp thay vì quyền "public_profile,email" được gợi ý. Nhìn chung, khi sử dụng quyền được cập nhật, mã nút của bạn sẽ có dạng như sau:

<fb:login-button 
  scope="read_audience_network_insights"
  onlogin="checkLoginState();">
</fb:login-button>

• Nhớ bật JavaScript SDK trong phương thức Đăng nhập bằng Facebook trên trang cài đặt sản phẩm cho ứng dụng của bạn

• Bây giờ, người dùng có thể thực hiện quy trình Đăng nhập bằng Facebook trên trang của bạn để tạo mã truy cập
• Mã truy cập sẽ được trả về trong đối số được chuyển vào phương thức JavaScript statusChangeCallback từ các bước trước đó.

• Mã này sẽ hết hạn sau khoảng 2 giờ theo mặc định
• Các nhà phát triển có thể yêu cầu gia hạn mã này thành Mã truy cập dài hạn mà không cần người dùng tương tác thêm.

  • Mã dài hạn được làm mới một lần mỗi ngày khi bạn thực hiện yêu cầu API Báo cáo đến máy chủ của Facebook. Nếu không có yêu cầu nào, mã này sẽ hết hạn sau khoảng 60 ngày và người dùng phải tạo mã mới.
• Lưu ý rằng dữ liệu có sẵn thông qua mã này chủ yếu phụ thuộc vào người đang chuyển dữ liệu thông qua quy trình Đăng nhập bằng Facebook và loại dữ liệu mà người đó đồng ý chia sẻ. Vì vậy, nếu nhân viên doanh nghiệp đang chuyển dữ liệu thông qua quy trình này, mã truy cập thu được sẽ có các quyền mà nhân viên đó có.

Khắc phục sự cố