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

Tích hợp AdColony với tính năng 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ừ AdColony bằng cách sử dụng tính năng dàn xếp, bao gồm cả chế độ tích hợp thác nước và đặt giá thầu. Bài viết này trình bày cách thêm AdColony 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 AdColony vào một ứng dụng Android .

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 của AdColony 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

[Dành cho tính năng đặt giá thầu]: Bộ chuyển đổi AdColony 3.3.10.1 trở lên (nên dùng phiên bản mới nhất)

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 giao diện người dùng AdColony

Đăng ký và đăng nhập vào tài khoản AdColony của bạn. Thêm ứng dụng của bạn vào trang tổng quan dành cho nhà xuất bản AdColony bằng cách nhấp vào nút Thiết lập ứng dụng mới.

Thiết lập ứng dụng mới AdColony

Điền vào biểu mẫu và nhấp vào Create (Tạo) ở cuối trang để thêm ứng dụng vào AdColony.

Ứng dụng tạo AdColony

Sau khi tạo ứng dụng, bạn có thể lấy Mã ứng dụng bằng cách chuyển đến phần Kiếm tiền > Ứng dụng trong phần Thông tin cơ bản về ứng dụng của ứng dụng.

Mã ứng dụng AdColony

Tiếp theo, hãy tạo một Vùng quảng cáo mới bằng cách nhấp vào nút Thiết lập vùng quảng cáo mới trong mục Vùng quảng cáo trên trang Ứng dụng của bạn. Bạn nên tạo một Vùng quảng cáo mới cho hoạt động dàn xếp thông qua Ad Manager ngay cả khi bạn đã có vùng quảng cáo.

Vùng thiết lập AdColony

Để được hướng dẫn thêm về cách tạo vị trí đặt quảng cáo, hãy chọn thẻ tương ứng với định dạng quảng cáo mà bạn muốn.

Đặt chế độ Zone đang hoạt động? thành Yes (Có).
Nhập Tên cho Vùng quảng cáo.
Chọn Biểu ngữ làm Kích thước vùng quảng cáo.
Nhập một giá trị cho Giới hạn phát hằng ngày.

Quảng cáo xen kẽ

Đặt chế độ Zone đang hoạt động? thành Yes (Có).
Nhập Tên cho Vùng quảng cáo.
Chọn Đầu video/Quảng cáo xen kẽ làm Loại khu vực.
Nhập một giá trị cho Giới hạn phát hằng ngày.

Được thưởng

Đặt chế độ Zone đang hoạt động? thành Yes (Có).
Nhập Tên cho Vùng quảng cáo.
Chọn Value Exchange/V4VC làm Loại vùng.
Đặt Chỉ phía máy khách? thành Có rồi nhập Tên đơn vị tiền tệ ảo, Số video tối đa hằng ngày trên mỗi người dùng và Số tiền phần thưởng.

Lưu ý: Bộ chuyển đổi sẽ chuyển tiếp giá trị phần thưởng chỉ định ở đây, trừ phi giá trị phần thưởng bị ghi đè trên giao diện người dùng Ad Manager.
Nhập một giá trị cho Giới hạn phát hằng ngày.

Nhấp vào nút Tạo khi đã hoàn tất để tạo Vùng quảng cáo.

Sau khi tạo Vùng quảng cáo, bạn có thể tìm Mã vùng trong mục Tích hợp của Vùng quảng cáo. Mã vùng sẽ được sử dụng trong bước tiếp theo.

Mã vùng AdColony

Xác định vị trí Khoá API AdColony

Đặt giá thầu

Bạn không bắt buộc phải thực hiện bước này để tích hợp tính năng đặt giá thầu.

Thác nước

Bạn sẽ cần Khoá API của AdColony để thiết lập Ad Manager mã đơn vị quảng cáo. Chuyển đến phần Cài đặt tài khoản trong trang tổng quan của nhà xuất bản AdColony để tìm Khoá API của bạn.

Chế độ cài đặt AdColony

Bật chế độ thử nghiệm

Để bật quảng cáo thử nghiệm trên AdColony, hãy chuyển đến trang tổng quan của AdColony rồi chuyển đến phần Kiếm tiền > Ứng dụng. Chọn Vùng mà bạn muốn bật quảng cáo thử nghiệm trong mục Vùng quảng cáo của ứng dụng. Bạn có thể bật quảng cáo thử nghiệm bằng cách chọn Có để Chỉ hiển thị quảng cáo thử nghiệm? trong phần Phát triển.

Kiểm thử AdColony

Bước 2: Thiết lập nhu cầu AdColony trong Ad Manager giao diện người dùng

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

Thêm AdColony trong Công ty

Đặt giá thầu

Bạn không bắt buộc phải thực hiện bước này để tích hợp tính năng đặt giá thầu.

Thác nước

Chuyển đến mục Quản trị > Công ty, sau đó nhấp vào nút Công ty mới trong thẻ Tất cả công ty. Chọn Mạng quảng cáo.

Chọn AdColony làm Mạng quảng cáo, nhập một Tên riêng biệt và bật tính năng Dàn xếp. Bật tính năng Thu thập dữ liệu tự động rồi nhập API Key đã nhận được trong phần trước.

Bạn không cần nhập Tên người dùng hoặc Mật khẩu. Nhấp vào Lưu khi hoàn tất.

Bật tính năng chia sẻ tín hiệu an toàn

Đặt giá thầu

Di chuyển đến mục Quản trị > Cài đặt chung. Chuyển đến thẻ Cài đặt tài khoản Ad Exchange, xem lại và bật tuỳ chọn Chia sẻ tín hiệu an toàn. Nhấp vào Save (Lưu).

Thác nước

Bạn không bắt buộc phải thực hiện bước này để tích hợp kiểu thác nước.

Định cấu hình AdColony đặt giá thầu

Đặt giá thầu

Chuyển đến phần Phân phối > Bên đặt giá thầu rồi nhấp vào Bên đặt giá thầu mới trong thẻ Đặt giá thầu qua SDK.

Chọn AdColony làm bên đặt giá thầu.

Bật tuỳ chọn Thêm thư viện tín hiệu của bên đặt giá thầu này vào danh sách các tín hiệu được phép và Cho phép chia sẻ tín hiệu với bên đặt giá thầu này. Sau đó, hãy nhấp vào Tiếp tục.

Nhấp vào Tiếp tục.

Nhấp vào Xong.

Thác nước

Bạn không bắt buộc phải thực hiện bước này để tích hợp kiểu thác nước.

Định cấu hình liên kết đơn vị quảng cáo

Đặt giá thầu

Chuyển đến phần Phân phối > Bên đặt giá thầu rồi chọn công tyAdColony trong thẻ Đặt giá thầu qua SDK.

Chuyển đến thẻ Liên kết đơn vị quảng cáo, rồi nhấp vào Liên kết đơn vị quảng cáo mới.

Chọn Đơn vị quảng cáo cụ thể. Chọn một đơn vị quảng cáo và định dạng, Ứng dụng dành cho thiết bị di động làm Loại khoảng không quảng cáo và Ứng dụng dành cho thiết bị di động của bạn. Sau đó, hãy nhậpApp ID and Zone ID đã nhận được ở phần trước. Cuối cùng, hãy nhấp vào Lưu.

Thác nước

Chuyển đến phần 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. Chọn Ứng dụng dành cho thiết bị di động.

Di chuyển xuống rồi nhấp vào mục Thêm đối tác lợi nhuận.

Chọn công ty bạn đã tạo cho AdColony trong phần trước. 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 App ID and Zone ID đã nhận được trong phần trước và giá trị CPM mặc định. Nhấp vào Save (Lưu).

Lưu ý: Tính năng thu thập dữ liệu tự động sẽ mất vài ngày để thu thập dữ liệu trước khi có thể tính toán chính xác giá trị CPM động cho mạng dàn xếp. Sau khi có thể tính eCPM, hệ thống sẽ tự động cập nhật giá trị này thay cho bạn.

Thêm AdColony vào danh sách đối tác quảng cáo theo quy định của các tiểu bang ở Hoa Kỳ theo Quy định chung về việc bảo vệ dữ liệu (GDPR) và

Hãy làm theo các bước trong cài đặt GDPR và cài đặt quy định của chính phủ Hoa Kỳ để thêm AdColony vào GDPR và danh sách đối tác quảng cáo theo quy định của tiểu bang Hoa Kỳ trong Ad Manager giao diện người dùng.

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

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

Di chuyển dự án sang AndroidX

SDK AdColony phụ thuộc vào các thư viện hỗ trợ Android nhưng SDK quảng cáo trên thiết bị di động của Google mới nhất lại sử dụng các thư viện Jetpack.

Để đảm bảo SDK AdColony và SDK quảng cáo của Google trên thiết bị di động tương thích, hãy tạo tệp gradle.properties ở cấp cao nhất của dự án và thêm đoạn mã sau:

android.useAndroidX=true
android.enableJetifier=true

Thao tác này sẽ ghi lại tệp nhị phân SDK AdColony để sử dụng các thư viện Jetpack. Xem hướng dẫn di chuyển AndroidX để biết thêm thông tin về các chế độ cài đặt này.

Tích hợp thủ công

Tải SDK Android AdColony xuống rồi trích xuất adcolony.jar trong thư mục Library rồi thêm tệp đó vào dự án của bạn.
SDK AdColony phụ thuộc vào Thư viện hỗ trợ chú thích. Xem bài viết Cải thiện việc kiểm tra mã bằng chú thích để biết thông tin chi tiết về cách thêm Thư viện hỗ trợ chú giải vào dự án của bạn.
Chuyển đến các cấu phần phần mềm bộ chuyển đổi AdColony 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 AdColony xuống rồi thêm tệp đó vào dự án của bạn.

Bước 4: Triển khai các chế độ cài đặt quyền riêng tư trên SDK AdColony

Sự đồng ý ở Liên minh Châu Âu và GDPR

Theo 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 đảm bảo rằng bạn đã công bố một số thông tin nhất định và nhận được sự đồng ý của người dùng trong Khu vực kinh tế Châu Âu (EEA) liên quan đến việc sử dụng giá trị nhận dạng thiết bị và dữ liệu cá nhân. 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). Khi yêu cầu sự đồng ý, bạn phải xác định từng mạng quảng cáo trong chuỗi dàn xếp có thể thu thập, nhận hoặc sử dụng dữ liệu cá nhân, đồng thời cung cấp thông tin về cách sử dụng từng mạng. Hiện tại, Google không thể tự động chuyển lựa chọn đồng ý của người dùng đến các mạng như vậy.

Bộ chuyển đổi AdColony cung cấp phương thức AdColonyMediationAdapter.getAppOptions() để tuỳ chỉnh các tham số sẽ gửi đến SDK của AdColony. Có 2 phương thức liên quan đến GDPR đối với các tuỳ chọn này là setPrivacyFrameworkRequired() và setPrivacyConsentString(). Mã mẫu sau đây minh hoạ cách truyền thông tin về sự đồng ý đến bộ chuyển đổi AdColony. Sau đó, bộ chuyển đổi này được dùng trong phương thức khởi chạy của AdColony. Bạn phải đặt các tuỳ chọn này trước khi khởi động SDK Quảng cáo của Google trên thiết bị di động để đảm bảo chúng được chuyển tiếp đúng cách đến SDK của AdColony.

Java

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1");

Kotlin

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.GDPR, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.GDPR, "1")

Hãy xem thông tin chi tiết về việc triển khai GDPR của AdColony để biết thêm thông tin chi tiết về những giá trị có thể được cung cấp trong các phương thức này.

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 tiểu bang ở Hoa Kỳ yêu cầu cung cấp cho người dùng quyền từ chối "bán" "thông tin cá nhân" (theo định nghĩa của các thuật ngữ này trong luật) bằng cách cung cấp lựa chọn từ chối 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 tiểu bang ở Hoa Kỳ cho phép bạn bật chế độ xử lý dữ liệu bị hạn chế để 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 hoạt động 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ủ.

Bộ chuyển đổi AdColony cung cấp phương thức AdColonyMediationAdapter.getAppOptions() để tuỳ chỉnh các tham số sẽ gửi đến SDK của AdColony. Có 2 phương thức có liên quan đến CCPA đối với các lựa chọn này là setPrivacyFrameworkRequired() và setPrivacyConsentString(). Mã mẫu sau đây minh hoạ cách truyền thông tin về sự đồng ý đến bộ chuyển đổi AdColony. Sau đó, bộ chuyển đổi này được dùng trong phương thức khởi chạy của AdColony. Bạn phải đặt các tuỳ chọn này trước khi khởi động SDK Quảng cáo của Google trên thiết bị di động để đảm bảo chúng được chuyển tiếp đúng cách đến SDK của AdColony.

Java

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter;
//...

AdColonyAppOptions appOptions = AdColonyMediationAdapter.getAppOptions();
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true);
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1");

Kotlin

import com.google.ads.mediation.adcolony.AdColonyMediationAdapter
//...

val appOptions = AdColonyMediationAdapter.getAppOptions()
appOptions.setPrivacyFrameworkRequired(AdColonyAppOptions.CCPA, true)
appOptions.setPrivacyConsentString(AdColonyAppOptions.CCPA, "1")

Hãy xem thông tin chi tiết về việc triển khai CCPA của AdColony để biết thêm thông tin chi tiết về những giá trị có thể được cung cấp trong các phương pháp này.

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 AdColony.

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 và bật chế độ thử nghiệm trong AdColony giao diện người 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ừ AdColony, 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 AdColony (Bidding) and AdColony (Waterfall) (các) nguồn quảng cáo.

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

Quyền

Để có hiệu suất tối ưu, AdColony khuyên bạn nên thêm các quyền không bắt buộc sau đây vào tệp AndroidManifest.xml của ứng dụng:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

Sử dụng quảng cáo xen kẽ và quảng cáo có tặng thưởng

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

Bộ chuyển đổi AdColony hỗ trợ các tham số yêu cầu bổ sung có thể được truyền đến bộ chuyển đổi bằng cách sử dụng lớp AdColonyBundleBuilder. AdColonyBundleBuilder bao gồm các phương thức sau:

setShowPrePopup(boolean): Đặt xem có hiển thị cửa sổ bật lên trước khi hiển thị quảng cáo hay không. Đặt thành false để không có cửa sổ bật lên trước khi quảng cáo hiển thị.
setShowPostPopup(boolean): Đặt xem có hiển thị cửa sổ bật lên sau khi hiển thị quảng cáo hay không. Đặt thành false để không có cửa sổ bật lên sau khi quảng cáo hiển thị.

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

Java

AdColonyBundleBuilder.setShowPrePopup(true);
AdColonyBundleBuilder.setShowPostPopup(true);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter.class, AdColonyBundleBuilder.build())
  .build();
rewardedInterstitialAd.loadAd(request);

Kotlin

AdColonyBundleBuilder.setShowPrePopup(true)
AdColonyBundleBuilder.setShowPostPopup(true)

val request = AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdColonyAdapter::class.java, AdColonyBundleBuilder.build())
  .build()
rewardedInterstitialAd.loadAd(request)

Xác minh phiên bản SDK và bộ chuyển đổi

Để ghi nhật ký phiên bản bộ chuyển đổi và SDK, hãy sử dụng đoạn mã sau:

AdColonyMediationAdapter adapter = new AdColonyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
    "Adapter version: %d.%d.%03d",
    adapterVersion.getMajorVersion(),
    adapterVersion.getMinorVersion(),
    adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
    "SDK version: %d.%d.%d",
    sdkVersion.getMajorVersion(),
    sdkVersion.getMinorVersion(),
    sdkVersion.getMicroVersion()));

Mã lỗi

Nếu bộ chuyển đổi không nhận được quảng cáo từ AdColony, thì 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:

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

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

Mã lỗi	Lý do
100	SDK AdColony đã trả về một lỗi.
101	Thông số máy chủ không hợp lệ (ví dụ: thiếu mã vùng).
102	Đã yêu cầu một quảng cáo cho cùng một mã vùng.
103	SDK AdColony đã trả về lỗi khởi động.
104	Kích thước biểu ngữ đã yêu cầu không tương ứng với kích thước quảng cáo AdColony hợp lệ.
105	Lỗi trình bày do không tải quảng cáo.
106	Ngữ cảnh dùng để khởi chạy SDK AdColony không phải là thực thể `Activity`.
0 – 3	SDK AdColony đã trả về một lỗi. Hãy xem tài liệu để biết thêm thông tin chi tiết.
101	Thông số máy chủ không hợp lệ (ví dụ: thiếu mã vùng).
102	Bộ điều khiển chế độ xem gốc trình bày quảng cáo là `nil`.
103	SDK AdColony đã trả về lỗi khởi động.
104	SDK AdColony không hỗ trợ việc định cấu hình 2 lần trong khoảng thời gian 5 giây.
105	Không hiển thị được quảng cáo.
106	Vùng được dùng cho quảng cáo có tặng thưởng không phải là vùng có tặng thưởng trên cổng thông tin AdColony.

Nhật ký thay đổi bộ chuyển đổi dàn xếp Android của AdColony