دمج 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. سيتم استخدام معرّف الشريحة هذا لإعداد وحدتك الإعلانية على AdMob في القسم التالي.

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

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

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

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

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

Android

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

iOS

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

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

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

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

OpenUPM-CLI

إذا كان OpenUPM-CLI مثبتًا لديك، يمكنك تثبيت

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(). يعرض الرمز النموذجي التالي كيفية تمرير معلومات موافقة المستخدم إلى حزمة myTarget SDK. إذا اختَرت استخدام هذه الطريقة، ننصحك بتنفيذها قبل طلب الإعلانات من خلال حزمة 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: اختبار عملية التنفيذ

رموز الخطأ

إذا تعذّر على المُحوِّل تلقّي إعلان من 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 حدث خطأ في حزمة myTarget SDK.
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.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 من محول Android myTarget.
  • يتوافق مع الإصدار 4.8.0.0 من محول iOS من myTarget.

الإصدار 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 من محول iOS من myTarget.

الإصدار 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() لإعادة توجيه حالة موافقة المستخدم إلى حزمة تطوير برامج 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.