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

توجه: Fyber Marketplace اکنون DT Exchange است.

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

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

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

یکپارچه سازی
مناقصه
آبشار
فرمت ها
بنر
بینابینی
پاداش داده شد

الزامات

• جدیدترین SDK تبلیغات موبایل گوگل
• یونیتی 4 یا بالاتر
• برای استقرار در اندروید
  • Android API سطح 21 یا بالاتر
• برای استقرار در iOS
  • هدف استقرار iOS 12.0 یا بالاتر
• یک کار Unity پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
• راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

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

اندروید

iOS

در فیلد با عنوان Name your Placement ، یک نام برای مکان جدید وارد کنید و نوع قرارگیری مورد نظر خود را از لیست کشویی انتخاب کنید. در نهایت، روی Save Placement کلیک کنید.

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

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

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

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

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

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

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

مرحله 2: تقاضای تبادل DT را در آن تنظیم کنید Ad Manager UI

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

اندروید

برای دستورالعمل ها، مرحله 2 را در راهنما ببینیداندروید .

iOS

برای دستورالعمل ها، مرحله 2 را در راهنما ببینیدiOS .

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

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

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

توجه: عدم ادغام نسخه‌های سازگار DT Exchange و Google Mobile Ads SDK ممکن است منجر به مشکلات ساخت شود.

OpenUPM-CLI

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM-CLI مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/DTExchange دارایی‌ها را از مکان قدیمی حذف نصب کنید.

اگر OpenUPM-CLI را نصب کرده‌اید، می‌توانید با اجرای دستور زیر از دایرکتوری ریشه پروژه خود، افزونه Google Mobile Ads DT Exchange Mediation for Unity را در پروژه خود نصب کنید:

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

OpenUPM

مهم: اگر از استفاده از .unitypackage به استفاده از OpenUPM مهاجرت می‌کنید، باید با حذف همه فایل‌ها از پوشه Assets/GoogleMobileAds/Mediation/DTExchange دارایی‌ها را از محل قدیمی حذف نصب کنید.

در ویرایشگر پروژه Unity خود، Edit > Project Settings > Package Manager را انتخاب کنید تا تنظیمات Unity Package Manager باز شود.

در برگه Scoped Registries ، OpenUPM را به عنوان یک رجیستری محدوده با جزئیات زیر اضافه کنید:

• نام: OpenUPM
• آدرس اینترنتی: https://package.openupm.com
• محدوده (ها): com.google

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

بسته Google Mobile Ads DT Exchange Mediation را انتخاب کنید و روی Install کلیک کنید.

پکیج یونیتی

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

مرحله 4: تنظیمات حریم خصوصی را در DT Exchange 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: کد مورد نیاز را اضافه کنید

اندروید

هیچ کد اضافی برای ادغام DT Exchange مورد نیاز نیست.

iOS

ادغام SKAdNetwork

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

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

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

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

مهم: قبل از انتشار برنامه، حالت تست را برای AdMob و DT Exchange غیرفعال کنید.

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

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

کدهای خطا

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

اندروید

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

اندروید

کد خطا	دلیل
101	پارامترهای سرور DT Exchange در پیکربندی شده است Ad Manager رابط کاربری موجود نیست/نامعتبر است.
103	اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از DT Exchange مطابقت ندارد.
105	DT Exchange SDK یک آگهی بارگیری کرد اما یک کنترلر غیرمنتظره را برگرداند.
106	آگهی آماده نمایش نیست
200-399	DT Exchange SDK یک خطا برگرداند. برای جزئیات بیشتر به کد مراجعه کنید.

iOS

کد خطا	دلیل
0-10	DT Exchange SDK یک خطا برگرداند. برای جزئیات بیشتر به مستندات مراجعه کنید.
101	پارامترهای سرور DT Exchange در پیکربندی شده است Ad Manager رابط کاربری موجود نیست/نامعتبر است.
102	اندازه آگهی درخواستی با اندازه بنر پشتیبانی شده از DT Exchange مطابقت ندارد.
103	تبلیغ نمایش داده نشد زیرا شیء تبلیغ قبلاً استفاده شده است.
104	به دلیل آماده نبودن آگهی، تبلیغات DT Exchange نشان داده نشد.
105	DT Exchange SDK یک خطای اولیه را برگرداند.

DT Exchange Unity Mediation Plugin Changelog

نسخه 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 پشتیبانی می کند.