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

Tích hợp nend với Dàn xếp

Hướng dẫn này cho bạn biết 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ừ phần mở rộng bằng cách sử dụng tính năng dàn xếp bao gồm hoạt động tích hợp kiểu thác nước. Bài viết này trình bày cách thêm Nend 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 Nend và bộ chuyển đổi vào một ứng dụngAndroid .

Giao diện trang tổng quan của nend sử dụng văn bản tiếng Nhật cho nhãn, nút và nội dung mô tả. Ngoài ra, các ảnh chụp màn hình hiển thị bên dưới chưa được dịch. Trong hướng dẫn này, nhãn và nút được gọi bằng các từ tương đương bằng tiếng Anh. Ví dụ: "URL スキート", là "Lược đồ URL", v.v.

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 Ad Manager cho nend có các chức năng sau:

Tích hợp
Đặt giá thầu
Thác nước
Dạng thức
Biểu ngữ
Quảng cáo xen kẽ
Được thưởng
Mã gốc

Yêu cầu

API Android cấp 19 trở lên

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

Đăng ký hoặc đăng nhập vào tài khoản nend của bạn.

Để thêm ứng dụng vào trang tổng quan nend, trước tiên hãy nhấp vào thẻ Quản lý vị trí, sau đó chọn Trang web/ứng dụng. Nhấp vào nút Thêm ứng dụng để thêm ứng dụng của bạn vào.

Tạo ứng dụng

Nhập tên ứng dụng rồi chọn nền tảng ứng dụng làm loại ứng dụng. Nhập URL rồi kiểm tra xem ứng dụng của bạn đã được liệt kê trên cửa hàng ứng dụng thích hợp hay chưa

(xem phần Câu hỏi thường gặp về ứng dụng chưa phát hành của Nend nếu ứng dụng của bạn chưa được phát hành). Chọn một danh mục cho ứng dụng của bạn rồi nhấp vào Create (Tạo) khi hoàn tất.

Ứng dụng của bạn sẽ hiển thị trên trang tổng quan sau khi được tạo.

Tạo vị trí

Sau khi đăng ký ứng dụng, bạn có thể chuyển sang việc tạo vị trí. Để tạo vị trí cho quảng cáo biểu ngữ, hãy chuyển đến thẻ Quản lý vị trí rồi nhấp vào Vị trí. Sau đó, nhấp vào nút Tạo vị trí mới.

Chọn ứng dụng của bạn trong trình đơn thả xuống. Sau đó, hãy làm theo hướng dẫn bên dưới tương ứng với định dạng quảng cáo bạn muốn dùng.

Chọn Hình ảnh tĩnh cho Loại quảng cáo và chọn Biểu ngữ cho Loại khoảng không quảng cáo. Sau khi hoàn tất, hãy nhập Vị trí, điền vào phần Giới thiệu về khoảng không quảng cáo, chọn Định dạng khoảng không quảng cáo và cuối cùng chọn Kích thước khoảng không quảng cáo. Khi hoàn tất, hãy nhấp vào nút Tạo để tạo vị trí của bạn.

Quảng cáo xen kẽ

Chọn Hình ảnh tĩnh cho Loại quảng cáo và Quảng cáo xen kẽ cho Loại khoảng không quảng cáo. Sau khi hoàn tất, hãy nhập Vị trí, điền vào phần Giới thiệu về khoảng không quảng cáo và chọn Tần suất hiển thị quảng cáo từ danh sách thả xuống. Khi hoàn tất, hãy nhấp vào nút Tạo để tạo vị trí của bạn.

Đối với Quảng cáo xen kẽ dạng video, hãy chọn Video cho Loại quảng cáo và Quảng cáo xen kẽ cho Loại khoảng không quảng cáo. Sau khi hoàn tất, hãy nhập Vị trí, điền vào phần Giới thiệu về khoảng không quảng cáo và chọn một Danh mục thích hợp từ danh sách thả xuống. Khi hoàn tất, hãy nhấp vào nút Tạo để tạo vị trí của bạn.

Được thưởng

Chọn Video cho Loại quảng cáo và chọn Phần thưởng cho Loại khoảng không quảng cáo. Sau khi hoàn tất, hãy nhập Vị trí, điền vào phần Giới thiệu về khoảng không quảng cáo và chọn một Danh mục thích hợp từ danh sách thả xuống.

Trong phần Cài đặt phần thưởng, hãy chọn một Nội dung phần thưởng bằng cách sử dụng danh sách thả xuống, rồi nhập Tên tiền ảo mà bạn muốn dùng. Khi hoàn tất, hãy nhấp vào nút Tạo để tạo vị trí của bạn.

Mã gốc

Chọn Hình ảnh tĩnh cho Loại quảng cáo và chọn Gốc cho Loại khoảng không quảng cáo. Sau khi hoàn tất, hãy nhập Vị trí, điền vào phần Giới thiệu về khoảng không quảng cáo rồi chọn Lựa chọn hình ảnh quảng cáo. Khi hoàn tất, hãy nhấp vào nút Tạo để tạo vị trí của bạn.

Đối với Quảng cáo gốc dạng video, hãy chọn Video cho Loại quảng cáo và chọn Gốc (tuỳ chỉnh) cho Loại khoảng không quảng cáo. Sau khi hoàn tất, hãy nhập Vị trí, điền vào phần Giới thiệu về khoảng không quảng cáo và chọn một Danh mục thích hợp từ danh sách thả xuống.

Trong phần Cài đặt gốc, hãy chọn Hướng quảng cáo dạng video và Loại quảng cáo gốc trong danh sách. Khi hoàn tất, hãy nhấp vào nút Tạo để tạo vị trí của bạn.

Để thiết lập đơn vị quảng cáo Ad Manager trong phần tiếp theo, bạn cần có apiKey và spotID cho từng vị trí. Để tìm các SDK này, hãy chuyển đến thẻ Quản lý vị trí và chọn nút SDK bên dưới tên ứng dụng của bạn.

Ghi lại apiKey và spotID.

Bạn cũng sẽ cần Khoá API cho API báo cáo của nend (họ gọi là Khoá API để dùng để trích xuất). Bạn có thể tìm thấy công cụ này trong thẻ Công cụ.

Bước 2: Thiết lập nhu cầu kết nối trong Ad Manager 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

Đăng nhập vào tài khoản Ad Manager của bạn.

Chuyển đến phần Phân phối > Nhóm lợi nhuận và nhấp vào nút Nhóm lợi nhuận mới.

Nhập một Tên riêng biệt cho nhóm lợi nhuận của bạn, đặt Trạng thái thành Đang hoạt động, chọn Định dạng quảng cáo và đặt Loại khoảng không quảng cáo thành Ứng dụng dành cho thiết bị di động. Trong phần Nhắm mục tiêu > Khoảng không quảng cáo, hãy chọn đơn vị quảng cáo trong Khoảng không quảng cáo và Ứng dụng dành cho thiết bị di động mà bạn muốn thêm tính năng dàn xếp.

Tiếp theo, hãy nhấp vào nút Thêm đối tác lợi nhuận.

Nếu đã có Đối tác lợi nhuận cho nend, thì bạn có thể chọn đối tác đó. Nếu không, hãy chọn Tạo đối tác lợi nhuận mới.

Chọn nend làm Mạng quảng cáo, nhập Tên riêng biệt và bật tính năng Dàn xếp.

Bật tuỳ chọn Thu thập dữ liệu tự động rồi nhậpReporting API Key from the API Key for Scraping đã nhận được trong phần trước.

Sau khi chọn Đối tác lợi nhuận, hãy 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ậpSlot ID and API Key nhận được ở phần trước. Sau đó, hãy nhập giá trị CPM mặc định.

Nhấp vào Lưu ở cuối trang khi hoàn tất.

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

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

Trong tệp settings.gradle.kts ở cấp dự án, hãy thêm các kho lưu trữ sau:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://fan-adn.github.io/nendSDK-Android-lib/library")
    }
  }
}

Sau đó, trong tệp build.gradle.kts ở 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. Sử dụng phiên bản mới nhất của SDK Nend và bộ chuyển đổi:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:nend:10.0.0.0")
}

Tích hợp thủ công

Tải phiên bản mới nhất của SDK Android bổ sung xuống và thêm phiên bản đó vào dự án của bạn.
Di chuyển đến các cấu phần phần mềm trình chuyển đổi Nend 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 nend xuống rồi thêm tệp đó vào dự án của bạn.

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

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

Bước 6: Kiểm thử 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 Ad Manager. Để tải quảng cáo thử nghiệm cho biểu ngữ, quảng cáo xen kẽ và quảng cáo có tặng thưởng, nend khuyên bạn nên sử dụng khoá API và Mã vị trí được cung cấp trong trang đơn vị quảng cáo thử nghiệm bổ sung . Bạn có thể nhập các khoá này dưới dạng Khoá API và Mã vị trí cho đơn vị quảng cáo AdMob trong quá trình thử nghiệm. Sau đó, bạn có thể thay thế bằng Khoá API và Mã điểm thực tế khi ứng dụng của bạn đã sẵn sàng phát hành chính thức.

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ừ nend, 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 nend (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 nend hỗ trợ các tham số yêu cầu bổ sung. Các tham số này có thể được truyền đến bộ chuyển đổi bằng cách sử dụng lớp NendExtrasBundleBuilder. Lớp này bao gồm các phương thức sau:

setInterstitialType(InterstitialType): Nend cung cấp tuỳ chọn chọn TYPE_NORMAL cho quảng cáo xen kẽ thông thường hoặc TYPE_VIDEO cho quảng cáo xen kẽ dạng video. Nend mặc định sử dụng TYPE_NORMAL làm loại quảng cáo xen kẽ nếu không thêm thông số bổ sung này.
setNativeAdsType(nativeAdsType): Nend cung cấp tuỳ chọn chọn TYPE_NORMAL cho quảng cáo gốc thông thường hoặc TYPE_VIDEO cho quảng cáo gốc dạng video. Theo mặc định, Nend sẽ sử dụng TYPE_NORMAL làm loại quảng cáo gốc nếu không thêm thông số bổ sung này.

Java

Bundle bundle = new NendAdapter.NendExtrasBundleBuilder()
                        .setInterstitialType(InterstitialType.TYPE_NORMAL)
                        .setNativeAdsType(FormatType.TYPE_NORMAL)
                        .build();

AdManagerAdRequest adRequest = new AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build();

adLoader.loadAd(adRequest);

Kotlin

val bundle = NendAdapter.NendExtrasBundleBuilder()
                     .setInterstitialType(InterstitialType.TYPE_NORMAL)
                     .setNativeAdsType(FormatType.TYPE_NORMAL)
                     .build()

val adRequest = AdManagerAdRequest.Builder()
    .addNetworkExtrasBundle(NendAdapter.class, bundle)
    .build()

adLoader.loadAd(adRequest)

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

Hiển thị quảng cáo

Bộ chuyển đổi Nend sẽ trả về quảng cáo gốc dưới dạng đối tượng NativeAd . Mẫu quảng cáo này sẽ điền sẵn các trường sau đây cho NativeAd.

Trường	Do bộ chuyển đổi Nend điền sẵn
Dòng tiêu đề
Bài đăng có hình ảnh	1
Nội dung
Biểu tượng ứng dụng	2
Lời kêu gọi hành động
Tên nhà quảng cáo
Điểm xếp hạng theo sao
Cửa hàng
Giá

¹ Nend chỉ cung cấp nội dung Hình ảnh cho các vị trí gốc được định cấu hình với Lựa chọn hình ảnh quảng cáo được đặt thành Hình ảnh quảng cáo lớn theo chiều ngang (5: 3).

² Nend không cung cấp thành phần Biểu tượng cho các vị trí gốc được định cấu hình với phần Lựa chọn hình ảnh quảng cáo được đặt thành Không có hình ảnh (chỉ văn bản).

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ nend, nhà xuất 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.getAdapterResponse() trong các lớp sau:

Định dạng	Tên lớp
Biểu ngữ	com.google.ads.mediation.nend.NendAdapter
Quảng cáo xen kẽ	com.google.ads.mediation.nend.NendAdapter
Được thưởng	com.google.ads.mediation.nend.NendRewardedAdapter
Mã gốc	com.google.ads.mediation.nend.NendMediationAdapter

Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi nend gửi khi quảng cáo không tải được:

Mã lỗi	Lâu đài	Lý do
101	com.google.ads.mediation.nend	nend yêu cầu bối cảnh hoạt động để tải và hiển thị quảng cáo.
102	com.google.ads.mediation.nend	tham số máy chủ nend được định cấu hình trong giao diện người dùng Ad Manager bị thiếu/không hợp lệ.
103	com.google.ads.mediation.nend	nend quảng cáo chưa sẵn sàng để được hiển thị.
104	com.google.ads.mediation.nend	không thể phát quảng cáo.
105	com.google.ads.mediation.nend	Kích thước quảng cáo được yêu cầu không khớp với kích thước biểu ngữ được hỗ trợ.
106	com.google.ads.mediation.nend	Tham chiếu đối tượng Ngữ cảnh là `null` và/hoặc gần đây đã được giải phóng khỏi bộ nhớ.
200-299	net.nend.android	nend SDK trả về lỗi tải quảng cáo xen kẽ. Hãy xem bài viết về đoạn mã để biết thêm chi tiết.
300-399	net.nend.android	nend SDK trả về một lỗi quảng cáo hiển thị xen kẽ. Hãy xem bài viết về đoạn mã để biết thêm chi tiết.
400-499	net.nend.android	nend SDK đã trả về một lỗi quảng cáo. Hãy xem bài viết về đoạn mã để biết thêm chi tiết.
101	com.google.mediation.nend	nend SDK đã trả về một lệnh gọi lại lỗi tải mà không có thêm thông tin về lỗi.
102	com.google.mediation.nend	nend SDK trả về một lệnh gọi lại hiển thị lỗi mà không có thêm thông tin về lỗi.
103	com.google.mediation.nend	tham số máy chủ nend được định cấu hình trong giao diện người dùng Ad Manager bị thiếu/không hợp lệ.
104	com.google.mediation.nend	Không tải được thành phần hình ảnh của quảng cáo gốc.
105	com.google.mediation.nend	Không thể hiển thị quảng cáo cuối do quảng cáo chưa sẵn sàng.
106	com.google.mediation.nend	Kích thước quảng cáo biểu ngữ được yêu cầu không khớp với kích thước biểu ngữ được hỗ trợ.
200-699	Do nend SDK gửi.	nend SDK đã trả về một lỗi. Xem tài liệu của nend để biết thêm thông tin chi tiết.