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

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

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

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

المتطلبات

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

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

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

إذا كان تطبيقك متوافقًا مع نظامَي 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 إلى قائمة شركاء الإعلانات بموجب "اللائحة العامّة لحماية البيانات" واللوائح التنظيمية السارية في الولايات الأمريكية

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

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

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

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

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

الإصدار 1.1.0

الإصدار 1.0.0