دمج 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، عليك إعداد كل منصة منهما على حدة.

Android

بعد ذلك، أدخِل عنوان URL على Google Play لتطبيقك.

iOS

بعد ذلك، أدخِل عنوان URL على iTunes** لتطبيقك.

عند إضافة تطبيق، يطلب منك 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

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

Android

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

iOS

للحصول على التعليمات، راجِع الخطوة 2 في الدليل الخاص بأجهزة iOS.

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

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

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

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

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

dependencies:
  gma_mediation_mytarget: ^1.11.0

الدمج اليدوي

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

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

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

للحصول على التعليمات، راجِع الخطوة 4 في الدليل الخاص بأجهزة Android و iOS.

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

Android

لا يلزم استخدام أي رمز إضافي لدمج myTarget.

iOS

دمج SKAdNetwork

اتّبِع مستندات myTarget لإضافة معرّفات SKAdNetwork إلى ملف Info.plist في مشروعك.

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

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

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

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

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

رموز الخطأ

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

Android

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

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

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

Android

رمز الخطأ السبب
100 عرضت حزمة تطوير البرامج (SDK) من myTarget خطأً.
101 مَعلمات خادم myTarget التي تم ضبطها في واجهة مستخدم AdMob غير صالحة أو غير متوفّرة.
102 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع myTarget.
103 طلب عرض الإعلان ليس طلب إعلان مدمج مع المحتوى موحّد.
104 يختلف الإعلان المدمج مع المحتوى الذي تم تحميله من myTarget عن الإعلان المدمج مع المحتوى المطلوب.
105 يفتقر الإعلان المدمج مع المحتوى الذي تم تحميله من myTarget إلى بعض مواد العرض المطلوبة (مثل صورة أو رمز).

iOS

رمز الخطأ السبب
100 لا تتوفّر حاليًا إعلانات في حزمة تطوير البرامج (SDK) من myTarget.
101 مَعلمات خادم myTarget التي تم ضبطها في واجهة مستخدم AdMob غير صالحة أو غير متوفّرة.
102 لا يتوافق محوّل myTarget مع شكل الإعلان المطلوب.
103 تمت محاولة عرض إعلان من myTarget لم يتم تحميله.
104 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان بانر متوافق مع myTarget.
105 مواد عرض الإعلان المدمج مع المحتوى المطلوبة غير متوفّرة.

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

الإصدار 1.11.0

  • تم التحديث لدعم الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
  • يتوافق مع الإصدار 5.47.1.0 من محوّل myTarget لنظام التشغيل Android.
  • يتوافق مع الإصدار 5.43.0.0 من محوّل myTarget لنظام التشغيل iOS.
  • تمت عملية الإنشاء والاختبار باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.10.0

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

الإصدار 1.7.1

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

الإصدار 1.7.0

الإصدار 1.6.0

الإصدار 1.5.0

الإصدار 1.4.0

الإصدار 1.3.0

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0