يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من AppLovin باستخدام التوسّط التي تغطي عمليات دمج كلّ من عروض الأسعار والعرض الإعلاني بدون انقطاع يتناول الفيديو كيفية إضافة AppLovin مع ضبط التوسّط لوحدة إعلانية معيّنة، وكيفية دمج AppLovin SDK ومحوّل إلى تطبيق Flutter
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن AdMob محوّل التوسّط في AppLovin الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | 1 |
إعلان بيني | |
تم منح المكافأة |
إعلانات البانر (باستثناء مجلس MREC إعلانات البانر) متاحة في التوسّط فقط. لا تتيح عروض الأسعار أي نوع من إعلانات البانر
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Flutter عامل تم إعداده باستخدام Google SDK لإعلانات الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: ضبط الإعدادات في واجهة مستخدم AppLovin
اشترِك أو سجِّل الدخول إلى حسابك على AppLovin.
لإعداد AdMob وحدتك الإعلانية، ستحتاج إلى مفتاح حزمة تطوير البرامج (SDK) AppLovin ومفتاح التقرير. للعثور عليها، انتقِل إلى واجهة مستخدم AppLovin > الحساب > المفاتيح لعرض كلا القيمتَين.
إذا كنت تخطط لدمج عروض الأسعار فقط، يمكنك المتابعة من أجل ضبط إعدادات التوسّط.
اختيار تطبيق للتوسّط
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
في واجهة مستخدم AppLovin، اختَر التطبيقات ضمن قسم تحقيق الربح للوصول إلى تطبيقاتك المسجَّلة. اختَر التطبيق الذي تريد استخدامه مع التوسّط من قائمة التطبيقات المتاحة
إنشاء منطقة
عروض الأسعار
هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.
شلال
في واجهة مستخدم AppLovin، اختَر المناطق ضمن قسم تحقيق الربح للوصول إلى أرقام تعريف المناطق المسجّلة. وإذا سبق لك إنشاء المناطق المطلوبة لتطبيقك، انتقِل إلى الخطوة 2. لإنشاء رقم تعريف منطقة جديد، انقر على إنشاء منطقة.
أدخِل اسم رقم تعريف المنطقة، واختَر Android باعتباره النظام الأساسي، ثم اختَر نوع الإعلان.
يمكنك ضبط التسعير للمنطقة من خلال اختيار التكلفة الثابتة لكل ألف ظهور أو محسَّن من خلال AppLovin. يمكن ضبط التكلفة لكل ألف ظهور على أساس كل بلد لخيار التكلفة الثابتة لكل ألف ظهور. انقر بعد ذلك على حفظ.
Android
iOS
بعد إنشاء المنطقة، يمكن العثور على رقم تعريف المنطقة ضمن عمود رقم تعريف المنطقة.
Android
iOS
تفعيل وضع الاختبار
اتّبِع التعليمات الواردة في وضع الاختبار الأقصى حول كيفية تفعيل الإعلانات الاختبارية في AppLovin.
الخطوة 2: إعداد طلبات AppLovin في واجهة مستخدم AdMob
ضبط إعدادات التوسّط لوحدتك الإعلانية
Android
للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.
iOS
للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.
إضافة AppLovin Corp. إلى قائمة شركاء الإعلانات بشأن اللائحة العامة لحماية البيانات (GDPR) واللوائح السارية في الولايات الأمريكية
اتّبِع الخطوات الواردة في إعدادات اللائحة العامة لحماية البيانات و إعدادات اللوائح السارية في الولايات الأمريكية لإضافة AppLovin Corp. إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في AdMob واجهة المستخدم.
الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوّل AppLovin
الدمج من خلال pub.dev
أضف التبعية التالية مع أحدث إصدارات
AppLovin حزمة تطوير البرامج (SDK) والمحوّل في حزمتك
ملف pubspec.yaml
:
dependencies:
gma_mediation_applovin: ^1.0.0
الدمج اليدوي
تنزيل أحدث إصدار من مكوّن توسّط إعلانات Google على الأجهزة الجوّالة
AppLovin،
استخراج الملف الذي تم تنزيله وإضافة مجلد المكون الإضافي المستخرج
(ومحتوياته) إلى مشروع Flutter ثم راجع المكون الإضافي في
pubspec.yaml
عن طريق إضافة التبعية التالية:
dependencies:
gma_mediation_applovin:
path: path/to/local/package
الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) من AppLovin
موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
يتيح تطبيق AppLovin قراءة سلسلة الموافقة من الإعدادات المفضّلة والإعدادات المشتركة. وحالة الموافقة وفقًا لذلكإذا كنت
عدم استخدام منصّة إدارة موافقة تكتب سلسلة الموافقة في
والتفضيلات، فيمكنك استخدام
GmaMediationApplovin.setHasUserConsent()
و
GmaMediationApplovin.setIsAgeRestrictedUser()
الطرق. يوضح الرمز النموذجي التالي كيفية
لتمرير معلومات الموافقة إلى حزمة AppLovin SDK يجب ضبط هذه الخيارات
قبل إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
لضمان إعادة توجيههم بشكل صحيح إلى AppLovin SDK.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setHasUserConsent(true);
GmaMediationApplovin.setIsAgeRestrictedUser(true);
الاطّلاع على إعدادات خصوصية AppLovin لمزيد من المعلومات.
قوانين الخصوصية في الولايات الأمريكية
الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.
مكوّن توسّط إعلانات Google للأجهزة الجوّالة الإضافي لمنصة AppLovin
تتضمن
GmaMediationApplovin.setDoNotSell()
. يوضح الرمز النموذجي التالي كيفية تمرير
الموافقة على إضافة حزمة AppLovin SDK يجب تعيين هذه الخيارات قبل
بدء إعلانات Google للأجهزة الجوّالة
حزمة SDK
لضمان إعادة توجيههم بشكل صحيح إلى AppLovin SDK.
import 'package:gma_mediation_applovin/gma_mediation_applovin.dart';
// ...
GmaMediationApplovin.setDoNotSell(true);
الاطّلاع على خصوصية AppLovin المستندات لمزيد من المعلومات.
الخطوة 5: إضافة الرمز المطلوب
Android
ما مِن رمز إضافي مطلوب لدمج AppLovin.
iOS
دمج SKAdNetwork
اتّباع مستندات AppLovin لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 6: اختبار عملية التنفيذ
تفعيل الإعلانات التجريبية
احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم AppLovin .
التحقّق من الإعلانات الاختبارية
للتأكّد من أنّك تتلقّى إعلانات اختبارية من AppLovin، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام AppLovin (Bidding) and AppLovin (Waterfall) مصادر الإعلانات.
خطوات اختيارية
المَعلمات الخاصة بالشبكة
يتيح محوّل AppLovin تمرير عنصر AppLovinMediationExtras
إلى
طلب إعلان لتعيين معلمات مخصصة للشبكة. يعرض الرمز النموذجي التالي
كيفية إيقاف الصوت في إعلانات الفيديو باستخدام مَعلمة isMuted
:
AppLovinMediationExtras applovinExtras = AppLovinMediationExtras(isMuted: true)
AdRequest request = AdRequest(
keywords: <String>['foo', 'bar'],
contentUrl: 'http://foo.com/bar.html',
mediationExtras: [applovinExtras],
);
تحسينات
جارٍ إضافة مكالمة إلى
GmaMediationApplovin.initializeSdk('sdkKey')
لنشاط الإطلاق لديك
بإمكان AppLovin تتبُّع الأحداث فور بدء التطبيق.
رموز الخطأ
وإذا تعذّر على المحوّل تلقّي إعلان من AppLovin،
يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام
ResponseInfo
ضمن
الفئات التالية:
Android
com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter
iOS
GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin
في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل AppLovin عند تعذّر تحميل إعلان:
Android
رمز الخطأ | السبب |
---|---|
من -1009 إلى -1، 204 | عرَضَت حزمة AppLovin SDK خطأً. عرض مستندات AppLovin لمزيد من التفاصيل. |
101 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع AppLovin. |
103 | السياق فارغ. |
104 | الرمز المميّز لعرض سعر AppLovin فارغ. |
105 | طلبت إعلانات متعددة للمنطقة نفسها. يمكن لتطبيق AppLovin تحميل إعلان واحد فقط في الوقت لكل منطقة. |
106 | الإعلان غير جاهز للعرض. |
108 | لا تتوافق محوّل AppLovin مع شكل الإعلان المطلوب. |
iOS
رمز الخطأ | السبب |
---|---|
من -1009 إلى -1، 204 | عرَضَت حزمة AppLovin SDK خطأً. الاطّلاع على مستندات AppLovin لمزيد من التفاصيل. |
101 | لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع AppLovin. |
102 | مَعلمات خادم AppLovin التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة. |
103 | تعذّر عرض إعلان AppLovin. |
104 | طلبت إعلانات متعددة للمنطقة نفسها. يمكن لتطبيق AppLovin تحميل إعلان واحد فقط في الوقت لكل منطقة. |
105 | لم يتم العثور على مفتاح AppLovin SDK. |
107 | الرمز المميز لعرض السعر فارغ. |
108 | لا تتوافق محوّل AppLovin مع شكل الإعلان المطلوب. |
110 | أرسلت AppLovin معاودة الاتصال بنجاح لتحميل المحتوى ولكن لم تُحمِّل أي إعلانات. |
سجلّ تغييرات محوّل توسّط AppLovin Flutter
1.1.0
- لم تعُد واجهة برمجة التطبيقات GmaMediationAppovin ثابتة.
- تم التحقّق من التوافق مع الإصدار 12.4.3.0 لمحوّل AppLovin لأجهزة Android.
- تم التحقّق من التوافق مع الإصدار 12.4.2.0 لمحوّل AppLovin iOS.
- تم إنشاء هذا البرنامج واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.
1.0.0
- الإصدار الأولي.
- تم التحقّق من التوافق مع الإصدار 12.3.0.0 لمحوّل AppLovin Android.
- تم التحقّق من التوافق مع الإصدار 12.2.1.0 لمحوّل AppLovin iOS.
- تم إنشاء هذا المكوّن الإضافي واختباره باستخدام الإصدار 5.0.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.