يوضِّح لك هذا الدليل كيفية استخدام "حزمة تطوير البرامج (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
- يتوافق مع الإصدار 5.20.0.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.20.1.0 من محوّل myTarget iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.7.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.14.0
- يتوافق مع الإصدار 5.18.0.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.19.0.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.5.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.13.2
- يتوافق مع الإصدار 5.16.5.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.17.5.0 من محوّل myTarget iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 8.3.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 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
- يتوافق مع الإصدار 5.16.4.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.17.4.0 من محوّل myTarget لنظام التشغيل iOS.
- تم إنشاء الإصدار 8.0.0 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها.
الإصدار 3.12.0
- يتوافق مع الإصدار 5.15.5.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.16.0.0 من محوّل myTarget iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.3.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.11.4
- يتوافق مع الإصدار 5.15.4.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.15.2.0 من محوّل myTarget iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.2.0 من المكوّن الإضافي لبرنامج Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 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
- يتوافق مع الإصدار 5.15.2.1 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.15.2.0 من محوّل myTarget iOS.
- تم إنشاء الإصدار 7.0.2 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.0.2.
الإصدار 3.11.1
- يتوافق مع الإصدار 5.15.1.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.15.1.0 من محوّل myTarget iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.11.0
- يتوافق مع الإصدار 5.15.0.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.15.0.1 من محوّل myTarget iOS.
- تم إنشاء البرنامج واختباره باستخدام الإصدار 7.0.0 من المكوّن الإضافي لنظام Unity الإضافي لإعلانات Google على الأجهزة الجوّالة.
الإصدار 3.10.2
- يتوافق مع الإصدار 5.14.4.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.14.4.0 من محوّل myTarget لنظام التشغيل iOS.
الإصدار 3.10.1
- يتوافق مع الإصدار 5.14.3.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.14.2.0 من محوّل myTarget iOS.
الإصدار 3.10.0
- يتوافق مع الإصدار 5.14.2.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.14.1.0 من محوّل myTarget iOS.
الإصدار 3.9.0
- يتوافق مع الإصدار 5.13.0.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.11.2.0 من محوّل myTarget iOS.
الإصدار 3.8.2
- يتوافق مع الإصدار 5.11.7.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.9.10.0 من محوّل myTarget لنظام التشغيل iOS.
الإصدار 3.8.1
- يتوافق مع الإصدار 5.11.5.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.9.6.0 من محوّل myTarget iOS.
الإصدار 3.8.0
- يتوافق مع الإصدار 5.11.4.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.9.5.0 من محوّل myTarget iOS.
الإصدار 3.7.0
- يتوافق مع الإصدار 5.10.0.0 من محوّل myTarget Android.
- يتوافق مع الإصدار 5.7.5.0 من محوّل myTarget iOS.
الإصدار 3.6.1
- تمت إعادة تسمية الإجراء
MyTarget.IsUserConsent()
إلىMyTarget.IsConsent()
. - يتوافق مع الإصدار 5.9.1.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.7.2.0 من محوّل myTarget iOS.
الإصدار 3.6.0
- يتوافق مع الإصدار 5.9.0.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.7.0.0 من محوّل myTarget iOS.
الإصدار 3.5.2
- يتوافق مع الإصدار 5.8.3.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.6.3.0 من محوّل myTarget iOS.
الإصدار 3.5.1
- يتوافق مع الإصدار 5.8.2.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.6.1.0 من محوّل myTarget iOS.
الإصدار 3.5.0
- يتوافق مع الإصدار 5.8.1.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.6.0.0 من محوّل myTarget iOS.
الإصدار 3.4.0
- يتوافق مع الإصدار 5.8.0.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.5.2.0 من محوّل myTarget iOS.
الإصدار 3.3.0
- يتوافق مع الإصدار 5.7.0.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.5.1.0 من محوّل myTarget iOS.
الإصدار 3.2.0
- يتوافق مع الإصدار 5.6.3.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.4.9.0 من محوّل myTarget لنظام التشغيل iOS.
الإصدار 3.1.0
- يتوافق مع الإصدار 5.4.6.0 من محوّل Android myTarget.
- يتوافق مع الإصدار 5.3.3.0 من محوّل myTarget iOS.
الإصدار 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.