این راهنما برای ناشرانی درنظر گرفته شده است که علاقه‌مند به استفاده از میانجی‌گری «آگهی‌های تلفن همراه Google» با Zucks هستند. این راهنما مراحل راه‌اندازی یک آداپتور میانجی‌گری برای کار با برنامه Android فعلی شما و پیکربندی تنظیمات اضافی را توضیح می‌دهد.
| منابع Zucks |
|---|
| مستندات |
| SDK |
| Adapter |
| پشتیبانی مشتری |
پیش‌نیازها
برنامه Android با GMA Next-Gen SDK یکپارچه. (اگر ندارید، راه‌اندازی GMA Next-Gen SDK را ببینید.)
حساب Google Ad Manager با واسطه‌گری برای برنامه‌های تلفن همراه پیکربندی شده باشد.
افزودن Zucks به پروژه
کیت توسعه نرم‌افزار و آداپتور شبکه را اضافه کنید
«کیت توسعه نرم‌افزار» و «آداپتور Zucks» را از پیوندهای قبلی بارگیری کنید.
در Android Studio، فایل‌های کیت توسعه نرم‌افزار و آداپتور را در پوشه libs
پروژه خود قرار دهید. مطمئن شوید که فایل Gradle سطح برنامه شما شامل موارد زیر باشد:
Kotlin
dependencies {
implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.aar", "*.jar"))))
// ...
}
Groovy
dependencies {
implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'])
// ...
}
پیکربندی فایل AndroidManifest.xml
فایل AndroidManifest.xml خود را طبق دستورالعمل‌های
موجود در اسناد Zucks اصلاح کنید.
برنامه شما نیازی ندارد مستقیماً Zucks را فراخوانی کند—GMA Next-Gen SDK برای واکشی آگهی‌ها ازطرف شما، کاربر Zucks را فراخوانی می‌کند. درصورت لزوم، می‌توانید پارامترهای درخواست اضافی را مشخص کنید. بقیه این صفحه جزئیات نحوه ارائه اطلاعات بیشتر به Zucks را توضیح می‌دهد.
شیء آگهی‌تان را با نمونه «فعالیت» مقداردهی اولیه کنید
در سازنده برای یک شیء آگهی جدید (برای مثال،
AdManagerAdView)،
باید شیئی از نوع
Context را ارسال کنید.
این Context هنگام استفاده از میانجی‌گری به شبکه‌های آگهی دیگر منتقل می‌شود. برخی‌از شبکه‌های آگهی به Context محدودکننده‌تری نیاز دارند که از نوع
Activity
باشد و ممکن است بدون نمونه Activity نتوانند آگهی ارائه دهند. بنابراین،
توصیه می‌کنیم هنگام مقداردهی اولیه کردن اشیای آگهی، نمونه Activity را ارسال کنید
تا تجربه یکسانی با شبکه‌های آگهی واسطه‌ای خود داشته باشید.