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

این راهنما به شما نشان می‌دهد که چگونه از Google Mobile Ads SDK برای بارگیری و نمایش تبلیغات از ironSource Ads با استفاده از میانجی‌گری استفاده کنید که ادغام‌های آبشار را پوشش می‌دهد. نحوه افزودن ironSource Ads به پیکربندی میانجی واحد تبلیغات و نحوه ادغام ironSource Ads SDK و آداپتور در یک Flutter برنامه

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

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

یکپارچه سازی
مناقصه 1
آبشار
فرمت ها
بنر 2
بینابینی
پاداش داده شد
بینابینی پاداش 2

1 ادغام مناقصه در نسخه آزمایشی بسته است، برای درخواست دسترسی با مدیر حساب خود تماس بگیرید.

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

الزامات

  • جدیدترین SDK تبلیغات موبایل گوگل
  • فلاتر 3.7.0 یا بالاتر
  • برای استقرار در اندروید
    • Android API سطح 21 یا بالاتر
  • برای استقرار در iOS
    • هدف استقرار iOS 12.0 یا بالاتر
  • یک کار Flutter پروژه با Google Mobile Ads SDK پیکربندی شده است. برای جزئیات بیشتر به شروع به کار مراجعه کنید.
  • راهنمای شروع میانجیگری را کامل کنید

مرحله 1: تنظیمات را در ironSource Ads UI تنظیم کنید

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

برای افزودن برنامه خود به داشبورد ironSource Ads، روی دکمه New App کلیک کنید.

جزئیات برنامه را وارد کنید

برنامه زنده را انتخاب کنید، برنامه خود را وارد کنید و روی وارد کردن اطلاعات برنامه کلیک کنید.

اگر برنامه شما در دسترس نیست، App Not Live را در Application Store انتخاب کنید و یک نام موقت برای برنامه خود وارد کنید. پلتفرم خود را انتخاب کنید.

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

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

اندروید

iOS

ایجاد نمونه

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

مناقصه

به LevelPlay > Setup > SDK networks بروید، سپس برنامه خود را انتخاب کنید. در بخش Bidding ، روی نماد ویرایش کلیک کنید تا شناسه نمونه پیشنهادی را مشاهده کنید.

اندروید

iOS

شناسه نمونه را یادداشت کنید.

اندروید

iOS

آبشار

به Ads > Setup > Instances بروید. برنامه را انتخاب کنید و روی Create Instance کلیک کنید.

جزئیات لازم را وارد کنید و روی ذخیره و بستن کلیک کنید.

پس از ایجاد نمونه، شناسه نمونه در قسمت Instance ID فهرست می‌شود.

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

مناقصه

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

آبشار

علاوه بر کلید برنامه و شناسه نمونه ، برای تنظیم شناسه واحد تبلیغات AdMob خود به کلید مخفی تبلیغات ironSource و Refresh Token نیز نیاز دارید.

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

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

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

مرحله 2: تقاضای ironSource Ads را تنظیم کنید Ad Manager UI

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

اندروید

برای دستورالعمل ها، مرحله 2 را در راهنما ببینیداندروید .

iOS

برای دستورالعمل ها، مرحله 2 را در راهنما ببینیدiOS .

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

برای افزودن ironSource Mobile به فهرست شرکای آگهی GDPR و مقررات ایالتی ایالات متحده در رابط کاربری AdMob، مراحل تنظیمات GDPR و تنظیمات مقررات ایالتی ایالات متحده را دنبال کنید.

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

ادغام از طریق pub.dev

(فقط اندروید) مخازن زیر را به فایل build.gradle داخل فهرست android پروژه خود اضافه کنید:

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

وابستگی زیر را با آخرین نسخه های آن اضافه کنیدironSource SDK و آداپتور در فایل pubspec.yaml بسته شما:

dependencies:
  gma_mediation_ironsource: ^1.0.0

ادغام دستی

دانلود آخرین نسخه افزونه میانجی تبلیغات موبایل گوگل برایironSource ، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه فلاتر خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package
،

ادغام از طریق pub.dev

(فقط اندروید) مخازن زیر را به فایل build.gradle داخل فهرست android پروژه خود اضافه کنید:

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

وابستگی زیر را با آخرین نسخه های آن اضافه کنیدironSource SDK و آداپتور در فایل pubspec.yaml بسته شما:

dependencies:
  gma_mediation_ironsource: ^1.0.0

ادغام دستی

دانلود آخرین نسخه افزونه میانجی تبلیغات موبایل گوگل برایironSource ، فایل دانلود شده را استخراج کنید و پوشه افزونه استخراج شده (و محتویات آن) را به پروژه فلاتر خود اضافه کنید. سپس با افزودن وابستگی زیر به پلاگین موجود در فایل pubspec.yaml خود مراجعه کنید:

dependencies:
  gma_mediation_ironsource:
    path: path/to/local/package

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

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

افزونه میانجیگری تبلیغات موبایل گوگل برای ironSource AdsشاملGmaMediationIronsource().SetConsent()روش کد نمونه زیر نحوه ارسال اطلاعات رضایت را به ironSource Ads SDK نشان می دهد. اگر تصمیم به فراخوانی این روش دارید، توصیه می‌شود قبل از درخواست تبلیغات از طریق Google Mobile Ads SDK این کار را انجام دهید. 

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setConsent(true);

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

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

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

افزونه میانجیگری تبلیغات موبایل گوگل برای ironSource AdsشاملGmaMediationIronsource().setDoNotSellروش کد نمونه زیر نحوه ارسال اطلاعات رضایت را به ironSource Ads SDK نشان می دهد. این گزینه‌ها باید قبل از راه‌اندازی SDK تبلیغات موبایلی Google تنظیم شوند تا مطمئن شوید که به درستی به ironSource Ads SDK منتقل می‌شوند. 

import 'package:gma_mediation_ironsource/gma_mediation_ironsource.dart';
// ...

GmaMediationIronsource().setDoNotSell(true);

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

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

اندروید

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

اگر برنامه خود را کوچک، مبهم و بهینه کنید ، IronSource Ads به قوانین ProGuard اضافی برای پروژه شما نیاز دارد.

برای اطلاعات بیشتر در مورد قوانین ProGuard که برای پروژه شما لازم است، با راهنمای ادغام Android SDK Ads IronSource Ads مشورت کنید و آن قوانین را به فایل proguard-user.txt خود اضافه کنید.

چرخه عمر برنامه

روش‌های onPause() و onResume() را در هر یک از فعالیت‌های خود لغو کنید تا متدهای ironSource Ads مربوطه را به شرح زیر فراخوانی کنید:

جاوا 

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

کاتلین 

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

iOS

ادغام SKAdNetwork

برای افزودن شناسه های SKAdNetwork به فایل Info.plist پروژه خود ، مستندات ironSource Ads را دنبال کنید.

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

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

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

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

برای تأیید اینکه آگهی‌های آزمایشی را از ironSource Ads دریافت می‌کنید، با استفاده از منابع آگهی ironSource Ads (مناقصه) و ironSource Ads (Waterfall) آزمایش منبع آگهی را در بازرس آگهی فعال کنید.

کدهای خطا

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

اندروید 

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

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

اندروید

کد خطا دلیل
101 ironSource Ads پارامترهای سرور پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است.
102 ironSource Ads برای مقداردهی اولیه SDK خود به یک زمینه فعالیت نیاز دارد.
103 تبلیغات ironSource فقط می تواند 1 تبلیغ را در هر شناسه نمونه ironSource بارگیری کند.
105 اندازه آگهی بنر درخواستی توسط ironSource Ads پشتیبانی نمی شود.
106 ironSource Ads SDK راه اندازی نشده است.
501-1056 خطاهای ironSource Ads SDK. برای جزئیات بیشتر به مستندات مراجعه کنید.

iOS

کد خطا دلیل
101 ironSource Ads پارامترهای سرور پیکربندی شده در Ad Manager رابط کاربری موجود نیست/نامعتبر است.
102 آداپتور تبلیغات ironSource از قالب آگهی درخواستی پشتیبانی نمی کند.
103 یک تبلیغ ironSource قبلاً برای این پیکربندی شبکه بارگیری شده است.
104 اندازه آگهی بنر درخواستی توسط ironSource Ads پشتیبانی نمی شود.
508-1037 خطاهای ironSource Ads SDK. برای جزئیات بیشتر به مستندات مراجعه کنید.

IronSource Flutter Mediation Adapter Changelog

نسخه بعدی

  • ساخته و آزمایش شده با Google Mobile Ads Flutter Plugin نسخه 5.2.0.

1.1.0

  • سازگاری تایید شده با آداپتور اندروید ironSource نسخه 8.2.1.0
  • سازگاری تأیید شده با آداپتور iOS ironSource نسخه 8.2.0.0.0
  • با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.

1.0.0

  • انتشار اولیه
  • سازگاری تأیید شده با آداپتور ironSource اندروید نسخه 8.0.0.0
  • سازگاری تأیید شده با آداپتور iOS ironSource نسخه 8.0.0.0.0
  • با افزونه Flutter Ads Google Mobile نسخه 5.1.0 ساخته و آزمایش شده است.