Trang này được dịch bởi Cloud Translation API.

Tích hợp dòng với tính năng dàn xếp (Beta)

Hướng dẫn này chỉ cho bạn 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ừ Dòng sử dụng Dàn xếp AdMob, bao gồm việc tích hợp thác nước. Hướng dẫn này trình bày cách thêm Đường vào một đơn vị quảng cáo cấu hình dàn xếp và cách tích hợp SDK dòng và bộ chuyển đổi vào ứng dụng Android .

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

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 Đường có các khả 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

¹ Tính năng tích hợp thác nước đang ở giai đoạn thử nghiệm beta công khai.

Yêu cầu

Android API cấp 21 trở lên

SDK Quảng cáo của Google trên thiết bị di động mới nhất
Hoàn tất quá trình 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 Line UI

Bước 2: Thiết lập Nhu cầu đối với đường truyền 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

Bạn cần thêm Line 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 đang có một nhóm dàn xếp 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 đến mục Thêm Line dưới dạng 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 quảng cáo của bạn, rồi nhấp vào Tiếp tục.

Đặt tên cho nhóm dàn xếp của bạn và chọn các 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ó. 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 Line làm nguồn quảng cáo

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

Chọn Line. Sau đó, hãy nhập giá trị eCPM cho Line rồi nhấp vào Tiếp tục.

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

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

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 phương thức triển khai sau các phần phụ thuộc và cấu hình. Sử dụng phiên bản mới nhất của Line SDK và bộ chuyển đổi:

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

Tích hợp thủ công

Tải xuống phiên bản mới nhất của .aar của SDK Đường tệp và thêm tệp đó vào dự án của bạn.
Chuyển đến Cấu phần phần mềm bộ chuyển đổi dòng trên Kho lưu trữ Maven của Google. Chọn phiên bản mới nhất, tải ứng dụng Line tệp .aar của bộ chuyển đổi rồi thêm tệp này vào dự án của bạn.

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

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

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

Hãy làm theo hướng dẫn trong Tài liệu về dòng về cách bật Quảng cáo thử nghiệm 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ừ Line, 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 Line (Waterfall) (các) nguồn quảng cáo.

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

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

Bộ chuyển đổi đường dây hỗ trợ một tham số yêu cầu bổ sung có thể được chuyển cho trình 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 thông số sau:

enableAdSound: boolean để chỉ định trạng thái bắt đầu phát â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.

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

Java

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

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

Kotlin

val lineExtras = LineExtras(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 dòng sẽ điền thông tin sau Nội dung mô tả trường quảng cáo gốc nâng cao cho một NativeAd

Trường	Tài sản luôn có trong Bộ chuyển đổi đường kẻ
Dòng tiêu đề
Bài đăng có hình ảnh
Nội dung
Biểu tượng ứng dụng	¹
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, SDK dòng không cung cấp thành phần biểu tượng ứng dụng. Thay vào đó, bộ chuyển đổi dòng sẽ điền ứ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, bạn có thể kiểm tra lỗi cơ bản từ phản hồi quảng cáo bằng cách sử dụng ResponseInfo.getAdapterResponses() thuộc các lớp sau:

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

Dưới đây là mã và tin nhắn đi kèm do Bộ chuyển đổi đường dây gửi khi không thể tải quảng cáo:

Mã lỗi	Lâu đài	Lý do
1-10	com.five_corp.ad	SDK dòng trả về một lỗi riêng của SDK. Xem Tài liệu của Line để biết thêm 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ùng 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 dòng 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 ngữ cảnh hoạt động.
105	com.google.ads.mediation.line	SDK dòng 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.