دمج AppLovin مع التوسّط

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

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

يتضمّن AdMob محوِّل التوسّط في AppLovin الإمكانات التالية:

¹ لا يُسمح بإعلانات البانر (باستثناء إعلانات بانر MREC) إلا في التوسط. لا تتيح عروض الأسعار أي نوع من إعلانات البانر.

المتطلبات

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

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

اشترِك أو سجِّل الدخول إلى حسابك على AppLovin.

لإعداد وحدتك الإعلانية على AdMob، ستحتاج إلى مفتاح حزمة تطوير البرامج (SDK) ومفتاح إعداد التقارير من AppLovin. للعثور عليهما، انتقِل إلى واجهة مستخدم AppLovin > الحساب > المفاتيح للاطّلاع على كلتا القيمتَين.

إذا كنت تخطّط لدمج عروض الأسعار فقط، يمكنك المتابعة إلى ضبط إعدادات التوسّط.

اختيار تطبيق للتوسّط

إنشاء منطقة

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

اتّبِع التعليمات الواردة في دليل وضع الاختبار في MAX من AppLovin بشأن كيفية تفعيل الإعلانات الاختبارية في AppLovin.

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

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

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

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

إذا كنت لا تستخدِم منصّة إدارة موافقة تُسجّل سلسلة الموافقة في الإعدادات المشترَكة ، يمكنك استخدام الإجراءين GmaMediationApplovin.setHasUserConsent() و GmaMediationApplovin.setIsAgeRestrictedUser() . يوضّح الرمز البرمجي النموذجي التالي كيفية تمرير معلومات الموافقة إلى حزمة AppLovin SDK. يجب ضبط هذه الخيارات قبل إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لضمان إعادة توجيهها بشكل صحيح إلى حزمة SDK من AppLovin.

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.

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

GmaMediationApplovin.setDoNotSell(true);

يمكنك الاطّلاع على مستندات AppLovin المتعلّقة بالخصوصية لمزيد من المعلومات.

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

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

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

تأكَّد من تسجيل جهازك الاختباري في AdMob وتفعيل وضع الاختبار في واجهة مستخدم Applovin.

إثبات صحة الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Applovin، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام مصدرَي الإعلانات Applovin (عروض الأسعار) وApplovin (العرض بدون انقطاع).

خطوات اختيارية

المَعلمات الخاصة بالشبكة

يتيح محوِّل 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 ضمن الفئات التالية:

com.google.ads.mediation.applovin.mediation.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل AppLovin عند تعذُّر تحميل إعلان:

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

النسخة التالية

• تم إنشاؤه واختباره باستخدام الإصدار 5.2.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

1.2.0

• تم التحقّق من التوافق مع الإصدار 12.6.1.0 من محوِّل Android في AppLovin.
• تم التحقّق من التوافق مع الإصدار 12.6.1.0 من محوِّل AppLovin لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

1.1.0

• لم تعُد واجهة برمجة التطبيقات لخدمة GmaMediationApplovin ثابتة.
• تم التحقّق من التوافق مع الإصدار 12.4.3.0 من محوِّل Android في AppLovin.
• تم التحقّق من التوافق مع الإصدار 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 على الأجهزة الجوّالة".