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

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