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

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

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

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

المتطلبات

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الدمج من خلال pub.dev

أضف التبعية التالية مع أحدث إصدارات DT Exchange حزمة تطوير البرامج (SDK) والمحوّل في حزمتك ملف pubspec.yaml:

dependencies:
  gma_mediation_dtexchange: ^1.0.0

الدمج اليدوي

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

dependencies:
  gma_mediation_dtexchange:
    path: path/to/local/package

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

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

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

لا يتيح المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لـ DT Exchange إكمال الموافقة على نقل بيانات حزمة تطوير البرامج (SDK) لـ DT Exchange

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

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

لا يتيح المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لـ DT Exchange إكمال الموافقة على نقل بيانات حزمة تطوير البرامج (SDK) لـ DT Exchange

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

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

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

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

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

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

رموز الخطأ

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

com.google.ads.mediation.fyber.FyberMediationAdapter

GADMediationAdapterFyber

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

سجلّ تغييرات مهايئ توسّط Flutter DT Exchange

1.0.0

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