حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في وضع الصيانة للحصول على آخر التحديثات والميزات، عليك migrate وإعداد "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".

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

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

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

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

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

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

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

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

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

مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث

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

أحدث إصدار من Google Mobile Ads SDK (Legacy)
إعداد ميزة "توسّط 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

الدمج مع "استوديو Android" (يُنصح به)

في ملف gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

Kotlin

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

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:vungle:7.7.8.1'
}

الدمج اليدوي

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

الخطوة 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 (Legacy).

جافا

VunglePrivacySettings.setCCPAStatus(true);LiftoffMonetizeMediationSnippets.java

Kotlin

VunglePrivacySettings.setCCPAStatus(true)LiftoffMonetizeMediationSnippets.kt

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

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

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

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

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

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

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

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

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

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

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

userId: سلسلة تمثّل رقم تعريف المستخدم الذي يحصل على حوافز في Liftoff Monetize.
adOrientation: عدد صحيح يحدّد اتجاه العرض للإعلانات بملء الشاشة
setBackButtonImmediatelyEnabled: قيمة منطقية لتفعيل زر الرجوع أو إيقافه في "الإعلانات على شاشة فتح التطبيق" على الفور. اضبط القيمة على true لتفعيل زر الرجوع على الفور، أو على false في الحالات الأخرى. القيمة التلقائية هي false. لمزيد من المعلومات، يُرجى الاطّلاع على مستندات Liftoff Monetize حول كيفية دمج "الإعلانات على شاشة فتح التطبيق".

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

جافا

Bundle extras = new Bundle();
extras.putString(VungleConstants.KEY_USER_ID, "myUserID");
extras.putInt(VungleConstants.KEY_ORIENTATION, 1);
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true);

AdRequest request =
    new AdRequest.Builder()
        .addNetworkExtrasBundle(VungleAdapter.class, extras) // Rewarded.
        .addNetworkExtrasBundle(VungleInterstitialAdapter.class, extras) // Interstitial.
        // App Open ads use VungleMediationAdapter
        .addNetworkExtrasBundle(VungleMediationAdapter.class, extras)
        .build();LiftoffMonetizeMediationSnippets.java

Kotlin

val extras = Bundle()
extras.putString(VungleConstants.KEY_USER_ID, "myUserID")
extras.putInt(VungleConstants.KEY_ORIENTATION, 1)
// Optional: Enables the back button on App Open ads immediately.
extras.putBoolean(VungleConstants.KEY_BACK_BUTTON_IMMEDIATELY_ENABLED, true)

val request =
  AdRequest.Builder()
    .addNetworkExtrasBundle(VungleAdapter::class.java, extras) // Rewarded.
    .addNetworkExtrasBundle(VungleInterstitialAdapter::class.java, extras) // Interstitial.
    // App Open ads use VungleMediationAdapter
    .addNetworkExtrasBundle(VungleMediationAdapter::class.java, extras)
    .build()LiftoffMonetizeMediationSnippets.kt

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

يعرض محوّل 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.