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

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

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

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

الدمج
عروض الأسعار
شلال
التنسيقات
بانر  1
إعلان بيني
تم منح المكافأة

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

المتطلّبات

  • أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
  • Unity 5.6 أو إصدار أحدث
  • [لتقديم عروض الأسعار]: المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 4.2.0 من AppLovin أو الإصدارات الأحدث (يُنصح باستخدام أحدث إصدار)
  • للنشر على Android:
    • المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
  • للنشر على iOS:
    • هدف نشر iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity يعمل باستخدام حزمة 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 والمحوّل

نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" في AppLovin من رابط التنزيل في سجلّ التغييرات واستخرِج GoogleMobileAdsAppLovinMediation.unitypackageمن الملف المضغوط.

في محرر مشروع Unity، حدد Assets >Import Package > Custom Package وابحث عن الملف GoogleMobileAdsAppLovinMediation.unitypackage الذي قمت بتنزيله. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play Services حل التبعية من البداية، وتنسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

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

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

بما أن الإصدار 7.0.0 من المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة"، يتيح AppLovin قراءة سلسلة الموافقة من الإعدادات المفضّلة المشتركة وضبط حالة الموافقة وفقًا لذلك.

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetHasUserConsent(true);

بالإضافة إلى ذلك، إذا كان المستخدم معروفًا ضمن فئة محظورة على فئات عمرية معيّنة، يمكنك أيضًا ضبط العلامة أدناه على true.

AppLovin.SetIsAgeRestrictedUser(true);

يمكنك الاطّلاع على إعدادات خصوصية AppLovin للحصول على مزيد من المعلومات.

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

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

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

using GoogleMobileAds.Api.Mediation.AppLovin;
// ...

AppLovin.SetDoNotSell(true);

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

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

Android

ما مِن رمز إضافي مطلوب لدمج تطبيق AppLovin.

iOS

دمج SKAdNetwork

اتّبِع مستندات AppLovin لإضافة معرّفات SKAdNetwork إلى ملف Info.plist لمشروعك.

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

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

احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم AppLovin .

التحقّق من الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من AppLovin، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام AppLovin (Bidding) and AppLovin (Waterfall) مصادر الإعلانات.

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

تحسينات

إنّ إضافة دعوة إلى AppLovin.Initialize() إلى نشاط الإطلاق، تمنح 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 Unity

الإصدار 7.1.0

الإصدار 7.0.1

الإصدار 7.0.0

الإصدار 6.9.1

الإصدار 6.9.0

الإصدار 6.8.0

الإصدار 6.7.0

الإصدار 6.6.0

الإصدار 6.5.1

الإصدار 6.5.0

الإصدار 6.4.3

الإصدار 6.4.2

الإصدار 6.4.1

الإصدار 6.4.0

الإصدار 6.3.1

الإصدار 6.3.0

الإصدار 6.2.1

الإصدار 6.2.0

الإصدار 6.1.0

الإصدار 6.0.0

الإصدار 5.1.3

الإصدار 5.1.2

الإصدار 5.1.1

الإصدار 5.1.0

الإصدار 5.0.0

الإصدار 4.8.1

الإصدار 4.8.0

الإصدار 4.7.0

الإصدار 4.6.2

الإصدار 4.6.1

الإصدار 4.6.0

الإصدار 4.5.8

الإصدار 4.5.7

الإصدار 4.5.6

الإصدار 4.5.5

الإصدار 4.5.4

الإصدار 4.5.3

الإصدار 4.5.2

الإصدار 4.5.1

الإصدار 4.5.0

الإصدار 4.4.1

الإصدار 4.4.0

الإصدار 4.3.0

الإصدار 4.2.0

  • يتوافق الجهاز مع الإصدار 9.4.2.0 من محوّل AppLovin المتوافق مع Android.
  • يتوافق مع الإصدار 6.6.1.0 من محوّل AppLovin الخاص بنظام التشغيل iOS.

الإصدار 4.1.0

  • تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات Rewarded API الجديدة والمفتوحة.
  • يتوافق الجهاز مع الإصدار 9.2.1.1 من محوّل AppLovin المتوافق مع Android.
  • يتوافق مع الإصدار 6.3.0.0 من محوّل AppLovin لنظام التشغيل iOS.

الإصدار 4.0.0

  • يتوافق الجهاز مع الإصدار 9.2.1.0 من محوّل AppLovin المتوافق مع Android.
  • يتوافق مع الإصدار 6.2.0.0 من محوّل AppLovin الخاص بنظام التشغيل iOS.

الإصدار 3.1.2

  • يتوافق الجهاز مع الإصدار 8.1.4.0 من محوّل AppLovin المتوافق مع Android.
  • يتوافق مع الإصدار 5.1.2.0 من محوّل AppLovin الخاص بنظام التشغيل iOS.

الإصدار 3.1.1

  • يتوافق الجهاز مع الإصدار 8.1.0.0 من محوّل AppLovin المتوافق مع Android.
  • يتوافق الجهاز مع الإصدار 5.1.1.0 من محوّل AppLovin الخاص بنظام التشغيل iOS.

الإصدار 3.1.0

  • يتوافق الجهاز مع الإصدار 8.1.0.0 من محوّل AppLovin المتوافق مع Android.
  • يتوافق مع الإصدار 5.1.0.0 من محوّل AppLovin الخاص بنظام التشغيل iOS.

الإصدار 3.0.3

  • يتوافق الجهاز مع الإصدار 8.0.2.1 من محوّل AppLovin المتوافق مع Android.
  • يتوافق مع الإصدار 5.0.2.0 من محوّل AppLovin الخاص بنظام التشغيل iOS.

الإصدار 3.0.2

  • يتوافق هذا الإصدار مع الإصدار 8.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق هذا الإصدار مع الإصدار 5.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.

الإصدار 3.0.1

  • يتوافق التطبيق مع الإصدار 8.0.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق هذا الإصدار مع الإصدار 5.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.
  • تمت إضافة طريقة AppLovin.SetIsAgeRestrictedUser() للإشارة إلى ما إذا كان معروفًا أنّ المستخدم ينتمي إلى فئة محظورة على فئات عمرية معيّنة.

الإصدار 3.0.0

  • يتوافق التطبيق مع الإصدار 8.0.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق هذا الإصدار مع الإصدار 5.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.
  • تمت إضافة طريقة "AppLovin.SetHasUserConsent()" لإعادة توجيه علامة موافقة المستخدم إلى حزمة تطوير البرامج (SDK) لتطبيق AppLovin.

الإصدار 2.0.0

  • يتوافق التطبيق مع الإصدار 7.8.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق هذا الإصدار مع الإصدار 5.0.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.

الإصدار 1.2.1

  • يتوافق التطبيق مع الإصدار 7.8.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق هذا الإصدار مع الإصدار 4.8.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.

الإصدار 1.2.0

  • يتوافق التطبيق مع الإصدار 7.8.5 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق هذا الإصدار مع الإصدار 4.8.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.

الإصدار 1.1.0

  • يتوافق هذا الإصدار مع الإصدار 7.7.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق التطبيق مع الإصدار 4.7.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.

الإصدار 1.0.0

  • الإصدار الأول
  • يتوافق التطبيق مع الإصدار 7.4.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin.
  • يتوافق هذا الإصدار مع الإصدار 4.4.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل AppLovin لنظام التشغيل iOS.