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).
Phiên bản GMA Next-Gen SDK 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).
Điền vào biểu mẫu rồi nhấp vào đăng ký.
Ghi lại Mã ứng dụng.
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.
Đ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.
Ghi lại Mã vị trí.
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.
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.
Điền thông tin vào biểu mẫu và nhấp vào mục Lưu.
Ghi lại Mã khoá API và Mã bí mật của khoá API.
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
Tích hợp Android Studio (nên dùng)
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
Tải phiên bản mới nhất của tệp
.aarcủa LY Ads Network SDK xuống rồi thêm tệp đó vào dự án của bạn.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
.aarcủ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
Kotlin
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
Kotlin
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
AgeRestrictedTreatmentvớ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
UnifiedNativeAdMapperkhông dùng nữa và thay bằngNativeAdMapper - Đã 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
FiveAdViewEventListenerkhông dùng nữa và thay bằngFiveAdCustomLayoutEventListener,FiveAdVideoRewardEventListener,FiveAdInterstitialEventListenervà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.