این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads Unity Plugin برای بارگذاری و نمایش تبلیغات از myTarget با استفاده از میانجیگری استفاده کنید و ادغامهای آبشاری را پوشش میدهد. این راهنما نحوه اضافه کردن myTarget به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام myTarget SDK و آداپتور آن در یک برنامه Unity را پوشش میدهد.
| ادغام | |
|---|---|
| مناقصه | |
| آبشار | |
| قالبها | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
| تبلیغات بینابینی پاداشدار | |
- آخرین Google Mobile Ads Unity Plugin
- یونیتی ۲۰۱۹.۴ یا بالاتر
- برای نصب روی اندروید
- اندروید API سطح ۲۳ یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 13.0 یا بالاتر
- یک پروژه یونیتی فعال که با Google Mobile Ads Unity Plugin پیکربندی شده است. برای جزئیات بیشتر به بخش «راهاندازی Google Mobile Ads Unity Plugin مراجعه کنید.
- میانجیگری AdMob را راهاندازی کنید .
وارد حساب کاربری myTarget خود شوید . با کلیک روی APPS در بالای صفحه، به صفحه برنامهها بروید. با کلیک روی ADD APP، برنامه خود را اضافه کنید.
اگر برنامه شما از هر دو پلتفرم اندروید و iOS پشتیبانی میکند، باید هر کدام را جداگانه تنظیم کنید.
در مرحله بعد، آدرس گوگل پلی اپلیکیشن خود را وارد کنید.
در مرحله بعد، آدرس اینترنتی iTunes ** را برای برنامه خود وارد کنید.
هنگام افزودن یک برنامه، myTarget از شما میخواهد که قبل از تکمیل فرآیند، یک واحد تبلیغاتی ایجاد کنید.
از بین قالبهای تبلیغاتی موجود، BANNER را انتخاب کنید و سپس روی دکمهی ADD AD UNIT کلیک کنید.
از بین قالبهای تبلیغاتی موجود، INTERSTITIAL را انتخاب کنید و سپس روی دکمهی ADD AD UNIT کلیک کنید.
از بین قالبهای تبلیغاتی موجود، ویدیوی جایزهدار (REWARDED VIDEO) را انتخاب کنید و سپس روی دکمهی «افزودن واحد تبلیغات» (ADD AD UNIT) کلیک کنید.
از بین قالبهای تبلیغاتی موجود، NATIVE را انتخاب کنید و سپس روی ADD AD UNIT کلیک کنید.
در صفحه جزئیات واحد تبلیغاتی خود، شناسه اسلات خود را که میتوانید در تنظیمات واحد تبلیغاتی با عنوان slot_id پیدا کنید، یادداشت کنید. این شناسه اسلات برای تنظیم واحد تبلیغاتی AdMob شما در بخش بعدی استفاده خواهد شد.
علاوه بر slot_id ، برای تنظیم شناسه واحد تبلیغاتی AdMob خود به توکن دسترسی دائمی myTarget خود نیز نیاز خواهید داشت. به برگه پروفایل بروید و توکنهای دسترسی را انتخاب کنید. برای مشاهده توکن دسترسی دائمی myTarget خود، روی ایجاد توکن یا نمایش توکن کلیک کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt برای myTarget، به نحوه ایجاد و انتشار یک فایل مراجعه کنید.
برای افزودن و پیکربندی یک دستگاه آزمایشی در رابط کاربری myTarget، دستورالعملهای موجود در مستندات myTarget را دنبال کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
برای افزودن Mail.ru به فهرست شرکای تبلیغاتی با مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
اگر OpenUPM-CLI را نصب کردهاید، میتوانید افزونهی Google Mobile Ads myTarget Mediation برای Unity را با اجرای دستور زیر از دایرکتوری ریشهی پروژه، روی پروژهی خود نصب کنید:
openupm add com.google.ads.mobile.mediation.mytargetدر ویرایشگر پروژه یونیتی خود، گزینه Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.
در زیر تب Scoped Registries ، OpenUPM را به عنوان یک رجیستری Scoped با جزئیات زیر اضافه کنید:
- نام:
OpenUPM - آدرس اینترنتی:
https://package.openupm.com - محدوده(ها):
com.google
سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.
بسته Google Mobile Ads MyTarget Mediation را انتخاب کرده و روی نصب کلیک کنید.
آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای myTarget را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsMyTargetMediation.unitypackage را از فایل زیپ استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsMyTargetMediation.unitypackage را که دانلود کردهاید، پیدا کنید. مطمئن شوید که همه فایلها انتخاب شدهاند و روی Import کلیک کنید.
سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگیها را از ابتدا انجام میدهد و وابستگیهای اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی میکند.
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
افزونه میانجیگری تبلیغات موبایل گوگل برای myTarget نسخه ۲.۱.۰ شامل متدهای SetUserConsent() و SetUserAgeRestricted() است. نمونه کد زیر نحوه ارسال اطلاعات رضایت کاربر به myTarget SDK را نشان میدهد. اگر تصمیم به فراخوانی این متد دارید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads Unity Plugin ، این کار را انجام دهید.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetUserConsent(true);
اگر مشخص شده باشد که کاربر در یک دسته بندی با محدودیت سنی قرار دارد، میتوانید متد SetUserAgeRestricted() را نیز فراخوانی کنید.
MyTarget.SetUserAgeRestricted(true);
برای اطلاعات بیشتر به راهنمای حریم خصوصی و GDPR سایت myTarget مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
افزونه میانجیگری تبلیغات موبایل گوگل برای myTarget نسخه ۳.۱۳.۳ شامل متد SetCCPAUserConsent(bool) است. نمونه کد زیر نحوه ارسال اطلاعات رضایت کاربر به myTarget SDK را نشان میدهد. اگر تصمیم به فراخوانی این متد دارید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads Unity Plugin ، این کار را انجام دهید.
using GoogleMobileAds.Api.Mediation.MyTarget;
// ...
MyTarget.SetCCPAUserConsent(true);
برای اطلاعات بیشتر با پشتیبانی myTarget تماس بگیرید.
برای ادغام myTarget هیچ کد اضافی لازم نیست.
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه خود ، مستندات myTarget را دنبال کنید.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید و حالت آزمایشی را در رابط کاربری myTarget فعال کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از myTarget دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های ) تبلیغاتی myTarget (آبشاری ) فعال کنید. اگر آداپتور نتواند تبلیغی از myTarget دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده در اینجا کدها و پیامهای همراه که توسط آداپتور myTarget هنگام عدم بارگیری یک تبلیغ ارسال میشوند، آمده است: ResponseInfo تحت کلاسهای زیر بررسی کنند: com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter
GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded
کد خطا دلیل ۱۰۰ myTarget SDK خطایی را برگرداند. ۱۰۱ پارامترهای سرور myTarget که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۲ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد. ۱۰۳ درخواست تبلیغ، یک درخواست تبلیغ بومی یکپارچه نیست. ۱۰۴ تبلیغ بومی بارگذاری شده از myTarget با تبلیغ بومی درخواستی متفاوت است. ۱۰۵ تبلیغ بومی بارگذاری شده از myTarget فاقد برخی از ویژگیهای مورد نیاز (مثلاً تصویر یا آیکون) است. کد خطا دلیل ۱۰۰ هنوز تبلیغی برای myTarget SDK در دسترس نیست. ۱۰۱ پارامترهای سرور myTarget که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۲ آداپتور myTarget از قالب تبلیغ درخواستی پشتیبانی نمیکند. ۱۰۳ سعی کردم یک تبلیغ myTarget نمایش دهم که بارگیری نشد. ۱۰۴ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط myTarget مطابقت ندارد. ۱۰۵ فقدان محتوای تبلیغاتی بومی مورد نیاز. DummyClient به PlaceholderClient تغییر یافت.GoogleMobileAds/Mediation/MyTarget/ منتقل شد.GoogleMobileAds.Mediation.MyTarget بازسازی شده است.IsConsent() از کلاس MyTarget را به GetUserConsent() تغییر داد.MyTarget اضافه کردم:SetCCPAUserConsent(bool)GetCCPAUserConsent()MyTarget.IsUserConsent() را به MyTarget.IsConsent() تغییر داد.MyTarget.SetUserConsent() برای ارسال وضعیت رضایت کاربر به MyTarget SDK.MyTarget.SetUserAgeRestricted که یک پرچم (flag) تنظیم میکند تا نشان دهد که آیا کاربر در یک دسته بندی با محدودیت سنی (یعنی زیر ۱۶ سال) قرار دارد یا خیر.MyTarget.IsUserConsent() برای دریافت وضعیت رضایت فعلی کاربر.MyTarget.IsUserAgeRestricted() برای دریافت پرچمی که نشان میدهد کاربر در یک دسته بندی با محدودیت سنی (یعنی زیر ۱۶ سال) قرار دارد.