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

Chọn nền tảng: Android (beta) Android iOS Unity Flutter

Hướng dẫn này sẽ 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ừ LINE Ads Network bằng Dàn xếp AdMob, bao gồm cả các hoạt động tích hợp theo kiểu thác nước. Tài liệu này trình bày cách thêm LINE Ads Network 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 LINE Ads Network vào một ứng dụng Android.

Giao diện trang tổng quan của LINE Ads Network sử dụng văn bản tiếng Nhật cho nhãn, nút và nội dung mô tả. Ảnh chụp màn hình trong hướng dẫn này chưa được dịch. Tuy nhiên, trong phần mô tả và hướng dẫn của hướng dẫn này, nhãn và nút được dịch bằng các từ tương đương trong tiếng Anh trong dấu ngoặc đơn.

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

Bộ chuyển đổi dàn xếp cho LINE Ads Network có các chức năng sau:

Yêu cầu

• 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 bộ chuyển đổi LINE Ads Network 2.9.20241129.0 trở lên (nên dùng phiên bản mới nhất)

• Mới nhất GMA Next-Gen SDK

• Hoàn tất hướng dẫn Bắt đầu dàn xếp

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

Đăng ký và đăng nhập vào tài khoản LINE Ads Network.

Thêm ứng dụng mới

Chuyển đến thẻ アプリ (Ứng dụng) rồi nhấp vào nút 新規登録 (Đăng ký mới).

Điền thông tin vào biểu mẫu rồi nhấp vào 登録 (Đăng ký).

Ghi lại アプリID (Mã ứng dụng).

Tạo một 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 phần スロット (Vị trí), hãy nhấp vào 追加 (Thêm).

Điền thông tin vào biểu mẫu để biết thông tin chi tiết về vị trí. Đối với Bidding Type (Loại đặt giá thầu), hãy chọn Standard (Tiêu 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 Google SDK Bidding (Đặ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 bạn điền xong biểu mẫu.

Ghi lại スロットID (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 thiết lập tệp app-ads.txt cho ứng dụng của bạn.

Để triển khai app-ads.txt cho LINE Ads Network, 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ề LINE 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 LINE Ads Network vào cấu hình dàn xếp cho đơn vị quảng cáo.

Trước tiên, hãy đăng nhập vào tài khoản AdMob. Tiếp theo, hãy chuyển đến thẻ Dàn xếp. Nếu bạn có một nhóm dàn xếp hiện có mà bạn muốn sửa đổi, 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 phần Thêm LINE 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, sau đó nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp và chọn các vị trí để nhắm mục tiêu. Tiếp theo, hãy đặt trạng thái 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ó. Sau đó, 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 LINE Ads Network làm nguồn quảng cáo

Đặt giá thầu

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

Nhấp vào Cách ký thoả thuận hợp tác rồi thiết lập mối quan hệ hợp tác đặt giá thầu với LINE Ads Network.



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



Nếu đã có mối liên kết cho LINE Ads Network, 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à Slot ID đã nhận được trong phần trước. Sau đó, nhấp vào Xong.

Thác nước

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

Chọn LINE Ads Network rồi bật nút chuyển Optimize (Tối ưu hoá). Nhập Login name (Tên đăng nhập) và Password (Mật khẩu) đã nhận được trong phần trước để thiết lập tính năng tối ưu hoá nguồn quảng cáo cho LINE Ads Network. Sau đó, nhập eCPM value (giá trị eCPM) cho LINE Ads Network rồi nhấp vào Tiếp tục.



Nếu đã có mối liên kết cho LINE Ads Network, 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 Application ID (Mã ứng dụng) và Slot ID (Mã vị trí) đã nhận được trong phần trước. Sau đó, nhấp vào Xong.

Bước 3: Nhập SDK và bộ chuyển đổi của LINE 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:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:line:3.0.1.1")
}

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

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:line:3.0.1.1'
}

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 LINE Ads Network SDK's .aar tệp 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 bộ chuyển đổi LINE Ads Network 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 bộ chuyển đổi LINE 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ã nào khác để tích hợp LINE Ads Network.

Bước 5: Kiểm thử quá trình 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 LINE Ads Network chứa một phương thức trợ giúp để bật chế độ thử nghiệm cho LINE Ads Network. Bạn phải đặt lựa chọn này trước khi bạn 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 LINE Ads Network.

LineMediationAdapter.Companion.setTestMode(true);
LineMediationSnippets.java

LineMediationAdapter.setTestMode(true)
LineMediationSnippets.kt

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ừ LINE Ads Network, hãy bật tính năng thử nghiệm 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 LINE Ads Network(Thác nước).

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

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

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

enableAdSound

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.

Sau đây là ví dụ về mã cách tạo yêu cầu quảng cáo đặt các tham số này:

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

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

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

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

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

Hiển thị quảng cáo

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

¹ Đối với quảng cáo gốc, SDK LINE Ads Network không cung cấp nội dung biểu tượng ứng dụng. Thay vào đó, bộ chuyển đổi LINE Ads Network sẽ điền biểu tượng ứng dụng bằng một hình ảnh trong suốt.

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ LINE Ads Network, bạn có thể kiểm tra lỗi cơ bản từ lượt phản hồi quảng cáo bằ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 LINE Ads Network gửi khi quảng cáo không tải được: