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

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

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

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

المتطلبات

  • أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • ‫Unity 2019.4 أو إصدار أحدث
  • للنشر على Android
    • المستوى 23 من واجهة برمجة التطبيقات Android أو مستوى أعلى
  • للنشر على أجهزة iOS
    • الإصدار المستهدف من نظام التشغيل iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity يعمل وتمّت تهيئته باستخدام حزمة "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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبَّتًا، يمكنك تثبيت myTarget Mediation Plugin for Unity في مشروعك من خلال تنفيذ الأمر التالي من الدليل الجذر لمشروعك:

openupm add com.google.ads.mobile.mediation.mytarget

OpenUPM

في أداة تعديل مشروع Unity، اختَر تعديل (Edit) > إعدادات المشروع (Project Settings) > إدارة الحِزم (Package Manager) لفتح إعدادات "إدارة حِزم Unity" (Unity Package Manager Settings).

ضمن علامة التبويب المستودعات المسجّلة ذات النطاق المحدود، أضِف OpenUPM كمستودع مسجّل ذي نطاق محدود مع التفاصيل التالية:

  • الاسم: OpenUPM
  • عنوان URL: https://package.openupm.com
  • النطاقات: com.google

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى Window (نافذة) > Package Manager (إدارة الحِزم) لفتح Unity Package Manager (إدارة حِزم Unity)، ثم اختَر My Registries (المستودعات الخاصة بي) من القائمة المنسدلة.

Unity Registries

اختَر حزمة Google Mobile Ads MyTarget Mediation وانقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

نزِّل أحدث إصدار من المكوّن الإضافي للتوسّط في "إعلانات Google على الأجهزة الجوّالة" لمنصة myTarget من رابط التنزيل في سجلّ التغيير، واستخرِج GoogleMobileAdsMyTargetMediation.unitypackage من ملف zip.

في أداة تعديل مشروع Unity، اختَر مواد العرض (Assets) > استيراد حزمة (Import Package) > حزمة مخصّصة (Custom Package)، وابحث عن ملف GoogleMobileAdsMyTargetMediation.unitypackage الذي نزّلته. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

الاستيراد من Unity

بعد ذلك، اختَر مواد العرض (Assets) > أداة إدارة التبعيات الخارجية (External Dependency Manager) > أداة حلّ المشاكل في Android (Android Resolver) > فرض الحلّ (Force Resolve). ستنفّذ مكتبة External Dependency Manager عملية تحديد العناصر التابعة من البداية، وستنسخ العناصر التابعة المحدّدة إلى الدليل Assets/Plugins/Android في تطبيق Unity.

فرض الحل

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

بموجب سياسة موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google، عليك التأكّد من تقديم إفصاحات معيّنة للمستخدمين في المنطقة الاقتصادية الأوروبية والحصول على موافقتهم بشأن استخدام معرّفات الأجهزة والبيانات الشخصية. تراعي هذه السياسة متطلبات "التوجيه الأوروبي بشأن الخصوصية الإلكترونية" و"اللائحة العامة لحماية البيانات" (GDPR) في الاتحاد الأوروبي. عند طلب الموافقة، عليك تحديد كل شبكة إعلانية في سلسلة التوسّط قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، وتقديم معلومات عن استخدام كل شبكة. في الوقت الحالي، لا يمكن لـ Google أن ينقل تلقائيًا خيار الموافقة الذي يحدّده المستخدم إلى هذه الشبكات.

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

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetUserConsent(true);

إذا كان المستخدم معروفًا بأنّه ينتمي إلى فئة محظورة على فئات عمرية معيّنة، يمكنك أيضًا استدعاء الطريقة SetUserAgeRestricted().

MyTarget.SetUserAgeRestricted(true);

يمكنك الاطّلاع على دليل الخصوصية واللائحة العامة لحماية البيانات في myTarget للحصول على مزيد من المعلومات.

قوانين الخصوصية في الولايات الأمريكية

تتطلّب قوانين الخصوصية في الولايات الأمريكية منح المستخدمين الحق في إيقاف "بيع" "معلوماتهم الشخصية" (وفق تعريف القانون لهاتَين العبارتَين)، باستخدام ميزة الإيقاف المقدّمة من خلال رابط بارز يتضمّن العبارة "عدم بيع معلوماتي الشخصية" على الصفحة الرئيسية للطرف الذي يُجري عملية "البيع". يتيح دليل الامتثال لقوانين الخصوصية في الولايات الأمريكية تفعيل المعالجة المحدودة للبيانات لعرض الإعلانات من Google، ولكن لا يمكن لـ Google تطبيق هذا الإعداد على كل شبكة إعلانية في سلسلة التوسّط. لذلك، عليك تحديد كل شبكة إعلانات في سلسلة التوسّط قد تشارك في بيع المعلومات الشخصية، واتّباع الإرشادات المقدَّمة من كل شبكة من هذه الشبكات لضمان الامتثال.

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

using GoogleMobileAds.Api.Mediation.MyTarget;
// ...

MyTarget.SetCCPAUserConsent(true);

يُرجى التواصل مع فريق دعم myTarget للحصول على مزيد من المعلومات.

الخطوة 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 Unity

الإصدار 3.28.0

الإصدار 3.27.1

الإصدار 3.27.0

الإصدار 3.26.0

الإصدار 3.25.0

الإصدار 3.24.0

الإصدار 3.23.0

الإصدار 3.22.0

الإصدار 3.21.1

الإصدار 3.21.0

الإصدار 3.20.0

الإصدار 3.19.0

الإصدار 3.18.2

الإصدار 3.18.1

الإصدار 3.18.0

الإصدار 3.17.1

الإصدار 3.17.0

الإصدار 3.16.2

الإصدار 3.16.1

الإصدار 3.16.0

الإصدار 3.15.0

الإصدار 3.14.0

الإصدار 3.13.2

الإصدار 3.13.1

الإصدار 3.13.0

الإصدار 3.12.0

الإصدار 3.11.4

الإصدار 3.11.3

الإصدار 3.11.2

الإصدار 3.11.1

الإصدار 3.11.0

الإصدار 3.10.2

الإصدار 3.10.1

الإصدار 3.10.0

الإصدار 3.9.0

الإصدار 3.8.2

الإصدار 3.8.1

الإصدار 3.8.0

الإصدار 3.7.0

الإصدار 3.6.1

الإصدار 3.6.0

الإصدار 3.5.2

الإصدار 3.5.1

الإصدار 3.5.0

الإصدار 3.4.0

الإصدار 3.3.0

الإصدار 3.2.0

الإصدار 3.1.0

الإصدار 3.0.0

  • تم تعديل المكوّن الإضافي ليتوافق مع واجهة برمجة التطبيقات الجديدة للإصدار التجريبي المفتوح لميزة "الإعلانات مقابل مكافآت".
  • يتوافق مع الإصدار 5.3.9.0 من محوّل myTarget Android.
  • يتوافق مع الإصدار 5.0.4.0 من محوّل myTarget iOS.

الإصدار 2.3.2

  • يتوافق مع الإصدار 5.2.5.0 من محوّل myTarget Android.
  • يتوافق مع الإصدار 4.8.9.0 من محوّل myTarget لنظام التشغيل iOS.

الإصدار 2.3.1

  • يتوافق مع الإصدار 5.2.5.0 من محوّل myTarget Android.
  • يتوافق مع الإصدار 4.8.5.0 من محوّل myTarget لنظام التشغيل iOS.

الإصدار 2.3.0

  • يتوافق مع الإصدار 5.2.2.0 من محوّل myTarget Android.
  • يتوافق مع الإصدار 4.8.0.0 من محوّل myTarget iOS.

الإصدار 2.2.0

  • يتوافق مع الإصدار 5.1.4.0 من محوّل myTarget لنظام التشغيل Android.
  • يتوافق مع الإصدار 4.8.0.0 من محوّل myTarget iOS.

الإصدار 2.1.2

  • يتوافق مع الإصدار 5.1.3.0 من محوّل myTarget Android.
  • يتوافق مع الإصدار 4.7.11.0 من محوّل myTarget iOS.

الإصدار 2.1.1

  • يتوافق مع الإصدار 5.1.1.0 من محوّل myTarget Android.
  • يتوافق مع الإصدار 4.7.10.0 من محوّل myTarget لنظام التشغيل iOS.

الإصدار 2.1.0

  • يتوافق مع الإصدار 5.1.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من myTarget.
  • يتوافق مع الإصدار 4.7.9 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من myTarget.
  • تمت إضافة الطرق التالية:
    • طريقة MyTarget.SetUserConsent() لإعادة توجيه حالة موافقة المستخدم إلى حزمة تطوير البرامج (SDK) الخاصة بمنصة MyTarget
    • MyTarget.SetUserAgeRestricted، وهي طريقة تضبط علامة للإشارة إلى ما إذا كان المستخدم معروفًا بأنّه ينتمي إلى فئة محظورة على فئات عمرية معيّنة (أي أقل من 16 عامًا).
    • طريقة MyTarget.IsUserConsent() للحصول على حالة الموافقة الحالية للمستخدم
    • MyTarget.IsUserAgeRestricted() طريقة للحصول على العلامة التي تشير إلى أنّ المستخدم معروف بأنّه ينتمي إلى فئة محظورة على فئات عمرية معيّنة (أي أقل من 16 عامًا).

الإصدار 2.0.1

  • يتوافق مع الإصدار 5.0.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من myTarget.
  • يتوافق مع الإصدار 4.7.8 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من myTarget.

الإصدار 2.0.0

  • يتوافق مع الإصدار 5.0.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من myTarget.
  • يتوافق مع الإصدار 4.7.7 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من myTarget.

الإصدار 1.1.0

  • يتوافق مع الإصدار 4.7.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من myTarget.
  • يتوافق مع الإصدار 4.7.6 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من myTarget.

الإصدار 1.0.0

  • الإصدار الأول!
  • يتوافق مع الإصدار 4.6.27 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من myTarget.
  • يتوافق مع الإصدار 4.6.24 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من myTarget.