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

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

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

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

يمتلك محوِّل التوسّط لخدمة InMobi الإمكانات التالية:

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

¹ دمج عروض الأسعار متاح في الإصدار العلني التجريبي.

² لا تتوفّر هذه الميزة إلا للخدمة توسّط العرض الإعلاني بدون انقطاع.

المتطلبات

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

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

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

اشترِك للحصول على حساب على InMobi. عند إنشاء حساب، اترك الخيار استخدام منصّة عرض الإعلانات InMobi مع عروض الأسعار المفتوحة من Google بدون وضع علامة في المربّع بجانبه.

بعد إثبات ملكية حسابك، سجِّل الدخول.

إضافة تطبيق

لإضافة تطبيقك إلى لوحة بيانات InMobi، انقر على المستودع الإعلاني > إعدادات المستودع الإعلاني.

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

ابدأ في كتابة عنوان URL متجر التطبيقات الذي نشرته في شريط البحث واختَر التطبيق من النتائج التي تتم تعبئتها تلقائيًا. انقر على متابعة.

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

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

مواضع الإعلانات

بعد إعداد مستودعك، سيعيد النظام توجيهك إلى سير عمل إنشاء موضع الإعلان.

عروض الأسعار

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

شلال

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

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

رقم تعريف الحساب

يتوفّر رقم تعريف حسابك على InMobi ضمن المالية > إعدادات الدفع > معلومات الدفع.

تحديد موضع مفتاح واجهة برمجة التطبيقات لإعداد التقارير في InMobi

عروض الأسعار

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

شلال

انتقِل إلى حسابي > إعدادات الحساب. انتقِل إلى علامة التبويب مفتاح واجهة برمجة التطبيقات وانقر على إنشاء مفتاح واجهة برمجة التطبيقات.

اختَر عنوان البريد الإلكتروني للمستخدم المطلوب إنشاء المفتاح له، ثم انقر على إنشاء مفتاح واجهة برمجة التطبيقات. سيتم إنشاء ملف يحتوي على مفتاح واجهة برمجة التطبيقات واسم المستخدم/اسم تسجيل الدخول.

لن يتمكّن سوى مشرف الناشر للحساب من إنشاء مفتاح واجهة برمجة التطبيقات لجميع المستخدمين. إذا نسيت مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه سابقًا، يمكنك إعادة ضبط مفتاح واجهة برمجة التطبيقات من خلال تمرير مؤشر الماوس فوق بريدك الإلكتروني في علامة التبويب مفتاح واجهة برمجة التطبيقات.

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

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

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

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

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

شلال

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

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

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

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

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

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

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

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

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

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

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج InMobi iOS SDK واربط InMobiSDK.framework في مشروعك.

نزِّل أحدث إصدار من محوِّل InMobi من رابط التنزيل في سجلّ التغييرات، واربطه InMobiAdapter.framework في مشروعك.
أضِف الإطارات التالية إلى مشروعك
- libsqlite3.0.tbd
- libz.tbd
- WebKit.framework

إعدادات المشروع

أضِف العلامة -ObjC إلى رموز ربط أخرى ضمن هدف التطبيق > إعدادات الإنشاء.

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

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

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

في الإصدار 7.1.1.0، أضاف محوِّل InMobi فئة GADMInMobiConsent التي تسمح لك بتمرير معلومات الموافقة إلى InMobi. يستدعي نموذج التعليمات البرمجية التالي updateGDPRConsent في فئة GADMInMobiConsent. إذا اخترت استدعاء هذه المحاولة، ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال حزمة SDK لإعلانات Google على الأجهزة الجوّالة.

Swift

import InMobiAdapter
// ...

var consentObject = Dictionary<String, String>()
consentObject["gdpr"] = "1"
consentObject[IM_GDPR_CONSENT_AVAILABLE] = "true"

GADMInMobiConsent.updateGDPRConsent(consentObject)

Objective-C

#import <InMobiAdapter/InMobiAdapter.h>
// ...

NSMutableDictionary *consentObject = [[NSMutableDictionary alloc] init];
[consentObject setObject:@"1" forKey:@"gdpr"];
[consentObject setObject:@"true" forKey:IM_GDPR_CONSENT_AVAILABLE];

[GADMInMobiConsent updateGDPRConsent:consentObject];

اطّلِع على تفاصيل تنفيذ "اللائحة العامّة لحماية البيانات" في InMobi للحصول على مزيد من المعلومات عن المفاتيح والقِيم المحتمَلة التي تقبلها InMobi في ملف تعريف الموافقة هذا.

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

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

في الإصدارين 10.5.6.0، أضاف محوِّل InMobi إمكانية قراءة سلسلة خصوصية مكتب IAB في الولايات المتحدة من NSUserDefaults. اتّبِع التعليمات الواردة في مستندات قوانين الخصوصية في الولايات الأمريكية لضبط سلسلة الخصوصية في الولايات المتحدة في NSUserDefaults.

بالإضافة إلى ذلك، يمكنك الاطّلاع على مستندات قانون خصوصية المستهلك في كاليفورنيا (CCPA) من InMobi للحصول على إرشادات حول كيفية تفعيل إعدادات قانون خصوصية المستهلك في كاليفورنيا (CCPA) في لوحة بيانات InMobi.

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

دمج SKAdNetwork

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

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

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

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

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

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

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

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

يتيح محوِّل InMobi معلَمات طلب إضافية يمكن تمريرها إلى المحوِّل باستخدام فئة GADInMobiExtras. تتضمّن GADInMobiExtras السمات التالية الشائعة لجميع أشكال الإعلانات المتوافقة:

مَعلمات الطلب وقيمها
`setAgeGroup` الفئة العمرية للمستخدم.	`kIMSDKAgeGroupBelow18` `kIMSDKAgeGroupBetween18And24` `kIMSDKAgeGroupBetween25And29` `kIMSDKAgeGroupBetween30And34` `kIMSDKAgeGroupBetween35And44` `kIMSDKAgeGroupBetween45And54` `kIMSDKAgeGroupBetween55And64` `kIMSDKAgeGroupAbove65`
`setEducationType` مستوى تعليم المستخدم	`kIMSDKEducationHighSchoolOrLess` `kIMSDKEducationCollegeOrGraduate` `kIMSDKEducationPostGraduateOrAbove`
`setLogLevel`	`kIMSDKLogLevelNone` `kIMSDKLogLevelError` `kIMSDKLogLevelDebug`
`setAge`	Integer. عمر المستخدِم
`setYearOfbirth`	Integer. سنة ميلاد المستخدم.
`setPostalCode`	سلسلة: الرمز البريدي للمستخدِم. يكون عادةً رقمًا مكوّنًا من خمسة أرقام.
`setAreaCode`	سلسلة: الرمز الهاتفي للمنطقة التي يقيم فيها المستخدم (جزء من رقم الهاتف)
`setLanguage`	سلسلة: اللغة الأم للمستخدم (إذا كانت معروفة)
`setLoginId`	سلسلة: رقم تعريف تسجيل الدخول في نطاق الناشر
`setSessionId`	سلسلة: رقم تعريف جلسة في نطاق الناشر
`setLocationWithCityStateCountry`	سلسلة: الموقع الجغرافي مع المدينة والولاية والبلد كمَعلمات
`setKeywords`	سلسلة: أيّ كلمات رئيسية ذات صلة بالسياق المطلوب تمريرها في طلب الإعلان
`setInterests`	سلسلة: أي سلاسل ذات صلة بالسياق ليتم تمريرها في طلب الإعلان
`setAdditionalParameters`	القاموس: أي قيم إضافية يتم تمريرها في طلب الإعلان

في ما يلي مثال على رمز لكيفية ضبط مَعلمات طلب الإعلانات هذه:

Swift

let request = GADRequest()
let extras = GADInMobiExtras()
extras.ageGroup = kIMSDKAgeGroupBetween35And54
extras.areaCode = "12345"
request.registerAdNetworkExtras(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADInMobiExtras *extras = [[GADInMobiExtras alloc] init];
extras.ageGroup = kIMSDKAgeGroupBetween35And54;
extras.areaCode = @"12345";
[request registerAdNetworkExtras:extras];

استخدام الإعلانات المدمجة مع المحتوى

عرض الإعلانات

يعرض محوِّل InMobi إعلاناته المدمجة مع المحتوى على هيئة عناصر GADNativeAd . وتعبئ هذه السمة حقول أوصاف الإعلانات المدمجة مع المحتوى لملف GADNativeAd.

الحقل	مواد العرض التي يتم تضمينها دائمًا من خلال محوِّل InMobi
العنوان
صورة	1
عرض الوسائط
الجسم
رمز التطبيق
الحث على اتخاذ إجراء
التقييم النجمي
المتجر
السعر

¹ لا يقدّم محوِّل InMobi إمكانية الوصول المباشر إلى مادة عرض الصورة الرئيسية لإعلاناته المدمجة مع المحتوى. بدلاً من ذلك، يملؤه المحوِّل بالرمز GADMediaView في حال توفّر فيديو أو صورة.

تتبُّع مرّات الظهور والنقرات

ترصد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" النقرات وتعيد توجيهها إلى InMobi، ما يؤدي إلى اتّساق تقارير النقرات.

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

رموز الخطأ

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

GADMAdapterInMobi
GADMediationAdapterInMobi

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

رمز الخطأ	السبب
101	مَعلمات خادم InMobi التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة أو غير صالحة.
102	لا يتوافق محوِّل InMobi مع تنسيق الإعلان المطلوب.
103	سبق أن تم تحميل إعلان InMobi لإعدادات الشبكة هذه.
غير ذلك	عرَض حِزم تطوير البرامج (SDK) من InMobi خطأً. يُرجى الاطّلاع على `IMRequestStatus.h` لمزيد من التفاصيل.