Tích hợp LY 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 GMA Next-Gen SDK để tải và hiển thị quảng cáo từ Mạng quảng cáo LY Ads Network bằng tính năng Dàn xếp AdMob, bao gồm cả các hoạt động tích hợp kiểu thác nước. Tài liệu này trình bày cách thêm Mạng quảng cáo LY 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 Mạng quảng cáo LY Ads vào một ứng dụng Android.

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 cho Mạng quảng cáo LY có các chức năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Định dạng
Biểu ngữ
Quảng cáo xen kẽ
Được thưởng
Mã gốc

Đ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:

  • Android API cấp 24 trở lên.

  • [Đối với tính năng đặt giá thầu]: Để tích hợp tất cả các định dạng quảng cáo được hỗ trợ trong tính năng đặt giá thầu, hãy sử dụng trình chuyển đổi LY Ads Network phiên bản 2.9.20241129.0 trở lên (nên dùng phiên bản mới nhất).

Bước 1: Thiết lập cấu hình trong giao diện người dùng của Mạng quảng cáo LY

Đăng ký và đăng nhập vào tài khoản Mạng quảng cáo LY.

Thêm ứng dụng mới

Chuyển đến thẻ App (Ứng dụng) rồi nhấp vào nút New registration (Đăng ký mới).

Đăng ký mới

Điền vào biểu mẫu rồi nhấp vào đăng ký.

Biểu mẫu đăng ký mới

Ghi lại Mã ứng dụng.

Thông tin đăng ký

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

Trên thẻ Ứng dụng, hãy chọn ứng dụng của bạn để xem thông tin chi tiết về ứng dụng. Trong mục Vị trí, hãy nhấp vào Thêm.

Thêm vị trí

Điền vào biểu mẫu để biết thông tin chi tiết về khung giờ. Đối với Loại đặt giá thầu, hãy chọn Chuẩn để định cấu hình vị trí này cho tính năng dàn xếp kiểu thác nước hoặc Đặt giá thầu qua SDK của Google để định cấu hình vị trí này cho tính năng Đặt giá thầu. Nhấp vào Tạo sau khi điền xong biểu mẫu.

Thêm biểu mẫu vị trí

Ghi lại Mã vị trí.

Thông tin chi tiết về khung giờ

Sau khi bạn tạo vị trí đầu tiên, hãy nhấp vào Xem xét trên trang thông tin chi tiết của ứng dụng để được Mạng quảng cáo LY Ads phê duyệt. Quá trình này có thể mất chút thời gian. Hãy liên hệ với người đại diện của LY Ads Network nếu bạn có thắc mắc.

Yêu cầu xem xét

Tạo khoá API báo cáo

Chuyển đến thẻ Quản lý khoá API báo cáo rồi nhấp vào nút Tạo khoá API.

Thẻ khoá API báo cáo

Điền thông tin vào biểu mẫu và nhấp vào mục Lưu.

Biểu mẫu khoá API báo cáo

Ghi lại Mã khoá API và Mã bí mật của khoá API.

Biểu mẫu khoá API báo cáo

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 thiết lập tệp app-ads.txt cho ứng dụng của bạn.

Để triển khai app-ads.txt cho Mạng quảng cáo LY, hãy xem bài viết Giới thiệu về tệp app-ads.txt.

Bước 2: Thiết lập nhu cầu về mạng quảng cáo LY Ads Network trong giao diện người dùng AdMob

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

Bạn cần thêm Mạng quảng cáo LY Ads vào cấu hình dàn xếp cho đơn vị quảng cáo của mình.

Trước tiên, hãy đăng nhập vào tài khoản AdMob của bạn. Tiếp theo, hãy chuyển đến thẻ Dàn xếp. Nếu bạn muốn sửa đổi một nhóm dàn xếp hiện có, hãy nhấp vào tên của nhóm dàn xếp đó để chỉnh sửa rồi chuyển sang bước Thêm LY Ads Network làm nguồn quảng cáo.

Để tạo một nhóm dàn xếp mới, hãy chọn Tạo nhóm dàn xếp.

Nhập định dạng quảng cáo và nền tảng, rồi nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp và chọn vị trí để nhắm mục tiêu. Tiếp theo, hãy đặt trạng thái của nhóm dàn xếp thành Đã bật, rồi nhấp vào Thêm đơn vị quảng cáo.

Liên kết nhóm dàn xếp này với một hoặc nhiều đơn vị quảng cáo AdMob hiện có của bạn. Sau đó, hãy nhấp vào Xong.

Bây giờ, bạn sẽ thấy thẻ đơn vị quảng cáo được điền sẵn các đơn vị quảng cáo mà bạn đã chọn:

Thêm LY Ads Network làm nguồn quảng cáo

Đặt giá thầu


Trong mục Nguồn quảng cáo, hãy tìm thẻ Đặt giá thầu rồi chọn Thêm nguồn quảng cáo. Sau đó, chọn LY Ads Network .

Nhấp vào Cách ký thoả thuận hợp tác và thiết lập mối quan hệ đối tác đặt giá thầu với Mạng quảng cáo LY.



Nhấp vào Xác nhận và đồng ý, sau đó nhấp vào Tiếp tục.



Nếu đã có liên kết cho Mạng quảng cáo LY, bạn có thể chọn liên kết đó. Nếu không, hãy nhấp vào Thêm mối liên kết.



Tiếp theo, hãy nhập Mã ứng dụng và Mã vị trí mà bạn đã lấy được trong phần trước. Sau đó, hãy nhấp vào Xong.



Thác nước


Trong thẻ Thác nước ở mục Nguồn quảng cáo, hãy chọn Thêm nguồn quảng cáo.

Chọn LY Ads Network rồi bật nút chuyển Tối ưu hoá. Nhập Mã khoá API và Khoá bí mật API mà bạn nhận được ở phần trước để thiết lập tính năng tối ưu hoá nguồn quảng cáo cho LY Ads Network. Sau đó, hãy nhập giá trị eCPM cho Mạng quảng cáo LY rồi nhấp vào Tiếp tục.




Nếu đã có mối liên kết cho Mạng quảng cáo LY, bạn có thể chọn mối liên kết đó. Nếu không, hãy nhấp vào Thêm mối liên kết.



Tiếp theo, hãy nhập Mã ứng dụng và Mã vùng quảng cáo mà bạn đã lấy được trong phần trước. Sau đó, hãy nhấp vào Xong.


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

Trong tệp gradle ở cấp ứng dụng, hãy thêm các phần phụ thuộc và cấu hình triển khai sau:

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:line:3.1.1.2")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:line:3.1.1.2'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

Tích hợp thủ công

  1. Tải phiên bản mới nhất của tệp .aar của LY Ads Network SDK xuống rồi thêm tệp đó vào dự án của bạn.

  2. Chuyển đến các cấu phần phần mềm của bộ chuyển đổi mạng quảng cáo LY Ads trên Kho lưu trữ Maven của Google. Chọn phiên bản mới nhất, tải tệp .aar của trình chuyển đổi LY Ads Network xuống rồi thêm tệp đó vào dự án của bạn.

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

Bạn không cần thêm mã để tích hợp Mạng quảng cáo LY.

Bước 5: Kiểm thử 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 AdMob.

Bộ chuyển đổi mạng quảng cáo LY Ads có chứa một phương thức trợ giúp để bật chế độ thử nghiệm cho mạng quảng cáo LY Ads. Bạn phải đặt lựa chọn này trước khi khởi động GMA Next-Gen SDK để đảm bảo các lựa chọn này được chuyển tiếp đúng cách đến SDK của Mạng quảng cáo LY.

Java

LineMediationAdapter.Companion.setTestMode(true);

Kotlin

LineMediationAdapter.setTestMode(true)

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ừ LY Ads Network, 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 LY Ads Network.

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

Tham số dành riêng cho mạng

Bộ chuyển đổi mạng quảng cáo LY Ads hỗ trợ một tham số yêu cầu bổ sung có thể được truyền đến bộ chuyển đổi bằng lớp LineExtras. Hàm khởi tạo lớp này bao gồm các tham số sau:

enableAdSound
Một boolean để chỉ định trạng thái bắt đầu âm thanh mặc định của quảng cáo biểu ngữ, quảng cáo xen kẽ và quảng cáo có tặng thưởng.

Dưới đây là ví dụ về mã để tạo một yêu cầu quảng cáo đặt các tham số này:

Java

LineExtras lineExtras = new LineExtras(/* enableAdSound: */ true);
Bundle extras = lineExtras.build();

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter.class, extras).build();

Kotlin

val lineExtras = LineExtras(enableAdSound = true)
val extras = lineExtras.build()

val request =
  AdRequest.Builder().addNetworkExtrasBundle(LineMediationAdapter::class.java, extras).build()

Sử dụng quảng cáo gốc

Hiển thị quảng cáo

Bộ chuyển đổi LY Ads Network điền sẵn các trường sau đây trong mô tả trường nâng cao của quảng cáo gốc cho một NativeAd.

Trường Các thành phần luôn được bộ chuyển đổi mạng quảng cáo LY Ads đưa vào
Dòng tiêu đề
Hình ảnh
Nội dung
Biểu tượng ứng dụng 1
Lời kêu gọi hành động
Điểm xếp hạng theo sao
Cửa hàng
Giá

1 Đối với quảng cáo gốc, SDK Mạng quảng cáo LY không cung cấp thành phần biểu tượng ứng dụng. Thay vào đó, bộ chuyển đổi Mạng quảng cáo LY sẽ điền hình ảnh trong suốt vào biểu tượng ứng dụng.

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ Mạng quảng cáo LY, bạn có thể kiểm tra lỗi cơ bản trong lượt phản hồi quảng cáo bằng cách sử dụng ResponseInfo.getAdSourceResponses() trong các lớp sau:

com.line.ads
com.google.ads.mediation.line.LineMediationAdapter

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

Mã lỗi Miền Lý do
1-10 com.five_corp.ad SDK Mạng quảng cáo LY đã trả về một lỗi dành riêng cho SDK. Hãy xem tài liệu của Mạng quảng cáo LY Ads Network để biết thêm thông tin chi tiết.
101 com.google.ads.mediation.line Mã ứng dụng bị thiếu hoặc không hợp lệ.
102 com.google.ads.mediation.line Mã vị trí bị thiếu hoặc không hợp lệ.
103 com.google.ads.mediation.line Kích thước quảng cáo được yêu cầu không khớp với kích thước quảng cáo biểu ngữ được mạng quảng cáo LY Ads Network hỗ trợ.
104 com.google.ads.mediation.line Không tải được quảng cáo xen kẽ hoặc quảng cáo có tặng thưởng do thiếu bối cảnh hoạt động.
105 com.google.ads.mediation.line SDK Mạng quảng cáo LY Ads không hiển thị được quảng cáo xen kẽ hoặc quảng cáo có tặng thưởng.
106 com.google.ads.mediation.line Không tải được quảng cáo gốc do thiếu thành phần.
107 com.google.ads.mediation.line FiveAd SDK đã trả về một trình tải quảng cáo rỗng.

Nhật ký thay đổi của Bộ chuyển đổi dàn xếp LINE dành cho Android

Phiên bản 3.1.1.2

  • Ghim phần phụ thuộc Kotlin của bộ chuyển đổi vào phiên bản 1.9.0 (phiên bản Kotlin tối thiểu được GMA NextGen SDK hỗ trợ).

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.4.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.4.0.
  • FiveAd SDK phiên bản 3.1.1.1.

Phiên bản 3.1.1.1

  • Liên kết AgeRestrictedTreatment với API ChildDirectedTreatment của Line.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.4.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.2.1.
  • FiveAd SDK phiên bản 3.1.1.1.

Phiên bản 3.1.1.0

  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 3.1.1.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.2.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 1.2.1.
  • FiveAd SDK phiên bản 3.1.1.0.

Phiên bản 3.1.0.0

  • Thêm thuộc tính để tạo bộ chuyển đổi có phần phụ thuộc GMA Next-Gen SDK.
  • Xác minh khả năng tương thích với SDK FiveAd phiên bản 3.1.0.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.1.0.
  • Google Mobile Ads Next-Gen SDK phiên bản 0.25.0-beta01.
  • FiveAd SDK phiên bản 3.1.0.0.

Phiên bản 3.0.1.2

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 25.1.0.
  • FiveAd SDK phiên bản 3.0.1.2.

Phiên bản 3.0.1.1

  • Lượt hiển thị quảng cáo gốc hiện được SDK FiveAd ghi đè khi sử dụng SDK Quảng cáo của Google trên thiết bị di động phiên bản 24.4.0 trở lên.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • FiveAd SDK phiên bản 3.0.1.1.

Phiên bản 3.0.1.0

  • Thêm tính năng hỗ trợ chuyển tiếp tham số tagForUnderAgeOfConsent của Google Mobile Ads SDK đến SDK FiveAd.
  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 3.0.1.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • FiveAd SDK phiên bản 3.0.1.0.

Phiên bản 3.0.0.0

  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 3.0.0.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.9.0.
  • FiveAd SDK phiên bản 3.0.0.0.

Phiên bản 2.9.20251028.0

  • Khả năng tương thích đã được xác minh với SDK FiveAd phiên bản 2.9.20251028.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.7.0.
  • FiveAd SDK phiên bản 2.9.20251028.0

Phiên bản 2.9.20250924.1

  • Đã xóa các tham chiếu cấp lớp đến Context. Có thể giúp giảm các vấn đề rò rỉ bộ nhớ.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.7.0.
  • FiveAd SDK phiên bản 2.9.20250924.1.

Phiên bản 2.9.20250924.0

  • Xác minh khả năng tương thích với SDK FiveAd phiên bản 2.9.20250924.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 24.6.0.
  • FiveAd SDK phiên bản 2.9.20250924.0

Phiên bản 2.9.20250718.0

  • Đã xác minh khả năng tương thích với FiveAd SDK phiên bản 2.9.20250718.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 24.3.0.
  • FiveAd SDK phiên bản 2.9.20250718.0.

Phiên bản 2.9.20250519.0

  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 2.9.20250519.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 24.3.0.
  • SDK FiveAd phiên bản 2.9.20250519.0.

Phiên bản 2.9.20250317.1

  • Khắc phục kích thước tải biểu ngữ cho quảng cáo đặt giá thầu bằng API FiveAd mới

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.1.0.
  • FiveAd SDK phiên bản 2.9.20250317.0

Phiên bản 2.9.20250317.0

  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 2.9.20250317.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.1.0.
  • FiveAd SDK phiên bản 2.9.20250317.0

Phiên bản 2.9.20250110.1

  • Cập nhật cấp độ API Android tối thiểu bắt buộc lên 23.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 24.0.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 24.0.0.
  • FiveAd SDK phiên bản 2.9.20250110.0

Phiên bản 2.9.20250110.0

  • Đã xóa lớp UnifiedNativeAdMapper không dùng nữa và thay bằng NativeAdMapper
  • Đã khắc phục quy trình thu thập tín hiệu.
  • Sửa quy trình khởi chạy cho định dạng quảng cáo xen kẽ và quảng cáo có tặng thưởng dạng thác nước.
  • Đã xác minh khả năng tương thích với FiveAd SDK phiên bản 2.9.20250110.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.6.0.
  • FiveAd SDK phiên bản 2.9.20250110.0

Phiên bản 2.9.20241129.0

  • Bổ sung tính năng hỗ trợ đặt giá thầu cho các định dạng quảng cáo biểu ngữ, quảng cáo xen kẽ, quảng cáo có tặng thưởng và định dạng quảng cáo gốc.
  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 2.9.20241129.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.5.0.
  • FiveAd SDK phiên bản 2.9.20241129.0

Phiên bản 2.8.20240827.0

  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 2.8.20240827.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 23.3.0.
  • FiveAd SDK phiên bản 2.8.20240827.0

Phiên bản 2.8.20240808.0

  • Đã xác minh khả năng tương thích với FiveAd SDK phiên bản 2.8.20240808.

Được tạo và thử nghiệm với:

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 23.2.0.
  • FiveAd SDK phiên bản 2.8.20240808.0

Phiên bản 2.8.20240722.0

  • Đã xác minh khả năng tương thích với SDK FiveAd phiên bản 2.8.20240722.

Được tạo và thử nghiệm với:

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 23.2.0.
  • FiveAd SDK phiên bản 2.8.20240722.0

Phiên bản 2.7.20240515.0

  • Đã xác minh khả năng tương thích với FiveAd SDK phiên bản 2.7.20240515.

Được tạo và thử nghiệm với:

  • SDK quảng cáo trên thiết bị di động của Google phiên bản 23.1.0.
  • FiveAd SDK phiên bản 2.7.20240515.0

Phiên bản 2.7.20240214.1

  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 23.0.0.
  • Đã xác minh khả năng tương thích với FiveAd SDK phiên bản 2.7.20240214.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 23.0.0.
  • FiveAd SDK phiên bản 2.7.20240214.0.

Phiên bản 2.7.20240214.0

  • Đã xác minh khả năng tương thích với FiveAd SDK phiên bản 2.7.20240214.

Được tạo và thử nghiệm với:

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 22.6.0.
  • FiveAd SDK phiên bản 2.7.20240214.0.

Phiên bản 2.7.20240126.0

  • Xác minh khả năng tương thích với SDK FiveAd phiên bản 2.7.20240126.

Được tạo và thử nghiệm với:

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 22.6.0.
  • FiveAd SDK phiên bản 2.7.20240126.0.

Phiên bản 2.7.20240112.0

  • Đã xóa FiveAdViewEventListener không dùng nữa và thay bằng FiveAdCustomLayoutEventListener, FiveAdVideoRewardEventListener, FiveAdInterstitialEventListener và FiveAdNativeEventListener.
  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 2.7.20240112.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên phiên bản 22.6.0.

Được tạo và thử nghiệm với:

  • SDK Quảng cáo của Google trên thiết bị di động phiên bản 22.6.0.
  • FiveAd SDK phiên bản 2.7.20240112.

Phiên bản 2.6.20230607.1

  • Thêm lớp LineExtras để nhà xuất bản xác định chế độ cài đặt âm thanh mặc định cho định dạng quảng cáo biểu ngữ, quảng cáo xen kẽ và quảng cáo có tặng thưởng.
  • Cập nhật phiên bản tối thiểu bắt buộc của Google Mobile Ads SDK lên 22.4.0.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 22.4.0.
  • FiveAd SDK phiên bản 2.6.20230607.

Phiên bản 2.6.20230607.0

  • Bản phát hành đầu tiên.
  • Bổ sung tính năng hỗ trợ cho các định dạng quảng cáo biểu ngữ, quảng cáo xen kẽ, quảng cáo có tặng thưởng và định dạng quảng cáo gốc.
  • Xác minh khả năng tương thích với FiveAd SDK phiên bản 2.6.20230607.

Được tạo và thử nghiệm với:

  • Google Mobile Ads SDK phiên bản 22.1.0.
  • FiveAd SDK phiên bản 2.6.20230607.