يوضِّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" لتحميل إعلانات من DT Exchange وعرضها باستخدام التوسّط، والتي تغطي عمليات الدمج في العرض الإعلاني بدون انقطاع. حيث يتناول كيفية إضافة DT Exchange إلى إعدادات التوسّط في وحدة إعلانية، وكيفية دمج محوّل وحزمة DT Exchange SDK في Flutter تطبيق.
عمليات الدمج وأشكال الإعلانات المتوافقة
يتضمّن محوِّل AdMob التوسّط الخاص بـ DT Exchange الإمكانات التالية:
الدمج | |
---|---|
عروض الأسعار | |
شلال | |
التنسيقات | |
بانر | |
إعلان بيني | |
تم منح المكافأة |
المتطلّبات
- أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android:
- المستوى 21 من واجهة برمجة تطبيقات Android أو أعلى
- للنشر على iOS:
- هدف نشر iOS هو 12.0 أو إصدار أحدث
- مشروع Flutter يعمل باستخدام حزمة 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 ومحوّلها
الدمج من خلال 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، عليك التأكّد من الإفصاح عن معلومات محدّدة للمستخدمين في المنطقة الاقتصادية الأوروبية والحصول على موافقات منهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتّحاد الأوروبي. عند طلب الحصول على موافقة، يجب عليك تحديد كل شبكة إعلانات في سلسلة التوسط قد تجمع البيانات الشخصية أو تتلقاها أو تستخدمها، وتقدم معلومات عن استخدام كل شبكة. ولا يمكن لشركة Google حاليًا تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
لا يتيح المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" في DT Exchange تمرير معلومات الموافقة إلى حزمة DT Exchange SDK.
قوانين الخصوصية في الولايات الأمريكية
قوانين الخصوصية في الولايات الأمريكية تتطلب من المستخدمين منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفقًا لما يحدّده القانون) لهذه المصطلحات)، وذلك من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف "البيع". إنّ دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية يوفّر إمكانية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات على Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل شبكة إعلانات في سلسلة التوسّط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية واتّباع الإرشادات من كل شبكة من هذه الشبكات لضمان الامتثال لها.
لا يتيح المكوّن الإضافي لتوسّط "إعلانات Google على الأجهزة الجوّالة" في DT Exchange تمرير معلومات الموافقة إلى حزمة DT Exchange SDK.
الخطوة 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 خطأ في الإعداد. |
1.0.0
- الإصدار الأولي.
- تم التحقق من التوافق مع محوّل DT Exchange Android الإصدار 8.2.6.1
- تم التحقق من التوافق مع محوّل DT Exchange على iOS الإصدار 8.2.7.0