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

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

این راهنما به شما نشان می‌دهد که چگونه از GMA Next-Gen SDK برای بارگذاری و نمایش تبلیغات از ironSource Ads با استفاده از میانجیگری استفاده کنید و ادغام‌های آبشاری را پوشش می‌دهد. این راهنما نحوه اضافه کردن 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 برای Ad Manager ایجاد کنید .

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

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

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

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

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

وارد حساب مدیر تبلیغات خود شوید.

به بخش تحویل > گروه‌های بازده بروید و روی دکمه‌ی گروه بازده جدید کلیک کنید.

یک نام منحصر به فرد برای گروه yield خود وارد کنید، وضعیت را روی فعال تنظیم کنید، قالب تبلیغ خود را انتخاب کنید و نوع موجودی را روی برنامه موبایل تنظیم کنید. در قسمت Targeting > Inventory ، واحد تبلیغاتی را که می‌خواهید به آن واسطه‌گری اضافه کنید، در قسمت Inventory and Mobile application انتخاب کنید.

سپس، روی دکمه‌ی «افزودن شریک Yield» کلیک کنید.

اگر از قبل یک شریک Yield برای ironSource Ads دارید، می‌توانید آن را انتخاب کنید. در غیر این صورت، گزینه Create a new yield partner را انتخاب کنید.

ironSource Ads را به عنوان شبکه تبلیغاتی انتخاب کنید، یک نام منحصر به فرد وارد کنید و Mediation را فعال کنید.

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

پس از انتخاب شریک Yield ، در قسمت Integration type گزینه Mobile SDK Mediation ، در قسمت Platform گزینه Android و در قسمت Status گزینه Active را انتخاب کنید. کلید برنامه (App Key) و شناسه نمونه (Instance ID) که در بخش قبل به دست آورده‌اید را وارد کنید. سپس، یک مقدار پیش‌فرض برای هر بار پرداخت (CPM) وارد کنید.

پس از اتمام کار، روی ذخیره در پایین صفحه کلیک کنید.

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

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

مرحله ۳: 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 مراجعه کنید.

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

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

مطمئن شوید که دستگاه آزمایشی خود را برای Ad Manager ثبت کرده‌اید و حالت آزمایشی را در رابط کاربری 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 که در رابط کاربری مدیریت تبلیغات پیکربندی شده‌اند، وجود ندارند/نامعتبر هستند.
۱۰۲ ironSource Ads برای مقداردهی اولیه SDK خود به یک Activity context نیاز دارد.
۱۰۳ تبلیغات ironSource فقط می‌تواند ۱ تبلیغ را به ازای هر شناسه نمونه تبلیغات ironSource بارگذاری کند.
۱۰۵ اندازه بنر تبلیغاتی درخواستی توسط ironSource Ads پشتیبانی نمی‌شود.
۱۰۶ کیت توسعه نرم‌افزاری IronSource Ads مقداردهی اولیه نشده است.
۵۰۱-۱۰۵۶ خطاهای SDK مربوط به تبلیغات ironSource. برای جزئیات بیشتر به مستندات مراجعه کنید.