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

دمج DT Exchange مع التوسّط

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

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

يتضمّن محوِّل AdMob التوسّط الخاص بـ DT Exchange الإمكانات التالية:

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

المتطلّبات

Unity 4 أو أعلى
أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
للنشر على Android:
- المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
مشروع Unity عملي تم إعداده باستخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على مزيد من التفاصيل.
إكمال عملية التوسّط دليل البدء

الخطوة 1: ضبط عمليات الضبط في واجهة مستخدم DT Exchange

إضافة تطبيق جديد وموضع إعلان جديد

الاشتراك أو تسجيل الدخول إلى DT Exchange Console

انقر على الزر إضافة تطبيق لإضافة تطبيقك.

إدارة التطبيقات

حدد النظام الأساسي، واملأ بقية النموذج، ثم انقر على إضافة مواضع إعلانات.

Android

iOS

أدخِل اسمًا للموضع الجديد في الحقل تسمية موضع الإعلان واختَر نوع الموضع المطلوب من القائمة المنسدلة. وأخيرًا، انقر على حفظ الموضع.

ضبط إعدادات الجهاز

رقم تعريف التطبيق ورقم تعريف موضع الإعلان

افتح شريط التنقل الأيمن من خلال تمرير مؤشر الماوس فوقه. ثم انقر على التطبيقات من القائمة اليمنى.

في صفحة إدارة التطبيق، دوِّن رقم تعريف التطبيق بجانب تطبيقك.

رقم تعريف التطبيق

اختر تطبيقك، وانتقل إلى علامة التبويب مواضع الإعلانات، ثم انقر على رمز النسخ بجانب اسم موضع الإعلان. دوِّن رقم تعريف موضع الإعلان.

رقم تعريف موضع الإعلان

الرقم التعريفي للناشر ومفتاح المستهلك وسر العميل

انقر على اسم المستخدم من القائمة اليمنى واختَر الملف الشخصي للمستخدم.

دوِّن الرقم التعريفي للناشر ومفتاح المستهلك وسر المستخدم لأنها مطلوبة في الخطوة التالية.

الخطوة 2: إعداد طلب DT Exchange في AdMob واجهة المستخدم

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

Android

للحصول على التعليمات، اطّلِع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

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

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) الخاصة بـ DT Exchange ومحوّلها

نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في DT Exchange من رابط التنزيل في سجلّ التغييرات واستخرج GoogleMobileAdsFyberMediation.unitypackage من ملف zip.

في محرر مشروع Unity، حدد Assets >Import Package > Custom Package وابحث عن الملف GoogleMobileAdsFyberMediation.unitypackage الذي قمت بتنزيله. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة أداة حلّ المشاكل في Unity Play Services حل التبعية من البداية، وتنسخ التبعيات المُعلَن عنها إلى دليل Assets/Plugins/Android في تطبيق Unity.

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

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

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

يوضّح هذا القسم كيفية تفعيل الإعلانات المخصّصة أو إيقافها لخدمة DT Exchange.

أضاف المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 1.1.0 من DT Exchange الفئة Fyber مع الطريقتَين SetGDPRRequired() وSetGDPRConsentString()، ما يتيح لك نقل معلومات الموافقة إلى DT Exchange يدويًا. يوضح الرمز النموذجي التالي كيفية تمرير هذه المعلمات إلى محوّل DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetGDPRConsent(true);
Fyber.SetGDPRConsentString("myGDPRConsentString");

يمكنك الاطّلاع على مقالة اللائحة العامة لحماية البيانات على DT Exchange لمعرفة المزيد من المعلومات والقيم التي يمكن تقديمها باستخدام الطريقة.

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

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

أضاف المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 3.1.1 من DT Exchange الفئة Fyber مع الطريقة SetCCPAString()، ما يسمح لك بتمرير معلومات الموافقة إلى DT Exchange يدويًا. يوضح الرمز النموذجي التالي كيفية تمرير هذه المعلمات إلى محول DT Exchange:

using GoogleMobileAds.Api.Mediation.Fyber;
// ...

Fyber.SetCCPAString("myCCPAConsentString");

// You can also clear CCPA consent information using the following method:
Fyber.ClearCCPAString();

يمكنك الاطّلاع على مقالة المصدر المفتوح المصدر لقانون خصوصية المستهلك في كاليفورنيا (CCPA) على موقع DT Exchange للحصول على مزيد من المعلومات والقيم التي يمكن تقديمها من خلال الطريقة.

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

Android

ليس من المطلوب استخدام رمز إضافي لدمج DT Exchange.

iOS

دمج SKAdNetwork

اتّبِع مستندات DT Exchange لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

احرص على تسجيل جهاز الاختبار من أجل AdMob.

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

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

رموز الخطأ

إذا تعذَّر على المحوّل تلقّي إعلان من DT Exchange، يمكن للناشرين التحقّق من الخطأ الأساسي من استجابة الإعلان باستخدام ResponseInfo ضمن الفئة التالية:

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

رمز الخطأ	السبب
101	معلمات خادم DT Exchange التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة.
103	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع DT Exchange.
105	حمَّلت DT Exchange SDK إعلانًا ولكنّه عرَضَ وحدة تحكُّم غير متوقَّعة.
106	الإعلان غير جاهز للعرض.
200-399	حدث خطأ في حزمة DT Exchange SDK. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.

iOS

رمز الخطأ	السبب
0-10	حدث خطأ في حزمة DT Exchange SDK. يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.
101	معلمات خادم DT Exchange التي تم ضبطها في AdMob واجهة المستخدم غير متوفّرة/غير صالحة.
102	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع DT Exchange.
103	تعذّر عرض الإعلان لأنّه سبق استخدام كائن الإعلان.
104	تعذّر عرض إعلانات DT Exchange لأنّ الإعلان غير جاهز.
105	عرضت حزمة DT Exchange SDK خطأ في الإعداد.

سجلّ تغييرات المكوّن الإضافي DT Exchange Unity Mediation

الإصدار 3.1.8

يتوافق الجهاز مع الإصدار 8.2.5.0 من محوّل DT Exchange الذي يعمل بنظام التشغيل Android.
يتوافق مع الإصدار 8.2.6.0 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 8.6.0 من المكوّن الإضافي لبرنامج Unity إضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.7

يتوافق الجهاز مع الإصدار 8.2.4.0 من محوّل DT Exchange الذي يعمل بنظام التشغيل Android.
يتوافق مع الإصدار 8.2.4.0 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 8.5.2 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.6

يتوافق مع الإصدار 8.2.3.0 من محوّل DT Exchange المتوافق مع Android.
يتوافق مع الإصدار 8.2.3.0 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 8.4.1 من المكوّن الإضافي لبرنامج Unity إضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.5

تم نقل محتوى المحوّل إلى GoogleMobileAds/Mediation/DTExchange/.
تمت إعادة ضبط مساحة اسم المحوّل لاستخدام GoogleMobileAds.Mediation.DTExchange.
يتوافق مع الإصدار 8.2.3.0 من محوّل DT Exchange المتوافق مع Android.
يتوافق مع الإصدار 8.2.1.0 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 8.1.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.4

يتوافق مع الإصدار 8.2.2.0 من محوّل DT Exchange الذي يعمل بنظام التشغيل Android.
يتوافق مع الإصدار 8.1.9.1 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء الإصدار 7.4.1 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.4.1.

الإصدار 3.1.3

يتوافق الجهاز مع الإصدار 8.2.1.0 من محوّل DT Exchange الذي يعمل بنظام التشغيل Android.
يتوافق مع الإصدار 8.1.9.0 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 7.4.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.2

تم تغيير اسم المكوّن الإضافي لتوسّط Unity إلى "DT Exchange".
تمت إعادة تسمية الصف "GoogleMobileAds.Api.Mediation.Fyber.Fyber" إلى "GoogleMobileAds.Api.Mediation.DTExchange.DTExchange".
يتوافق الجهاز مع الإصدار 8.2.1.0 من محوّل DT Exchange الذي يعمل بنظام التشغيل Android.
يتوافق مع الإصدار 8.1.7.0 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.1 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.1

تمت إضافة الطرق التالية إلى الفئة Fyber:
- SetCCPAString(string)
- ClearCCPAString()
يتوافق مع الإصدار 8.2.0.0 من محوّل Fyber Android.
يتوافق مع الإصدار 8.1.6.0 من محوّل Fyber iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.0

يتوافق مع الإصدار 8.2.0.0 من محوّل Fyber Android.
يتوافق مع الإصدار 8.1.5.0 من محوّل Fyber iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 7.2.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.0.2

يتوافق مع الإصدار 8.1.3.1 من محوّل Fyber Android.
يتوافق مع الإصدار 8.1.5.0 من محوّل Fyber iOS.
تم إنشاء الإصدار 7.0.2 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.0.2.

الإصدار 3.0.1

يتوافق مع الإصدار 8.1.3.0 من محوّل Fyber Android.
يتوافق مع الإصدار 8.1.4.0 من محوّل Fyber لنظام التشغيل iOS.
تم إنشاء البرنامج واختباره باستخدام الإصدار 7.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 1.1.0

تمت إضافة الطرق التالية إلى الفئة Fyber لتلبية متطلبات اللائحة العامة لحماية البيانات:
- SetGDPRConsent()
- SetGDPRConsentString()
- ClearGDPRConsentData()
يتوافق مع الإصدار 7.3.4.0 من محوّل Fyber Android.
يتوافق مع الإصدار 7.5.0.0 من محوّل Fyber لنظام التشغيل iOS.

الإصدار 1.0.0

الإصدار الأول
يتوافق مع الإصدار 7.3.4.0 من محوّل Fyber Android.
يتوافق مع الإصدار 7.4.0.0 من محوّل Fyber iOS.