Tích hợp Zucks với tính năng dàn xếp
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài liệu hướng dẫn này dành cho những nhà xuất bản muốn sử dụng tính năng dàn xếp của Quảng cáo trên thiết bị di động của Google với Zucks. Tài liệu này hướng dẫn cách thiết lập một bộ chuyển đổi dàn xếp để hoạt động với ứng dụng Android hiện tại của bạn và cách định cấu hình các chế độ cài đặt bổ sung.
Điều kiện tiên quyết
Thông tin cơ bản hữu ích
Các bài viết sau đây trên Trung tâm trợ giúp cung cấp thông tin cơ bản về hoạt động dàn xếp:
Thêm Zucks vào dự án của bạn
Bao gồm bộ chuyển đổi mạng và SDK
Tải SDK và bộ chuyển đổi Zucks xuống từ các đường liên kết trước đó.
Trong Android Studio, hãy thêm tệp bộ chuyển đổi và SDK vào thư mục libs
của dự án. Đảm bảo rằng tệp Gradle cấp ứng dụng của bạn có chứa nội dung sau:
Kotlin
dependencies {
implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar", "*.jar"))))
// ...
}
Groovy
dependencies {
implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'])
// ...
}
Sửa đổi tệp AndroidManifest.xml
theo hướng dẫn trong tài liệu Zucks.
Ứng dụng của bạn không cần gọi Zucks trực tiếp – SDK quảng cáo trên thiết bị di động của Google sẽ gọi bộ chuyển đổi Zucks để tìm nạp quảng cáo thay cho bạn. Nếu cần, bạn có thể chỉ định mọi tham số yêu cầu bổ sung.
Phần còn lại của trang này trình bày chi tiết cách cung cấp thêm thông tin cho Zucks.
Khởi chạy đối tượng quảng cáo thông qua một phiên bản Activity
Trong hàm dựng cho một đối tượng quảng cáo mới (ví dụ: AdView
), bạn phải truyền vào một đối tượng thuộc loại Context
.
Hệ thống sẽ chuyển Context
này sang các mạng quảng cáo khác khi bạn sử dụng tính năng dàn xếp. Một số mạng quảng cáo yêu cầu Context
hạn chế hơn thuộc loại Activity
và không thể phân phát quảng cáo nếu không có phiên bản Activity
. Do đó, bạn nên chuyển vào một thực thể Activity
khi khởi chạy các đối tượng quảng cáo để đảm bảo trải nghiệm nhất quán với các mạng quảng cáo được dàn xếp.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-09-02 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-09-02 UTC."],[[["\u003cp\u003eThe Mediation Test Suite allows you to test whether your mediation setup is configured correctly before going live to ensure ad requests and revenue are flowing as expected.\u003c/p\u003e\n"],["\u003cp\u003eBy integrating the Mediation Test Suite into your app, you gain access to detailed, real-time insights into the ad mediation waterfall to troubleshoot setup problems quickly.\u003c/p\u003e\n"],["\u003cp\u003eThe suite offers comprehensive functionalities such as manual ad requests for testing specific scenarios, a visual ad request waterfall, and adapter status reports to monitor adapter configuration.\u003c/p\u003e\n"],["\u003cp\u003eIt enables you to manage and organize multiple ad units and ad sources within the test suite, including line item details and other properties for each ad source.\u003c/p\u003e\n"],["\u003cp\u003eThis ensures a seamless and optimized ad mediation experience, leading to higher fill rates, increased ad revenue, and improved app performance.\u003c/p\u003e\n"]]],["Publishers using Google Mobile Ads mediation with Zucks should integrate the Zucks SDK and adapter into their Android app via Android Studio's `libs` folder and update their app-level Gradle file. They must also configure the `AndroidManifest.xml` according to Zucks' documentation. An `Activity` instance should be passed when initializing ad objects for mediated ad networks. The Google Mobile Ads SDK handles fetching ads via the Zucks adapter, without direct calls from the app.\n"],null,["This guide is intended for publishers who are interested in using Google\nMobile Ads mediation with **Zucks**. It walks\nthrough the setup of a mediation adapter to work with your current Android app\nand the configuration of additional settings.\n\n| Zucks Resources |\n|---------------------------------------------------------------------------------|\n| [Documentation](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [SDK](http://ms.zucksadnetwork.com/media/sdk/manual/android/) |\n| [Adapter](http://ms.zucksadnetwork.com/media/sdk/manual/admob-mediation/) |\n| [Customer support](mailto:support@zucksadnetwork.com) |\n\nPrerequisites\n\n- An Android app with Google Mobile Ads SDK integrated. (If you don't\n have one, see [Get Started](/admob/android/quick-start).)\n\n- An AdMob account and [an ad unit configured with mediation line\n items](//support.google.com/admob/answer/3124703).\n\nHelpful primers\n\nThe following Help Center articles provide background information on mediation:\n\n- [About AdMob Mediation](//support.google.com/admob/answer/3063564)\n- [Set up AdMob Mediation](//support.google.com/admob/answer/3124703)\n- [Optimize AdMob Network](//support.google.com/admob/answer/3534471)\n\nAdd Zucks to your project\n\nInclude network adapter and SDK\n\nDownload the Zucks SDK and adapter from the\n[previous links](#resources).\n\nIn Android Studio, include the adapter and SDK files in your project's `libs`\nfolder. Make sure that your app-level Gradle file includes the following: \n\nKotlin \n\n dependencies {\n implementation(fileTree(mapOf(\"dir\" to \"libs\", \"include\" to listOf(\"\\*.aar\", \"\\*.jar\"))))\n // ...\n }\n\nGroovy \n\n dependencies {\n implementation fileTree(dir: 'libs', include: \\['\\*.aar', '\\*.jar'\\])\n // ...\n }\n\nConfigure the AndroidManifest.xml file\n\nModify your `AndroidManifest.xml` file as instructed in the\nZucks documentation.\n\nYour app doesn't need to call Zucks\ndirectly---Google Mobile Ads SDK calls the\nZucks adapter to fetch ads on your behalf. If necessary, you can\nspecify any additional request parameters.\nThe rest of this page details how to provide more information to\nZucks.\n\nInitialize your ad object with an Activity instance\n\nIn the constructor for a new ad object (for example,\n\n[`AdView`](/admob/android/reference/com/google/android/gms/ads/AdView)),\n\nyou must pass in an object of type\n[`Context`](//developer.android.com/reference/android/content/Context).\nThis `Context` is passed on to other ad networks when using mediation. Some\nad networks require a more restrictive `Context` that is of type\n[`Activity`](//developer.android.com/reference/android/app/Activity)\nand may not be able to serve ads without an `Activity` instance. Therefore,\nwe recommend passing in an `Activity` instance when initializing ad objects\nto ensure a consistent experience with your mediated ad networks."]]