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

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

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

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

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

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

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

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

المتطلّبات

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

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

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

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

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

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

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

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

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

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

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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

بانر

بانر 300×250

إعلان بيني

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

انقر على كيفية توقيع اتّفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع Liftoff Monetize.

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

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

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

ملاحظة مهمة: يجب Application ID ربط التطبيق المستهدَف بالتطبيق، كما هو الحال في Liftoff Monetize واجهة المستخدم.

شلال

ضمن بطاقة منهجية الشلال في قسم مصادر الإعلانات، اختَر إضافة مصدر الإعلان. بعد ذلك، اختَر Liftoff Monetize.

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

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

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

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

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

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

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

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

الدمج اليدوي

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

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

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

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

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

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

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

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

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

التنسيق	اسم الصف
بانر	GADMAdapterVungleInterstitial
إعلان بيني	GADMAdapterVungleInterstitial
تم منح المكافأة	إعلان فيديو يستند إلى GADMAdapterVungleReward

في ما يلي الرموز والرسائل المصاحبة التي يعرضها معدِّل تحقيق الربح من 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 التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة.
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 معاودة الاتصال بأنّ الإعلان غير قابل للتشغيل.

سجلّ تغييرات مهايئ مهايئ توسّط نظام التشغيل iOS Monetize Monetize