دمج Unity Ads مع التوسّط

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

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

يتميّز AdMob محوّل التوسّط لبرنامج Unity Ads بالإمكانات التالية:

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

المتطلّبات

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

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

اشترِك أو سجِّل الدخول في Unity Ads.

إنشاء مشروع

في لوحة بيانات Unity Ads، انتقِل إلى المشاريع وانقر على إنشاء مشروع.

املأ النموذج وانقر على إنشاء مشروع لإضافة مشروعك.

انتقِل إلى تحقيق الربح > البدء، ثمّ انقر على البدء.

في النافذة المشروطة إعداد المشروع، اختر أخطط لاستخدام التوسّط وGoogle Admob لشريك التوسّط، ثم انقر على التالي.

اختَر إعدادات الإعلانات، ثمّ انقر على التالي.

املأ النموذج، ثم انقر على إضافة مشروع.

دوِّن رقم تعريف اللعبة.

إنشاء وحدة إعلانية

انتقِل إلى تحقيق الربح > الوحدات الإعلانية، ثمّ انقر على إضافة وحدة إعلانية.

أدخِل اسم الوحدة الإعلانية، ثم اختَر النظام الأساسي وشكل الإعلان.

Android

iOS

أخيرًا، انقر على إنشاء لحفظ وحدتك الإعلانية.

إضافة موضع إعلان

بعد إنشاء المشروع، انتقِل إلى تحقيق الربح > مواضع الإعلانات. لإنشاء موضع إعلان جديد، انقر على إضافة موضع إعلان لوحدتك الإعلانية.

املأ التفاصيل اللازمة، ثم انقر على إضافة موضع إعلان.

دوِّن رقم تعريف موضع الإعلان.

Android

iOS

استرداد بيانات الاعتماد

بالإضافة إلى معرّف اللعبة ومعرّف موضع الإعلان، ستحتاج أيضًا إلى مفتاح واجهة برمجة التطبيقات لإعلانات Unity ورقم التعريف الأساسي للمؤسسة لإعداد AdMob معرّف الوحدة الإعلانية.

انتقِل إلى تحقيق الربح > الإعداد > إدارة واجهة برمجة التطبيقات ودوِّن ملاحظاتك بشأن مفتاح الوصول إلى واجهة برمجة التطبيقات لإحصاءات تحقيق الربح.

بعد ذلك، انتقِل إلى تحقيق الربح > إعدادات المؤسسة ودوِّن المعرّف الأساسي للمؤسسة.

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

يمكن تفعيل وضع الاختبار من لوحة بيانات Unity Ads. ضمن إعدادات مشروعك، اختر علامة التبويب الاختبار.

يمكنك فرض وضع الاختبار لتطبيقك من خلال النقر على زر التعديل في كل نظام أساسي ووضع علامة في المربّع إلغاء وضع اختبار العميل واختيار فرض تفعيل وضع الاختبار (أي استخدام إعلانات تجريبية) لجميع الأجهزة.

Android

iOS

ويمكنك بدلاً من ذلك تفعيل "وضع الاختبار" لأجهزة محدّدة من خلال النقر على زر إضافة جهاز اختباري.

املأ النموذج وانقر على حفظ.

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

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

Android

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

iOS

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

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

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

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

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

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

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

استخدام أداة Unity Adapter مع خدمات Unity Ads

إذا دمجت حزمة تطوير البرامج (SDK) مع Unity Ads من خلال جزء "الخدمات" أو "أداة إدارة الحِزم" أو "متجر مواد العرض"، يعني ذلك أنّه لديك نسخة من حزمة تطوير البرامج (SDK) لنظام التشغيل Unity Ads لنظام التشغيل Android في تطبيقك. لتجنُّب حدوث مشاكل متعلّقة بالرموز المكرّرة عند إنشاء حزمة SDK لنظام التشغيل Android، عليك إزالة المرجع الذي يخصّ Unity Ads SDK.

حدِّث ملف Assets/GoogleMobileAds/Editor/UnityMediationDependencies.xml وأزِل الاعتمادية لحزمة Unity Ads SDK:

<!-- If using the Unity Ads Service from Unity3D, comment out this dependency to
avoid including the Unity Ads Android SDK twice. -->
<androidPackage spec="com.unity3d.ads:unity-ads:x.y.z">
  <repositories>
    <repository>https://repo.maven.apache.org/maven2/</repository>
  </repositories>
</androidPackage>

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

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

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

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("gdpr.consent", true);

يُرجى الاطّلاع على أدلة الموافقة على الخصوصية وواجهات برمجة التطبيقات للبيانات في Unity Ads، ودليلَي الامتثال للائحة العامة لحماية البيانات (GDPR) للحصول على مزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

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

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

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

using GoogleMobileAds.Api.Mediation.UnityAds;
// ...

UnityAds.SetConsentMetaData("privacy.consent", true);

اطّلِع على دليلَي الموافقة على الخصوصية وواجهات برمجة التطبيقات للبيانات في Unity Ads وأدلة الامتثال لقانون خصوصية المستهلك في كاليفورنيا (CCPA) للحصول على مزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.

الخطوة 5: إضافة الرمز المطلوب

Android

ما مِن رمز إضافي مطلوب لعمليات دمج Unity Ads مع Android.

iOS

دمج SKAdNetwork

اتّبِع مستندات Unity Ads لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

أخطاء التجميع

بالنسبة إلى محوّل Unity Ads 3.4.0 أو إصدار أحدث، عليك اتّباع خطوات الدمج الواردة في مستندات Unity.

الخطوة 6: اختبار عملية التنفيذ

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

احرص على تسجيل جهاز الاختبار من أجل AdMob وتفعيل وضع الاختبار في واجهة المستخدم Unity Ads .

التحقّق من الإعلانات الاختبارية

للتأكّد من أنّك تتلقّى إعلانات اختبارية من Unity Ads، فعِّل اختبار مصدر إعلان فردي في "أداة فحص الإعلانات" باستخدام Unity Ads (Waterfall) مصادر الإعلانات.

رموز الخطأ

إذا تعذّر على المحوّل تلقّي إعلان من Unity Ads، يمكن للناشرين التحقق من الخطأ الأساسي في استجابة الإعلان باستخدام ResponseInfo ضمن الفئات التالية:

Android

com.google.ads.mediation.unity.UnityAdapter
com.google.ads.mediation.unity.UnityMediationAdapter

iOS

GADMAdapterUnity
GADMediationAdapterUnity

في ما يلي الرموز والرسائل المصاحبة التي يعرضها محوّل UnityAds عند تعذُّر تحميل الإعلان:

Android

رمز الخطأ السبب
0-10 حدث خطأ في حزمة تطوير البرامج (SDK) في UnityAds. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
101 مَعلمات خادم UnityAds التي تم ضبطها في واجهة مستخدم Admob غير متوفّرة/غير صالحة
102 عرضت UnityAds موضع إعلان بحالة NO_FILL.
103 عرضت UnityAds موضع إعلان بالحالة "متوقّفة".
104 حاولت UnityAds عرض إعلان بسياق فارغ.
105 إنّ السياق المستخدَم لإعداد الإعلانات و/أو تحميلها و/أو عرضها من Unity Ads ليس من أمثلة النشاط.
106 حاولت UnityAds عرض إعلان غير جاهز للعرض.
107 لا يمكن استخدام UnityAds على الجهاز.
108 بإمكان UnityAds تحميل إعلان واحد فقط لكل موضع في المرة الواحدة.
109 انتهت UnityAds بحالة "خطأ".
200-204 حدث خطأ معيّن في بانر UnityAds. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.

iOS

0-9 حدث خطأ في حزمة تطوير البرامج (SDK) في UnityAds. راجِع مستندات Unity لمزيد من التفاصيل.
101 مَعلمات خادم UnityAds التي تم ضبطها في واجهة مستخدم Admob غير متوفّرة/غير صالحة
102 الجهاز غير متوافق مع UnityAds.
103 انتهت صلاحية عرض الوحدة الإعلانية UnityAds مع ظهور حالة الخطأ kUnityAdsFinishStateError.
104 يكون عنصر إعلان Unity معدومًا بعد استدعاء أداة الإعداد.
105 تعذّر عرض إعلانات Unity لأنّ الإعلان غير جاهز.
106 غيَّرت UnityAds موضع الإعلان معاودة الاتصال بحالة الموضع kUnityAdsPositionStateNoFill.
107 غيَّرت UnityAds موضع الإعلان معاودة الاتصال بحالة الموضع kUnityAdsPositionStateDisabled.
108 سبق أن تم تحميل إعلان لهذا الموضع. لا تتيح حزمة تطوير البرامج (SDK) في UnityAds تحميل إعلانات متعددة لموضع معيّن.

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

الإصدار 3.9.1

الإصدار 3.9.0

الإصدار 3.8.0

الإصدار 3.7.1

الإصدار 3.7.0

الإصدار 3.6.1

الإصدار 3.6.0

الإصدار 3.5.0

الإصدار 3.4.1

الإصدار 3.4.0

الإصدار 3.3.0

الإصدار 3.2.1

الإصدار 3.2.0

الإصدار 3.1.0

الإصدار 3.0.1

الإصدار 3.0.0

الإصدار 2.7.2

الإصدار 2.7.1

الإصدار 2.7.0

الإصدار 2.6.0

الإصدار 2.5.1

الإصدار 2.5.0

الإصدار 2.4.7

الإصدار 2.4.6

الإصدار 2.4.5

الإصدار 2.4.4

الإصدار 2.4.3

الإصدار 2.4.2

الإصدار 2.4.1

الإصدار 2.4.0

الإصدار 2.3.0

الإصدار 2.2.0

الإصدار 2.1.0

  • يتوافق مع الإصدار 3.1.0.0 من محوّل Unity Ads لنظام التشغيل Android.
  • يتوافق مع الإصدار 3.1.0.0 من محوّل Unity Ads لنظام التشغيل iOS.

الإصدار 2.0.3

  • تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات Rewarded API الجديدة والمفتوحة.
  • إضافة دعم لإعلانات البانر.
  • يتوافق مع الإصدار 3.0.0.2 من محوّل Unity Ads لنظام التشغيل Android.
  • يتوافق مع الإصدار 3.0.0.3 من محوّل Unity Ads لنظام التشغيل iOS.

الإصدار 2.0.2

  • يتوافق مع الإصدار 3.0.0.0 من محوّل Unity Ads لنظام التشغيل Android.
  • يتوافق مع الإصدار 3.0.0.1 من محوّل Unity Ads لنظام التشغيل iOS.

الإصدار 2.0.1

  • تم إصلاح الخطأ "نوع غير متوافق" الذي تسبب في حدوث مشاكل عند إنشاء نظام التشغيل iOS.

الإصدار 2.0.0

  • يتوافق مع الإصدار 3.0.0.0 من محوّل Unity Ads لنظام التشغيل Android.
  • يتوافق مع الإصدار 3.0.0.0 من محوّل Unity Ads لنظام التشغيل iOS.

الإصدار 1.2.0

  • يتوافق مع الإصدار 2.3.0.0 من محوّل Unity Ads لنظام التشغيل Android.
  • يتوافق مع الإصدار 2.3.0.0 من محوّل Unity Ads لنظام التشغيل iOS.

الإصدار 1.1.3

  • يتوافق مع الإصدار 2.2.1.0 من محوّل Unity Ads لنظام التشغيل Android.
  • يتوافق مع الإصدار 2.2.1.0 من محوّل Unity Ads لنظام التشغيل iOS.

الإصدار 1.1.2

  • يتوافق مع الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Unity Ads لنظام التشغيل Android.
  • يتوافق مع الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS وUnity Ads.
  • تمت إضافة طريقة UnityAds.SetGdprConsentMetaData() لطلب موافقة المستخدم على الإعلانات المستهدفة يدويًا.

الإصدار 1.1.1

  • يتوافق مع الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Unity Ads لنظام التشغيل Android.
  • يتوافق الإصدار 2.2.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS مع Unity Ads.

الإصدار 1.1.0

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

الإصدار 1.0.0

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