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 đề cập đến 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ụng Unity.
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. Tuy nhiên, trong văn bản của hướng dẫn này, các nhãn và nút được tham chiếu đến tên 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ợ
| Tích hợp | |
|---|---|
| Đặt giá thầu | |
| Thác nước | |
| Dạng thức | |
| Biểu ngữ | |
| Quảng cáo xen kẽ | |
| Được thưởng | |
Yêu cầu
- Unity 4 trở lên
- SDK quảng cáo trên thiết bị di động của Google mới nhất
- Cách triển khai trên Android
- API Android cấp 19 trở lên
- Cách triển khai trên iOS
- Mục tiêu triển khai iOS phiên bản 12.0 trở lên
- Một dự án Unity đang hoạt động được định cấu hình bằng SDK Quảng cáo của Google trên thiết bị di động. Hãy xem phần Bắt đầu để biết thông tin chi tiế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.
Android
iOS
Ứng dụng của bạn sẽ hiển thị trên trang tổng quan sau khi được tạo.
Android
iOS
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.
Biểu 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 AdMob 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 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
Android
Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho Android.
iOS
Để biết hướng dẫn, hãy xem bước 2 trong hướng dẫn dành cho iOS.
Bước 3: Nhập nend SDK và bộ chuyển đổi
Tải phiên bản mới nhất của trình bổ trợ dàn xếp Quảng cáo của Google trên thiết bị di động xuống
từ đường liên kết tải xuống trong Nhật ký thay đổi
rồi giải nén gói GoogleMobileAdsNendMediation.unitypackage từ
tệp zip.
Trong trình chỉnh sửa dự án Unity, hãy chọn Assets > Import Package > Custom Package (Thành phần > Nhập gói > Gói tuỳ chỉnh) rồi tìm tệp GoogleMobileAdsNendMediation.unitypackage mà bạn đã tải xuống. Đảm bảo rằng bạn đã chọn tất cả các tệp rồi nhấp vào Nhập.
Sau đó, chọn Nội dung > Trình phân giải các dịch vụ của Play > Trình phân giải Android > Buộc phân giải. Thư viện Trình phân giải dịch vụ của Google Play của Unity sẽ thực hiện việc phân giải phần phụ thuộc từ đầu và sao chép các phần phụ thuộc đã khai báo vào thư mục Assets/Plugins/Android của ứng dụng Unity.
Bước 4: Thêm mã bắt buộc
Android
Bạn không cần phải thêm mã để tích hợp nend.
iOS
Tích hợp SKAdNetwork
Làm theo tài liệu của nend để thêm giá trị nhận dạng SKAdNetwork vào tệp Info.plist của dự án.
Bước 5: 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 AdMob. Để 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ạ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.
Mã lỗi
Nếu bộ chuyển đổi không nhận được quảng cáo từ nend, thì nhà xuất 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 theo các lớp sau:
Android
com.google.ads.mediation.nend.NendAdapter
com.google.ads.mediation.nend.NendRewardedAdapter
com.google.ads.mediation.nend.NendMediationAdapter
iOS
GADMAdapterNend
GADMAdapterNend
GADMAdapterNendRewarded
GADMediationAdapterNend
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:
Android
| 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 AdMob 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. |
iOS
| Mã lỗi | Lâu đài | Lý do |
|---|---|---|
| 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 AdMob 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. |
Nhật ký thay đổi trình bổ trợ dàn xếp nend Unity
Phiên bản 8.0.0
- Hỗ trợ nend Android adapter phiên bản 10.0.0.0.
- Hỗ trợ bộ chuyển đổi Nend iOS phiên bản 8.2.0.0.
- Được tạo và thử nghiệm với Trình bổ trợ Unity dành cho quảng cáo trên thiết bị di động của Google phiên bản 8.6.0.
Phiên bản 7.0.0
- Đã di chuyển nội dung trong bộ chuyển đổi sang
GoogleMobileAds/Mediation/Nend/. - Tái cấu trúc không gian tên trình chuyển đổi để sử dụng
GoogleMobileAds.Mediation.Nend. - Hỗ trợ nend Android adapter phiên bản 9.0.1.0.
- Hỗ trợ bộ chuyển đổi Nend iOS phiên bản 8.0.1.0.
- Được tạo và thử nghiệm với Trình bổ trợ Unity dành cho quảng cáo trên thiết bị di động của Google phiên bản 8.1.0.
Phiên bản 6.0.1
- Hỗ trợ nend Android adapter phiên bản 9.0.0.0.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 7.4.0.1.
- Được tạo và thử nghiệm với Trình bổ trợ Unity dành cho quảng cáo của Google trên thiết bị di động phiên bản 7.4.1.
Phiên bản 6.0.0
- Hỗ trợ nend Android adapter phiên bản 9.0.0.0.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 7.4.0.0.
- Được tạo và thử nghiệm với Trình bổ trợ Unity dành cho quảng cáo của Google trên thiết bị di động phiên bản 7.2.0.
Phiên bản 5.2.0
- Hỗ trợ nend Android adapter phiên bản 8.1.0.1.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 7.3.0.0.
- Được tạo và thử nghiệm với Trình bổ trợ Unity dành cho quảng cáo của Google trên thiết bị di động phiên bản 7.0.2.
Phiên bản 5.1.0
- Hỗ trợ nend Android adapter phiên bản 8.1.0.0.
- Hỗ trợ trình chuyển đổi Nend iOS phiên bản 7.2.0.0.
- Được tạo và thử nghiệm với Trình bổ trợ Unity dành cho quảng cáo trên thiết bị di động của Google phiên bản 7.0.0.
Phiên bản 5.0.0
Phiên bản 4.0.1
Phiên bản 4.0.0
Phiên bản 3.0.0
Phiên bản 2.3.0
Phiên bản 2.2.0
Phiên bản 2.1.0
- Cập nhật trình bổ trợ để hỗ trợ API có tặng thưởng mới.
- Hỗ trợ nend Android Adapter phiên bản 5.1.0.2.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 5.1.1.0.
Phiên bản 2.0.3
- Hỗ trợ nend Android Adapter phiên bản 5.0.2.1.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 5.0.2.0.
Phiên bản 2.0.2
- Hỗ trợ nend Android Adapter phiên bản 5.0.2.0.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 5.0.2.0.
Phiên bản 2.0.1
- Hỗ trợ nend Android Adapter phiên bản 5.0.2.0.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 5.0.1.0.
Phiên bản 2.0.0
- Hỗ trợ nend Android Adapter phiên bản 5.0.0.0.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 5.0.0.0.
Phiên bản 1.0.2
- Hỗ trợ nend Android Adapter phiên bản 4.0.5.0.
- Hỗ trợ bộ chuyển đổi nend iOS phiên bản 4.0.6.0.
Phiên bản 1.0.1
- Hỗ trợ nend Android SDK phiên bản 4.0.4.
- Hỗ trợ nend iOS SDK phiên bản 4.0.4.
Phiên bản 1.0.0
- Bản phát hành đầu tiên!
- Hỗ trợ nend Android SDK phiên bản 4.0.2.
- Hỗ trợ nend iOS SDK phiên bản 4.0.2.