يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" من أجل تحميل وعرض الإعلانات من AppLovin باستخدام التوسّط، ويشمل ذلك عمليات دمج عروض الأسعار والعرض الإعلاني بدون انقطاع. كما يتناول كيفية إضافة AppLovin إلى إعدادات التوسّط في وحدة إعلانية معيَّنة وكيفية دمج حزمة تطوير البرامج AppLovin والمحوّل في Flutter تطبيق.
عمليات الدمج وأشكال الإعلانات المتوافقة
يوفّر AdMob محوِّل التوسّط في AppLovin الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | 1 |
إعلان بيني | |
تم منح المكافأة |
يُسمح باستخدام إعلانات البانر (باستثناء إعلانات البانر MREC) في التوسّط فقط. لا تدعم عروض الأسعار أي نوع من إعلانات البانر
المتطلّبات
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android:
- المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
- للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
- مشروع Flutter يعمل باستخدام حزمة SDK لإعلانات Google على الأجهزة الجوّالة. يمكنك الاطّلاع على البدء للحصول على مزيد من التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 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، عليك التأكّد من الإفصاح عن معلومات محدّدة للمستخدمين في المنطقة الاقتصادية الأوروبية والحصول على موافقات منهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتّحاد الأوروبي. عند طلب الحصول على موافقة، يجب عليك تحديد كل شبكة إعلانات في سلسلة التوسط قد تجمع البيانات الشخصية أو تتلقاها أو تستخدمها، وتقدم معلومات عن استخدام كل شبكة. ولا يمكن لشركة Google حاليًا تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
يتيح AppLovin قراءة سلسلة الموافقة من الإعدادات المفضّلة المشتركة وضبط حالة الموافقة وفقًا لذلك.في حال
عدم استخدام منصّة إدارة موافقة (CMP) لكتابة سلسلة الموافقة في الإعدادات المفضّلة
المشتركة، يمكنك استخدام طريقتَي
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. ويجب ضبط هذه الخيارات قبل إعداد حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة لضمان إعادة توجيهها بشكل صحيح إلى حزمة 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 | حدث خطأ في حزمة تطوير البرامج (SDK) الخاصة بـ AppLovin. يمكنك الاطّلاع على مستندات AppLovin للحصول على مزيد من التفاصيل. |
101 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع AppLovin. |
103 | السياق فارغ. |
104 | الرمز المميّز لعرض السعر AppLovin فارغ. |
105 | تم طلب إعلانات متعددة للمنطقة نفسها. يمكن لتطبيق AppLovin تحميل إعلان واحد فقط في كل مرة لكل منطقة. |
106 | الإعلان غير جاهز للعرض. |
108 | لا تتوافق محوّل AppLovin مع شكل الإعلان المطلوب. |
iOS
رمز الخطأ | السبب |
---|---|
-1009 إلى -1، 204 | حدث خطأ في حزمة تطوير البرامج (SDK) الخاصة بـ AppLovin. يمكنك الاطّلاع على مستندات AppLovin للحصول على مزيد من التفاصيل. |
101 | لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع AppLovin. |
102 | مَعلمات خادم AppLovin التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة |
103 | تعذَّر عرض إعلان AppLovin. |
104 | تم طلب إعلانات متعددة للمنطقة نفسها. يمكن لتطبيق AppLovin تحميل إعلان واحد فقط في كل مرة لكل منطقة. |
105 | لم يتم العثور على مفتاح حزمة تطوير البرامج (SDK) AppLovin. |
107 | الرمز المميز لعرض السعر فارغ. |
108 | لا تتوافق محوّل AppLovin مع شكل الإعلان المطلوب. |
110 | أرسلت AppLovin عملية استدعاء ناجحة لتحميل البيانات ولكن لم يتم تحميل أي إعلانات. |
سجلّ التغييرات في محوّل محوِّل توسّط AppLovin Flutter
1.1.0
- لم تعُد واجهة برمجة التطبيقات لـ GmaMediationApplovin ثابتة.
- تم التحقّق من التوافق مع الإصدار 12.4.3.0 من محوّل AppLovin Android.
- تم التحقّق من التوافق مع الإصدار 12.4.2.0 من محوّل AppLovin iOS.
- تمّ إنشاء الإصدار 5.1.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة واختباره باستخدام الإصدار 5.1.0.
1.0.0
- الإصدار الأولي.
- تم التحقّق من التوافق مع الإصدار 12.3.0.0 من محوّل AppLovin Android
- تم التحقّق من التوافق مع الإصدار 12.2.1.0 من محوّل AppLovin iOS
- تم إنشاء الإصدار 5.0.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة واختباره باستخدام الإصدار 5.0.0.