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

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

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

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

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

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

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

الشروط

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

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

اشترِك وسجِّل الدخول إلى حسابك على 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، عليك التأكّد من الإفصاح عن معلومات محدّدة للمستخدمين في المنطقة الاقتصادية الأوروبية والحصول على موافقات منهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتّحاد الأوروبي. عند طلب الحصول على موافقة، يجب عليك تحديد كل شبكة إعلانات في سلسلة التوسط قد تجمع البيانات الشخصية أو تتلقاها أو تستخدمها، وتقدم معلومات عن استخدام كل شبكة. ولا يمكن لشركة Google حاليًا تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.

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

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

GmaMediationIronsource().setConsent(true);

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

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

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

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

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

GmaMediationIronsource().setDoNotSell(true);

يمكنك الاطّلاع على مستندات ironSource في مقالة "الإعدادات المتقدّمة للتنظيم" لكل من Android وiOS لمعرفة المزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

Android

قواعد Proguard

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

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

مراحل نشاط التطبيق

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

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.
106 لم يتم إعداد حزمة تطوير البرامج (SDK) لإعلانات ironSource.
501-1056 أخطاء ironSource في حزمة تطوير البرامج (SDK) لعرض الإعلانات يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.

iOS

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

سجلّ تغييرات محوّل توسّط Flutter في ironSource

1.0.0

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