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

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

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

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

المتطلبات

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

الخطوة 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 التقني" للمساعدة في ضمان عدم بيع المساحة المتوفّرة للإعلانات في تطبيقك سوى من خلال القنوات التي حدَّدت أنّها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف 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: ^

الدمج اليدوي

نزِّل أحدث إصدار من مكوّن التوسّط الإضافي في "إعلانات Google على الأجهزة الجوّالة" لمنصة 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 Adapter مع شكل الإعلان المطلوب.
103 محاولة عرض إعلان myTarget لم يتم تحميله
104 لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع myTarget.
105 مواد عرض الإعلانات المدمجة مع المحتوى المطلوبة غير متوفّرة.

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

الإصدار 1.4.0

الإصدار 1.3.0

الإصدار 1.2.0

الإصدار 1.1.0

الإصدار 1.0.0