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

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

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

يتضمّن محوِّل توسّط AdMob لـ AppLovin الخطوات التالية:

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 5.6 من Unity أو إصدار أحدث
  • [لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّن "توسّط إعلانات Google على الأجهزة الجوّالة" الإضافي لإصدار 4.2.0 من AppLovin أو إصدار أحدث (ننصح باستخدام أحدث إصدار).
  • للنشر على Android
    • المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android
  • للنشر على أجهزة iOS
    • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
  • مشروع Unity صالح تم إعداده باستخدام حزمة تطوير البرامج (SDK) لميزة إعلانات Google على الأجهزة الجوّالة اطّلِع على البدء لمعرفة التفاصيل.
  • إكمال التوسّط دليل البدء

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

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

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

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

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

عروض الأسعار

هذه الخطوة غير مطلوبة لدمج عروض الأسعار.

شلال

في واجهة مستخدم AppLovin، اختَر التطبيقات ضمن القسم تحقيق الربح للوصول إلى تطبيقاتك المسجّلة. اختَر التطبيق الذي تريد استخدامه مع التوسّط من قائمة التطبيقات المتاحة.

إنشاء منطقة

عروض الأسعار

هذه الخطوة غير مطلوبة لدمج عروض الأسعار.

شلال

في واجهة مستخدم AppLovin، اختَر المناطق ضمن القسم تحقيق الربح للوصول إلى أرقام تعريف المناطق المسجّلة. إذا سبق لك إنشاء المناطق المطلوبة لتطبيقك، انتقِل إلى الخطوة 2. لإنشاء رقم تعريف منطقة جديد، انقر على إنشاء منطقة.

أدخِل اسم معرّف المنطقة، واختَر Android كـ النظام الأساسي، ثم اختَر نوع الإعلان.

اضبط السعر للمنطقة من خلال اختيار تكلفة ثابتة لكل ألف ظهور أو محسّن من خلال AppLovin. يمكن ضبط التكاليف لكل ألف ظهور حسب البلد لتطبيق خيار التكلفة الثابتة لكل ألف ظهور. بعد ذلك، انقر على حفظ.

Android

iOS

بعد إنشاء المنطقة، يمكن العثور على رقم تعريفها ضمن عمود رقم تعريف المنطقة.

Android

iOS

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

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

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

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت "مكوّن إضافي لتوسّط Applovin" لإعلانات Google للأجهزة الجوّالة في Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.applovin

OpenUPM

في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حِزم Unity.

ضمن علامة التبويب السجلّات على مستوى النطاق، أضِف OpenUPM كسجلّ على مستوى النطاق باستخدام التفاصيل التالية:

  • الاسم: OpenUPM
  • عنوان URL: https://package.openupm.com
  • النطاقات: com.google

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

سجلات Unity

اختَر حزمة Google Mobile Ads Applovin Mediation وانقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

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

في محرِّر مشروع Unity، اختَر مواد العرض > استيراد حزمة > حزمة مخصّصة وابحث عن GoogleMobileAdsApplovinMediation.unitypackage الملف الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

الاستيراد من Unity

بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية > Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستُجري مكتبة "مدير التبعية الخارجية" عملية حلّ التبعية من البداية وستنسخ التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android في تطبيق Unity.

حلّ المشاكل بالقوة

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

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

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

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

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

AppLovin.SetHasUserConsent(true);

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

AppLovin.SetIsAgeRestrictedUser(true);

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

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

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

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

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

AppLovin.SetDoNotSell(true);

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

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

Android

لا يلزم استخدام رمز إضافي لدمج AppLovin.

iOS

دمج SKAdNetwork

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

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

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

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

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

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

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

تحسينات

من خلال إضافة طلب برمجي لسلسلة رسائل برمجية ‎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

رمز الخطأ السبب
من -1,009 إلى -1,204 ظهرت رسالة خطأ في حزمة تطوير البرامج (SDK) من AppLovin. يمكنك الاطّلاع على مستندات AppLovin للحصول على مزيد من التفاصيل.
101 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع AppLovin.
103 السياق فارغ.
104 رمز مميّز لعرض السعر في AppLovin فارغ.
105 تمّ طلب إعلانات متعدّدة للمنطقة نفسها. يمكن لخدمة AppLovin تحميل إعلان واحد فقط في كل مرة لكل منطقة.
106 الإعلان غير جاهز للعرض.
108 لا يتيح محوِّل AppLovin تنسيق الإعلان المطلوب.

iOS

رمز الخطأ السبب
من -1,009 إلى -1,204 ظهرت رسالة خطأ في حزمة تطوير البرامج (SDK) من AppLovin. يمكنك الاطّلاع على مستندات AppLovin للحصول على مزيد من التفاصيل.
101 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع AppLovin.
102 مَعلمات خادم AppLovin التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
103 تعذّر عرض إعلان AppLovin.
104 تمّ طلب إعلانات متعدّدة للمنطقة نفسها. يمكن لخدمة AppLovin تحميل إعلان واحد فقط في كل مرة لكل منطقة.
105 لم يتم العثور على مفتاح حزمة تطوير البرامج (SDK) من AppLovin.
107 رمز مميّز لعرض السعر فارغ.
108 لا يتيح محوِّل AppLovin تنسيق الإعلان المطلوب.
110 أرسلت AppLovin طلب استدعاء تحميل ناجحًا، ولكن لم يتم تحميل أي إعلانات.
111 تعذّر استرداد مثيل حزمة تطوير البرامج (SDK) من AppLovin.
112 المستخدم طفل.

سجلّ التغييرات في مكوّن AppLovin Unity Mediation الإضافي

الإصدار 8.0.3

الإصدار 8.0.2

الإصدار 7.4.1

الإصدار 7.4.0

الإصدار 7.3.1

الإصدار 7.3.0

الإصدار 7.2.2

الإصدار 7.2.1

الإصدار 7.2.0

الإصدار 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 من محوِّل Android في AppLovin
  • يتوافق مع الإصدار 6.6.1.0 من محوِّل AppLovin لنظام التشغيل iOS.

الإصدار 4.1.0

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

الإصدار 4.0.0

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

الإصدار 3.1.2

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

الإصدار 3.1.1

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

الإصدار 3.1.0

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

الإصدار 3.0.3

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

الإصدار 3.0.2

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

الإصدار 3.0.1

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

الإصدار 3.0.0

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

الإصدار 2.0.0

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

الإصدار 1.2.1

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

الإصدار 1.2.0

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

الإصدار 1.1.0

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

الإصدار 1.0.0

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