Hướng dẫn này sẽ cho bạn biết cách sử dụng GMA Next-Gen SDK để tải và hiển thị quảng cáo từ Chartboost bằng tính năng dàn xếp, 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 Chartboost 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 và bộ chuyển đổi của Chartboost vào một ứng dụng Android.
Các định dạng quảng cáo và hoạt động tích hợp được hỗ trợ
Bộ chuyển đổi dàn xếp cho Chartboost 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 | |
Yêu cầu
- Android API cấp độ 24 trở lên
Mới nhất GMA Next-Gen SDK
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 Chartboost
Đăng ký tài khoản Chartboost và đăng nhập sau khi tài khoản của bạn được xác minh. Sau đó, hãy chuyển đến thẻ Quản lý ứng dụng.
Nhấp vào nút Thêm ứng dụng mới để tạo ứng dụng.
Điền vào phần còn lại của biểu mẫu rồi nhấp vào nút Thêm ứng dụng để hoàn tất ứng dụng.
Sau khi tạo ứng dụng, bạn sẽ được chuyển đến trang tổng quan của ứng dụng. Hãy ghi lại Mã ứng dụng và Chữ ký ứng dụng của ứng dụng.
Ad Manager yêu cầu Mã người dùng và Chữ ký người dùng của Chartboost để thiết lập mã đơn vị quảng cáo Ad Manager. Bạn có thể tìm thấy các tham số này bằng cách nhấp vào Dàn xếp Chartboost trên giao diện người dùng Chartboost.
Chuyển đến thẻ Tài nguyên > APIs Explorer rồi ghi lại Mã nhận dạng người dùng và Chữ ký người dùng nằm trong phần Xác thực.
Cập nhật tệp app-ads.txt
Tệp Authorized Sellers for Apps 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 Chartboost, hãy xem
app-ads.txt.
Bật chế độ thử nghiệm
Bạn có thể bật chế độ thử nghiệm trên ứng dụng bằng cách chuyển đến thẻ Quản lý ứng dụng trong giao diện người dùng Chartboost, chọn ứng dụng trong danh sách rồi nhấp vào Chỉnh sửa chế độ cài đặt ứng dụng.
Trong phần cài đặt của ứng dụng, bạn có thể bật/tắt Chế độ thử nghiệm trên ứng dụng.
Sau khi bật chế độ thử nghiệm, bạn có thể yêu cầu quảng cáo bằng mã đơn vị quảng cáo đã tạo trước đó và nhận được quảng cáo thử nghiệm của Chartboost.
Sau khi bạn có thể nhận được quảng cáo thử nghiệm của Chartboost, ứng dụng của bạn sẽ được đưa vào quy trình Xem xét ứng dụng của nhà xuất bản của Chartboost. Để tính năng kiếm tiền trên Chartboost hoạt động, Chartboost cần phê duyệt quy trình xem xét ứng dụng của nhà xuất bản.
Bước 2: Thiết lập nhu cầu về Chartboost trong giao diện người dùng Ad Manager
Định cấu hình chế độ cài đặt dàn xếp cho đơn vị quảng cáo
Đăng nhập vào tài khoản Ad Manager.
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.
Nhập Tên duy nhất cho nhóm lợi nhuậ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 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 mục Khoảng không quảng cáo và Ứng dụng 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 Chartboost, 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 Chartboost làm Mạng quảng cáo, nhập Tên duy nhất và bật Dàn xếp.
Bật Tính năng thu thập dữ liệu tự động rồi nhập Mã người dùng và Chữ ký người dùng đã lấy đượ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ập Mã ứng dụng, Chữ ký ứng dụng và Vị trí quảng cáo đã lấy được trong phần trước. Sau đó, hãy nhập giá trị CPM mặc định.
Vị trí quảng cáo Chartboost (Vị trí được đặt tên) là những tên đơn giản đại diện cho một vị trí trong ứng dụng mà bạn muốn hiển thị quảng cáo. Ad Manager gửi yêu cầu đến vị trí được chỉ định trong phần cài đặt. Sau khi gửi yêu cầu, Chartboost sẽ thêm vị trí đó vào giao diện người dùng của mình cho mục đích báo cáo.
Trong giao diện người dùng Chartboost, Vị trí quảng cáo có thể được hiển thị trên trang Cài đặt cơ bản bằng cách nhấp vào Cài đặt nâng cao. Hãy xem hướng dẫn về Vị trí được đặt tên của Chartboost để biết thêm thông tin chi tiết.
Nhấp vào Lưu ở cuối trang khi hoàn tất.
Thêm Chartboost vào danh sách đối tác quảng cáo theo GDPR và quy định của các bang tại Hoa Kỳ
Hãy làm theo các bước trong Chế độ cài đặt theo quy định của Châu Âu và Chế độ cài đặt theo quy định của các bang tại Hoa Kỳ để thêm Chartboost vào danh sách đối tác quảng cáo theo quy định của Châu Âu và các bang tại Hoa Kỳ trong giao diện người dùng Ad Manager.
Bước 3: Nhập SDK và bộ chuyển đổi của Chartboost
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://cboost.jfrog.io/artifactory/chartboost-ads/")
}
}
}
Trong tệp gradle ở 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:
Kotlin
dependencies { implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01") implementation("com.google.ads.mediation:chartboost:9.11.1.1") } configurations.configureEach { exclude(group = "com.google.android.gms", module = "play-services-ads") exclude(group = "com.google.android.gms", module = "play-services-ads-lite") }
Groovy
dependencies { implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01' implementation 'com.google.ads.mediation:chartboost:9.11.1.1' } configurations.configureEach { exclude group: 'com.google.android.gms', module: 'play-services-ads' exclude group: 'com.google.android.gms', module: 'play-services-ads-lite' }
Tích hợp thủ công
Tải tệp
.aarcủa phiên bản SDK Chartboost mới nhất xuống từ Maven Central rồi thêm tệp đó vào dự án.Chuyển đến các cấu phần phần mềm bộ chuyển đổi Chartboost trên Kho lưu trữ Maven của Google. Chọn phiên bản mới nhất, tải tệp
.aarcủa bộ chuyển đổi Chartboost xuống rồi thêm tệp đó vào dự án.
Bước 4: Triển khai chế độ cài đặt quyền riêng tư trên SDK Chartboost
Sự đồng ý của người dùng ở Liên minh Châu Âu và GDPR
Để tuân thủ Chính sách về sự đồng ý của người dùng ở Liên minh Châu Âu của Google, bạn phải công bố một số thông tin nhất định cho người dùng ở Khu vực kinh tế Châu Âu (EEA), Vương quốc Anh và Thuỵ Sĩ, đồng thời phải được họ đồng ý cho sử dụng cookie hoặc bộ nhớ cục bộ khác khi pháp luật yêu cầu, cũng như đối với việc thu thập, chia sẻ và sử dụng dữ liệu cá nhân để cá nhân hoá quảng cáo. Chính sách này thể hiện các yêu cầu của Chỉ thị về quyền riêng tư và truyền thông điện tử của Liên minh Châu Âu và Quy định chung về việc bảo vệ dữ liệu (GDPR). Bạn chịu trách nhiệm xác minh rằng sự đồng ý được truyền đến từng nguồn quảng cáo trong chuỗi dàn xếp của bạn. Google không thể tự động chuyển lựa chọn về sự đồng ý của người dùng cho các mạng như vậy.
Trong SDK phiên bản 8.1.0, Chartboost đã thêm phương thức addDataUseConsent(). Đoạn mã mẫu sau đây đặt sự đồng ý về việc sử dụng dữ liệu thành NON_BEHAVIORAL. Nếu chọn
gọi phương thức này, bạn nên thực hiện trước khi yêu cầu quảng cáo
thông qua GMA Next-Gen SDK.
Java
DataUseConsent dataUseConsent = new GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = GDPR(GDPR.GDPR_CONSENT.NON_BEHAVIORAL)
Chartboost.addDataUseConsent(context, dataUseConsent)
Hãy xem bài viết của Chartboost về GDPR và Phương thức quyền riêng tư trên Android để biết thêm thông tin chi tiết và các giá trị có thể được cung cấp trong từng phương thức.
luật về quyền riêng tư của các tiểu bang ở Hoa Kỳ
Luật về quyền riêng tư của các bang tại Hoa Kỳ yêu cầu bạn phải cung cấp cho người dùng quyền từ chối việc "bán" "thông tin cá nhân" của họ (theo định nghĩa của các thuật ngữ này trong luật), trong đó quyền từ chối được cung cấp thông qua một đường liên kết nổi bật "Không bán thông tin cá nhân của tôi" trên trang chủ của bên "bán". Hướng dẫn tuân thủ luật về quyền riêng tư của các bang tại Hoa Kỳ cho phép bạn bật chế độ xử lý dữ liệu bị hạn chế cho hoạt động phân phát quảng cáo của Google, nhưng Google không thể áp dụng chế độ cài đặt này cho từng mạng quảng cáo trong chuỗi dàn xếp của bạn. Do đó, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể tham gia vào việc bán thông tin cá nhân và làm theo hướng dẫn của từng mạng đó để đảm bảo tuân thủ quy định.
Trong SDK phiên bản 8.1.0, Chartboost đã thêm phương thức addDataUseConsent(). Đoạn mã mẫu sau đây đặt sự đồng ý về việc sử dụng dữ liệu thành OPT_IN_SALE. Nếu chọn gọi phương thức này, bạn nên thực hiện trước khi yêu cầu quảng cáo thông qua GMA Next-Gen SDK.
Java
DataUseConsent dataUseConsent = new CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE);
Chartboost.addDataUseConsent(context, dataUseConsent);
Kotlin
val dataUseConsent = CCPA(CCPA.CCPA_CONSENT.OPT_IN_SALE)
Chartboost.addDataUseConsent(context, dataUseConsent)
Hãy xem bài viết của Chartboost về CCPA và Phương thức quyền riêng tư trên Android để biết thêm thông tin chi tiết và các giá trị có thể được cung cấp trong từng phương thức.
Bước 5: Thêm mã bắt buộc
Cập nhật các thay đổi về cấu hình Hoạt động
Thêm thuộc tính sau vào mỗi hoạt động trong tệp AndroidManifest.xml hiển thị quảng cáo Chartboost và hỗ trợ nhiều hướng:
android:configChanges="keyboardHidden|orientation|screenSize"
Bước 6: 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 và bật chế độ thử nghiệm trong giao diện người dùng Chartboost.
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ừ Chartboost, 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ác) nguồn quảng cáo Chartboost(Thác nước).
Các bước không bắt buộc
Quyền
Để đạt được hiệu quả tối ưu, Chartboost khuyên bạn nên thêm các quyền không bắt buộc sau vào tệp AndroidManifest.xml của ứng dụng:
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
Mã lỗi
Nếu bộ chuyển đổi không nhận được quảng cáo từ Chartboost, bạn có thể kiểm tra lỗi cơ bản trong lượt phản hồi quảng cáo bằng ResponseInfo.getAdSourceResponses() trong các lớp sau:
com.google.ads.mediation.chartboost.ChartboostAdapter
com.google.ads.mediation.chartboost.ChartboostMediationAdapter
Dưới đây là các mã và thông báo đi kèm do bộ chuyển đổi Chartboost gửi khi quảng cáo không tải được:
| Mã lỗi | Lý do |
|---|---|
| 0-99 | SDK Chartboost đã trả về một lỗi. Hãy xem tài liệu của Chartboost để biết thêm thông tin chi tiết. |
| 101 | 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 Chartboost hỗ trợ. |
| 102 | Chartboost chỉ có thể tải 1 quảng cáo cho mỗi vị trí tại một thời điểm. |
| 103 | Các thông số máy chủ Chartboost đượ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 | Quảng cáo xen kẽ hoặc quảng cáo có tặng thưởng của Chartboost chưa sẵn sàng để hiển thị. |