ادغام DT Exchange با واسطه

پلتفرم مورد نظر: اندروید، iOS، یونیتی، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از SDK تبلیغات موبایل گوگل برای بارگذاری و نمایش تبلیغات از DT Exchange با استفاده از میانجیگری استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن DT Exchange به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور DT در یک برنامه Unity را پوشش می‌دهد.

ادغام‌ها و قالب‌های تبلیغاتی پشتیبانی‌شده

آداپتور میانجیگری Unity برای DT Exchange دارای قابلیت‌های زیر است:

ادغام
مناقصه ۱
آبشار
قالب‌ها
بنر
بینابینی
پاداش داده شده ۲

۱- ادغام پیشنهاد قیمت در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

۲- قالب تبلیغات پاداشی برای پیشنهاد قیمت iOS در مرحله آلفا است.

الزامات

  • جدیدترین SDK تبلیغات موبایلی گوگل
  • یونیتی ۴ یا بالاتر
  • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از افزونه‌ی میانجیگری تبلیغات موبایلی گوگل برای DT Exchange 3.3.12 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه Unity در حال کار که با SDK تبلیغات موبایلی گوگل پیکربندی شده است. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
  • راهنمای شروع میانجیگری را تکمیل کنید

مرحله 1: تنظیمات را در رابط کاربری DT Exchange انجام دهید

افزودن اپلیکیشن جدید و محل قرارگیری تبلیغات

در کنسول DT Exchange ثبت نام کنید یا وارد شوید .

روی افزودن برنامه کلیک کنید.

مدیریت برنامه‌ها

پلتفرم و جایگاه‌های خود را انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد برنامه کلیک کنید.

اندروید

آی‌او‌اس

نام‌ها را وارد کنید و انواع جایگاه‌های خود را انتخاب کنید. سپس، روی ذخیره جایگاه کلیک کنید.

راه‌اندازی

شناسه برنامه و شناسه قرارگیری

برای باز کردن نوار ناوبری سمت چپ، نشانگر ماوس را روی آن نگه دارید، سپس روی مدیریت برنامه کلیک کنید.

در صفحه مدیریت برنامه ، شناسه برنامه را در کنار برنامه خود یادداشت کنید.

برنامه خود را انتخاب کنید و به برگه Placements بروید. شناسه Placement را یادداشت کنید.

شناسه قرارگیری

شناسه ناشر، کلید مصرف‌کننده و راز مصرف‌کننده

از منوی سمت چپ روی نام کاربری خود کلیک کنید و گزینه پروفایل کاربری را انتخاب کنید.

شناسه ناشر ، کلید مصرف‌کننده و راز مصرف‌کننده را یادداشت کنید زیرا در مرحله بعدی به آنها نیاز خواهید داشت.

پروفایل کاربر

فایل app-ads.txt خود را به‌روزرسانی کنید.

فروشندگان مجاز برنامه‌ها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک می‌کند تا موجودی تبلیغات برنامه خود را فقط از طریق کانال‌هایی که به عنوان مجاز شناسایی کرده‌اید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیاده‌سازی کنید. اگر قبلاً این کار را نکرده‌اید، یک فایل app-ads.txt برای Ad Manager ایجاد کنید .

برای پیاده‌سازی app-ads.txt برای DT Exchange، DT را به فایل app-ads.txt خود اضافه کنید .

مرحله ۲: تنظیم تقاضای DT Exchange در رابط کاربری Ad Manager

تنظیمات میانجیگری را برای واحد تبلیغاتی خود پیکربندی کنید

اندروید

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای اندروید مراجعه کنید.

آی‌او‌اس

برای دستورالعمل‌ها، به مرحله ۲ در راهنمای iOS مراجعه کنید.

اضافه کردن DT Exchange به فهرست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده

برای افزودن DT Exchange (Fyber Monetization) به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری Ad Manager، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.

مرحله ۳: DT SDK و آداپتور را وارد کنید

رابط خط فرمان OpenUPM

اگر 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

جزئیات OpenUPM

سپس، به مسیر Window > Package Manager بروید تا Unity Package Manager باز شود و از منوی کشویی، My Registrys را انتخاب کنید.

رجیستری‌های یونیتی

بسته‌ی Google Mobile Ads DTExchange Mediation را انتخاب کرده و روی نصب کلیک کنید.

نصب از OpenUPM

بسته یونیتی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل برای 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 شما کپی می‌کند.

عزم راسخ

مرحله ۴: تنظیمات حریم خصوصی را روی DT SDK پیاده‌سازی کنید

برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (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 هیچ کد اضافی لازم نیست.

آی‌او‌اس

ادغام شبکه SKAd

برای افزودن شناسه‌های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات DT Exchange را دنبال کنید.

مرحله ۶: پیاده‌سازی خود را آزمایش کنید

فعال کردن تبلیغات آزمایشی

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید .

تأیید تبلیغات آزمایشی

برای تأیید اینکه تبلیغات آزمایشی را از DT Exchange دریافت می‌کنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی DT Exchange (Bidding) و DT Exchange (Waterfall ) فعال کنید.

کدهای خطا

اگر آداپتور نتواند تبلیغی از DT Exchange دریافت کند، ناشران می‌توانند خطای اساسی را از پاسخ تبلیغ با استفاده از ResponseInfo تحت کلاس زیر بررسی کنند:

اندروید 

com.google.ads.mediation.fyber.FyberMediationAdapter

آی‌او‌اس 

GADMediationAdapterFyber

در اینجا کدها و پیام‌های همراه که توسط آداپتور DT Exchange هنگام عدم بارگیری یک تبلیغ نمایش داده می‌شوند، آمده است:

اندروید

کد خطا دلیل
۱۰۱ پارامترهای سرور DT Exchange که در رابط کاربری Ad Manager پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۳ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط DT Exchange مطابقت ندارد.
۱۰۵ DT SDK یک تبلیغ را بارگذاری کرد اما یک کنترلر غیرمنتظره را برگرداند.
۱۰۶ آگهی آماده نمایش نیست.
۱۰۷ متن (context) یک نمونه از فعالیت (activity) نیست.
۲۰۰-۳۹۹ DT SDK خطایی را برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.

آی‌او‌اس

کد خطا دلیل
۰-۱۰ DT SDK خطایی را برگرداند. برای جزئیات بیشتر به مستندات مراجعه کنید.
۱۰۱ پارامترهای سرور DT Exchange که در رابط کاربری Ad Manager پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده توسط DT Exchange مطابقت ندارد.
۱۰۳ نمایش تبلیغ ناموفق بود زیرا شیء تبلیغ قبلاً استفاده شده است.
۱۰۴ به دلیل آماده نبودن تبلیغ، نمایش تبلیغات DT Exchange ناموفق بود.
۱۰۵ DT SDK خطای مقداردهی اولیه را برگرداند.

تغییرات افزونه میانجیگری DT Exchange Unity

نسخه ۳.۴.۰ (در حال انجام)

نسخه ۳.۳.۱۲

نسخه ۳.۳.۱۱

نسخه ۳.۳.۱۰

نسخه ۳.۳.۹

نسخه ۳.۳.۸

نسخه ۳.۳.۷

نسخه ۳.۳.۶

نسخه ۳.۳.۵

نسخه ۳.۳.۴

نسخه ۳.۳.۳

نسخه ۳.۳.۲

نسخه ۳.۳.۱

نسخه ۳.۳.۰

نسخه ۳.۲.۱

نسخه ۳.۲.۰

نسخه ۳.۱.۱۲

نسخه ۳.۱.۱۱

نسخه ۳.۱.۱۰

نسخه ۳.۱.۸

نسخه ۳.۱.۷

نسخه ۳.۱.۶

نسخه ۳.۱.۵

نسخه ۳.۱.۴

نسخه ۳.۱.۳

نسخه ۳.۱.۲

نسخه ۳.۱.۱

نسخه ۳.۱.۰

نسخه ۳.۰.۲

نسخه ۳.۰.۱

نسخه ۳.۰.۰

نسخه ۲.۰.۰

نسخه ۱.۶.۱

نسخه ۱.۶.۰

نسخه ۱.۵.۲

نسخه ۱.۵.۱

نسخه ۱.۵.۰

نسخه ۱.۴.۰

نسخه ۱.۳.۰

نسخه ۱.۲.۳

نسخه ۱.۲.۲

نسخه ۱.۲.۱

نسخه ۱.۲.۰

نسخه ۱.۱.۰

نسخه ۱.۰.۰