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

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

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

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

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

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

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

المتطلبات

المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

إنشاء منطقة

عروض الأسعار

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

شلال

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

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

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

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

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

اتّبِع التعليمات الواردة في وضع الاختبار الأقصى حول كيفية تفعيل الإعلانات الاختبارية في AppLovin.

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

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

إضافة 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. إلى اللائحة العامة لحماية البيانات (GDPR) وقائمة شركاء الإعلانات للوائح الولايات الأمريكية في Ad Manager واجهة المستخدم.

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

الدمج مع "استوديو Android" (يُنصح به)

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

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

الدمج اليدوي

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

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

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

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

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

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

Java

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

AppLovinPrivacySettings.setHasUserConsent(true, context);

Kotlin

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

AppLovinPrivacySettings.setHasUserConsent(true, context)

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

Java

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context);

Kotlin

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context)

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

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

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

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

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

Java

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

AppLovinPrivacySettings.setDoNotSell(true, context);

Kotlin

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

AppLovinPrivacySettings.setDoNotSell(true, context)

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

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

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

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

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

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

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

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

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

المَعلمات الخاصة بالشبكة

محوّل 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()

تحسينات

يؤدي إعداد حزمة AppLovin SDK فور إطلاق تطبيقك إلى توفير بإمكان 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 عند تعذّر تحميل إعلان:

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