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

پلتفرم مورد نظر را انتخاب کنید: اندروید (بتا) جدید-منتخب اندروید، iOS، یونیتی ، فلاتر

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از DT Exchange با استفاده از AdMob Mediation استفاده کنید و ادغام‌های waterfall را پوشش می‌دهد. این راهنما نحوه اضافه کردن DT Exchange به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام DT SDK و آداپتور را در یک برنامه اندروید پوشش می‌دهد.

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

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

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

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

الزامات

  • اندروید API سطح ۲۴ یا بالاتر

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

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

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

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

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

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

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

راه‌اندازی

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

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

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

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

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

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

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

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

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

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

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

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

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

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

شما باید DT Exchange را به پیکربندی میانجیگری برای واحد تبلیغاتی خود اضافه کنید.

ابتدا، وارد حساب کاربری AdMob خود شوید. سپس، به برگه Mediation بروید. اگر یک گروه میانجیگری موجود دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجیگری کلیک کنید تا آن را ویرایش کنید و به Add DT Exchange as an ad source بروید.

برای ایجاد یک گروه میانجیگری جدید، گزینه «ایجاد گروه میانجیگری» را انتخاب کنید.

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

به گروه میانجیگری خود یک نام بدهید و مکان‌هایی را برای هدف قرار دادن انتخاب کنید. در مرحله بعد، وضعیت گروه میانجیگری را روی فعال (Enabled) تنظیم کنید و سپس روی افزودن واحدهای تبلیغاتی (Add Ad Units) کلیک کنید.

این گروه میانجی را با یک یا چند واحد تبلیغاتی AdMob موجود خود مرتبط کنید. سپس روی «انجام شد» کلیک کنید.

اکنون باید کارت واحدهای تبلیغاتی را ببینید که با واحدهای تبلیغاتی که انتخاب کرده‌اید پر شده است:

DT Exchange را به عنوان منبع تبلیغات اضافه کنید

مناقصه


در قسمت «منابع تبلیغات» ، زیر کارت پیشنهاد قیمت ، گزینه «افزودن منبع تبلیغات» را انتخاب کنید. سپس «DT Exchange» را انتخاب کنید.

روی نحوه امضای قرارداد مشارکت و تنظیم مشارکت در مناقصه با DT Exchange کلیک کنید.



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



اگر از قبل نگاشتی برای DT Exchange دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.



در مرحله بعد، شناسه برنامه و شناسه قرارگیری که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» کلیک کنید.



آبشار


در زیر کارت Waterfall در بخش Ad Sources ، گزینه Add Ad Source را انتخاب کنید.

DT Exchange را انتخاب کنید و سوئیچ Optimize را فعال کنید. شناسه ناشر ، راز مصرف‌کننده و کلید مصرف‌کننده که در بخش قبل به دست آورده‌اید را برای تنظیم بهینه‌سازی منبع تبلیغات برای DT Exchange وارد کنید. سپس یک مقدار eCPM برای DT Exchange وارد کنید و روی ادامه کلیک کنید.



اگر از قبل نگاشتی برای DT Exchange دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.

در مرحله بعد، شناسه برنامه و شناسه قرارگیری که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» کلیک کنید.


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

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

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

در فایل gradle سطح برنامه خود، وابستگی‌ها و پیکربندی‌های پیاده‌سازی زیر را اضافه کنید:

کاتلین 

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:fyber:8.4.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

گرووی 

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:fyber:8.4.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

ادغام دستی

  • آخرین نسخه DT SDK را برای اندروید دانلود کنید و fyber-marketplace-xyzaar را به پروژه خود اضافه کنید.
  • به مصنوعات آداپتور DT Exchange در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور DT Exchange را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

از نسخه ۸.۳.۰ کیت توسعه نرم‌افزاری DT Exchange، DT Exchange به‌طور خودکار رضایت‌نامه GDPR تنظیم‌شده توسط پلتفرم‌های مدیریت رضایت‌نامه که از مشخصات رضایت‌نامه اضافی گوگل پشتیبانی می‌کنند را می‌خواند. برای اطلاعات بیشتر، به راهنمای پیاده‌سازی GDPR در DT Exchange مراجعه کنید.

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

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

DT Exchange حاوی یک API است که به شما امکان می‌دهد رضایت کاربر را به SDK آنها ارسال کنید. نمونه کد زیر نحوه ارسال دستی اطلاعات رضایت به DT SDK را نشان می‌دهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به DT SDK ارسال کنید، توصیه می‌شود قبل از درخواست تبلیغات از طریق GMA Next-Gen SDK ، این کد فراخوانی شود.

جاوا 

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING);
DTExchangeMediationSnippets.java

کاتلین 

InneractiveAdManager.setUSPrivacyString(US_PRIVACY_STRING)
DTExchangeMediationSnippets.kt

US_PRIVACY_STRING را با رشته‌ی حریم خصوصی آمریکایی خود جایگزین کنید.

برای جزئیات بیشتر و مقادیری که ممکن است در این روش ارائه شوند ، به راهنمای پیاده‌سازی CCPA در DT Exchange مراجعه کنید.

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

بارگذاری تبلیغ با زمینه فعالیت

هنگام بارگذاری قالب‌های تبلیغات بینابینی، زمینه Activity را ارسال کنید. بدون زمینه فعالیت، بارگذاری تبلیغ با شکست مواجه خواهد شد.

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

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

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

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

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

مراحل اختیاری

پارامترهای خاص شبکه

آداپتور DT Exchange از پارامترهای درخواست اضافی پشتیبانی می‌کند که می‌توانند به عنوان یک Android Bundle به آداپتور منتقل شوند. آداپتور به دنبال کلیدهای زیر در بسته می‌گردد:

درخواست پارامترها و مقادیر
InneractiveMediationDefs.KEY_AGE عدد صحیح . سن کاربر
FyberMediationAdapter.KEY_MUTE_VIDEO بولی . بی‌صدا یا بی‌صدا کردن ویدیو

در اینجا یک مثال کد از نحوه تنظیم این پارامترهای درخواست تبلیغ آورده شده است:

جاوا 

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request =
    new AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter.class, extras).build();
DTExchangeMediationSnippets.java

کاتلین 

val extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request =
  AdRequest.Builder().addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras).build()
DTExchangeMediationSnippets.kt

کدهای خطا

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

com.google.ads.mediation.fyber.FyberMediationAdapter

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

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