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

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

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

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

يتضمن محوّل التوسط Ad Manager لخدمة DT Exchange الإمكانات التالية:

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

المتطلبات

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

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

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

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

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

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

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

Android

iOS

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

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

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

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

في محرِّر مشروعات Unity، اختَر مواد العرض >. استيراد الحزمة > مُخَصَّصْ الحزمة وابحث عن ملف GoogleMobileAdsFyberMediation.unitypackage الذي تريد تم تنزيله. تأكَّد من اختيار كل الملفات وانقر على استيراد.

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

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

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

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

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

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

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

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

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

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

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

أضاف المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لنظام DT Exchange الإصدار 3.1.1 صف واحد (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: اختبار عملية التنفيذ

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

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

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

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

رموز الخطأ

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

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل DT Exchange عند تعذّر تحميل إعلان:

Android

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

iOS

رمز الخطأ	السبب
0-10	حدث خطأ في حزمة DT Exchange SDK. الاطّلاع على المستندات لمزيد من التفاصيل.
101	معلَمات خادم DT Exchange التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
102	لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع DT Exchange.
103	تعذّر عرض الإعلان نظرًا لاستخدام عنصر الإعلان مسبقًا.
104	تعذّر عرض إعلانات DT Exchange لأنّ الإعلان غير جاهز.
105	عرَضَت حزمة تطوير البرامج (SDK) لـ DT Exchange خطأ في الإعداد.

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

الإصدار 3.3.0

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

الإصدار 3.2.1

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

الإصدار 3.2.0

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

الإصدار 3.1.12

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

الإصدار 3.1.11

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

الإصدار 3.1.10

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

الإصدار 3.1.8

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

الإصدار 3.1.7

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

الإصدار 3.1.6

يتوافق مع الإصدار 8.2.3.0 من محوّل Android DT Exchange.
يتوافق مع الإصدار 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 من محوّل Android DT Exchange.
يتوافق مع الإصدار 8.2.1.0 من محوّل DT Exchange لنظام التشغيل iOS.
تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 3.1.4

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

الإصدار 3.1.3

يتوافق مع الإصدار 8.2.1.0 من محوّل Android DT Exchange.
يتوافق مع الإصدار 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 من محوّل Android DT Exchange.
يتوافق مع الإصدار 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 على الأجهزة الجوّالة.

الإصدار 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.