دمج myTarget مع التوسّط

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

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

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

المتطلبات

• أحدث Google Mobile Ads Flutter Plugin
• ‫Flutter 3.7.0 أو إصدار أحدث
• للنشر على Android
  • مستوى واجهة برمجة التطبيقات 23 من Android أو إصدار أحدث
• للنشر على iOS
  • هدف النشر على iOS 13.0 أو إصدار أحدث
• مشروع Flutter يعمل وتم ضبطه باستخدام Google Mobile Ads Flutter Plugin. لمزيد من التفاصيل، يُرجى الاطّلاع على مقالة إعداد Google Mobile Ads Flutter Plugin.
• إعداد ميزة "توسّط AdMob".

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

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

إذا كان تطبيقك متوافقًا مع منصتَي Android وiOS، عليك إعداد كل منصة منهما على حدة.

عند إضافة تطبيق، يطلب منك myTarget إنشاء وحدة إعلانية قبل أن تتمكّن من إكمال العملية.

في صفحة تفاصيل وحدتك الإعلانية، سجِّل رقم تعريف موضع الإعلان الذي يمكن العثور عليه ضِمن إعدادات الوحدة الإعلانية باسم slot_id. سيتم استخدام رقم تعريف موضع الإعلان هذا لإعداد وحدتك الإعلانية على AdMob في القسم التالي.

بالإضافة إلى الـ slot_id، ستحتاج أيضًا إلى رمز الدخول الدائم على myTarget لإعداد رقم تعريف وحدتك الإعلانية على AdMob. انتقِل إلى علامة التبويب الملف الشخصي واختَر رموز الدخول. انقر على إنشاء رمز أو إظهار الرمز لعرض رمز الدخول الدائم على myTarget.

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

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

لتنفيذ app-ads.txt من أجل myTarget، يُرجى الاطّلاع على مقالة كيفية إنشاء ملف ونشره.

تفعيل "الوضع التجريبي"

اتّبِع التعليمات الواردة في مستندات myTarget لإضافة جهاز اختباري وضبطه في واجهة مستخدم myTarget.

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

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

إضافة Mail.ru إلى قائمة الشركاء الإعلانيين بموجب "اللائحة العامة لحماية البيانات" (GDPR) واللوائح التنظيمية في الولايات الأمريكية

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

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

التكامل من خلال pub.dev

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

dependencies:
  gma_mediation_mytarget: ^1.9.0

التكامل اليدوي

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

dependencies:
  gma_mediation_mytarget:
    path: path/to/local/package

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

للاطّلاع على التعليمات، يُرجى الرجوع إلى الخطوة 4 في دليل Android و iOS.

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

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

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

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

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

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

رموز الخطأ

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

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

سجلّ التغييرات في محوّل التوسّط لـ myTarget على Flutter

الإصدار 1.9.0

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1.
• تم التعديل ليتوافق مع الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• يتوافق مع الإصدار 5.27.4.1 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.39.1.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.8.0

• يتوافق مع الإصدار 5.27.4.1 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.39.1.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.7.1

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
• تم التعديل ليتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads

• يتوافق مع الإصدار 5.27.4.0 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.38.0.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.7.0

• يتوافق مع الإصدار 5.27.4.0 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.38.0.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.6.0

• يتوافق مع الإصدار 5.27.4.0 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.37.1.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.5.0

• يتوافق مع الإصدار 5.27.3.0 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.36.0.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.4.0

• يتوافق مع الإصدار 5.27.2.0 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.33.0.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.3.0

• يتوافق مع الإصدار 5.27.1.1 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.31.1.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.0

• يتوافق مع الإصدار 5.27.1.1 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.29.1.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.0

• يتوافق مع الإصدار 5.27.1.1 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.28.0.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.0

• الإصدار الأوّلي.
• يتوافق مع الإصدار 5.27.1.0 من محوّل myTarget على Android.
• يتوافق مع الإصدار 5.24.1.0 من محوّل myTarget على iOS.
• تمت عملية الإنشاء والاختبار باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.