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

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

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

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

المتطلبات

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

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

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

إذا كان تطبيقك متوافقًا مع نظامَي Android وiOS، عليك إعداد كلٍّ منهما بشكلٍ منفصل.

Android

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

iOS

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

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

اختَر بانر من أشكال الإعلانات المتاحة، ثم انقر على الزر إضافة وحدة إعلانية.

إعلان بيني

اختَر إعلان بيني من أشكال الإعلانات المتاحة، ثم انقر على الزر إضافة وحدة إعلانية.

تم منح المكافأة

اختَر إعلان فيديو يضم مكافأة من أشكال الإعلانات المتاحة، ثم انقر على الزر إضافة وحدة إعلانية.

مدمجة مع المحتوى

اختَر مدمَج مع المحتوى من أشكال الإعلانات المتاحة، ثم انقر على إضافة وحدة إعلانية.

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

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

تفعيل وضع الاختبار

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

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

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

Android

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

iOS

للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل استخدام iOS.

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبّتًا، يمكنك تثبيت "مكوّن توسّط myTarget" لإعلانات Google على Unity في مشروعك من خلال تنفيذ الأمر التالي من directory root لمشروعك:

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

OpenUPM

في محرِّر مشروع Unity، اختَر تعديل > إعدادات المشروع > مدير الحِزم لفتح إعدادات مدير حِزم Unity.

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

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

تفاصيل OpenUPM

بعد ذلك، انتقِل إلى النافذة > مدير الحِزم لفتح مدير حِزم Unity و اختَر السجلّات الخاصة بي من القائمة المنسدلة.

سجلات Unity

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

التثبيت من OpenUPM

حزمة Unity

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

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

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

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

حلّ المشاكل بالقوة

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

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

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

MyTarget.SetCCPAUserConsent(true);

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

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

تأكَّد من تسجيل جهازك الاختباري في "مدير إعلانات Google" وتفعيل وضع الاختبار في واجهة مستخدم 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 التي تم ضبطها في واجهة مستخدم Ad Manager غير متوفّرة أو غير صالحة.
102 لا يتطابق حجم الإعلان المطلوب مع حجم إعلان البانر المتوافق مع myTarget.
103 طلب الإعلان ليس طلب إعلان مدمجًا مع المحتوى موحّدًا.
104 يختلف الإعلان المدمج الذي تم تحميله من myTarget عن الإعلان المدمج المطلوب.
105 لا يتضمّن الإعلان المدمج مع المحتوى الذي تم تحميله من myTarget بعض مواد العرض المطلوبة (مثل الصورة أو الرمز).

iOS

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

سجلّ التغييرات في المكوّن الإضافي لتوسّط myTarget في Unity

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

  • تم تعديل المكوّن الإضافي ليتوافق مع الإصدار التجريبي المفتوح الجديد من Rewarded API.
  • متوافق مع الإصدار 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.