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

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

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

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

¹ ادغام مناقصه در نسخه آزمایشی بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

² تبلیغات پاداش فقط در میانجی گری آبشار پشتیبانی می شود.

الزامات

• جدیدترین SDK تبلیغات موبایل گوگل
• یونیتی 4 یا بالاتر
• [برای مناقصه]: برای ادغام همه قالب‌های تبلیغاتی پشتیبانی شده در مناقصه، از افزونه میانجی‌گری Google Mobile Ads برای DT Exchange 3.3.12 یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )
• برای استقرار در اندروید
  • Android API سطح 23 یا بالاتر
• برای استقرار در iOS
  • هدف استقرار iOS 12.0 یا بالاتر
• یک پروژه واحد کاری که با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
• راهنمای شروع میانجیگری را کامل کنید

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

اضافه کردن برنامه جدید و قرار دادن آگهی

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

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

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

نام ها را وارد کنید و انواع مکان های خود را انتخاب کنید. سپس روی Save Placement کلیک کنید.

شناسه برنامه و شناسه مکان

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

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

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

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

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

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

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

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

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

مرحله 2: تقاضای تبادل DT را در رابط کاربری AdMob تنظیم کنید

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

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

مراحل تنظیمات مقررات اروپا و تنظیمات مقررات ایالتی ایالات متحده را برای افزودن DT Exchange (درآمدزایی فیبر) به لیست شرکای تبلیغات مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob دنبال کنید.

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

openupm add com.google.ads.mobile.mediation.dtexchange

مرحله 4: تنظیمات حریم خصوصی را در DT SDK اجرا کنید

رضایت اتحادیه اروپا و GDPR

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

این بخش نحوه فعال یا غیرفعال کردن تبلیغات شخصی شده برای DT Exchange را نشان می دهد.

افزونه میانجیگری Google Mobile Ads برای DT Exchange نسخه 1.1.0 کلاس Fyber را با متدهای SetGDPRRequired() و SetGDPRConsentString() اضافه کرد و به شما امکان داد اطلاعات رضایت را به صورت دستی به DT Exchange ارسال کنید. کد نمونه زیر نحوه ارسال این پارامترها را به آداپتور DT Exchange نشان می دهد:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

برای اطلاعات بیشتر و مقادیری که در روش ارائه می شود، به مقاله GDPR DT Exchange مراجعه کنید.

قوانین حفظ حریم خصوصی ایالات متحده

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

افزونه میانجی‌گری Google Mobile Ads برای DT Exchange نسخه 3.1.1 کلاس 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 Exchange دیدن کنید.

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

مرحله 6: اجرای خود را آزمایش کنید

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

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

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

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

کدهای خطا

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

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

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

DT Exchange Unity Mediation Plugin Changelog

نسخه 3.3.12

• از آداپتور اندروید DT Exchange نسخه 8.3.8.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.8.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 10.3.0 ساخته و آزمایش شده است.

نسخه 3.3.11

• از آداپتور اندروید DT Exchange نسخه 8.3.7.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.7.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 10.2.0 ساخته و آزمایش شده است.

نسخه 3.3.10

• از آداپتور اندروید DT Exchange نسخه 8.3.7.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.6.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 10.0.0 ساخته و آزمایش شده است.

نسخه 3.3.9

• از آداپتور اندروید DT Exchange نسخه 8.3.6.1 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.6.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 10.0.0 ساخته و آزمایش شده است.

نسخه 3.3.8

• از آداپتور اندروید DT Exchange نسخه 8.3.5.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.4.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.5.0.

نسخه 3.3.7

• از آداپتور اندروید DT Exchange نسخه 8.3.4.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.4.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.5.0.

نسخه 3.3.6

• از آداپتور اندروید DT Exchange نسخه 8.3.3.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.4.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.5.0.

نسخه 3.3.5

• از آداپتور اندروید DT Exchange نسخه 8.3.3.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.3.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.4.0.

نسخه 3.3.4

• از آداپتور اندروید DT Exchange نسخه 8.3.3.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.2.1 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.4.0.

نسخه 3.3.3

• از آداپتور اندروید DT Exchange نسخه 8.3.2.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.2.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 9.3.0 ساخته و آزمایش شده است.

نسخه 3.3.2

• از آداپتور اندروید DT Exchange نسخه 8.3.1.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.2.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 9.3.0 ساخته و آزمایش شده است.

نسخه 3.3.1

• از آداپتور اندروید DT Exchange نسخه 8.3.1.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.2.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.

نسخه 3.3.0

• DummyClient به PlaceholderClient تغییر نام داد.
• از آداپتور اندروید DT Exchange نسخه 8.3.0.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.1.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.2.0.

نسخه 3.2.1

• از آداپتور اندروید DT Exchange نسخه 8.2.7.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.1.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.1.

نسخه 3.2.0

• از آداپتور اندروید DT Exchange نسخه 8.2.7.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.3.0.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 3.1.12

• از آداپتور اندروید DT Exchange نسخه 8.2.7.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.2.8.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 3.1.11

• از آداپتور اندروید DT Exchange نسخه 8.2.7.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.2.7.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.1.0.

نسخه 3.1.10

• از آداپتور اندروید DT Exchange نسخه 8.2.6.1 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.2.7.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 9.0.0.

نسخه 3.1.8

• از آداپتور اندروید DT Exchange نسخه 8.2.5.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.2.6.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 8.6.0.

نسخه 3.1.7

• از آداپتور اندروید DT Exchange نسخه 8.2.4.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.2.4.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.5.2 ساخته و آزمایش شده است.

نسخه 3.1.6

• از آداپتور اندروید DT Exchange نسخه 8.2.3.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.2.3.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.4.1 ساخته و آزمایش شده است.

نسخه 3.1.5

• محتوای آداپتور به GoogleMobileAds/Mediation/DTExchange/ منتقل شد.
• فضای نام آداپتور برای استفاده از GoogleMobileAds.Mediation.DTExchange بازسازی شد.
• از آداپتور اندروید DT Exchange نسخه 8.2.3.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.2.1.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 8.1.0 ساخته و آزمایش شده است.

نسخه 3.1.4

• از آداپتور اندروید DT Exchange نسخه 8.2.2.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.1.9.1 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.4.1 ساخته و آزمایش شده است.

نسخه 3.1.3

• از آداپتور اندروید DT Exchange نسخه 8.2.1.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.1.9.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.4.0 ساخته و آزمایش شده است.

نسخه 3.1.2

• نام پلاگین میانجیگری Unity به "DT Exchange" تغییر نام داد.
• کلاس GoogleMobileAds.Api.Mediation.Fyber.Fyber به GoogleMobileAds.Api.Mediation.DTExchange.DTExchange تغییر نام داد.
• از آداپتور اندروید DT Exchange نسخه 8.2.1.0 پشتیبانی می کند.
• از آداپتور DT Exchange iOS نسخه 8.1.7.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.3.1 ساخته و آزمایش شده است.

نسخه 3.1.1

• متدهای زیر را به کلاس Fyber اضافه کرد:
  • SetCCPAString(string)
  • ClearCCPAString()
• از آداپتور اندروید فیبر نسخه 8.2.0.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 8.1.6.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.3.0 ساخته و آزمایش شده است.

نسخه 3.1.0

• از آداپتور اندروید فیبر نسخه 8.2.0.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 8.1.5.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.2.0 ساخته و آزمایش شده است.

نسخه 3.0.2

• از آداپتور اندروید فیبر نسخه 8.1.3.1 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 8.1.5.0 پشتیبانی می کند.
• ساخته و آزمایش شده با افزونه Google Mobile Ads Unity نسخه 7.0.2.

نسخه 3.0.1

• از آداپتور اندروید فیبر نسخه 8.1.3.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 8.1.4.0 پشتیبانی می کند.
• با افزونه Google Mobile Ads Unity نسخه 7.0.0 ساخته و آزمایش شده است.

نسخه 3.0.0

• از آداپتور اندروید فیبر نسخه 8.1.2.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 8.1.2.0 پشتیبانی می کند.

نسخه 2.0.0

• از آداپتور اندروید فیبر نسخه 7.8.4.1 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 8.0.0.0 پشتیبانی می کند.

نسخه 1.6.1

• از آداپتور اندروید فیبر نسخه 7.8.3.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.8.6.0 پشتیبانی می کند.

نسخه 1.6.0

• از آداپتور اندروید فیبر نسخه 7.8.2.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.8.5.0 پشتیبانی می کند.

نسخه 1.5.2

• از آداپتور اندروید فیبر نسخه 7.7.4.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.7.3.0 پشتیبانی می کند.

نسخه 1.5.1

• از آداپتور اندروید فیبر نسخه 7.7.2.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.7.2.0 پشتیبانی می کند.

نسخه 1.5.0

• از آداپتور اندروید فیبر نسخه 7.7.1.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.7.1.0 پشتیبانی می کند.

نسخه 1.4.0

• از آداپتور اندروید فیبر نسخه 7.7.0.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.6.4.0 پشتیبانی می کند.

نسخه 1.3.0

• از آداپتور اندروید فیبر نسخه 7.6.0.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.6.0.0 پشتیبانی می کند.

نسخه 1.2.3

• از آداپتور اندروید فیبر نسخه 7.5.4.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.5.6.0 پشتیبانی می کند.

نسخه 1.2.2

• از آداپتور اندروید فیبر نسخه 7.5.3.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.5.4.0 پشتیبانی می کند.

نسخه 1.2.1

• از آداپتور اندروید فیبر نسخه 7.5.2.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.5.3.0 پشتیبانی می کند.

نسخه 1.2.0

• از آداپتور اندروید فیبر نسخه 7.5.0.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.5.1.0 پشتیبانی می کند.

نسخه 1.1.0

• برای پشتیبانی از الزامات GDPR متدهای زیر را به کلاس Fyber اضافه کرد:
  • SetGDPRConsent()
  • SetGDPRConsentString()
  • ClearGDPRConsentData()
• از آداپتور اندروید فیبر نسخه 7.3.4.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.5.0.0 پشتیبانی می کند.

نسخه 1.0.0

• اولین انتشار!
• از آداپتور اندروید فیبر نسخه 7.3.4.0 پشتیبانی می کند.
• از آداپتور Fyber iOS نسخه 7.4.0.0 پشتیبانی می کند.