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

دمج Liftoff Monetize باستخدام التوسّط

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

يوضّح لك هذا الدليل كيفية استخدام Google Mobile Ads SDK لتحميل الإعلانات وعرضها من Liftoff Monetize باستخدام توسّط AdMob، ويغطي كلاً من عمليات دمج عروض الأسعار والعرض الإعلاني بدون انقطاع. توضّح هذه الصفحة كيفية إضافة Liftoff Monetize إلى إعدادات التوسّط الخاصة بوحدة إعلانية، وكيفية دمج حزمة تطوير البرامج (SDK) ومحوّل Vungle في تطبيق iOS.

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

هدف نشر iOS‏ 13.0 أو إصدار أحدث
[بالنسبة إلى عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم الإصدار 7.3.0.0 أو إصدارًا أحدث من محوِّل Liftoff Monetize (يُنصح باستخدام أحدث إصدار).

أحدث إصدار من Google Mobile Ads SDK
إعداد ميزة "توسّط AdMob"

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

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

أضِف تطبيقك إلى لوحة بيانات Liftoff Monetize بالنقر على الزر إضافة تطبيق.

املأ النموذج وأدخِل جميع التفاصيل اللازمة.

بعد إنشاء تطبيقك، اختَره من لوحة بيانات تطبيقات Liftoff Monetize.

دوِّن رقم تعريف التطبيق.

إضافة مواضع إعلان جديدة

لإنشاء موضع إعلان جديد لاستخدامه مع ميزة "توسّط AdMob"، انتقِل إلى لوحة بيانات مواضع الإعلانات في Liftoff Monetize، وانقر على الزرّ إضافة موضع إعلان واختَر تطبيقك من القائمة المنسدلة.

في ما يلي تفاصيل حول إضافة مواضع إعلان جديدة:

إعلان على شاشة فتح التطبيق

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

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

اختَر إعلان MREC، وأدخِل اسم موضع الإعلان، ثم املأ بقية النموذج. [عروض الأسعار فقط] ضمن تحقيق الربح، فعِّل مفتاح التبديل عروض الأسعار داخل التطبيق . انقر على الزر متابعة في أسفل الصفحة لإنشاء موضع الإعلان.

إعلان بيني

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

تمت المكافأة

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

إعلان بيني مقابل مكافأة

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

مدمج مع المحتوى

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

دوِّن رقم التعريف المرجعي وانقر على حسنًا.

إعلان على شاشة فتح التطبيق

بانر

إعلان بانر بحجم ‎300x250

إعلان بيني

تمت المكافأة

إعلان بيني مقابل مكافأة

مدمج مع المحتوى

العثور على مفتاح Reporting API

عروض الأسعار

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

شلال

بالإضافة إلى رقم تعريف التطبيق ورقم التعريف المرجعي، ستحتاج أيضًا إلى مفتاح Reporting API في Liftoff Monetize لإعداد معرّف الوحدة الإعلانية في AdMob. انتقِل إلى لوحة بيانات تقارير Liftoff Monetize وانقر على زرّ مفتاح واجهة برمجة التطبيقات للتقارير للاطّلاع على مفتاح واجهة برمجة التطبيقات للتقارير.

تعديل ملف app-ads.txt

مبادرة البائعون المعتمَدون للتطبيقات (app-ads.txt) هي مبادرة من المختبَر التقني لمكتب الإعلانات التفاعلية (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقك إلا من خلال القنوات التي حدَّدت أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، أعِدّ ملف app-ads.txt لتطبيقك.

لتنفيذ ملف app-ads.txt في Liftoff Monetize، يُرجى تنزيل إدخالات app-ads.txt الخاصة بـ Liftoff Monetize وإلحاقها بملف app-ads.txt الحالي. لمزيد من المعلومات، يُرجى الاطّلاع على app-ads.txt.

تفعيل "الوضع التجريبي"

لتفعيل الإعلانات الاختبارية، انتقِل إلى لوحة بيانات Liftoff Monetize ثم إلى التطبيقات.

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

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

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

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

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

شلال

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

اختَر Liftoff Monetize وفعِّل مفتاح التبديل تحسين. أدخِل مفتاح Reporting API الذي حصلت عليه في القسم السابق لإعداد ميزة "تحسين مصدر الإعلان" في Liftoff Monetize. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لشبكة Liftoff Monetize وانقر على متابعة.

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

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

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

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

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

استخدام Swift Package Manager

قبل المتابعة، يجب أن يكون لديك الحد الأدنى من إصدار المحوّل المتوافق 7.5.3.0.

لإضافة حزمة تابعة إلى مشروعك، اتّبِع الخطوات التالية:

في Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).
في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالية:
```
https://github.com/googleads/googleads-mobile-ios-mediation-liftoffmonetize.git
```
في قاعدة التبعية، اختَر الفرع.
في حقل النص، أدخِل main.

استخدام CocoaPods

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

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Vungle واربط VungleAdsSDK.xcframework في مشروعك.
نزِّل أحدث إصدار من محوّل Liftoff Monetize من رابط التنزيل في سجلّ التغييرات واربط LiftoffMonetizeAdapter.xcframework في مشروعك.
أضِف أُطر العمل التالية إلى مشروعك:
- AdSupport
- AudioToolbox
- AVFoundation
- CFNetwork
- CoreGraphics
- CoreMedia
- libz.tbd
- MediaPlayer
- QuartzCore
- StoreKit
- SystemConfiguration

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

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

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

اعتبارًا من الإصدار 7.4.1 من حزمة تطوير البرامج (SDK) لـ Vungle، تقرأ Liftoff Monetize تلقائيًا الموافقة بموجب اللائحة العامة لحماية البيانات (GDPR) التي تحدّدها منصات إدارة الموافقة التي تتيح مواصفات الموافقة الإضافية من Google، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، يُرجى الاطّلاع على تعليمات التنفيذ المقترَحة بشأن "اللائحة العامة لحماية البيانات".

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

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

تتضمّن منصة Liftoff Monetize واجهة برمجة تطبيقات تتيح لك تمرير الموافقة إلى حزمة تطوير البرامج (SDK) من Vungle. يوضّح الرمز النموذجي التالي كيفية تمرير معلومات الموافقة هذه إلى حزمة تطوير البرامج (SDK) من Vungle. إذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال Google Mobile Ads SDK.

Swift

VunglePrivacySettings.setCCPAStatus(true)LiftoffMonetizeMediationSwiftSnippets.swift

Objective-C

[VunglePrivacySettings setCCPAStatus:YES];LiftoffMonetizeMediationObjectiveCSnippets.m

يمكنك الاطّلاع على تعليمات التنفيذ المقترَحة لقانون CCPA لمزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

تنفيذ SKAdNetwork

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

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

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

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

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

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

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

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

يتيح محوّل Liftoff Monetize استخدام مَعلمة طلب إضافية يمكن تمريرها إلى المحوّل باستخدام فئة VungleAdNetworkExtras. تتضمّن هذه الفئة السمات التالية:

userId: سلسلة تمثّل رقم تعريف المستخدم الذي يحصل على حوافز في Liftoff Monetize.
nativeAdOptionPosition: عدد صحيح يحدّد موضع رمز الخصوصية في "الإعلانات المدمجة مع المحتوى".

في ما يلي مثال على رمز برمجي يوضّح كيفية إنشاء طلب عرض إعلان يضبط هذه المَعلمات:

Swift

let adRequest = Request()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = AdChoicesPosition.topRightCorner
// ...
adRequest.register(extras)LiftoffMonetizeMediationSwiftSnippets.swift

Objective-C

GADRequest *adRequest = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = GADAdChoicesPositionTopRightCorner;
// ...
[adRequest registerAdNetworkExtras:extras];LiftoffMonetizeMediationObjectiveCSnippets.m

عرض "الإعلانات المدمجة مع المحتوى"

يعرض محوّل Liftoff Monetize "الإعلانات المدمجة مع المحتوى" كعناصر GADNativeAd. يتم ملء أوصاف حقول الإعلانات المدمجة مع المحتوى التالية لـ GADNativeAd.

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

¹ لا يوفّر محوّل Liftoff Monetize وصولاً مباشرًا إلى مادة عرض الصورة الرئيسية في "الإعلانات المدمجة مع المحتوى". بدلاً من ذلك، يملأ المحوّل GADMediaView بفيديو أو صورة.

رموز الخطأ

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

التنسيق	اسم الصف
إعلان على شاشة فتح التطبيق (عرض الأسعار)	GADMediationAdapterVungle
إعلان على شاشة فتح التطبيق (عرض بدون انقطاع)	GADMediationAdapterVungle
إعلان بانر (عروض أسعار)	GADMediationAdapterVungle
إعلان بانر (عرض إعلاني بدون انقطاع)	GADMAdapterVungleInterstitial
إعلان بيني (عروض أسعار)	GADMediationAdapterVungle
إعلان بيني (عرض إعلاني بدون انقطاع)	GADMAdapterVungleInterstitial
إعلان مقابل مكافأة (عروض أسعار)	GADMediationAdapterVungle
إعلان مقابل مكافأة (عرض إعلاني بدون انقطاع)	GADMAdapterVungleRewardBasedVideoAd
إعلان بيني مقابل مكافأة (عروض أسعار)	GADMediationAdapterVungle
إعلان بيني مقابل مكافأة (العرض الإعلاني بدون انقطاع)	GADMediationAdapterVungle
إعلان مدمج مع المحتوى (عرض أسعار)	GADMediationAdapterVungle
إعلان مدمج مع المحتوى (عرض إعلاني بدون انقطاع)	GADMediationAdapterVungle

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

رمز الخطأ	النطاق	السبب
101	com.google.mediation.vungle	معلَمات الخادم غير صالحة (مثل رقم تعريف التطبيق أو رقم تعريف موضع الإعلان).
102	com.google.mediation.vungle	تم تحميل إعلان مسبقًا لإعدادات الشبكة هذه. لا يمكن لحزمة تطوير البرامج (SDK) من Vungle تحميل إعلان ثانٍ لرقم تعريف موضع الإعلان نفسه.
103	com.google.mediation.vungle	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع Liftoff Monetize.
104	com.google.mediation.vungle	تعذّر على حزمة تطوير البرامج (SDK) من Vungle عرض إعلان البانر.
105	com.google.mediation.vungle	لا تتيح حزمة تطوير البرامج (SDK) لخدمة Vungle سوى تحميل إعلان بانر واحد في كل مرة، بغض النظر عن رقم تعريف موضع الإعلان.
106	com.google.mediation.vungle	أرسلت حزمة تطوير البرامج (SDK) من Vungle طلب استدعاء يفيد بأنّ الإعلان غير قابل للتشغيل.
107	com.google.mediation.vungle	حزمة تطوير البرامج (SDK) من Vungle غير جاهزة لتشغيل الإعلان.

بالنسبة إلى الأخطاء التي تحدث في حزمة تطوير البرامج (SDK) من Vungle، يُرجى الرجوع إلى رموز الأخطاء: حزمة تطوير البرامج (SDK) من Vungle لنظامَي التشغيل iOS وAndroid.