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

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

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

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

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

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

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

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

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

المتطلبات

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

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

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

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

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

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

الخطوة 3: استيراد Vungle SDK ومحوّل

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

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

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

الدمج اليدوي

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

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

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

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

يتضمن Liftoff Monetize واجهة برمجة تطبيقات تتيح لك تمرير الموافقة إلى Vungle SDK. يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة هذه إلى Vungle SDK. إذا اخترت استدعاء هذه الطريقة، فمن المستحسن أن تفعل ذلك قبل طلب الإعلانات من خلال "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")

يُرجى الاطّلاع على تعليمات التنفيذ المقترَحة بموجب اللائحة العامة لحماية البيانات (GDPR). لمزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات 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.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 الحجم.
103	com.google.ads.mediation.vungle	يجب توفير `Activity`سياق للطلب في Liftoff Monetize الإعلانات.
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 غير جاهز لتشغيل الإعلان.
108	com.google.ads.mediation.vungle	عرَضَ Vungle SDK رمزًا مميزًا غير صالح لعروض الأسعار.

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