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

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

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

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

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

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

المتطلبات

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

الخطوة 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

OpenUPM-CLI

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

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

OpenUPM

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

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

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

تفاصيل OpenUPM

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

سجلات الانسجام

اختَر توسّط AppLovin لإعلانات Google للأجهزة الجوّالة من أجل حزمة Unity والنقر على تثبيت.

التثبيت من OpenUPM

حزمة الانسجام

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

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

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

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

فرض الحل

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

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

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

إذا كنت عدم استخدام مكوّن توسّط "إعلانات Google للأجهزة الجوّالة" الإضافي لتطبيق Appovin الإصدار 7.0.0 أو الإصدارات الأحدث أو عدم استخدام منصّة إدارة موافقة تكتب سلسلة الموافقة في والتفضيلات، فيمكنك استخدام 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 يجب تعيين هذه الخيارات قبل بدء إعلانات Google للأجهزة الجوّالة حزمة SDK لضمان إعادة توجيههم بشكل صحيح إلى 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 عرَضَت حزمة AppLovin SDK خطأً. عرض مستندات AppLovin لمزيد من التفاصيل.
101 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع AppLovin.
103 السياق فارغ.
104 الرمز المميّز لعرض سعر AppLovin فارغ.
105 طلبت إعلانات متعددة للمنطقة نفسها. يمكن لتطبيق AppLovin تحميل إعلان واحد فقط في الوقت لكل منطقة.
106 الإعلان غير جاهز للعرض.
108 لا تتوافق محوّل AppLovin مع شكل الإعلان المطلوب.

iOS

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

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

الإصدار 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

  • يتوافق مع الإصدار 11.9.0.0 من محوّل AppLovin.
  • يتوافق مع الإصدار 11.9.0.0 من محوّل AppLovin iOS.
  • تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
  • تم نقل محتوى المحوّل إلى GoogleMobileAds/Mediation/AppLovin/.
  • تمت إعادة ضبط مساحة الاسم للمهايئ لاستخدام GoogleMobileAds.Mediation.AppLovin.

الإصدار 6.6.0

الإصدار 6.5.1

الإصدار 6.5.0

الإصدار 6.4.3

الإصدار 6.4.2

الإصدار 6.4.1

الإصدار 6.4.0

الإصدار 6.3.1

  • تمت إضافة الطريقة AppLovin.SetDoNotSell(bool) لاستيفاء متطلبات قانون خصوصية المستهلك في كاليفورنيا (CCPA).
  • يتوافق مع الإصدار 11.4.4.0 من محوّل AppLovin.
  • يتوافق مع الإصدار 11.4.3.0 من محوّل AppLovin iOS.
  • تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 7.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 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

  • تم تحديث المكوِّن الإضافي لإتاحة واجهة برمجة التطبيقات التي تتضمن مكافأة جديدة مفتوحة في الإصدار التجريبي.
  • يتوافق مع الإصدار 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) لنظام التشغيل 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() لإعادة توجيه علامة موافقة المستخدم إلى حزمة تطوير برامج 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.