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

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

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

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

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

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

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

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

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

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

أحدث إصدار من Google Mobile Ads SDK
إعداد التوسّط

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

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

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

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

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

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

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

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

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

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

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

إعلان بيني

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

تمت المكافأة

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

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

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

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

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

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

بانر

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

إعلان بيني

تمت المكافأة

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

عروض الأسعار

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

انقر على حفظ.

شلال

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

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

عروض الأسعار

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

انقر على حفظ.

شلال

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

ضبط عروض أسعار Liftoff Monetize

عروض الأسعار

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى SDK Bidding.

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

اختَر Liftoff Monetize كمقدّم عرض سعر.

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

انقر على تم.

شلال

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

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

عروض الأسعار

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى SDK Bidding.

اختَر الشركة التي تمثّل Liftoff Monetize.

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

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

أخيرًا، انقر على حفظ.

شلال

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

انتقِل إلى شركاء الأرباح وانقر على إضافة شريك توسّط.

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

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

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

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

الخطوة 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: اختبار عملية التنفيذ

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات" وتفعيل وضع الاختبار في واجهة مستخدم 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.