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

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

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

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

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

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

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

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

المتطلبات

المستوى 21 أو إصدار أحدث لواجهة برمجة التطبيقات Android

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

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

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

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

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

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

سجِّل رقم تعريف التطبيق.

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

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

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

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

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

إعلان بيني

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

تم منح المكافأة

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

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

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

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

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

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

بانر

بانر مقاس 300×250

إعلان بيني

تم منح المكافأة

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

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

تحديد مكان مفتاح Reporting API

عروض الأسعار

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

شلال

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

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

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

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

الخطوة 2: إعداد ميزة "تحقيق الربح من Liftoff" في Ad Manager واجهة المستخدم

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

عروض الأسعار

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

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

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

انقر على متابعة.

انقر على تم.

شلال

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

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

عروض الأسعار

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

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

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

شلال

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

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

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

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

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

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

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

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

دمج "استوديو Android" (إجراء يُنصح به)

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.5.0")
    implementation("com.google.ads.mediation:vungle:7.4.2.0")
}

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير برامج Vungle لنظام التشغيل Android واستخرِج ملفات .jar ضمن المجلد libs وأضِفها إلى مشروعك.
انتقِل إلى عناصر محوِّل Liftoff Monetize في مستودع Maven التابع لشركة Google. اختَر أحدث إصدار، ونزِّل ملف .aar الخاص بمحوِّل Vungle ، وأضِفه إلى مشروعك.

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

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

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

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

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0");

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setGDPRStatus(true, "v1.0.0")

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

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

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

Java

import com.vungle.ads.VunglePrivacySettings;
// ...

VunglePrivacySettings.setCCPAStatus(true);

Kotlin

import com.vungle.ads.VunglePrivacySettings
// ...

VunglePrivacySettings.setCCPAStatus(true)

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

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

لا يلزم استخدام رمز إضافي لدمج Liftoff Monetize.

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

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

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

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

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

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

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

يتيح محوِّل Liftoff Monetize معلَمات الطلب الإضافية التالية التي يمكن تمريرها إلى المحوِّل:

userId: سلسلة تمثّل رقم تعريف المستخدِم المُحفَّز في Liftoff Monetize
adOrientation: عدد صحيح يحدّد اتجاه العرض للإعلانات التي تظهر بملء الشاشة.

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

Java

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build();

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(VungleAdapter::class, extras) // Rewarded.
   .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
   .build()

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

يعرض محوِّل Liftoff Monetize إعلاناته المدمجة مع المحتوى على هيئة عناصر NativeAd . وتعبِّئ هذه السمة لملف شخصي على NativeAd.

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

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

رموز الخطأ

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

التنسيق	اسم الصف
إعلان على شاشة فتح التطبيق (عروض الأسعار)	com.google.ads.mediation.vungle.VungleMediationAdapter
إعلان على شاشة فتح التطبيق (عرض بدون انقطاع)	com.google.ads.mediation.vungle.VungleMediationAdapter
إعلان البانر (عروض الأسعار)	com.google.ads.mediation.vungle.VungleMediationAdapter
بانر (معروض بدون انقطاع)	com.vungle.mediation.VungleInterstitialAdapter
بيني (عروض الأسعار)	com.google.ads.mediation.vungle.VungleMediationAdapter
إعلان بيني (العرض الإعلاني بدون انقطاع)	com.vungle.mediation.VungleInterstitialAdapter
إعلانات تضمّ مكافأة (عروض الأسعار)	com.google.ads.mediation.vungle.VungleMediationAdapter
إعلانات تضمّ مكافأة (مُعدّة للعرض بدون انقطاع)	com.vungle.mediation.VungleAdapter
إعلان بيني يضمّ مكافأة (عروض الأسعار)	com.google.ads.mediation.vungle.VungleMediationAdapter
إعلان بيني يضمّ مكافأة (العرض بدون انقطاع)	com.google.ads.mediation.vungle.VungleMediationAdapter
إعلانات مدمَجة مع المحتوى (عروض الأسعار)	com.google.ads.mediation.vungle.VungleMediationAdapter
إعلانات مدمَجة مع المحتوى (العرض الإعلاني الانحداري)	com.google.ads.mediation.vungle.VungleMediationAdapter

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

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

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