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

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

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

يتضمّن برنامج التكيّف الخاص بالتوسّط في "مدير إعلانات Google" لمنصة AppLovin الإمكانات التالية:

¹ يتوفّر دمج العرض الانحداري لطلبات الشبكة في إصدار تجريبي مغلق.

^‫2 لا تتوافق "العرض المتتالي" إلا مع أحجام إعلانات البانر 320×50 و728×90. لا تتيح عروض الأسعار "إعلانات البانر".

المتطلبات الأساسية

قبل المتابعة، يُرجى التأكّد مما يلي:

• أحدث إصدار من Google Mobile Ads Flutter Plugin
• الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
• للنشر على Android
  • المستوى 24 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث
• للنشر على أجهزة iOS
  • هدف نشر iOS‏ 13.0 أو إصدار أحدث
• مشروع Flutter يعمل بشكل صحيح وتم إعداده باستخدام Google Mobile Ads Flutter Plugin لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.

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

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

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

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

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

إنشاء منطقة

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt) هي مبادرة من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقاتك إلا من خلال القنوات التي حدّدتها على أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، عليك إنشاء ملف app-ads.txt في "إدارة إعلانات Google".

لاستخدام app-ads.txt مع AppLovin، أضِف AppLovin إلى ملف app-ads.txt.

تفعيل "الوضع التجريبي"

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

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

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

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

اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية الأوروبية و إعدادات اللوائح التنظيمية في الولايات الأمريكية لإضافة AppLovin Corp.‎ إلى قائمة الشركاء الإعلانيين في اللوائح التنظيمية الأوروبية واللوائح التنظيمية في الولايات الأمريكية في واجهة مستخدم "إدارة إعلانات Google".

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) والمحوّل الخاصَّين بمنصّة AppLovin

الدمج من خلال pub.dev

أضِف التبعية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) ومحوّل AppLovin في ملف pubspec.yaml الخاص بالحزمة:

dependencies:
  gma_mediation_applovin: ^2.6.4

الدمج اليدوي

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

dependencies:
  gma_mediation_applovin:
    path: path/to/local/package

الخطوة 4: تنفيذ إعدادات الخصوصية على حزمة تطوير البرامج (SDK) من AppLovin

موافقة المستخدمين في الاتحاد الأوروبي و"اللائحة العامة لحماية البيانات"

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

يتيح الإصدار 1.0.0 من محوّل AppLovin Flutter والإصدارات الأحدث تمرير إشارات موافقة بموجب اللائحة العامة لحماية البيانات (GDPR) من حزمة تطوير البرامج لمنصّة UMP ومنصّات إدارة الموافقة التي تتكامل مع مواصفات "الموافقة الإضافية" من Google.

لمزيد من المعلومات، يُرجى الاطّلاع على إعدادات الخصوصية في AppLovin.

الإفصاح عن المستخدمين الأطفال

لا تتيح AppLovin تهيئة حزمة تطوير البرامج (SDK) الخاصة بها في ما يتعلّق بالأطفال. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات AppLovin حول "حظر بيانات الأطفال أو استخدام الخدمات للأطفال أو التطبيقات المخصّصة للأطفال فقط" على Android أو iOS.

يؤدي المكوّن الإضافي للتوسّط في Google Mobile Ads Flutter مع AppLovin بالإصدار 9.1.0 أو الإصدارات الأحدث إلى إيقاف التوسّط مع AppLovin تلقائيًا في التطبيقات التي تحدّد أنّ المستخدم طفل باستخدام أي من الإعدادات التالية:

• ضبط إعدادات المعالجة الموجّهة للفئة العمرية
• الإعدادات المخصّصة للمحتوى الموجّه إلى الأطفال
• المستخدمون دون سن الرشد

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

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

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

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

GmaMediationApplovin.setDoNotSell(true);

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

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

الخطوة 6: اختبار عملية الإعداد

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات" وتفعيل وضع الاختبار في واجهة مستخدم 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

الإصدار 2.6.5 (قيد التطوير)

الإصدار 2.6.4

• يتوافق مع الإصدار 13.6.4.1 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.6.4.0 من محوّل AppLovin لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.6.3

• تم تعديل هذا الإصدار ليتوافق مع الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• إضافة إمكانية استخدام Swift Package Manager
• يتوافق مع الإصدار 13.6.4.0 من محوّل AppLovin لنظام التشغيل Android.
• متوافق مع الإصدار 13.6.3.0 من محوّل AppLovin لنظام التشغيل iOS.
• تم إنشاء هذا الدليل واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.6.2

• تم تعديل هذا الإصدار ليتوافق مع الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• متوافق مع الإصدار 13.6.3.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.6.3.0 من محوّل AppLovin لنظام التشغيل iOS.
• تم إنشاء هذا الدليل واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.6.1

• يتوافق مع الإصدار 13.6.2.0 من محوِّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.6.2.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.6.0

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1.
• تم التحديث لدعم الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• يتوافق مع الإصدار 13.6.2.0 من محوِّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.6.1.0 من محوّل AppLovin لنظام التشغيل iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.5.2

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
• تم تعديلها لتتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
• يتوافق مع الإصدار 13.5.1.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.5.0.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.5.1

• يتوافق مع الإصدار 13.5.1.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.5.0.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.5.0

• يتوافق مع الإصدار 13.5.0.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.5.0.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.4.0

• يتوافق مع الإصدار 13.4.0.0 من محوّل Android في AppLovin.
• يتوافق مع الإصدار 13.4.0.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.3.2

• يتوافق مع الإصدار 13.3.1.1 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.3.1.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.3.1

• يتوافق مع الإصدار 13.3.1.0 من محوّل AppLovin لنظام التشغيل Android.
• متوافق مع الإصدار 13.3.1.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.3.0

• يتوافق مع الإصدار 13.3.0.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.3.0.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.2.1

• يتوافق مع الإصدار 13.2.0.1 من محوّل AppLovin Android.
• يتوافق مع الإصدار 13.2.0.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاؤه واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.2.0

• يتوافق مع الإصدار 13.2.0.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.2.0.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.1.0

• يتوافق مع الإصدار 13.1.0.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 13.1.0.0 من محوّل AppLovin المتوافق مع iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 2.0.0

• متوافق مع الإصدار 13.0.1.0 من محوّل AppLovin لنظام التشغيل Android
• يتوافق مع الإصدار 13.0.1.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.0

• يتوافق مع الإصدار 12.6.1.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 12.6.1.0 من أداة ربط AppLovin على iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.0

• لم تعُد واجهة برمجة التطبيقات لـ GmaMediationApplovin ثابتة.
• يتوافق مع الإصدار 12.4.3.0 من محوّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 12.4.2.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.0

• الإصدار الأوّلي

• يتوافق مع الإصدار 12.3.0.0 من محوِّل AppLovin لنظام التشغيل Android.
• يتوافق مع الإصدار 12.2.1.0 من محوّل AppLovin لنظام التشغيل iOS.

• تم إنشاؤه واختباره باستخدام الإصدار 5.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.