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

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

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

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

المتطلّبات

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

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

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

إذا كان تطبيقك متوافقًا مع نظامَي التشغيل Android وiOS، عليك إعداد كل منهما على حدة.

Android

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

iOS

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

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

اختَر BANNER من أشكال الإعلانات المتاحة، ثم انقر على الزر BANNER.

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

يشتمل المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 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 على الأجهزة الجوّالة للإصدار 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: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل 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 حدث خطأ في حزمة myTarget SDK.
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 لم يتم إدخال مواد عرض الإعلانات المدمجة مع المحتوى.

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

الإصدار 3.15.0

الإصدار 3.14.0

الإصدار 3.13.2

الإصدار 3.13.1

الإصدار 3.13.0

الإصدار 3.12.0

الإصدار 3.11.4

الإصدار 3.11.3

  • تمت إعادة تسمية الطريقة IsConsent() من الفئة MyTarget إلى GetUserConsent().
  • تمت إضافة الطرق التالية إلى الفئة MyTarget:
    • SetCCPAUserConsent(bool)
    • GetCCPAUserConsent()
  • يتوافق مع الإصدار 5.15.3.0 من محوّل Android myTarget.
  • يتوافق مع الإصدار 5.15.2.0 من محوّل myTarget iOS.
  • تم إنشاء البرنامج واختباره باستخدام الإصدار 7.2.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

الإصدار 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.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 المستهدَف.

الإصدار 2.0.0

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

الإصدار 1.1.0

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

الإصدار 1.0.0

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