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

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

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

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

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

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

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

المتطلبات

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

إنشاء منطقة

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

مشاركة إشارة آمنة في طلبات عروض الأسعار

عروض الأسعار

انتقِل إلى المستودع الإعلاني > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن Applovin Corp. وفعِّل تفعيل دمج التطبيقات.

انقر على حفظ.

شلال

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

السماح بمشاركة الإشارات الآمنة في عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)

عروض الأسعار

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

انقر على حفظ.

شلال

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

ضبط عروض أسعار Applovin

عروض الأسعار

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

انقر على مقدّم عروض أسعار جديد.

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

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

انقر على تم.

شلال

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

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

عروض الأسعار

اختَر شركة Applovin.

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

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

شلال

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

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

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

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

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

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

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

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

استخدام CocoaPods (إجراء يُنصح به)

أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
```
pod 'GoogleMobileAdsMediationAppLovin'
```
من سطر الأوامر، شغِّل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من AppLovin وأدرِج الرابط ApplovinSDK.framework في مشروعك.
نزِّل أحدث إصدار من محوِّل AppLovin من رابط التنزيل في سجلّ التغييرات والرابط ApplovinAdapter.framework في مشروعك.
أضِف الأطر التالية إلى مشروعك:
- AdSupport
- AVFoundation
- CoreGraphics
- CoreMedia
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libz.tbd

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

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

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

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

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

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setHasUserConsent(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setHasUserConsent:YES];

يمكنك الاطّلاع على إعدادات الخصوصية في 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.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setDoNotSell(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setDoNotSell:YES];

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

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

دمج SKAdNetwork

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

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

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

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

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

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

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

تحسينات

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

Swift

let sdk = ALSdk.shared(withKey: "sdkKey")
sdk?.initializeSdk()

Objective-C

ALSdk *sdk = [ALSdk sharedWithKey:@"sdkKey"];
[sdk initializeSdk];

رموز الخطأ

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

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

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

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

سجلّ التغييرات في "محوِّل التوسّط لنظام التشغيل iOS" من AppLovin