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

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

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

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

الزامات

• Android API سطح 21 یا بالاتر

• جدیدترین SDK تبلیغات موبایل گوگل

• راهنمای شروع میانجیگری را کامل کنید

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ابتدا وارد حساب AdMob خود شوید. سپس به تب Mediation بروید. اگر گروه میانجی موجودی دارید که می‌خواهید آن را تغییر دهید، روی نام آن گروه میانجی کلیک کنید تا آن را ویرایش کنید، و به افزودن DT Exchange به عنوان منبع آگهی بروید.

برای ایجاد یک گروه میانجی جدید، Create Mediation Group را انتخاب کنید.

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

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

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

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

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

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

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

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

ادغام Android Studio (توصیه می شود)

در فایل build.gradle.kts در سطح برنامه خود، وابستگی ها و پیکربندی های پیاده سازی زیر را اضافه کنید. از آخرین نسخه های DT Exchange SDK و آداپتور استفاده کنید:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:fyber:8.3.3.0")
}

ادغام دستی

• آخرین نسخه DT Exchange SDK برای اندروید را دانلود کنید و فایل های زیر را به پروژه خود اضافه کنید:
  • ia-mraid-kit-release-xyzaar
  • ia-sdk-core-release-xyzaar
  • ia-video-kit-release-xyzaar
• به مصنوعات آداپتور DT Exchange در مخزن Maven Google بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور DT Exchange را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

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

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

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

از صفحه منابع GDPR و آنها در DT Exchange دیدن کنیدراهنمای اجرای GDPRبرای جزئیات بیشتر و مقادیری که ممکن است در روش ارائه شود.

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

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

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

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

از صفحه منبع CCPA تبادل DT و آنها دیدن کنیدراهنمای اجرای CCPAبرای جزئیات بیشتر و مقادیری که ممکن است در روش ارائه شود.

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

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

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

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

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

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

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

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

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

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

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

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();

var 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()

کدهای خطا

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

com.google.ads.mediation.fyber.FyberMediationAdapter

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

DT Exchange Android Mediation Adapter Changelog

نسخه 8.3.3.0

• سازگاری تایید شده با DT Exchange SDK 8.3.3.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.5.0.
• DT Exchange SDK نسخه 8.3.3.

نسخه 8.3.2.0

• سازگاری تایید شده با DT Exchange SDK 8.3.2.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.4.0.
• DT Exchange SDK نسخه 8.3.2.

نسخه 8.3.1.0

• سازگاری تایید شده با DT Exchange SDK 8.3.1.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.3.0.
• DT Exchange SDK نسخه 8.3.1.

نسخه 8.3.0.0

• پشتیبانی برای انتقال نسخه SDK تبلیغات تلفن همراه Google به DT Exchange SDK اضافه شد.
• سازگاری تایید شده با DT Exchange SDK 8.3.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.2.0.
• DT Exchange SDK نسخه 8.3.0.

نسخه 8.2.7.0

• سازگاری تایید شده با DT Exchange SDK 8.2.7.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.0.0.
• DT Exchange SDK نسخه 8.2.7.

نسخه 8.2.6.1

• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 23.0.0 به روز شد.
• سازگاری تایید شده با DT Exchange SDK 8.2.6.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 23.0.0.
• DT Exchange SDK نسخه 8.2.6.

نسخه 8.2.6.0

• سازگاری تایید شده با DT Exchange SDK 8.2.6.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.6.0.
• DT Exchange SDK نسخه 8.2.6.

نسخه 8.2.5.0

• سازگاری تایید شده با DT Exchange SDK 8.2.5.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.5.0.
• DT Exchange SDK نسخه 8.2.5.

نسخه 8.2.4.0

• سازگاری تایید شده با DT Exchange SDK 8.2.4.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.3.0.
• DT Exchange SDK نسخه 8.2.4.

نسخه 8.2.3.0

• آداپتور به‌روزرسانی شده برای استفاده از کلاس جدید VersionInfo .
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 22.0.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 22.0.0.
• DT Exchange SDK نسخه 8.2.3.

نسخه 8.2.2.1

• اضافه شدن پشتیبانی برای ارسال کلید muteVideo در میانجیگری اضافی برای بی صدا کردن تبلیغات بینابینی.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.5.0.
• DT Exchange SDK نسخه 8.2.2.

نسخه 8.2.2.0

• سازگاری تایید شده با DT Exchange SDK 8.2.2.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.5.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.5.0.
• DT Exchange SDK نسخه 8.2.2.

نسخه 8.2.1.0

• نام آداپتور به "DT Exchange" تغییر نام داد.
• سازگاری تایید شده با DT Exchange SDK 8.2.1.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 21.3.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.3.0.
• DT Exchange SDK نسخه 8.2.1.

نسخه 8.2.0.0

• سازگاری تایید شده با Fyber SDK 8.2.0.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.1.0 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.1.0.
• Fyber SDK نسخه 8.2.0.

نسخه 8.1.5.0

• سازگاری تایید شده با Fyber SDK 8.1.5.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.0.0.
• Fyber SDK نسخه 8.1.5.

نسخه 8.1.4.0

• سازگاری تایید شده با Fyber SDK 8.1.4.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.0.0.
• Fyber SDK نسخه 8.1.4.

نسخه 8.1.3.1

• compileSdkVersion و targetSdkVersion را به API 31 به روز کرد.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 21.0.0 به روز کرد.
• حداقل سطح API Android مورد نیاز را به 19 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 21.0.0.
• Fyber SDK نسخه 8.1.3.

نسخه 8.1.3.0

• سازگاری تایید شده با Fyber SDK 8.1.3.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.6.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 20.6.0.
• Fyber SDK نسخه 8.1.3.

نسخه 8.1.2.0

• سازگاری تایید شده با Fyber SDK 8.1.2.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.5.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 20.5.0.
• Fyber SDK نسخه 8.1.2.

نسخه 8.1.0.0

• سازگاری تایید شده با Fyber SDK 8.1.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 20.4.0.
• Fyber SDK نسخه 8.1.0.

نسخه 7.8.4.1

• اگر یک شناسه برنامه تکراری یا بیش از یک منحصر به فرد از پیکربندی‌های میانجی وجود داشته باشد، آداپتور راه‌اندازی نمی‌شود.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.4.0 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 20.4.0.
• Fyber SDK نسخه 7.8.4.

نسخه 7.8.4.0

• سازگاری تایید شده با Fyber SDK 7.8.4.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.3.0 به روز کرد.
• مشکل مربوط به تبلیغات نمایشی با پاداش، که در آن onVideoComplete() فراخوانی نشده بود، برطرف شد.
• اکنون Fyber برای نمایش تبلیغات به یک زمینه فعالیت نیاز دارد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 20.3.0.
• Fyber SDK نسخه 7.8.4.

نسخه 7.8.3.0

• سازگاری تایید شده با Fyber SDK 7.8.3.
• کدها و پیام های خطای استاندارد آداپتور اضافه شده است.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 20.1.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 20.1.0.
• Fyber SDK نسخه 7.8.3.

نسخه 7.8.2.0

• سازگاری تایید شده با Fyber SDK 7.8.2.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 20.0.0 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 20.0.0.
• Fyber SDK نسخه 7.8.2.

نسخه 7.8.1.0

• سازگاری تایید شده با Fyber SDK 7.8.1.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.7.0.
• Fyber SDK نسخه 7.8.1.

نسخه 7.8.0.0

• سازگاری تایید شده با Fyber SDK 7.8.0.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.7.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.7.0.
• Fyber SDK نسخه 7.8.0.

نسخه 7.7.4.0

• سازگاری تایید شده با Fyber SDK 7.7.4.
• مشکلی که در آن onUserEarnedReward() دو بار برای تبلیغات پاداش‌دار ارسال می‌شود، برطرف شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.5.0.
• Fyber SDK نسخه 7.7.4.

نسخه 7.7.3.0

• سازگاری تایید شده با Fyber SDK 7.7.3.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.5.0.
• Fyber SDK نسخه 7.7.3.

نسخه 7.7.2.0

• سازگاری تایید شده با Fyber SDK 7.7.2.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.5.0 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.5.0.
• Fyber SDK نسخه 7.7.2.

نسخه 7.7.1.0

• سازگاری تایید شده با Fyber SDK 7.7.1.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.4.0 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.4.0.
• Fyber SDK نسخه 7.7.1.

نسخه 7.7.0.0

• سازگاری تایید شده با Fyber SDK 7.7.0.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.3.0.
• Fyber SDK نسخه 7.7.0.

نسخه 7.6.1.0

• سازگاری تایید شده با Fyber SDK 7.6.1.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.3.0.
• Fyber SDK نسخه 7.6.1.

نسخه 7.6.0.0

• سازگاری تایید شده با Fyber SDK 7.6.0.
• آداپتور را برای پشتیبانی از درخواست های بنر تطبیقی ​​درون خطی به روز کرد.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.3.0 به روز شد.
• رفع اشکالی که در آن متدهای onAdOpened()/onAdClosed() برای تبلیغات بنری فراخوانی نمی شدند.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.3.0.
• Fyber SDK نسخه 7.6.0.

نسخه 7.5.4.0

• سازگاری تایید شده با Fyber SDK 7.5.4.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 19.1.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.1.0.
• Fyber SDK نسخه 7.5.4.

نسخه 7.5.3.0

• سازگاری تایید شده با Fyber SDK 7.5.3.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.0.1.
• Fyber SDK نسخه 7.5.3.

نسخه 7.5.2.0

• سازگاری تایید شده با Fyber SDK 7.5.2.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK را به 19.0.1 به روز کرد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 19.0.1.
• Fyber SDK نسخه 7.5.2.

نسخه 7.5.0.0

• سازگاری تایید شده با Fyber SDK 7.5.0.
• رفع خرابی NullPointerException در حین بارگذاری تبلیغات Fyber.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 18.3.0.
• Fyber SDK نسخه 7.5.0.

نسخه 7.4.1.0

• سازگاری تایید شده با Fyber SDK 7.4.1.
• حداقل نسخه مورد نیاز Google Mobile Ads SDK به 18.3.0 به روز شد.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 18.3.0.
• Fyber SDK نسخه 7.4.1.

نسخه 7.3.4.0

• انتشار اولیه!
• از تبلیغات بنر، بینابینی و پاداش پشتیبانی می کند.

ساخته و تست شده با:

• Google Mobile Ads SDK نسخه 18.2.0.
• Fyber SDK نسخه 7.3.4.