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

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

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

يتضمّن محوِّل التوسّط في Unity لميزة DT Exchange الإمكانات التالية:

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

المتطلبات

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

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

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

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

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

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

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

Android

iOS

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

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

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

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

القائمة

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

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

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

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

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

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

قائمة الملف الشخصي للمستخدم

سجِّل معرّف الناشر ومفتاح المستهلِك وسر المستهلِك، لأنّك ستحتاج إلى هذه المعلومات في الخطوة التالية.

الملف الشخصي للمستخدم

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

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

Android

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

iOS

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

إضافة DT Exchange إلى قائمة شركاء الإعلانات بموجب "اللائحة العامة لحماية البيانات" واللوائح التنظيمية في الولايات الأمريكية

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت "مكوّن إضافي لتوسّط DT Exchange في إعلانات Google للأجهزة الجوّالة" لنظام Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.dtexchange

OpenUPM

في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حِزم Unity.

ضمن علامة التبويب السجلّات على مستوى النطاق، أضِف OpenUPM كسجلّ على مستوى النطاق باستخدام التفاصيل التالية:

  • الاسم: OpenUPM
  • عنوان URL: https://package.openupm.com
  • النطاقات: com.google

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

سجلات Unity

اختَر حِزمة Google Mobile Ads DT Exchange Mediation وانقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

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

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

الاستيراد من Unity

بعد ذلك، اختَر مواد العرض > مدير التبعيات الخارجية > Android Resolver > Force Resolve (حلّ المشاكل بالقوة). ستُجري مكتبة "مدير التبعية الخارجية" عملية حلّ التبعية من البداية وستنسخ التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android في تطبيق Unity.

حلّ المشاكل بالقوة

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

بموجب سياسة موافقة المستخدِم في الاتّحاد الأوروبي المتّبَعة في Google، عليك التأكّد من تقديم بيانات الإفصاح المعيّنة إلى المستخدِمين في المنطقة الاقتصادية الأوروبية والحصول على موافقاتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تراعي هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR). عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، و تقديم معلومات عن استخدام كل شبكة. لا يمكن لشركة 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");

يُرجى الانتقال إلى مقالة GDPR في 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: اختبار عملية التنفيذ

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

تأكَّد من تسجيل جهازك الاختباري في AdMob.

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

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

رموز الخطأ

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

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

رمز الخطأ السبب
101 مَعلمات خادم DT Exchange التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
103 لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع DT Exchange.
105 حمّلت حزمة تطوير البرامج (SDK) في DT Exchange إعلانًا، ولكنّها عرضت وحدة تحكّم غير متوقّعة.
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 Plugin

الإصدار 3.3.4

الإصدار 3.3.3

الإصدار 3.3.2

الإصدار 3.3.1

الإصدار 3.3.0

الإصدار 3.2.1

الإصدار 3.2.0

الإصدار 3.1.12

الإصدار 3.1.11

الإصدار 3.1.10

الإصدار 3.1.8

الإصدار 3.1.7

الإصدار 3.1.6

الإصدار 3.1.5

الإصدار 3.1.4

الإصدار 3.1.3

الإصدار 3.1.2

الإصدار 3.1.1

الإصدار 3.1.0

الإصدار 3.0.2

الإصدار 3.0.1

الإصدار 3.0.0

الإصدار 2.0.0

الإصدار 1.6.1

الإصدار 1.6.0

الإصدار 1.5.2

الإصدار 1.5.1

الإصدار 1.5.0

الإصدار 1.4.0

الإصدار 1.3.0

الإصدار 1.2.3

الإصدار 1.2.2

الإصدار 1.2.1

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0