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

اختيار النظام الأساسي: Android جديد Android iOS Unity Flutter

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

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

يتضمّن برنامج التكيّف الخاص بالتوسّط في Unity لمنصة DT Exchange الإمكانات التالية:

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

1يتوفّر شكل الإعلان المدمج مع المحتوى في إصدار تجريبي مغلق لعروض الأسعار. يُرجى التواصل مع مدير حسابك لطلب إذن الوصول.

المتطلبات

  • أحدث محتوى من قناة Google Mobile Ads Unity Plugin
  • ‫Unity 4 أو الإصدارات الأحدث
  • [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّنًا إضافيًا للتوسّط في "إعلانات Google على الأجهزة الجوّالة" من أجل DT Exchange 3.3.12 أو إصدار أحدث (يُنصح باستخدام أحدث إصدار)
  • للنشر على Android
    • مستوى واجهة برمجة التطبيقات 23 من Android أو مستوى أعلى
  • للنشر على أجهزة iOS، اتّبِع الخطوات التالية:
    • الإصدار المستهدف من نظام التشغيل iOS هو 13.0 أو إصدار أحدث
  • يجب أن يكون لديك مشروع Unity يعمل وتم إعداده باستخدام Google Mobile Ads Unity Plugin. راجِع مقالة إعداد Google Mobile Ads Unity Plugin لمعرفة التفاصيل.
  • إعداد التوسّط

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

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

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

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

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

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

Android

iOS

أدخِل الأسماء واختَر الأنواع لمواضع الإعلان، ثم انقر على حفظ موضع الإعلان.

الإعداد

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

مرِّر مؤشر الماوس فوق شريط التنقل الأيمن لفتحه، ثم انقر على إدارة التطبيقات.

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

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

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

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

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

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

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

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" أو ملف app-ads.txt هي مبادرة يقدّمها "مختبر IAB التقني" للمساعدة في ضمان عدم بيع مساحات إعلانية متاحة في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. ولمنع حدوث خسارة كبيرة في إيرادات الإعلانات، عليك تنفيذ ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، أنشئ ملف app-ads.txt في "إدارة الإعلانات".

لتنفيذ app-ads.txt في DT Exchange، أضِف DT إلى ملف app-ads.txt.

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت Google Mobile Ads DT Exchange Mediation Plugin for Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

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

OpenUPM

في محرِّر مشروع Unity، انقر على تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات إدارة حِزم Unity (Unity Package Manager Settings).

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

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

تفاصيل‫ OpenUPM

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

Unityمستودعات ‫

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

التثبيت من‫ OpenUPM

Unity Package

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

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

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

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

فرض الحل

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

للامتثال لسياسة موافقة المستخدم في الاتحاد الأوروبي المتّبعة في 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");

يمكنك الانتقال إلى مقالة اللائحة العامة لحماية البيانات في 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: اختبار عملية الإعداد

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

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

تأكيد الإعلانات الاختبارية

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

رموز الخطأ

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

Android

com.google.ads.mediation.fyber.FyberMediationAdapter

iOS

GADMediationAdapterFyber

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

Android

رمز الخطأ السبب
101 معلمات خادم DT Exchange التي تم ضبطها في واجهة مستخدم "مدير إعلانات Google" غير متوفّرة أو غير صالحة.
103 لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع DT Exchange.
105 حمّلت حزمة تطوير البرامج (SDK) في "العرض المباشر" إعلانًا ولكنها عرضت أداة تحكّم غير متوقّعة.
106 الإعلان غير جاهز للعرض.
107 السياق ليس مثيلاً لنشاط.
108 تعذّر عرض الإعلان.
200-399 عرَض حزمة تطوير البرامج (SDK) في "التقارير الديناميكية" خطأً. يمكنك الاطّلاع على الرمز لمزيد من التفاصيل.

iOS

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

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

الإصدار 3.5.9

الإصدار 3.5.8

الإصدار 3.5.7

الإصدار 3.5.6

الإصدار 3.5.5

الإصدار 3.5.4

الإصدار 3.5.3

الإصدار 3.5.2

الإصدار 3.5.1

الإصدار 3.5.0

الإصدار 3.4.0

الإصدار 3.3.12

الإصدار 3.3.11

الإصدار 3.3.10

الإصدار 3.3.9

الإصدار 3.3.8

الإصدار 3.3.7

الإصدار 3.3.6

الإصدار 3.3.5

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