Tích hợp BIGO Ads SDK với tính năng hoà giải

Hướng dẫn này sẽ cho bạn biết cách sử dụng Google Mobile Ads Unity Plugin để tải và hiển thị quảng cáo từ BIGO Ads SDK bằng tính năng dàn xếp, bao gồm cả các hoạt động tích hợp đặt giá thầu. Tài liệu này trình bày cách thêm SDK quảng cáo của BIGO Ads vào cấu hình dàn xếp của một đơn vị quảng cáo, cũng như cách tích hợp SDK và bộ chuyển đổi của BIGO Ads vào một ứng dụng Unity.

Các định dạng quảng cáo và công cụ tích hợp được hỗ trợ

Bộ chuyển đổi dàn xếp Ad Manager cho SDK quảng cáo BIGO Ads có các khả năng sau:

Điều kiện tiên quyết

Trước khi tiếp tục, hãy xác minh những thông tin sau:

• Phiên bản Google Mobile Ads Unity Plugin mới nhất.
• Unity Editor phiên bản 2019.4 trở lên.
• Cách triển khai trên Android
  • Android API cấp 24 trở lên.
• Cách triển khai trên iOS
  • Mục tiêu triển khai iOS từ 13.0 trở lên.
• Một dự án Unity đang hoạt động được định cấu hình bằng Google Mobile Ads Unity Plugin. Hãy xem phần Bắt đầu để biết thông tin chi tiết.
• Thiết lập tính năng dàn xếp.

Bước 1: Thiết lập cấu hình trong giao diện người dùng BIGO Ads SDK

Đăng nhập vào trang tổng quan BIGO Ads.

Tạo ứng dụng

Chuyển đến thẻ Kho hàng rồi chọn nút + Thêm trong bảng Ứng dụng và trang web.

Điền thông tin vào phần còn lại của biểu mẫu rồi nhấp vào Gửi.

Ghi lại Mã ứng dụng của bạn.

Tạo một vị trí quảng cáo

Sau khi đơn đăng ký của bạn được xem xét, hãy chuyển đến bảng Vị trí quảng cáo rồi chọn nút + Thêm.

Chọn Đặt giá thầu phía máy chủ cho Loại phiên đấu giá, điền vào phần còn lại của biểu mẫu rồi nhấp vào Gửi.

Ghi lại Mã vị trí

Cập nhật tệp app-ads.txt

Tệp Authorized Sellers for Apps app-ads.txt là một sáng kiến của IAB Tech Lab giúp đảm bảo rằng khoảng không quảng cáo trong ứng dụng của bạn chỉ được bán thông qua những kênh mà bạn đã xác định là được uỷ quyền. Để tránh mất nhiều doanh thu từ quảng cáo, bạn cần phải triển khai tệp app-ads.txt. Nếu chưa làm, hãy tạo tệp app-ads.txt cho Ad Manager.

Để triển khai app-ads.txt cho BIGO SDK quảng cáo, hãy chuyển đến thẻ APP-ads.txt trên Trang tổng quan rồi làm theo hướng dẫn trong thẻ này.

Bước 2: Thiết lập nhu cầu về BIGO Ads SDK trong giao diện người dùng Ad Manager

Định cấu hình chế độ cài đặt dàn xếp cho đơn vị quảng cáo

Thêm BIGO TECHNOLOGY PTE LTD vào danh sách đối tác quảng cáo theo GDPR và quy định của các bang tại Hoa Kỳ

Hãy làm theo các bước trong phần Chế độ cài đặt theo quy định của Châu Âu và Chế độ cài đặt theo quy định của các bang tại Hoa Kỳ để thêm Empathy Technology Pte.Ltd. (BIGO Ads) vào danh sách đối tác quảng cáo theo quy định của Châu Âu và thêm ** BIGOAds** vào danh sách đối tác quảng cáo theo quy định của các bang tại Hoa Kỳ trong giao diện người dùng Ad Manager.

Bước 3: Nhập SDK quảng cáo và bộ chuyển đổi của BIGO Ads

openupm add com.google.ads.mobile.mediation.bigo

Bước 4: Triển khai chế độ cài đặt quyền riêng tư trên SDK quảng cáo BIGO Ads

Để triển khai chế độ cài đặt quyền riêng tư cho SDK quảng cáo BIGO và tuân thủ các quy định có liên quan về quyền riêng tư, hãy đọc các phần sau.

Sự đồng ý của người dùng ở Liên minh Châu Âu và GDPR

Để tuân thủ Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google, bạn phải công bố một số thông tin nhất định cho người dùng ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh và Thuỵ Sĩ, đồng thời phải có được sự đồng ý của họ để sử dụng cookie hoặc phương pháp lưu trữ cục bộ khác khi pháp luật yêu cầu, cũng như để thu thập, chia sẻ và sử dụng dữ liệu cá nhân cho hoạt động cá nhân hoá quảng cáo. Chính sách này thể hiện các yêu cầu của Chỉ thị về quyền riêng tư và truyền thông điện tử của Liên minh Châu Âu và Quy định chung về việc bảo vệ dữ liệu (GDPR). Bạn chịu trách nhiệm xác minh rằng sự đồng ý được truyền đến từng nguồn quảng cáo trong chuỗi dàn xếp của bạn.

BIGO Ads SDK tự động đọc sự đồng ý theo GDPR do các nền tảng quản lý sự đồng ý đặt ra, bao gồm cả UMP SDK. Để biết thêm thông tin, hãy xem hướng dẫn về GDPR của SDK quảng cáo BIGO cho Android và iOS.

Luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ

Luật về quyền riêng tư của các tiểu bang tại Hoa Kỳ yêu cầu cung cấp cho người dùng quyền chọn không tham gia vào việc "bán" "thông tin cá nhân" (theo định nghĩa của các thuật ngữ này trong luật) của họ, trong đó quyền chọn không tham gia được cung cấp thông qua một đường liên kết nổi bật "Không bán thông tin cá nhân của tôi" trên trang chủ của bên "bán". Hướng dẫn tuân thủ luật về quyền riêng tư của các bang tại Hoa Kỳ cho phép bạn bật chế độ xử lý dữ liệu bị hạn chế cho hoạt động phân phát quảng cáo của Google, nhưng Google không thể áp dụng chế độ cài đặt này cho từng mạng quảng cáo trong chuỗi dàn xếp của bạn. Do đó, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể tham gia vào việc bán thông tin cá nhân và làm theo hướng dẫn của từng mạng đó để đảm bảo tuân thủ quy định.

Đoạn mã mẫu sau đây cho biết cách truyền cờ đồng ý đến SDK quảng cáo BIGO. Gọi phương thức này trước khi yêu cầu quảng cáo thông qua Google Mobile Ads Unity Plugin.

using GoogleMobileAds.Mediation.Bigo.Api;
// ...

Bigo.SetCcpaConsent(true);

Bước 5: Thêm mã bắt buộc

Bước 6: Kiểm tra kết quả triển khai

Bật quảng cáo thử nghiệm

Đảm bảo rằng bạn đăng ký thiết bị thử nghiệm cho Ad Manager.

BIGO Ads cung cấp Mã ứng dụng và Mã vị trí quảng cáo thử nghiệm cho Android và iOS để hỗ trợ việc thử nghiệm và tích hợp.

Xác minh quảng cáo thử nghiệm

Để xác minh rằng bạn đang nhận được quảng cáo thử nghiệm từ SDK quảng cáo BIGO, hãy bật thử nghiệm riêng một nguồn quảng cáo trong công cụ kiểm tra quảng cáo bằng (các) nguồn quảng cáo SDK quảng cáo BIGO(Đặt giá thầu).

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ SDK BIGO Ads, bạn có thể kiểm tra lỗi cơ bản trong phản hồi quảng cáo bằng ResponseInfo trong các lớp sau:

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

GADMediationAdapterBigo

Dưới đây là các mã và thông báo đi kèm do bộ điều hợp SDK quảng cáo BIGO Ads gửi khi quảng cáo không tải được:

Nhật ký thay đổi của trình bổ trợ dàn xếp SDK quảng cáo BIGO cho Unity

Phiên bản 3.1.0 (Đang tiến hành)

Phiên bản 3.0.0

• Hỗ trợ bộ chuyển đổi SDK quảng cáo BIGO cho Android phiên bản 6.0.0.1.
• Hỗ trợ bộ chuyển đổi BIGO Ads SDK cho iOS phiên bản 6.0.0.0.
• Được tạo và thử nghiệm bằng Trình bổ trợ Quảng cáo của Google trên thiết bị di động cho Unity phiên bản 11.5.0.

Phiên bản 2.0.0

• Hỗ trợ bộ chuyển đổi BIGO Ads SDK cho Android phiên bản 6.0.0.0.
• Hỗ trợ bộ chuyển đổi BIGO Ads SDK cho iOS phiên bản 5.3.0.0.
• Được tạo và thử nghiệm bằng Trình bổ trợ Quảng cáo của Google trên thiết bị di động cho Unity phiên bản 11.4.0.

Phiên bản 1.1.0

• Hỗ trợ bộ chuyển đổi BIGO Ads SDK cho Android phiên bản 5.10.1.0.
• Hỗ trợ bộ chuyển đổi BIGO Ads SDK cho iOS phiên bản 5.3.0.0.
• Được tạo và thử nghiệm bằng Trình bổ trợ Quảng cáo của Google trên thiết bị di động cho Unity phiên bản 11.3.0.

Phiên bản 1.0.0

• Bản phát hành đầu tiên!
• Hỗ trợ bộ chuyển đổi SDK quảng cáo BIGO cho Android phiên bản 5.8.0.0.
• Hỗ trợ bộ chuyển đổi BIGO Ads SDK cho iOS phiên bản 5.1.2.0.
• Được tạo và thử nghiệm bằng Trình bổ trợ Quảng cáo của Google trên thiết bị di động cho Unity phiên bản 11.0.0.