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

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

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

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

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

التكامل
عروض الأسعار
شلال
التنسيقات
إعلان على شاشة فتح التطبيق	^{1، 2}
بانر	¹
إعلان بيني
تم منح المكافأة
إعلان بيني يضمّ مكافأة	¹
مدمجة مع المحتوى	^{1، 2}

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

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

المتطلبات

إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
[لعروض الأسعار]: محوِّل Liftoff Monetize‏ 6.11.0.1 أو إصدار أحدث (ننصح باستخدام أحدث إصدار)

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

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

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

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

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

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

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

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

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

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

إعلان على شاشة فتح التطبيق

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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

إعلان على شاشة فتح التطبيق

بانر

بانر مقاس 300×250

إعلان بيني

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

ضبط إعدادات التوسّط لوحدتك الإعلانية

عليك إضافة Liftoff Monetize إلى إعدادات التوسّط لوحدتك الإعلانية.

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

لإنشاء مجموعة توسّط جديدة، اختَر إنشاء مجموعة توسّط.

أدخِل تنسيق الإعلان والمنصّة، ثم انقر على متابعة.

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

اربط مجموعة التوسّط هذه بوحدة إعلانية واحدة أو أكثر من وحدات AdMob الإعلانية الحالية. بعد ذلك، انقر على تم.

من المفترض أن تظهر لك الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة Liftoff Monetize كمصدر إعلان

عروض الأسعار

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، انقر على تحقيق الربح من Liftoff .
انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار باستخدام Liftoff Monetize.

انقر على الإقرار والموافقة، ثم انقر على متابعة.

إذا كان لديك تعيين حاليًا لخدمة Liftoff Monetize، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

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

شلال

ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، انقر على Liftoff Monetize.

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

إذا كان لديك تعيين لميزة Liftoff Monetize، يمكنك اختياره. بخلاف ذلك، انقر على إضافة تعيين.

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

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

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

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

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

استخدام CocoaPods (إجراء يُنصح به)

أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
```
pod 'GoogleMobileAdsMediationVungle'
```
من سطر الأوامر، شغِّل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) من Vungle واستخدم الرابط VungleSDK.framework في مشروعك.
نزِّل أحدث إصدار من محوِّل Liftoff Monetize من رابط التنزيل في سجلّ التغييرات والرابط LiftoffMonetizeAdapter.framework في مشروعك.
أضِف الإطارات التالية إلى مشروعك:
- AdSupport
- AudioToolbox
- AVFoundation
- CFNetwork
- CoreGraphics
- CoreMedia
- libz.tbd
- MediaPlayer
- QuartzCore
- StoreKit
- SystemConfiguration

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

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

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

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

Swift

import VungleAdsSDK
// ...

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

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setGDPRStatus:YES];
[VunglePrivacySettings setGDPRMessageVersion:@"v1.0.0"];

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

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

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

Swift

import VungleAdsSDK
// ...

VunglePrivacySettings.setCCPAStatus(true)

Objective-C

#import <VungleAdsSDK/VungleAdsSDK.h>
// ...

[VunglePrivacySettings setCCPAStatus:YES];

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

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

دمج SKAdNetwork

اتّبِع مستندات Liftoff Monetize لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.

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

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

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

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

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

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

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

يتيح محوِّل Liftoff Monetize مَعلمة طلب إضافية يمكن تمريرها إلى المحوِّل باستخدام فئة VungleAdNetworkExtras. تتضمّن هذه الفئة السمات التالية:

userId: سلسلة تمثّل رقم تعريف المستخدِم المُحفَّز في Liftoff Monetize
nativeAdOptionPosition: عدد صحيح يحدّد موضع رمز الخصوصية للإعلانات المدمجة مع المحتوى

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

Swift

#import "VungleAdapter.h"
// ...

let request = GADRequest()
let extras = VungleAdNetworkExtras()
extras.userId = "myUserID"
extras.nativeAdOptionPosition = 1
// ...
request.register(extras)

Objective-C

#import <LiftoffMonetizeAdapter/VungleAdapter.h>
// ...

GADRequest *request = [GADRequest request];
VungleAdNetworkExtras *extras = [[VungleAdNetworkExtras alloc] init];
extras.userId = @"myUserID";
extras.nativeAdOptionPosition = 1;
// ...
[request registerAdNetworkExtras:extras];

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

يعرض محوِّل 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 carregar um anúncio segundo para o mesmo número de identificação do local.
103	com.google.mediation.vungle	لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع ميزة "تحقيق الربح من Liftoff".
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.