این راهنما به شما نشان میدهد که چگونه Google Mobile Ads SDK برای بارگذاری و نمایش تبلیغات از DT Exchange با استفاده از AdMob Mediation استفاده کنید و ادغامهای آبشاری را پوشش میدهد. این راهنما نحوه اضافه کردن DT Exchange به پیکربندی میانجیگری یک واحد تبلیغاتی و نحوه ادغام SDK و آداپتور DT در یک برنامه اندروید را پوشش میدهد.
ادغامها و قالبهای تبلیغاتی پشتیبانیشده
آداپتور میانجیگری برای DT Exchange دارای قابلیتهای زیر است:
۱- ادغام پیشنهاد قیمت در مرحله بتای بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.
الزامات
اندروید API سطح ۲۳ یا بالاتر
[برای پیشنهاد قیمت]: برای ادغام تمام قالبهای تبلیغاتی پشتیبانیشده در پیشنهاد قیمت، از آداپتور DT Exchange نسخه ۸.۴.۰.۱ یا بالاتر ( آخرین نسخه توصیه میشود ) استفاده کنید.
پلتفرم و جایگاههای خود را انتخاب کنید، بقیه فرم را پر کنید و سپس روی ایجاد برنامه کلیک کنید.
نامها را وارد کنید و انواع جایگاههای خود را انتخاب کنید. سپس، روی ذخیره جایگاه کلیک کنید.
شناسه برنامه و شناسه قرارگیری
برای باز کردن نوار ناوبری سمت چپ، نشانگر ماوس را روی آن نگه دارید، سپس روی مدیریت برنامه کلیک کنید.
در صفحه مدیریت برنامه ، شناسه برنامه را در کنار برنامه خود یادداشت کنید.
برنامه خود را انتخاب کنید و به برگه Placements بروید. شناسه Placement را یادداشت کنید.
شناسه ناشر، کلید مصرفکننده و راز مصرفکننده
از منوی سمت چپ روی نام کاربری خود کلیک کنید و گزینه پروفایل کاربری را انتخاب کنید.
شناسه ناشر ، کلید مصرفکننده و راز مصرفکننده را یادداشت کنید زیرا در مرحله بعدی به آنها نیاز خواهید داشت.
فایل app-ads.txt خود را بهروزرسانی کنید.
فروشندگان مجاز برنامهها app-ads.txt یک ابتکار آزمایشگاه فناوری IAB است که به شما کمک میکند تا موجودی تبلیغات برنامه خود را فقط از طریق کانالهایی که به عنوان مجاز شناسایی کردهاید، به فروش برسانید. برای جلوگیری از کاهش قابل توجه درآمد تبلیغات، باید یک فایل app-ads.txt پیادهسازی کنید. اگر قبلاً این کار را نکردهاید، یک فایل 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 دارید، میتوانید آن را انتخاب کنید. در غیر این صورت، روی افزودن نگاشت کلیک کنید.
در مرحله بعد، شناسه برنامه و شناسه قرارگیری که در بخش قبل به دست آوردهاید را وارد کنید. سپس روی «انجام شد» کلیک کنید.
آبشار در زیر کارت 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 سطح برنامه خود، وابستگیهای پیادهسازی زیر را اضافه کنید:
آخرین نسخه DT SDK را برای اندروید دانلود کنید و fyber-marketplace-xyzaar را به پروژه خود اضافه کنید.
به مصنوعات آداپتور DT Exchange در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور DT Exchange را دانلود کنید و آن را به پروژه خود اضافه کنید.
مرحله ۴: تنظیمات حریم خصوصی را روی DT SDK پیادهسازی کنید رضایت اتحادیه اروپا و GDPR
برای رعایت سیاست رضایت کاربر اتحادیه اروپا گوگل ، شما باید اطلاعات خاصی را در اختیار کاربران خود در منطقه اقتصادی اروپا (EEA)، بریتانیا و سوئیس قرار دهید و رضایت آنها را برای استفاده از کوکیها یا سایر ذخیرهسازیهای محلی در صورت لزوم قانونی، و برای جمعآوری، اشتراکگذاری و استفاده از دادههای شخصی برای شخصیسازی تبلیغات، دریافت کنید. این سیاست منعکسکننده الزامات دستورالعمل حریم خصوصی الکترونیکی اتحادیه اروپا و مقررات عمومی حفاظت از دادهها (GDPR) است. شما مسئول تأیید انتشار رضایت به هر منبع تبلیغاتی در زنجیره واسطهگری خود هستید. گوگل قادر نیست رضایت کاربر را به طور خودکار به چنین شبکههایی منتقل کند.
از نسخه ۸.۳.۰ کیت توسعه نرمافزاری DT Exchange، DT Exchange بهطور خودکار رضایتنامه GDPR تنظیمشده توسط پلتفرمهای مدیریت رضایتنامه که از مشخصات رضایتنامه اضافی گوگل پشتیبانی میکنند را میخواند. برای اطلاعات بیشتر، به راهنمای پیادهسازی GDPR در DT Exchange مراجعه کنید.
قوانین حفظ حریم خصوصی ایالتهای آمریکا
قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، به کاربران حق انصراف از «فروش» «اطلاعات شخصی» خود (همانطور که قانون این اصطلاحات را تعریف میکند) را میدهد، و این انصراف از طریق پیوند برجسته «اطلاعات شخصی من را نفروشید» در صفحه اصلی طرف «فروشنده» ارائه میشود. راهنمای انطباق با قوانین حفظ حریم خصوصی ایالتهای ایالات متحده ، امکان فعال کردن پردازش دادههای محدود برای سرویس تبلیغات گوگل را ارائه میدهد، اما گوگل قادر به اعمال این تنظیم برای هر شبکه تبلیغاتی در زنجیره واسطهگری شما نیست. بنابراین، شما باید هر شبکه تبلیغاتی را در زنجیره واسطهگری خود که ممکن است در فروش اطلاعات شخصی شرکت کند، شناسایی کنید و برای اطمینان از انطباق، از راهنماییهای هر یک از این شبکهها پیروی کنید.
DT Exchange حاوی یک API است که به شما امکان میدهد رضایت کاربر را به SDK آنها ارسال کنید. نمونه کد زیر نحوه ارسال دستی اطلاعات رضایت به DT SDK را نشان میدهد. اگر تصمیم دارید اطلاعات رضایت را به صورت دستی به DT SDK ارسال کنید، توصیه میشود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK ، این کد فراخوانی شود.
برای تأیید اینکه تبلیغات آزمایشی را از DT Exchange دریافت میکنید، آزمایش منبع تبلیغاتی واحد را در بازرس تبلیغات با استفاده از منبع(های) تبلیغاتی DT Exchange (Bidding) و DT Exchange (Waterfall) فعال کنید.
مراحل اختیاری پارامترهای خاص شبکه
آداپتور DT Exchange از پارامترهای درخواست اضافی پشتیبانی میکند که میتوانند به عنوان یک Android Bundle به آداپتور منتقل شوند. آداپتور به دنبال کلیدهای زیر در بسته میگردد:
درخواست پارامترها و مقادیر
InneractiveMediationDefs.KEY_AGE
عدد صحیح . سن کاربر
FyberMediationAdapter.KEY_MUTE_VIDEO
بولی . بیصدا یا بیصدا کردن ویدیو
در اینجا یک مثال کد از نحوه تنظیم این پارامترهای درخواست تبلیغ آورده شده است:
اگر آداپتور نتواند تبلیغی از DT Exchange دریافت کند، میتوانید خطای اساسی را از پاسخ تبلیغ با استفاده ResponseInfo.getAdapterResponses() تحت کلاس زیر بررسی کنید:
تاریخ آخرین بهروزرسانی 2026-01-18 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-01-18 بهوقت ساعت هماهنگ جهانی."],[],["Integrate DT Exchange ads into Android apps via AdMob mediation by configuring both DT Exchange and AdMob UIs. Retrieve necessary IDs (App, Placement, Publisher, Consumer Key/Secret) from DT Exchange. In AdMob, create a mediation group, add DT Exchange as an ad source, and provide its credentials. Integrate the DT Exchange SDK and adapter into your Android project. Handle GDPR and US privacy settings using provided methods. No additional code is needed for basic integration. Test and verify ad delivery before releasing the app.\n"]]