این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از DT Exchange با استفاده از میانجیگری استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن DT Exchange به پیکربندی میانجی واحد تبلیغات و نحوه ادغام SDK و آداپتور DT Exchange در یک برنامه Flutter را پوشش می دهد.
ادغام ها و قالب های تبلیغاتی پشتیبانی شده
آداپتور میانجی فلاتر برای DT Exchange دارای قابلیت های زیر است:
| یکپارچه سازی | |
|---|---|
| مناقصه | |
| آبشار | |
| فرمت ها | |
| بنر | |
| بینابینی | |
| پاداش داده شد | |
الزامات
- جدیدترین SDK تبلیغات موبایل گوگل
- فلاتر 3.7.0 یا بالاتر
- برای استقرار در اندروید
- Android API سطح 21 یا بالاتر
- برای استقرار در iOS
- هدف استقرار iOS 12.0 یا بالاتر
- یک پروژه Flutter در حال کار که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
- راهنمای شروع میانجیگری را کامل کنید
مرحله 1: تنظیمات را در DT Exchange UI تنظیم کنید
اضافه کردن برنامه جدید و قرار دادن آگهی
ثبت نام کنید یا به کنسول DT Exchange وارد شوید .
روی دکمه افزودن برنامه کلیک کنید تا برنامه خود را اضافه کنید.
پلتفرم خود را انتخاب کنید، بقیه فرم را پر کنید و روی Add Placements کلیک کنید.
اندروید
iOS
در فیلد با عنوان Name your Placement ، یک نام برای مکان جدید وارد کنید و نوع قرارگیری مورد نظر خود را از لیست کشویی انتخاب کنید. در نهایت، روی Save Placement کلیک کنید.
شناسه برنامه و شناسه مکان
نوار ناوبری سمت چپ را با نگه داشتن ماوس روی آن باز کنید. سپس از منوی سمت چپ روی Apps کلیک کنید.
در صفحه مدیریت برنامه ، شناسه برنامه در کنار برنامه خود را یادداشت کنید.
برنامه خود را انتخاب کنید، به برگه Placements بروید و روی نماد کپی در کنار نام مکان کلیک کنید. شناسه مکان را یادداشت کنید.
شناسه ناشر، کلید مصرف کننده و راز مصرف کننده
از منوی سمت چپ روی نام کاربری خود کلیک کرده و User Profile را انتخاب کنید.
به شناسه ناشر ، کلید مصرف کننده و راز مصرف کننده توجه داشته باشید زیرا در مرحله بعدی به این موارد نیاز دارید.
مرحله 2: تقاضای تبادل DT را در رابط کاربری AdMob تنظیم کنید
تنظیمات میانجی را برای واحد تبلیغات خود پیکربندی کنید
اندروید
برای دستورالعمل‌ها، به مرحله 2 در راهنمای Android مراجعه کنید.
iOS
برای دستورالعمل‌ها، مرحله 2 را در راهنمای iOS ببینید.
DT Exchange را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده اضافه کنید
مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید تا DT Exchange (کسب درآمد فیبر) را به لیست شرکای تبلیغاتی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob اضافه کنید.
مرحله 3: SDK و آداپتور DT Exchange را وارد کنید
ادغام از طریق pub.dev
وابستگی زیر را با آخرین نسخه های DT Exchange SDK و آداپتور در فایل pubspec.yaml بسته خود اضافه کنید:
dependencies:
gma_mediation_dtexchange: ^1.0.0
ادغام دستی
آخرین نسخه افزونه میانجی گری تبلیغات موبایل گوگل را برای DT Exchange دانلود کنید، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه Flutter خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:
dependencies:
gma_mediation_dtexchange:
path: path/to/local/package
مرحله 4: تنظیمات حریم خصوصی را در DT Exchange SDK اجرا کنید
رضایت اتحادیه اروپا و GDPR
تحت «خط‌مشی رضایت کاربر اتحادیه اروپا» Google، باید اطمینان حاصل کنید که اطلاعات مشخصی در رابطه با استفاده از شناسه‌های دستگاه و داده‌های شخصی به کاربران منطقه اقتصادی اروپا (EEA) داده می‌شود و از آنها رضایت گرفته می‌شود. این سیاست منعکس کننده الزامات دستورالعمل حریم خصوصی الکترونیک اتحادیه اروپا و مقررات عمومی حفاظت از داده ها (GDPR) است. هنگام درخواست رضایت، باید هر شبکه تبلیغاتی را در زنجیره میانجی خود شناسایی کنید که ممکن است داده‌های شخصی را جمع‌آوری، دریافت یا استفاده کند و اطلاعاتی درباره استفاده هر شبکه ارائه دهد. Google در حال حاضر نمی تواند رضایت کاربر را به طور خودکار به چنین شبکه هایی منتقل کند.
افزونه میانجیگری تبلیغات Google Mobile برای DT Exchange از انتقال اطلاعات رضایت به DT Exchange SDK پشتیبانی نمی‌کند.
قوانین حفظ حریم خصوصی ایالات متحده
قوانین حفظ حریم خصوصی ایالات متحده مستلزم دادن حق انصراف کاربران از "فروش" "اطلاعات شخصی" خود (همانطور که قانون آن شرایط را تعریف می کند)، با انصراف ارائه شده از طریق پیوند برجسته "اطلاعات شخصی من را نفروش" در "فروش" "صفحه اصلی حزب. راهنمای انطباق با قوانین حریم خصوصی ایالات ایالات متحده، امکان فعال کردن پردازش داده های محدود را برای ارائه تبلیغات Google ارائه می دهد، اما Google نمی تواند این تنظیم را برای هر شبکه تبلیغاتی در زنجیره میانجی شما اعمال کند. بنابراین، شما باید هر یک از شبکه‌های تبلیغاتی را در زنجیره میانجی خود که ممکن است در فروش اطلاعات شخصی شرکت کنند شناسایی کنید و از راهنمایی‌های هر یک از آن شبکه‌ها برای اطمینان از رعایت آن پیروی کنید.
افزونه میانجیگری تبلیغات Google Mobile برای DT Exchange از انتقال اطلاعات رضایت به DT Exchange SDK پشتیبانی نمی‌کند.
مرحله 5: کد مورد نیاز را اضافه کنید
اندروید
هیچ کد اضافی برای ادغام DT Exchange مورد نیاز نیست.
iOS
ادغام SKAdNetwork
مستندات DT Exchange را دنبال کنید تا شناسه های SKAdNetwork را به فایل Info.plist پروژه خود اضافه کنید.
مرحله 6: اجرای خود را آزمایش کنید
فعال کردن تبلیغات آزمایشی
مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده اید.
تبلیغات آزمایشی را تأیید کنید
برای تأیید اینکه آگهی‌های آزمایشی را از DT Exchange دریافت می‌کنید، با استفاده از منبع(های) آگهی DT Exchange (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.
کدهای خطا
اگر آداپتور نتواند تبلیغی را از DT Exchange دریافت کند، ناشران می‌توانند با استفاده ResponseInfo در کلاس زیر، خطای اساسی در پاسخ آگهی را بررسی کنند:
اندروید
com.google.ads.mediation.fyber.FyberMediationAdapter
iOS
GADMediationAdapterFyber
در اینجا کدها و پیام‌های همراهی هستند که توسط آداپتور DT Exchange هنگام بارگیری نشدن آگهی ارسال می‌شوند:
اندروید
| کد خطا | دلیل |
|---|---|
| 101 | پارامترهای سرور DT Exchange پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است. |
| 103 | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از DT Exchange مطابقت ندارد. |
| 105 | DT Exchange SDK یک آگهی بارگیری کرد اما یک کنترلر غیرمنتظره را برگرداند. |
| 106 | آگهی آماده نمایش نیست |
| 200-399 | DT Exchange SDK یک خطا برگرداند. برای جزئیات بیشتر به کد مراجعه کنید. |
iOS
| کد خطا | دلیل |
|---|---|
| 0-10 | DT Exchange SDK یک خطا برگرداند. برای جزئیات بیشتر به مستندات مراجعه کنید. |
| 101 | پارامترهای سرور DT Exchange پیکربندی شده در رابط کاربری AdMob وجود ندارد/نامعتبر است. |
| 102 | اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از DT Exchange مطابقت ندارد. |
| 103 | تبلیغ نمایش داده نشد زیرا شیء تبلیغ قبلاً استفاده شده است. |
| 104 | به دلیل آماده نبودن آگهی، تبلیغات DT Exchange نشان داده نشد. |
| 105 | DT Exchange SDK یک خطای اولیه را برگرداند. |
DT Exchange Flutter Mediation Adapter Changelog
نسخه بعدی
- ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.
1.1.0
- سازگاری تایید شده با آداپتور اندروید DT Exchange نسخه 8.3.0.0.
- سازگاری تایید شده با آداپتور DT Exchange iOS نسخه 8.3.1.0.
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.
1.0.0
- انتشار اولیه
- سازگاری تایید شده با آداپتور اندروید DT Exchange نسخه 8.2.7.0.
- سازگاری تأیید شده با آداپتور DT Exchange iOS نسخه 8.2.8.0.
- با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.