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

دمج ميزة تحقيق الربح مع التوسّط

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

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

يتمتع Ad Manager محوّل التوسط لتطبيق Liftoff Monetize بالإمكانات التالية:

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

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

² يتوفّر دمج عروض الأسعار لهذا الشكل في إصدار تجريبي مغلق.

³ تتطلب الصفحة البينية التي تضم مكافأة المساعدة في إعدادها. تواصَل مع مدير حسابك على Liftoff Monetize أو monetize@liftoff.io.

المتطلّبات

المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى

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

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

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

أضف تطبيقك إلى لوحة تحكم Liftoff Monetize عن طريق النقر على الزر Add Application (إضافة تطبيق).

املأ النموذج، مع إدخال جميع التفاصيل المطلوبة.

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

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

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

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

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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

بانر

بانر 300×250

إعلان بيني

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

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

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

تحديد موقع مفتاح واجهة برمجة التطبيقات Reporting API

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

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

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

عروض الأسعار

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

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

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

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

انقر على تم.

شلال

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

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

عروض الأسعار

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

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

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

شلال

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

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

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

أدخِل القيمة Application ID and Placement Reference ID التي تم الحصول عليها في القسم السابق، وقيمة التكلفة التلقائية لكل ألف ظهور. انقر على حفظ.

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

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

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

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

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

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

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

الدمج اليدوي

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

الخطوة 4: تنفيذ إعدادات الخصوصية في Liftoff Monetize SDK

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

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

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

Java

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

VunglePrivacySettings.setGDPRStatus(true, "1.0.0");

Kotlin

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

VunglePrivacySettings.setGDPRStatus(true, "1.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: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager وتفعيل وضع الاختبار في واجهة المستخدم Liftoff Monetize .

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

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

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

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

يتيح محوّل 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.getAdapterResponse() ضمن الفئات التالية:

التنسيق	اسم الصف
بانر	com.vungle.mediation.VungleInterstitialAdapter
إعلان بيني	com.vungle.mediation.VungleInterstitialAdapter
تم منح المكافأة	com.vungle.mediation.VungleAdapter

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

رمز الخطأ	النطاق	السبب
0-‏100	com.vungle.warren	عرضت حزمة Vungle SDK خطأً. اطّلِع على المستند لمزيد من التفاصيل.
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	لا يمكن لحزمة Vungle SDK تحميل إعلانات متعددة لرقم تعريف موضع الإعلان نفسه.
105	com.google.ads.mediation.vungle	تعذّر إعداد Vungle SDK.
106	com.google.ads.mediation.vungle	عرضت Vungle SDK استدعاء تحميل ناجحًا، ولكن Banners.getBanner() أو Vungle.getNativeAd() قيمة فارغة.
107	com.google.ads.mediation.vungle	حزمة Vungle SDK ليست جاهزة لعرض الإعلان.
1-100	تم الإرسال من قِبل Vungle SDK	عرضت حزمة Vungle SDK خطأً. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
101	com.google.mediation.vungle	مَعلمات خادم Liftoff Monetize التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة/غير صالحة.
102	com.google.mediation.vungle	سبق أن تم تحميل إعلان لإعداد الشبكة هذه. لا يمكن لحزمة Vungle SDK تحميل إعلان ثاني برقم تعريف موضع الإعلان نفسه.
103	com.google.mediation.vungle	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع Liftoff Monetize.
104	com.google.mediation.vungle	تعذّر على Vungle SDK عرض إعلان البانر.
105	com.google.mediation.vungle	تتيح Vungle SDK تحميل إعلان بانر واحد فقط في كل مرة، بصرف النظر عن رقم تعريف موضع الإعلان.
106	com.google.mediation.vungle	أرسلَت Vungle SDK معاودة الاتصال بأنّ الإعلان غير قابل للتشغيل.