IronSource را با میانجیگری ادغام کنید

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

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

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

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

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

۱ این قالب فقط در یکپارچه‌سازی آبشاری پشتیبانی می‌شود.

الزامات

  • اندروید API سطح ۲۴ یا بالاتر
  • [برای پیشنهاد قیمت]: برای ادغام تمام قالب‌های تبلیغاتی پشتیبانی‌شده در پیشنهاد قیمت، از آداپتور IronSource نسخه ۸.۵.۰.۱ یا بالاتر استفاده کنید ( آخرین نسخه توصیه می‌شود )

مرحله ۱: تنظیمات را در رابط کاربری ironSource Ads تنظیم کنید

ثبت نام کنید و وارد حساب کاربری خود در ironSource Ads شوید .

اضافه کردن یک برنامه جدید

برای افزودن یک برنامه جدید، به تبلیغات > برنامه‌ها بروید و روی افزودن برنامه کلیک کنید.

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

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

یک نمونه ایجاد کنید

در مرحله بعد، یک نمونه برای برنامه‌ای که اضافه کرده‌اید پیکربندی کنید.

به تبلیغات > تنظیمات > نمونه‌ها بروید. برنامه را انتخاب کنید و روی ایجاد نمونه کلیک کنید.

مناقصه

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

به شناسه نمونه (Instance ID) توجه کنید.

آبشار

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

به شناسه نمونه (Instance ID) توجه کنید.

کلید API گزارش‌دهی خود را پیدا کنید

مناقصه

این مرحله برای ادغام‌های پیشنهاد قیمت لازم نیست.

آبشار

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

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

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

برای پیاده‌سازی app-ads.txt برای ironSource، به فروشندگان مجاز ironSource مراجعه کنید.

حالت تست را روشن کنید

دستورالعمل‌های موجود در راهنمای تست ادغام ironSource Ads را در مورد نحوه فعال‌سازی تبلیغات آزمایشی ironSource Ads دنبال کنید.

مرحله ۲: تنظیم تقاضای تبلیغات ironSource در رابط کاربری AdMob

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

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

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

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

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

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

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

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

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

مناقصه


در زیر کارت پیشنهاد قیمت در بخش منابع تبلیغات ، گزینه افزودن منبع تبلیغات (Add ad source) را انتخاب کنید. سپس ironSource Ads را انتخاب کنید.

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



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



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



در مرحله بعد، کلید برنامه (App Key) و شناسه نمونه (Instance ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.



آبشار


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

ironSource Ads را انتخاب کنید و سوئیچ Optimize را فعال کنید. کلید مخفی و توکن به‌روزرسانی (Refresh Token) که در بخش قبل به دست آوردید را وارد کنید تا بهینه‌سازی منبع تبلیغات برای ironSource Ads تنظیم شود. سپس یک مقدار eCPM برای ironSource Ads وارد کنید و روی ادامه کلیک کنید.



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

در مرحله بعد، کلید برنامه (App Key) و شناسه نمونه (Instance ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس روی «انجام شد» (Done) کلیک کنید.


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

برای اضافه کردن ironSource Mobile به فهرست شرکای تبلیغاتی مقررات ایالتی اروپا و ایالات متحده در رابط کاربری AdMob، مراحل موجود در تنظیمات مقررات اروپا و تنظیمات مقررات ایالت ایالات متحده را دنبال کنید.

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

در فایل settings.gradle.kts در سطح پروژه، مخازن زیر را اضافه کنید:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

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

کاتلین 

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

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:ironsource:9.3.0.1'
}

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

ادغام دستی

  1. آخرین نسخه ironSource Ads Android SDK را دانلود کرده و به پروژه خود اضافه کنید.

  2. به مصنوعات آداپتور IronSource Ads در مخزن Maven گوگل بروید. آخرین نسخه را انتخاب کنید، فایل .aar آداپتور IronSource را دانلود کنید و آن را به پروژه خود اضافه کنید.

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

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

با شروع از IronSource SDK نسخه ۷.۷.۰، ironSource به طور خودکار رضایت GDPR تنظیم شده توسط پلتفرم‌های مدیریت رضایت که از مشخصات رضایت اضافی گوگل ، از جمله UMP SDK ، پشتیبانی می‌کنند را می‌خواند. برای اطلاعات بیشتر، به پشتیبانی از UMP و CMPهای گوگل که از رضایت اضافی گوگل پشتیبانی می‌کنند ، مراجعه کنید.

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

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

در نسخه ۶.۱۴.۰ از SDK، شرکت ironSource Ads یک API برای پشتیبانی از مقررات CCPA اضافه کرده است. نمونه کد زیر نحوه ارسال این اطلاعات رضایت به ironSource Ads SDK را نشان می‌دهد. این گزینه‌ها باید قبل از راه‌اندازی GMA Next-Gen SDK تنظیم شوند تا از ارسال صحیح آنها به ironSource Ads SDK اطمینان حاصل شود.

جاوا 

LevelPlay.setMetaData("do_not_sell", "true");
IronSourceMediationSnippets.java

کاتلین 

LevelPlay.setMetaData("do_not_sell", "true")
IronSourceMediationSnippets.kt

برای جزئیات بیشتر و مقادیری که می‌توان در این روش ارائه داد، به مستندات ironSource Ads در مورد تنظیمات پیشرفته‌ی مقررات مراجعه کنید.

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

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

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

قوانین پروگارد

اگر برنامه خود را کوچک، مبهم و بهینه کنید ، ironSource Ads به قوانین ProGuard اضافی برای پروژه شما نیاز دارد. برای اطلاعات بیشتر به راهنمای ادغام SDK اندروید ironSource Ads مراجعه کنید.

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای AdMob ثبت کرده‌اید و حالت آزمایشی را در رابط کاربری ironSource Ads فعال کرده‌اید .

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

برای تأیید اینکه تبلیغات آزمایشی را از ironSource Ads دریافت می‌کنید، آزمایش منبع تبلیغاتی تکی را در ad inspector با استفاده از منبع(های) تبلیغاتی ironSource Ads (پیشنهاد) و ironSource Ads (آبشاری ) فعال کنید.

کدهای خطا

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

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

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

کد خطا دلیل
۱۰۱ پارامترهای سرور ironSource Ads که در رابط کاربری AdMob پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ ironSource Ads برای مقداردهی اولیه SDK خود به یک Activity context نیاز دارد.
۱۰۳ تبلیغات ironSource فقط می‌تواند ۱ تبلیغ را به ازای هر شناسه نمونه تبلیغات ironSource بارگذاری کند.
۱۰۵ اندازه بنر تبلیغاتی درخواستی توسط ironSource Ads پشتیبانی نمی‌شود.
۱۰۶ کیت توسعه نرم‌افزاری IronSource Ads مقداردهی اولیه نشده است.
۵۰۱-۱۰۵۶ خطاهای SDK مربوط به تبلیغات ironSource. برای جزئیات بیشتر به مستندات مراجعه کنید.