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 | 1 |
Định dạng | |
Biểu ngữ | |
Quảng cáo xen kẽ | |
Được thưởng | |
Mã gốc |
1 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 | 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 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. |
Nhật ký thay đổi của bộ chuyển đổi dàn xếp Android trong LINE
Phiên bản 2.8.20240808.0
- Khả năng tương thích xác minh với FiveAd SDK phiên bản 2.8.20240808.0
Được xây dựng 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.
- Phiên bản SDK FiveAd 2.8.20240808.0
Phiên bản 2.8.20240722.0
- Khả năng tương thích xác minh với FiveAd SDK phiên bản 2.8.20240722.0
Được xây dựng 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.
- Phiên bản SDK FiveAd 2.8.20240722.0
Phiên bản 2.7.20240515.0
- Khả năng tương thích được xác minh với FiveAd SDK phiên bản 2.7.20240515.0
Được xây dựng 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 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.0.
Được xây dựng 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.
- Phiên bản SDK FiveAd 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.0.
Được xây dựng 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.
- Phiên bản SDK FiveAd 2.7.20240214.0.
Phiên bản 2.7.20240126.0
- Khả năng tương thích xác minh với FiveAd SDK phiên bản 2.7.20240126.0.
Được xây dựng 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.
- Phiên bản SDK FiveAd 2.7.20240126.0.
Phiên bản 2.7.20240112.0
- Xoá
FiveAdViewEventListener
không dùng nữa, thay vào đó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 phiên bản 22.6.0.
Được xây dựng 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.
- Phiên bản SDK FiveAd 2.7.20240112.
Phiên bản 2.6.20230607.1
- Thêm lớp
LineExtras
dành cho nhà xuất bản để xác định chế độ cài đặt âm thanh mặc định cho định dạng 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 phiên bản 22.4.0.
Được xây dựng 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.
- Phiên bản SDK FiveAd 2.6.20230607.
Phiên bản 2.6.20230607.0
- Bản phát hành đầu tiên.
- Thêm tuỳ chọn 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.
- Khả năng tương thích xác minh với FiveAd SDK phiên bản 2.6.20230607.
Được xây dựng 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.
- Phiên bản SDK FiveAd 2.6.20230607.