این راهنما به شما نشان میدهد که چگونه از Google Mobile Ads Unity Plugin برای بارگذاری و نمایش تبلیغات از DT Exchange با استفاده از میانجیگری استفاده کنید، و ادغامهای آبشاری را پوشش میدهد. این راهنما نحوه اضافه کردن DT Exchange به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام DT SDK و آداپتور را در یک برنامه Unity پوشش میدهد.
آداپتور میانجیگری Unity برای DT Exchange دارای قابلیتهای زیر است:
| ادغام | |
|---|---|
| مناقصه | ۱ |
| آبشار | |
| قالبها | |
| بنر | |
| بینابینی | |
| پاداش داده شده | |
۱- ادغام پیشنهاد قیمت در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
- آخرین Google Mobile Ads Unity Plugin
- یونیتی ۴ یا بالاتر
- [برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از افزونهی میانجیگری تبلیغات موبایلی گوگل برای DT Exchange 3.3.12 یا بالاتر استفاده کنید ( آخرین نسخه توصیه میشود )
- برای نصب روی اندروید
- اندروید API سطح ۲۳ یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 13.0 یا بالاتر
- یک پروژه یونیتی فعال که با Google Mobile Ads Unity Plugin پیکربندی شده است. برای جزئیات بیشتر به بخش «راهاندازی Google Mobile Ads Unity Plugin مراجعه کنید.
- میانجیگری AdMob را راهاندازی کنید .
در کنسول DT Exchange ثبت نام کنید یا وارد شوید .
روی افزودن برنامه کلیک کنید.
پلتفرم و جایگاههای خود را انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد برنامه کلیک کنید.
نامها را وارد کنید و انواع جایگاههای خود را انتخاب کنید. سپس، روی ذخیره جایگاه کلیک کنید.
برای باز کردن نوار ناوبری سمت چپ، نشانگر ماوس را روی آن نگه دارید، سپس روی مدیریت برنامه کلیک کنید.
در صفحه مدیریت برنامه ، شناسه برنامه را در کنار برنامه خود یادداشت کنید.
برنامه خود را انتخاب کنید و به برگه Placements بروید. شناسه Placement را یادداشت کنید.
از منوی سمت چپ روی نام کاربری خود کلیک کنید و گزینه پروفایل کاربری را انتخاب کنید.
شناسه ناشر ، کلید مصرفکننده و راز مصرفکننده را یادداشت کنید زیرا در مرحله بعدی به آنها نیاز خواهید داشت.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل app-ads.txt برای برنامه خود تنظیم کنید .
برای پیادهسازی app-ads.txt برای DT Exchange، DT را به فایل app-ads.txt خود اضافه کنید .
برای دستورالعملها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.
برای دستورالعملها، به مرحله ۲ در راهنمای iOS مراجعه کنید.
برای اضافه کردن DT Exchange (Fyber Monetization) به فهرست شرکای تبلیغاتی مطابق با مقررات اروپا و ایالتهای آمریکا در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.
اگر OpenUPM-CLI را نصب کردهاید، میتوانید افزونهی Google Mobile Ads DT Exchange Mediation را برای Unity با اجرای دستور زیر از دایرکتوری ریشهی پروژهتان، روی پروژهتان نصب کنید:
openupm add com.google.ads.mobile.mediation.dtexchangeدر ویرایشگر پروژه یونیتی خود، گزینه 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 DTExchange Mediation را انتخاب کرده و روی نصب کلیک کنید.
آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای DT Exchange را از لینک دانلود موجود در Changelog دانلود کنید و بسته GoogleMobileAdsDTExchangeMediation.unitypackage را از فایل زیپ استخراج کنید.
در ویرایشگر پروژه Unity خود، Assets > Import Package > Custom Package را انتخاب کنید و فایل GoogleMobileAdsDTExchangeMediation.unitypackage را که دانلود کردهاید، پیدا کنید. مطمئن شوید که همه فایلها انتخاب شدهاند و روی Import کلیک کنید.
سپس، Assets > External Dependency Manager > Android Resolver > Force Resolve را انتخاب کنید. کتابخانه External Dependency Manager تجزیه و تحلیل وابستگیها را از ابتدا انجام میدهد و وابستگیهای اعلام شده را در پوشه Assets/Plugins/Android برنامه Unity شما کپی میکند.
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
این بخش نحوه فعال یا غیرفعال کردن تبلیغات شخصیسازیشده برای DT Exchange را نشان میدهد.
افزونه میانجیگری تبلیغات موبایل گوگل برای DT Exchange نسخه ۱.۱.۰، کلاس Fyber را با متدهای SetGDPRRequired() و SetGDPRConsentString() اضافه کرده است که به شما امکان میدهد اطلاعات رضایت را به صورت دستی به DT Exchange ارسال کنید. کد نمونه زیر نحوه ارسال این پارامترها به آداپتور DT Exchange را نشان میدهد:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");
برای اطلاعات بیشتر و مقادیری که میتوان در این روش ارائه داد، به مقاله GDPR صرافی DT مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
افزونه میانجیگری تبلیغات موبایل گوگل برای DT Exchange نسخه ۳.۱.۱، کلاس Fyber را با متد SetCCPAString() اضافه کرده است که به شما امکان میدهد اطلاعات رضایت را به صورت دستی به DT Exchange ارسال کنید. کد نمونه زیر نحوه ارسال این پارامترها به آداپتور DT Exchange را نشان میدهد:
using GoogleMobileAds.Api.Mediation.Fyber;
// ...
Fyber.SetCCPAString("myCCPAConsentString");
// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();
برای اطلاعات بیشتر و مقادیری که میتوان در این روش ارائه داد، به مقاله متنباز CCPA صرافی DT مراجعه کنید.
برای ادغام DT Exchange هیچ کد اضافی لازم نیست.
برای افزودن شناسههای SKAdNetwork به فایل Info.plist پروژه خود ، مستندات DT Exchange را دنبال کنید.
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کردهاید . برای تأیید اینکه تبلیغات آزمایشی را از DT Exchange دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی DT Exchange (Bidding) و DT Exchange (Waterfall) فعال کنید. اگر آداپتور نتواند تبلیغی از DT Exchange دریافت کند، ناشران میتوانند خطای اساسی را از پاسخ تبلیغ با استفاده از در اینجا کدها و پیامهای همراه که توسط آداپتور DT Exchange هنگام عدم بارگیری یک تبلیغ نمایش داده میشوند، آمده است: ResponseInfo تحت کلاس زیر بررسی کنند: com.google.ads.mediation.fyber.FyberMediationAdapter
GADMediationAdapterFyber
کد خطا دلیل ۱۰۱ پارامترهای سرور DT Exchange که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۳ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط DT Exchange مطابقت ندارد. ۱۰۵ DT SDK یک تبلیغ را بارگذاری کرد اما یک کنترلر غیرمنتظره را برگرداند. ۱۰۶ آگهی آماده نمایش نیست. ۱۰۷ متن (context) یک نمونه از فعالیت (activity) نیست. ۲۰۰-۳۹۹ DT SDK خطایی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید. کد خطا دلیل ۰-۱۰ DT SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات مراجعه کنید. ۱۰۱ پارامترهای سرور DT Exchange که در رابط کاربری AdMob پیکربندی شدهاند، وجود ندارند/نامعتبر هستند. ۱۰۲ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط DT Exchange مطابقت ندارد. ۱۰۳ نمایش تبلیغ ناموفق بود زیرا شیء تبلیغ قبلاً استفاده شده است. ۱۰۴ به دلیل آماده نبودن تبلیغ، نمایش تبلیغات DT Exchange ناموفق بود. ۱۰۵ DT SDK خطای مقداردهی اولیه را برگرداند. DummyClient به PlaceholderClient تغییر یافت.GoogleMobileAds/Mediation/DTExchange/ منتقل شد.GoogleMobileAds.Mediation.DTExchange بازسازی شده است.GoogleMobileAds.Api.Mediation.Fyber.Fyber را به GoogleMobileAds.Api.Mediation.DTExchange.DTExchange تغییر نام داد.Fyber اضافه شد:SetCCPAString(string)ClearCCPAString()Fyber اضافه شد:SetGDPRConsent()SetGDPRConsentString()ClearGDPRConsentData()