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

دمج AppLovin مع ميزة "التوسّط"

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

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

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

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

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

المتطلبات

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

[لعروض الأسعار]: محوِّل AppLovin 9.4.2.0 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

إنشاء منطقة

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

سجِّل الدخول إلى حسابك على "مدير إعلانات Google".

إضافة AppLovin في "الشركات"

عروض الأسعار

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

شلال

انتقِل إلى المشرف > الشركات، ثم انقر على الزر شركة جديدة في علامة التبويب جميع الشركات. اختَر شبكة الإعلانات.

اختَر AppLovin كـ شبكة المواقع الإعلانية، وأدخِل اسمًا فريدًا وفعِّل التوسّط. فعِّل جمع البيانات التلقائي، وأدخِل Report Key الذي حصلت عليه في القسم السابق.

لست بحاجة إلى إدخال اسم مستخدم أو كلمة مرور. انقر على حفظ عند الانتهاء.

تفعيل ميزة "مشاركة الإشارات الآمنة"

عروض الأسعار

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange راجِع مشاركة الإشارات الآمنة وفعِّلها. انقر على حفظ.

شلال

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

ضبط AppLovin عروض الأسعار

عروض الأسعار

انتقِل إلى العرض > مقدّمو عروض الأسعار، وانقر على مقدّم عروض أسعار جديد ضمن علامة التبويب عروض الأسعار باستخدام حِزم تطوير البرامج (SDK).

اختَر AppLovin كمقدّم عروض الأسعار.

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

انقر على متابعة.

انقر على تم.

شلال

هذه الخطوة غير مطلوبة لعمليات دمج العرض الإعلاني بدون انقطاع.

ضبط ربط الوحدات الإعلانية

عروض الأسعار

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

انتقِل إلى علامة التبويب ربط الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديد.

اختَر وحدة إعلانية محدّدة. اختَر وحدة إعلانية وشكل إعلان، وتطبيق متوافق مع الأجهزة الجوّالة كنوع المستودع، وتطبيقك المتوافق مع الأجهزة الجوّالة. بعد ذلك، أدخِل SDK Key المُسجَّلة في القسم السابق. أخيرًا، انقر على حفظ.

شلال

انتقِل إلى العرض > مجموعات الأرباح وانقر على الزر مجموعة أرباح جديدة. اختَر تطبيقك المتوافق مع الأجهزة الجوّالة.

انتقِل للأسفل وانقر على إضافة شريك عائد.

اختَر الشركة التي أنشأت حسابًا لها AppLovin في القسم السابق. اختَر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كنوع الدمج، وAndroid كنظام أساسي، ونشط كحالة.

أدخِل Application ID of your app along with the SDK Key and the Zone ID القيمة التي حصلت عليها في القسم السابق وقيمة التكلفة التلقائية لكل ألف ظهور. انقر على حفظ.

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.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 أو لا تستخدم منصّة إدارة موافقة تُسجِّل سلسلة الموافقة في ملفået الإعدادات المشترَكة ، يمكنك استخدام الطريقة 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: اختبار عملية التنفيذ

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

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

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

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

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

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

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

Java

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

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

Kotlin

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

val request = AdManagerAdRequest.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 مع تنسيق الإعلان المطلوب.