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

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

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

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

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

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

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

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

الزامات

  • جدیدترین SDK تبلیغات موبایلی گوگل
  • فلاتر ۳.۷.۰ یا بالاتر
  • برای نصب روی اندروید
    • اندروید API سطح ۲۳ یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک پروژه فلاترِ در حال کار که با 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 و آداپتور را وارد کنید

ادغام از طریق pub.dev

وابستگی زیر را به همراه آخرین نسخه‌های DT Exchange SDK و آداپتور آن در فایل pubspec.yaml پکیج خود اضافه کنید:

dependencies:
  gma_mediation_dtexchange: ^

ادغام دستی

آخرین نسخه افزونه میانجیگری تبلیغات موبایلی گوگل را برای DT Exchange دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با اضافه کردن وابستگی زیر، افزونه را در فایل pubspec.yaml خود ارجاع دهید:

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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

برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکی‌ها یا سایر ذخیره‌سازی‌های محلی در صورت لزوم قانونی، و برای جمع‌آوری، اشتراک‌گذاری و استفاده از داده‌های شخصی برای شخصی‌سازی تبلیغات، دریافت کنید. این سیاست منعکس‌کننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از داده‌ها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطه‌گری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکه‌هایی منتقل کند.

افزونه میانجیگری تبلیغات موبایلی گوگل برای DT Exchange از ارسال اطلاعات رضایت به DT SDK پشتیبانی نمی‌کند.

قوانین حفظ حریم خصوصی ایالت‌های آمریکا

قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف می‌کند) را می‌دهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه می‌شود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالت‌های ایالات متحده، امکان فعال کردن پردازش داده‌های محدود برای سرویس تبلیغات گوگل را ارائه می‌دهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطه‌گری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطه‌گری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنمایی‌های هر یک از این شبکه‌ها پیروی کنید.

افزونه میانجیگری تبلیغات موبایلی گوگل برای DT Exchange از ارسال اطلاعات رضایت به DT SDK پشتیبانی نمی‌کند.

مرحله ۵: اضافه کردن کد مورد نیاز

اندروید

برای ادغام 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 خطای مقداردهی اولیه را برگرداند.

تغییرات آداپتور میانجیگری Flutter در DT Exchange

نسخه ۱.۱.۵

نسخه ۱.۱.۴

نسخه ۱.۱.۳

نسخه ۱.۱.۲

نسخه ۱.۱.۱

نسخه ۱.۱.۰

نسخه ۱.۰.۰