تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

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

المتطلبات

المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android

[لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم محوِّل AppLovin 9.4.2.0 أو إصدارًا أحدث (ننصح باستخدام أحدث إصدار).

أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
إكمال التوسّط دليل البدء

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

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

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

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

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

عروض الأسعار

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

شلال

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

إنشاء منطقة

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

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

عليك إضافة Applovin إلى إعدادات التوسّط لوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، وانتقِل إلى إضافة Applovin كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل تنسيق الإعلان والمنصّة، ثم انقر على متابعة.

أدخِل اسمًا لمجموعة التوسّط، واختَر المواقع الجغرافية التي تريد استهدافها. بعد ذلك، اضبط حالة مجموعة التوسّط على مفعّلة، ثمّ انقر على إضافة وحدات إعلانية.

اربط مجموعة التوسّط هذه بوحدة إعلانية واحدة أو أكثر من وحدات AdMob الإعلانية الحالية. بعد ذلك، انقر على تم.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة Applovin كمصدر إعلان

عروض الأسعار

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

انقر على الإقرار والموافقة، ثم انقر على متابعة.

إذا كان لديك تعيين لـ Applovin، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل مفتاح حزمة SDK الذي حصلت عليه في القسم السابق. بعد ذلك، انقر على تم.

شلال

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

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

إذا كان لديك تعيين لعلامة Applovin، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

بعد ذلك، أدخِل رقم تعريف التطبيق لتطبيقك مع مفتاح حزمة تطوير البرامج (SDK) ورقم تعريف المنطقة الذي حصلت عليه في القسم السابق. بعد ذلك، انقر على تم.

ملاحظة: يستغرق تحسين مصدر الإعلان بضعة أيام لجمع بيانات كافية بهدف حساب التكلفة الفعلية لكل ألف ظهور بدقة لشبكة توسّط. في الوقت الحالي، تكون حالة تحسين مصدر الإعلان هي PENDING، لذا عليك ضبط قيمة التكلفة الفعلية لكل ألف ظهور يدويًا للشبكة. بعد أن يصبح من الممكن احتساب التكلفة الفعلية لكل ألف ظهور، يبدأ مصدر الإعلان في تعديل التكلفة الفعلية لكل ألف ظهور تلقائيًا نيابةً عنك.

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

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

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

دمج "استوديو Android" (إجراء يُنصح به)

في ملف build.gradle.kts على مستوى التطبيق، أضِف الإعدادات التالية للتبعيات والإعدادات. استخدِم أحدث إصدارات من حزمة تطوير البرامج (SDK) ومحوِّل AppLovin:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.6.0")
    implementation("com.google.ads.mediation:applovin:13.0.1.0")
}

الدمج اليدوي

نزِّل حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AppLovin، واسحب applovin-sdk-x.y.z.jar وأضِفه إلى مشروعك.
انتقِل إلى عناصر محوِّل AppLovin في مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف ‎ .aar الخاص بمحوِّل AppLovin، وأضِفه إلى مشروعك.

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

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

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

منذ الإصدار 12.0.0 من حزمة تطوير البرامج (SDK)، تتيح AppLovin قراءة سلسلة الموافقة من الإعدادات المفضّلة المشتركة وضبط حالة الموافقة وفقًا لذلك.

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

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context)

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

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

اعتبارًا من الإصدار 13.0.0 من حزمة تطوير البرامج (SDK) من AppLovin، لم تعُد حزمة SDK من AppLovin تتيح رصد علامات "المستخدم" التي تفرض قيودًا على العمر، ولا يجوز لك إعداد حزمة SDK من AppLovin أو استخدامها في ما يتعلّق بتسجيل "طفل" على النحو المحدّد بموجب القوانين السارية. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات AppLovin بشأن حظر جمع بيانات الأطفال أو استخدام الخدمات المخصّصة للأطفال أو التطبيقات التي تستهدفهم حصرًا .

يوقف الإصدار 13.0.0.1 من محوِّل AppLovin ميزة التوسّط في AppLovin تلقائيًا للتطبيقات التي تحدّد أيًا من الإعدادات التالية باستخدام حزمة SDK لإعلانات Google على الأجهزة الجوّالة:

إذا كنت تستخدم الإصدار 12.6.1.0 من محوِّل AppLovin أو إصدارًا أقدم، يُرجى الرجوع إلى مستندات AppLovin لضبط علامة المستخدم المحظور بموجب الفئة العمرية باستخدام حزمة تطوير البرامج (SDK) من AppLovin.

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

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

تتضمّن حزمة تطوير البرامج (SDK) من AppLovin طريقة setDoNotSell للسماح للناشرين بإيقاف بيع المعلومات الشخصية.

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

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setDoNotSell(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setDoNotSell(true, context)

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

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

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

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

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

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

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

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

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

المَعلمات المتعلّقة بالشبكة

يتيح محوِّل AppLovin استخدام setMuteAudio() الذي يمكنه إيقاف الصوت في إعلانات الفيديو. يمكن استدعاء هذه الطريقة من عنصر AppLovinExtras.Builder():

Java

Bundle extras = new AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build();

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter.class, extras)
   .build();

Kotlin

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

تحسينات

من خلال إعداد حزمة تطوير البرامج (SDK) من AppLovin فور تشغيل تطبيقك، يصبح بإمكان AppLovin تتبُّع الأحداث فور بدء التطبيق.

Java

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk();

Kotlin

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk()

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من AppLovin، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo.getAdapterResponses() ضمن الفئات التالية:

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوِّل AppLovin عند تعذُّر تحميل إعلان:

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