دمج 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 في AdMob واجهة المستخدِم

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

Android

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

iOS

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

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

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

OpenUPM-CLI

إذا كان لديك OpenUPM-CLI مثبتة، يمكنك تثبيت إعلانات Google للأجهزة الجوالة myTarget المكوّن الإضافي للتوسّط for Unity إلى مشروعك من خلال تشغيل الأمر التالي من الدليل الجذري لمشروعك:

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

OpenUPM

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

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

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

تفاصيل OpenUPM

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

سجلات الانسجام

اختَر حزمة توسّط myTarget لإعلانات Google على الأجهزة الجوّالة انقر على تثبيت.

التثبيت من OpenUPM

حزمة Unity

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

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

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

بعد ذلك، اختَر مواد العرض >. مدير التبعية الخارجية > أداة تحليل Android > فرض الحل: ستُجري مكتبة "مدير التبعية الخارجية" عملية حلّ التبعية من البداية وستنسخ التبعيات المعلَن عنها إلى الدليل Assets/Plugins/Android في تطبيق Unity.

فرض الحل

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

يتضمن المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 3.13.3 من 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 (Waterfall) مصادر الإعلانات.

رموز الخطأ

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

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

الإصدار 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 من محوّل Android myTarget.
  • يتوافق مع الإصدار 5.0.4.0 من محوِّل myTarget لنظام التشغيل iOS.

الإصدار 2.3.2

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

الإصدار 2.3.1

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

الإصدار 2.3.0

  • يتوافق مع الإصدار 5.2.2.0 من محول Android myTarget.
  • يتوافق مع الإصدار 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 من محول iOS من myTarget.

الإصدار 2.1.1

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

الإصدار

  • يتوافق مع الإصدار 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.