دمج 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 إنشاء وحدة إعلانية قبل إكمال العملية.

اختَر 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 واجهة المستخدم.

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

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

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

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

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

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

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

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

MyTarget.SetUserConsent(true);

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

MyTarget.SetUserAgeRestricted(true);

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

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

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

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

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 لم يتم إدخال مواد عرض الإعلانات المدمجة مع المحتوى المطلوبة.

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

الإصدار التالي

  • تمت إعادة تسمية "DummyClient" إلى "PlaceholderClient".

الإصدار 3.17.0

الإصدار 3.16.2

الإصدار 3.16.1

الإصدار 3.16.0

الإصدار 3.15.0

الإصدار 3.14.0

الإصدار 3.13.2

الإصدار 3.13.1

  • تم نقل محتوى المحوّل إلى GoogleMobileAds/Mediation/MyTarget/.
  • تمت إعادة ضبط مساحة الاسم للمهايئ لاستخدام GoogleMobileAds.Mediation.MyTarget.
  • يتوافق مع الإصدار 5.16.4.1 من محوّل Android myTarget.
  • يتوافق مع الإصدار 5.17.4.0 من محوّل myTarget iOS.
  • تم إنشاء هذه الأداة واختبارها باستخدام الإصدار 8.1.0 من مكوّن Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.

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

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

الإصدار 2.3.2

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

الإصدار 2.2.0

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

الإصدار 2.1.2

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