دمج إعلانات ironSource مع التوسّط

يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من ironSource Ads باستخدام التوسّط: تغطي الشلال عمليات الدمج. وتتناول هذه المقالة كيفية إضافة إعلانات ironSource إلى إعدادات التوسّط وكيفية دمج محوّل وحزمة تطوير البرامج (SDK) لإعلانات ironSource في Flutter تطبيق.

أشكال الإعلانات وعمليات الدمج المتوافقة

يحتوي AdMob محوّل التوسّط لإعلانات ironSource على الإمكانات التالية:

الدمج
عروض الأسعار  1
شلال
التنسيقات
بانر  2
إعلان بيني
تم منح المكافأة
إعلان بيني يضم مكافأة  2

1 تتوفر عملية دمج عروض الأسعار حاليًا. لإصدار تجريبي مغلق، يمكنك التواصل مع مدير حسابك لطلب الإذن بالوصول.

2 هذا التنسيق مخصص فقط مدعومة في دمج العرض الإعلاني بدون انقطاع.

المتطلبات

  • أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • Flutter 3.7.0 أو إصدار أحدث
  • للنشر على Android
    • المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
  • للنشر على iOS
    • الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
  • مشروع Flutter عامل تم إعداده باستخدام Google SDK لإعلانات الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
  • إكمال عملية التوسّط دليل البدء

الخطوة 1: إعداد الإعدادات في واجهة مستخدم ironSource Ads

اشترِك وسجِّل الدخول إلى حسابك على ironSource في "إعلانات Google".

لإضافة تطبيقك إلى لوحة بيانات ironSource، انقر على زر New App (تطبيق جديد).

إدخال تفاصيل التطبيق

اختَر تطبيق مباشر، وأدخِل عنوان URL لتطبيقك، ثم انقر على استيراد معلومات التطبيق.

إذا لم يكن تطبيقك متاحًا، اختَر التطبيق غير متاح في متجر التطبيقات وأدخِل اسمًا مؤقتًا لتطبيقك، ثم اختَر نظامك الأساسي.

املأ البيانات المتبقية في النموذج وانقر على إضافة تطبيق.

دوِّن مفتاح التطبيق الجديد، الذي يتم عرضه بعد إضافة التطبيق. ستحتاج إلى هذه القيمة لإعداد AdMob رقم تعريف وحدتك الإعلانية. اختَر أشكال الإعلانات التي يتيحها تطبيقك وبعد ذلك، انقر على مواصلة.

Android

iOS

إنشاء مثيل

بعد ذلك، اضبط مثيل شبكة للتطبيق الذي أضفته.

عروض الأسعار

انتقِل إلى LevelPlay > الإعداد > شبكات SDK، ثمّ اختَر تطبيقك. ضمن عروض الأسعار، انقر على رمز التعديل لعرض رقم تعريف مثيل عروض الأسعار.

Android

iOS

دوِّن رقم تعريف المثيل.

Android

iOS

شلال

انتقِل إلى الإعلانات > الإعداد > المثيلات. اختَر التطبيق وانقر على إنشاء مثيل.

أدخِل التفاصيل اللازمة، ثم انقر على حفظ وإغلاق.

بعد إنشاء المثيل، يتم إدراج رقم تعريف المثيل في حقل رقم تعريف المثيل.

تحديد موقع مفتاح واجهة برمجة التطبيقات Reporting API

عروض الأسعار

هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.

شلال

بالإضافة إلى مفتاح التطبيق ورقم تعريف المثيل، ستحتاج أيضًا إلى المفتاح السري لإعلانات ironSource والرمز المميز لإعادة التحميل لإعداد AdMob رقم تعريف الوحدة الإعلانية.

انتقِل إلى حسابي في لوحة بيانات الناشر لإعلانات ironSource ثم انقر على علامة التبويب واجهة برمجة التطبيقات. دوِّن المفتاح السري والرمز المميز لإعادة التحميل.

تفعيل وضع الاختبار

اتّبِع التعليمات الواردة في دليل اختبار الدمج لإعلانات ironSource حول كيفية تفعيل الإعلانات التجريبية في ironSource.

الخطوة 2: إعداد طلبات إعلانات ironSource في واجهة المستخدم AdMob

ضبط إعدادات التوسّط لوحدتك الإعلانية

Android

للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

إضافة ironSource Mobile إلى قائمة شركاء الإعلانات بموجب اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية

اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة ironSource Mobile إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.

الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) الخاصة بإعلانات ironSource

الدمج من خلال pub.dev

(نظام التشغيل Android فقط) أضِف المستودعات التالية إلى ملف 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

الدمج اليدوي

تنزيل أحدث إصدار من مكوّن توسّط إعلانات Google على الأجهزة الجوّالة IronSource ، استخراج الملف الذي تم تنزيله وإضافة مجلد المكون الإضافي المستخرج (ومحتوياته) إلى مشروع Flutter ثم راجع المكون الإضافي في pubspec.yaml عن طريق إضافة التبعية التالية:

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

الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) لعرض الإعلانات من ironSource

بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.

مكوّن توسّط إعلانات Google للأجهزة الجوّالة الإضافي لإعلانات ironSource تتضمن GmaMediationIronsource().SetConsent() . يوضح الرمز النموذجي التالي كيفية تمرير معلومات الموافقة على حزمة تطوير البرامج (SDK) لإعلانات ironSource. إذا اخترت الاتصال بهذا الاسم ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال SDK لإعلانات Google على الأجهزة الجوّالة.

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

GmaMediationIronsource().setConsent(true);

اطّلِع على مستندات ironSource Ads على الإعدادات المتقدِّمة للتنظيم لمزيد من التفاصيل.

قوانين الخصوصية في الولايات الأمريكية

الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.

مكوّن توسّط إعلانات Google للأجهزة الجوّالة الإضافي لإعلانات ironSource تتضمن GmaMediationIronsource().setDoNotSell . يوضح الرمز النموذجي التالي كيفية تمرير معلومات الموافقة على حزمة تطوير البرامج (SDK) لإعلانات ironSource. يجب ضبط هذه الخيارات قبل تهيئة إعلانات Google للجوّال حزمة SDK لضمان إعادة توجيههم بشكل صحيح إلى حزمة "SDK لإعلانات ironSource".

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

GmaMediationIronsource().setDoNotSell(true);

اطّلِع على مستندات ironSource Ads في قسم "الإعدادات المتقدمة للّائحة التنظيمية" لكلٍّ من الميزتَين. جهاز Android أو iOS لمزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

الخطوة 5: إضافة الرمز المطلوب

Android

قواعد Proguard

في حال تصغير حجم تطبيقك وتشويشه وتحسينه، تتطلّب إعلانات IronSource قواعد ProGuard إضافية لمشروعك.

استشارة دليل دمج حزمة تطوير البرامج (SDK) لنظام التشغيل Android في IronSource Ads للحصول على المزيد من المعلومات حول قواعد ProGuard المطلوبة لمشروعك وأضِف هذه القواعد إلى ملف proguard-user.txt.

دورة حياة التطبيق

إلغاء الطريقتين onPause() وonResume() في كل من أنشطتك لاستدعاء طرق ironSource Ads المقابلة على النحو التالي:

Java

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

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

Kotlin

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

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

iOS

دمج SKAdNetwork

اتّبِع مستندات إعلانات ironSource لإضافة معرّفات SKAdNetwork إلى لملف Info.plist الخاص بالمشروع.

الخطوة 6: اختبار عملية التنفيذ

تفعيل الإعلانات التجريبية

احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم IronSource .

التحقّق من الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من IronSource ، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام ironSource Ads (Waterfall) مصادر الإعلانات.

رموز الخطأ

وفي حال تعذّر على المحوّل استلام إعلان من إعلانات ironSource، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

Android

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

iOS

GADMAdapterIronSource
GADMAdapterIronSourceRewarded

في ما يلي الرموز والرسائل المرفقة التي طرحتها إعلانات ironSource المحول عند إخفاق تحميل الإعلان:

Android

رمز الخطأ السبب
101 مَعلمات خادم إعلانات ironSource التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة.
102 تتطلب إعلانات ironSource سياقًا للنشاط لإعداد حزمة SDK الخاصة بها.
103 يمكن لإعلانات ironSource تحميل إعلان واحد فقط لكل رقم تعريف لمثيل ironSource.
105 الحجم المطلوب لإعلان البانر غير متوافق مع ironSource Ads.
106 لم يتم إعداد حزمة تطوير البرامج (SDK) لإعلانات ironSource.
501-1056 أخطاء SDK لإعلانات ironSource. الاطّلاع على المستندات لمزيد من التفاصيل.

iOS

رمز الخطأ السبب
101 مَعلمات خادم إعلانات ironSource التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة.
102 لا تتوافق محوّل إعلانات ironSource مع شكل الإعلان المطلوب.
103 سبق أن تم تحميل إعلان ironSource لضبط إعدادات الشبكة هذه.
104 الحجم المطلوب لإعلان البانر غير متوافق مع ironSource Ads.
508-1037 أخطاء SDK لإعلانات ironSource. الاطّلاع على المستندات لمزيد من التفاصيل.

سجلّ تغييرات مهايئ وساطة ironSource Flutter

1.0.0

  • الإصدار الأولي.
  • تم التحقّق من التوافق مع الإصدار 8.0.0.0 من محوّل ironSource لنظام Android.
  • تم التحقّق من التوافق مع الإصدار 8.0.0.0.0 من محوّل ironSource لنظام التشغيل iOS.
  • تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.