Tích hợp AdColony với tính năng dàn xếp

Hướng dẫn này cho bạn biết cách sử dụng SDK Quảng cáo của Google trên thiết bị di động để tải và hiển thị quảng cáo từ AdColony bằng cách sử dụng tính năng dàn xếp, bao gồm cả chế độ tích hợp thác nước và đặt giá thầu. Hướng dẫn này trình bày cách thêm AdColony 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 AdColony vào ứng dụng Unity.

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

Bộ chuyển đổi dàn xếp AdMob của AdColony có các chức năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Dạng thức
Biểu ngữ
Quảng cáo xen kẽ
Được thưởng

Yêu cầu

  • Unity 5.6 trở lên
  • SDK quảng cáo trên thiết bị di động của Google mới nhất
  • [Dành cho tính năng đặt giá thầu]: Trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động cho AdColony 1.0.5 trở lên (nên dùng phiên bản mới nhất)
  • Cách triển khai trên Android
    • API Android cấp 19 trở lên
  • Cách triển khai trên iOS
    • Mục tiêu triển khai iOS phiên bản 12.0 trở lên
  • Một dự án Unity đang hoạt động được định cấu hình bằng SDK Quảng cáo của Google trên thiết bị di động. Hãy xem bài viết Bắt đầu để biết thông tin chi tiết.
  • Hoàn tất tính năng dàn xếp Hướng dẫn bắt đầu sử dụng

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

Đăng ký và đăng nhập vào tài khoản AdColony của bạn. Thêm ứng dụng của bạn vào trang tổng quan dành cho nhà xuất bản AdColony bằng cách nhấp vào nút Thiết lập ứng dụng mới.

Thiết lập ứng dụng mới AdColony

Điền vào biểu mẫu và nhấp vào Create (Tạo) ở cuối trang để thêm ứng dụng vào AdColony.

Android

Ứng dụng tạo AdColony

iOS

Ứng dụng tạo AdColony

Sau khi tạo ứng dụng, bạn có thể lấy Mã ứng dụng bằng cách chuyển đến phần Kiếm tiền > Ứng dụng trong phần Thông tin cơ bản về ứng dụng của ứng dụng.

Android

Mã ứng dụng AdColony

iOS

Mã ứng dụng AdColony

Tiếp theo, hãy tạo một Vùng quảng cáo mới bằng cách nhấp vào nút Thiết lập vùng quảng cáo mới trong mục Vùng quảng cáo trên trang Ứng dụng của bạn. Bạn nên tạo một Vùng quảng cáo mới cho hoạt động dàn xếp thông qua AdMob ngay cả khi bạn đã có vùng quảng cáo.

Android

Vùng thiết lập AdColony

iOS

Vùng thiết lập AdColony

Để được hướng dẫn thêm về cách tạo vị trí đặt quảng cáo, hãy chọn thẻ tương ứng với định dạng quảng cáo mà bạn muốn.

  1. Đặt chế độ Zone đang hoạt động? thành Yes (Có).

  2. Nhập Tên cho Vùng quảng cáo.

  3. Chọn Biểu ngữ làm Kích thước vùng quảng cáo.

  4. Nhập một giá trị cho Giới hạn phát hằng ngày.

Quảng cáo xen kẽ

  1. Đặt chế độ Zone đang hoạt động? thành Yes (Có).

  2. Nhập Tên cho Vùng quảng cáo.

  3. Chọn Đầu video/Quảng cáo xen kẽ làm Loại khu vực.

  4. Nhập một giá trị cho Giới hạn phát hằng ngày.

Được thưởng

  1. Đặt chế độ Zone đang hoạt động? thành Yes (Có).

  2. Nhập Tên cho Vùng quảng cáo.

  3. Chọn Value Exchange/V4VC làm Loại vùng.

  4. Đặt Chỉ phía máy khách? thành Có rồi nhập Tên đơn vị tiền tệ ảo, Số video tối đa hằng ngày trên mỗi người dùng và Số tiền phần thưởng.

  5. Nhập một giá trị cho Giới hạn phát hằng ngày.

Nhấp vào nút Tạo khi đã hoàn tất để tạo Vùng quảng cáo.

Sau khi tạo Vùng quảng cáo, bạn có thể tìm Mã vùng trong mục Tích hợp của Vùng quảng cáo. Mã vùng sẽ được sử dụng trong bước tiếp theo.

Mã vùng AdColony

Xác định vị trí Khoá API AdColony

Đặt giá thầu

Bạn không bắt buộc phải thực hiện bước này để tích hợp tính năng đặt giá thầu.

Thác nước

Bạn sẽ cần Khoá API của AdColony để thiết lập AdMob mã đơn vị quảng cáo. Chuyển đến phần Cài đặt tài khoản trong trang tổng quan của nhà xuất bản AdColony để tìm Khoá API của bạn.

Chế độ cài đặt AdColony

Bật chế độ thử nghiệm

Để bật quảng cáo thử nghiệm trên AdColony, hãy chuyển đến trang tổng quan của AdColony rồi chuyển đến phần Kiếm tiền > Ứng dụng. Chọn Vùng mà bạn muốn bật quảng cáo thử nghiệm trong mục Vùng quảng cáo của ứng dụng. Bạn có thể bật quảng cáo thử nghiệm bằng cách chọn Có để Chỉ hiển thị quảng cáo thử nghiệm? trong phần Phát triển.

Kiểm thử AdColony

Bước 2: Thiết lập nhu cầu AdColony trong AdMob giao diện người dùng

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

Android

Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho Android.

iOS

Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho iOS.

Thêm AdColony vào danh sách đối tác quảng cáo theo quy định của các tiểu bang ở Hoa Kỳ và GDPR

Hãy làm theo các bước trong cài đặt GDPR và cài đặt quy định của chính phủ Hoa Kỳ để thêm AdColony vào GDPR và danh sách đối tác quảng cáo theo quy định của tiểu bang Hoa Kỳ trong AdMob giao diện người dùng.

Bước 3: Nhập SDK AdColony và bộ chuyển đổi

Hãy tải phiên bản mới nhất của trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động cho AdColony từ đường liên kết tải xuống trong Nhật ký thay đổi rồi trích xuất GoogleMobileAdsAdColonyMediation.unitypackage từ tệp zip.

Trong trình chỉnh sửa dự án Unity, hãy chọn Assets > Import Package > Custom Package (Thành phần > Nhập gói > Gói tuỳ chỉnh) rồi tìm tệp GoogleMobileAdsAdColonyMediation.unitypackage mà bạn đã tải xuống. Hãy chắc chắn rằng bạn đã chọn tất cả các tệp rồi nhấp vào Nhập.

Sau đó, chọn Nội dung > Trình phân giải các dịch vụ của Play > Trình phân giải Android > Buộc phân giải. Thư viện Trình quản lý phần phụ thuộc bên ngoài sẽ thực hiện việc phân giải phần phụ thuộc từ đầu và sao chép các phần phụ thuộc đã khai báo vào thư mục Assets/Plugins/Android của ứng dụng Unity.

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

Theo 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 đảm bảo rằng bạn đã công bố một số thông tin nhất định và nhận được sự đồng ý của người dùng trong Khu vực kinh tế Châu Âu (EEA) liên quan đến việc sử dụng giá trị nhận dạng thiết bị và dữ liệu cá nhân. 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). Khi yêu cầu sự đồng ý, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể thu thập, nhận hoặc sử dụng dữ liệu cá nhân, đồng thời cung cấp thông tin về cách sử dụng từng mạng. Hiện tại, Google không thể tự động chuyển lựa chọn đồng ý của người dùng đến các mạng như vậy.

Trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động cho AdColony phiên bản 2.6.1 đã thêm lớp AdColonyAppOptions bằng các phương thức SetPrivacyFrameworkRequired() và SetPrivacyConsentString(), để cho phép bạn chuyển sự đồng ý đến SDK AdColony. Mã mẫu sau đây minh hoạ cách truyền thông tin về sự đồng ý đến bộ chuyển đổi AdColony. Sau đó, bộ chuyển đổi này được dùng trong phương thức khởi chạy của AdColony. Bạn phải đặt các tuỳ chọn này trước khi khởi động SDK quảng cáo trên thiết bị di động của Google để đảm bảo chúng được chuyển tiếp đúng cách đến SDK của AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

Hãy xem bài viết về Quyền riêng tư của người tiêu dùng và hướng dẫn triển khai Luật về quyền riêng tư của AdColony để biết thêm thông tin và các giá trị có thể được cung cấp trong phương thức này.

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 ở Hoa Kỳ yêu cầu cung cấp cho người dùng quyền từ chối "bán" "thông tin cá nhân" (theo định nghĩa của các thuật ngữ này trong luật) bằng cách cung cấp lựa chọn từ chối 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 tiểu bang ở Hoa Kỳ cho phép bạn bật chế độ xử lý dữ liệu bị hạn chế để 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 hoạt động 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ủ.

Trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động cho AdColony phiên bản 2.6.1 đã thêm lớp AdColonyAppOptions bằng các phương thức SetPrivacyFrameworkRequired() và SetPrivacyConsentString(), để cho phép bạn chuyển sự đồng ý đến SDK AdColony. Mã mẫu sau đây minh hoạ cách truyền thông tin về sự đồng ý đến bộ chuyển đổi AdColony. Sau đó, bộ chuyển đổi này sẽ được dùng trong phương thức khởi chạy của AdColony. Bạn phải đặt các tuỳ chọn này trước khi khởi động SDK Quảng cáo của Google trên thiết bị di động để đảm bảo chúng được chuyển tiếp đúng cách đến SDK của AdColony.

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

Hãy xem bài viết về Quyền riêng tư của người tiêu dùng và hướng dẫn triển khai Luật về quyền riêng tư của AdColony để biết thêm thông tin và các giá trị có thể được cung cấp trong phương thức này.

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

Android

Bạn không cần phải thêm mã để tích hợp AdColony.

iOS

Tích hợp SKAdNetwork

Làm theo tài liệu của AdColony để thêm các giá trị nhận dạng SKAdNetwork vào tệp Info.plist của dự án.

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

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

Hãy nhớ đăng ký thiết bị thử nghiệm cho AdMob và bật chế độ thử nghiệm trong AdColony giao diện người dùng.

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

Để xác minh rằng bạn đang nhận quảng cáo thử nghiệm từ AdColony, 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ách sử dụng AdColony (Bidding) and AdColony (Waterfall) (các) nguồn quảng cáo.

Các bước không bắt buộc

Android

Quyền

Để có hiệu suất tối ưu, AdColony khuyên bạn nên thêm các quyền không bắt buộc sau đây vào tệp AndroidManifest.xml nằm trong thư mục Assets/Plugins/Android/GoogleMobileAdsPlugin của dự án Unity.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

iOS

Bạn không cần thực hiện thêm bước nào khác để tích hợp trên iOS.

Thông số theo mạng cụ thể

Gói dàn xếp AdColony hỗ trợ các tham số yêu cầu và cấu hình bổ sung. Các tham số này có thể được truyền đến bộ chuyển đổi bằng cách sử dụng các lớp AdColonyMediationExtras và AdColonyAppOptions.

Lớp AdColonyMediationExtras bao gồm các phương thức sau:

SetShowPrePopup(bool)
Đặt xem có hiển thị cửa sổ bật lên trước khi hiển thị quảng cáo hay không. Đặt thành false nếu bạn không muốn hiển thị cửa sổ bật lên trước khi quảng cáo hiển thị.
SetShowPostPopup(bool)
Đặt xem có hiển thị cửa sổ bật lên sau khi hiển thị quảng cáo hay không. Đặt thành false nếu bạn không muốn hiển thị cửa sổ bật lên sau khi quảng cáo hiển thị.

Lớp AdColonyAppOptions bao gồm các phương thức sau:

SetUserId(string)
Đặt Mã nhận dạng người dùng cho SDK AdColony nhằm cung cấp thêm số liệu phân tích cho Máy chủ quảng cáo AdColony.
SetTestMode(bool)
Thiết lập xem có bật chế độ thử nghiệm cho SDK AdColony hay không.

Dưới đây là mã ví dụ về cách đặt các cấu hình và thông số yêu cầu quảng cáo này:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ AdColony, thì nhà xuất bản có thể kiểm tra lỗi cơ sở trong phản hồi quảng cáo bằng cách sử dụng ResponseInfo theo các lớp sau:

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi AdColony gửi khi một quảng cáo không tải được:

Android

Mã lỗi Lý do
100 SDK AdColony đã trả về một lỗi.
101 Thông số máy chủ không hợp lệ (ví dụ: thiếu mã vùng).
102 Đã yêu cầu một quảng cáo cho cùng một mã vùng.
103 SDK AdColony đã trả về lỗi khởi động.
104 Kích thước biểu ngữ đã yêu cầu không tương ứng với kích thước quảng cáo AdColony hợp lệ.
105 Lỗi trình bày do không tải quảng cáo.
106 Ngữ cảnh dùng để khởi chạy SDK AdColony không phải là thực thể Activity.

iOS

Mã lỗi Lý do
0 – 3 SDK AdColony đã trả về một lỗi. Hãy xem tài liệu để biết thêm thông tin chi tiết.
101 Thông số máy chủ không hợp lệ (ví dụ: thiếu mã vùng).
102 Bộ điều khiển chế độ xem gốc trình bày quảng cáo là nil.
103 SDK AdColony đã trả về lỗi khởi động.
104 SDK AdColony không hỗ trợ việc định cấu hình 2 lần trong khoảng thời gian 5 giây.
105 Không hiển thị được quảng cáo.
106 Vùng được dùng cho quảng cáo có tặng thưởng không phải là vùng có tặng thưởng trên cổng thông tin AdColony.

Nhật ký thay đổi trình bổ trợ dàn xếp AdColony Unity

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

  • Khắc phục cảnh báo định nghĩa trùng lặp cho MediationExtras.

Phiên bản 2.6.2

Phiên bản 2.6.1

  • Cập nhật các API quyền riêng tư từ lớp AdColonyAppOptions thành các phương thức sau để hỗ trợ GDPR và CCPA:
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string) –> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • Hỗ trợ Bộ chuyển đổi Android AdColony phiên bản 4.8.0.1.
  • Hỗ trợ Bộ chuyển đổi AdColony iOS phiên bản 4.9.0.2.
  • Được tạo và thử nghiệm với Trình bổ trợ Unity dành cho quảng cáo của Google trên thiết bị di động phiên bản 7.4.1.

Phiên bản 2.6.0

Phiên bản 2.5.0

Phiên bản 2.4.1

Phiên bản 2.4.0

Phiên bản 2.3.0

Phiên bản 2.2.0

Phiên bản 2.1.0

Phiên bản 2.0.3

Phiên bản 2.0.2

Phiên bản 2.0.1

Phiên bản 2.0.0

Phiên bản 1.0.6

Phiên bản 1.0.5

  • Di chuyển các phương thức sau từ lớp Builder AdColonyMediationExtras sang lớp AdColonyAppOptions:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • Thêm các phương thức sau vào lớp AdColonyAppOptions:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • Xoá phương thức SetZoneId() khỏi lớp Builder AdColonyMediationExtras.
  • Hỗ trợ bộ chuyển đổi AdColony Android phiên bản 3.3.10.1.
  • Hỗ trợ bộ chuyển đổi AdColony iOS phiên bản 3.3.7.2.

Phiên bản 1.0.4

  • Cập nhật trình bổ trợ để hỗ trợ API quảng cáo có tặng thưởng dạng thử nghiệm mở mới.
  • Hỗ trợ bộ điều hợp Android AdColony phiên bản 3.3.8.1.
  • Hỗ trợ bộ chuyển đổi AdColony iOS phiên bản 3.3.6.1.

Phiên bản 1.0.3

  • Hỗ trợ bộ chuyển đổi AdColony Android phiên bản 3.3.5.1.
  • Hỗ trợ bộ chuyển đổi AdColony iOS phiên bản 3.3.5.0.

Phiên bản 1.0.2

  • Hỗ trợ SDK Android AdColony phiên bản 3.3.4.
  • Hỗ trợ SDK AdColony iOS phiên bản 3.3.4.
  • SetTestMode() trong lớp Builder AdColonyMediationExtras hiện bị bỏ qua trên Android. Giờ đây, nhà xuất bản có thể yêu cầu quảng cáo thử nghiệm từ AdColony dành cho Android bằng cách chỉ định một thiết bị thử nghiệm thông qua AddTestDevice() từ lớp Builder AdRequest.
  • Thêm các phương thức sau vào lớp Builder AdColonyMediationExtras:
    • SetGDPRRequired()
    • SetGDPRConsentString()

Phiên bản 1.0.1

  • Hỗ trợ SDK Android AdColony phiên bản 3.3.0-unity.
  • Hỗ trợ SDK AdColony iOS phiên bản 3.3.0.

Phiên bản 1.0.0

  • Bản phát hành đầu tiên!
  • Hỗ trợ SDK Android AdColony phiên bản 3.3.0.
  • Hỗ trợ SDK AdColony iOS phiên bản 3.3.0.