Tích hợp Mạng quảng cáo LINE với tính năng dàn xếp

Hướng dẫn này sẽ cho bạn biết cách sử dụng SDK quảng cáo trên thiết bị di động của Google để tải và hiển thị quảng cáo từ Mạng quảng cáo LINE bằng cách sử dụng tính năng hoà giải, 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 Mạng quảng cáo LINE vào cấu hình dàn xếp của một đơn vị quảng cáo và cách tích hợp SDK và bộ chuyển đổi Mạng quảng cáo LINE vào một ứng dụng Android.

Giao diện trang tổng quan của Mạng quảng cáo LINE 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 tài liệu này, các nhãn và nút được dịch sang tiếng Anh tương đương trong dấu ngoặc đơn.

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 cho Mạng quảng cáo LINE 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	^1

¹ Quảng cáo gốc (để Đặt giá thầu) đang ở giai đoạn thử nghiệm kín, hãy liên hệ với người quản lý tài khoản để yêu cầu quyền truy cập.

Yêu cầu

• API Android cấp 23 trở lên

• SDK Quảng cáo của Google trên thiết bị di động mới nhất

• Xem hết hướng dẫn Bắt đầu sử dụng 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 Mạng quảng cáo LINE

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

Thêm ứng dụng mới

Nhấp vào 広告枠管理 (Quản lý vùng quảng cáo) > メディア (Nội dung nghe nhìn). Sau đó, nhấp vào 新規作成 (Tạo mới).

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

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

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

Nhấp vào mã nhận dạng của ứng dụng mà bạn muốn thêm vị trí đặt quảng cáo. Sau đó, hãy chọn 詳細 (Chi tiết).

Nhấp vào スロット 追加 (Thêm vùng quảng cáo).

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

Lưu ý: Bạn không thể thay đổi フォーマット (Định dạng) và Bidding Type (Loại giá thầu) sau khi đăng ký vị trí. Hãy liên hệ với người quản lý tài khoản LINE Ads Network để được cấp quyền tạo vị trí quảng cáo gốc trong giao diện người dùng LINE Ads Network.

Ghi lại Mã vị trí.

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

Người bán được uỷ quyền cho ứng dụng 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 Mạng quảng cáo LINE, hãy xem phần Giới thiệu về tệp app-ads.txt.

Bước 2: Thiết lập nhu cầu của Mạng quảng cáo LINE trong giao diện người dùng Ad Manager

Đăng nhập vào tài khoản Ad Manager.

Thêm Mạng quảng cáo LINE vào mục Công ty

Đặt giá thầu

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

Thác nước

Chuyển đến mục Quản trị > Công ty, sau đó nhấp vào nút Công ty mới trong thẻ Tất cả công ty. Chọn Mạng quảng cáo.

Chọn LINE Ads Network làm Mạng quảng cáo, nhập một Tên duy nhất và bật Dàn xếp. Bật chế độ Thu thập dữ liệu tự động, rồi nhập Tên đăng nhập và Mật khẩu mà bạn đã nhận được trong phần trước.

Bạn không cần nhập Tên người dùng hoặc Mật khẩu. Nhấp vào Lưu khi hoàn tất.

Bật tính năng chia sẻ tín hiệu an toàn

Đặt giá thầu

Chuyển đến mục Quản trị > Cài đặt chung. Chuyển đến thẻ Cài đặt tài khoản Ad Exchange, sau đó xem xét và bật chế độ Chia sẻ tín hiệu an toàn. Nhấp vào Lưu.

Thác nước

Bạn không bắt buộc phải thực hiện bước này đối với các chế độ tích hợp theo kiểu thác nước.

Chia sẻ tín hiệu an toàn trong yêu cầu giá thầu

Đặt giá thầu

Chuyển đến mục Khoảng không quảng cáo > Tín hiệu an toàn. Trong phần Tín hiệu an toàn, hãy tìm LINE rồi bật Bật tính năng tích hợp ứng dụng.

Nhấp vào Lưu.

Thác nước

Bạn không bắt buộc phải thực hiện bước này đối với các chế độ tích hợp theo kiểu thác nước.

Cho phép chia sẻ tín hiệu an toàn cho tính năng Đặt giá thầu qua SDK

Đặt giá thầu

Chuyển đến phần Phân phối > Cài đặt kênh nhu cầu. Trong thẻ Chế độ cài đặt mặc định, hãy bật chế độ Cho phép chia sẻ tín hiệu an toàn cho Đặt giá thầu SDK.

Nhấp vào Lưu.

Thác nước

Bạn không bắt buộc phải thực hiện bước này đối với các chế độ tích hợp theo kiểu thác nước.

Định cấu hình hoạt động đặt giá thầu trên LINE Ads Network

Đặt giá thầu

Chuyển đến mục Phân phối > Bên đặt giá thầu, rồi nhấp vào Chuyển đến tính năng Đặt giá thầu qua SDK.

Nhấp vào Người đặt giá thầu mới.

Chọn Mạng quảng cáo LINE làm đơn vị đặt giá thầu.

Nhấp vào Tiếp tục để bật tính năng Đặt giá thầu qua SDK cho bên đặt giá thầu này.

Nhấp vào Xong.

Thác nước

Bạn không bắt buộc phải thực hiện bước này đối với các chế độ tích hợp theo kiểu thác nước.

Định cấu hình mối liên kết đơn vị quảng cáo

Đặt giá thầu

Chuyển đến mục Phân phối > Bên đặt giá thầu, rồi nhấp vào Chuyển đến tính năng Đặt giá thầu qua SDK.

Chọn công ty cho Mạng quảng cáo LINE.

Chuyển đến thẻ Liên kết đơn vị quảng cáo rồi nhấp vào Liên kết đơn vị quảng cáo mới.

Chọn Đơn vị quảng cáo cụ thể. Chọn một đơn vị quảng cáo và định dạng, Ứng dụng di động làm Loại khoảng không quảng cáo và Ứng dụng di động của bạn. Sau đó, hãy nhập Mã ứng dụng và Mã vị trí mà bạn đã lấy được trong phần trước. Cuối cùng, hãy nhấp vào Lưu.

Lưu ý quan trọng: Nhắm đến đơn vị quảng cáo đã chọn bằng ít nhất một nhóm lợi nhuận và Mã ứng dụng phải được liên kết với ứng dụng được nhắm đến như trong giao diện người dùng Mạng quảng cáo LINE.

Thác nước

Chuyển đến mục Phân phối > Nhóm lợi nhuận rồi nhấp vào nút Nhóm lợi nhuận mới. Chọn Ứng dụng di động.

Di chuyển xuống dưới rồi nhấp vào Thêm đối tác lợi nhuận.

Chọn công ty mà bạn đã tạo cho Mạng quảng cáo LINE trong phần trước. Chọn Dàn xếp SDK trên thiết bị di động làm Loại tích hợp, Android làm Nền tảng và Đang hoạt động làm Trạng thái.

Nhập Mã ứng dụng và Mã vị trí quảng cáo thu được trong phần trước, cũng như giá trị CPM mặc định. Nhấp vào Lưu.

Quan trọng: Mã ứng dụng phải được liên kết với ứng dụng mục tiêu như trong giao diện người dùng Mạng quảng cáo LINE.

Lưu ý: Tính năng thu thập dữ liệu tự động cần một vài ngày để thu thập dữ liệu trước khi có thể tính toán chính xác giá trị CPM linh động cho một mạng dàn xếp. Sau khi có thể tính eCPM, giá trị này sẽ tự động được cập nhật thay cho bạn.

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

Lưu ý: Nếu không tích hợp các phiên bản tương thích của LINE Ads Network và SDK Quảng cáo của Google trên thiết bị di động, bạn có thể gặp phải các vấn đề về bản dựng.

Tích hợp Android Studio (nên dùng)

Trong tệp build.gradle.kts ở cấp ứng dụng, hãy thêm các cấu hình và phần phụ thuộc triển khai sau đây. Sử dụng phiên bản mới nhất của SDK và bộ chuyển đổi Mạng quảng cáo LINE:

dependencies {
    implementation("com.google.android.gms:play-services-ads:24.5.0")
    implementation("com.google.ads.mediation:line:2.9.20250718.0")
}

Tích hợp thủ công

1. Tải tệp .aar của SDK Mạng quảng cáo LINE phiên bản mới nhất xuống và 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 LINE 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 Mạng quảng cáo LINE 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 LINE.

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

Lưu ý quan trọng: Tắt chế độ kiểm thử cho Ad Manager và Mạng quảng cáo LINE trước khi phát hành ứng dụng.

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ừ Mạng quảng cáo LINE, 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 Mạng quảng cáo LINE(Dạng 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 Mạng quảng cáo LINE hỗ trợ một thông số yêu cầu bổ sung có thể được truyề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

Một boolean để chỉ định trạng thái bắt đầu âm thanh mặc định của 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 một yêu cầu quảng cáo đặt các tham số này:

Java

LineExtras lineExtras = new LineExtras(true);
Bundle extras = lineExtras.build();

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

Kotlin

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

val request = AdManagerAdRequest.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 Mạng quảng cáo LINE sẽ điền sẵn các trường sau đây cho NativeAd.

Trường	Các thành phần luôn được bộ chuyển đổi LINE Ads Network đư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á

¹ Đối với quảng cáo gốc, LINE Ads Network SDK không cung cấp thành phần 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ừ Mạng quảng cáo LINE, bạn có thể kiểm tra lỗi cơ bản trong phản hồi quảng cáo bằng cách sử dụng ResponseInfo.getAdapterResponses() 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 LINE gửi khi quảng cáo không tải được:

Mã lỗi	Lâu đài	Lý do
1-10	com.five_corp.ad	LINE Ads Network SDK 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 LINE để biết thêm thông tin chi tiết.
101	com.google.ads.mediation.line	Thiếu hoặc Mã ứng dụng không hợp lệ.
102	com.google.ads.mediation.line	Thiếu hoặc không hợp lệ Mã nhận dạng khe cắm.
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 LINE 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	LINE Ads Network SDK 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.

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

Phiên bản 2.9.20250718.0

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

Đượ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 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 của Google trên thiết bị di động phiên bản 24.3.0.
• FiveAd SDK 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 FiveAd API mới

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

• SDK Quảng cáo của Google trên thiết bị di động 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 SDK Quảng cáo của Google trên thiết bị di động lên 24.0.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 24.0.0.
• FiveAd SDK phiên bản 2.9.20250110.0

Phiên bản 2.9.20250110.0

• Xoá lớp UnifiedNativeAdMapper không dùng nữa và thay bằng NativeAdMapper
• Đã sửa quy trình thu thập tín hiệu.
• Đã khắc phục quy trình khởi chạy cố định cho các đị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:

• SDK Quảng cáo của Google trên thiết bị di động 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

• Đã thêm 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à quảng cáo gốc.
• Đã xác minh khả năng tương thích với SDK FiveAd phiên bản 2.9.20241129.

Đượ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.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 của Google trên thiết bị di động 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 SDK FiveAd 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 của Google trên thiết bị di động 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 SDK Quảng cáo của Google trên thiết bị di động lê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:

• SDK Quảng cáo của Google trên thiết bị di động 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 FiveAd SDK 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

• Đã xoá 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 SDK Quảng cáo của Google trên thiết bị di động lê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 các đị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 SDK Quảng cáo của Google trên thiết bị di động lên 22.4.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.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.
• Thêm chế độ 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à 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:

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