يوضِّح لك هذا الدليل كيفية استخدام "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.