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

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

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

يتضمّن AdMob محوّل التوسّط في Unity Ads الإمكانات التالية:

الدمج
عروض الأسعار  1
شلال
التنسيقات
بانر
إعلان بيني
تم منح المكافأة
1 تم إغلاق عملية دمج عروض الأسعار تجريبيًا، يُرجى التواصل مع مدير حسابك لطلب الإذن بالوصول.

المتطلبات

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

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

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

إنشاء مشروع

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

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

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

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

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

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

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

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

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

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

Android

iOS

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

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

عروض الأسعار

تواصَل مع مدير حسابك على Google لإنشاء مواضع إعلان لعروض الأسعار.

شلال

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

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

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

Android

iOS

العثور على مفتاح واجهة برمجة التطبيقات لإعداد التقارير في Unity Ads

عروض الأسعار

وهذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.

شلال

بالإضافة إلى رقم تعريف اللعبة ورقم تعريف موضع الإعلان، ستحتاج أيضًا إلى مفتاح واجهة برمجة التطبيقات والمعرّف الأساسي للمؤسسة في Unity Ads لإعداد 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" الاعتمادية من البداية ونسخ التبعيات المعلنة إلى الدليل Assets/Plugins/Android لتطبيق Unity

استخدام Unity Adapter مع Unity Ads Services

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

تعديل ملف Assets/GoogleMobileAds/Editor/UnityMediationDependencies.xml وأزِل الاعتمادية على حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية:

<!-- 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 الإعلانية

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

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

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

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

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

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

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

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

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

بالنسبة إلى المحوّل 3.4.0 من Unity Ads أو الإصدارات الأحدث، يجب اتّباع خطوات الدمج. في مستندات 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 حدث خطأ في حزمة UnityAds SDK. الاطّلاع على الرمز لمزيد من التفاصيل.
101 مَعلمات خادم UnityAds التي تم ضبطها في واجهة مستخدم AdMob غير متوفّرة أو غير صالحة.
102 عرضت UnityAds موضع إعلان بالحالة NO_FILL.
103 عرضت UnityAds موضع إعلان بالحالة "غير مفعّل".
104 حاولت UnityAds عرض إعلان بدون سياق.
105 السياق المستخدَم لإعداد الإعلانات وتحميلها و/أو عرضها من Unity Ads ليس من حالات "النشاط".
106 حاولت UnityAds عرض إعلان غير جاهز للعرض.
107 لا تتوفّر حزمة UnityAds على الجهاز.
108 يمكن لبرنامج UnityAds تحميل إعلان واحد فقط لكل موضع إعلان في الوقت نفسه.
109 انتهت UnityAds بالحالة ERROR.
200-204 حدث خطأ معيّن في UnityAds Banner. الاطّلاع على الرمز لمزيد من التفاصيل.

iOS

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

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

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

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

الإصدار 3.12.1

الإصدار 3.12.0

الإصدار 3.11.1

الإصدار 3.11.0

الإصدار 3.10.0

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

الإصدار 2.2.0

الإصدار

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

الإصدار 2.0.3

  • تم تحديث المكوِّن الإضافي لإتاحة واجهة برمجة التطبيقات التي تتضمن مكافأة جديدة مفتوحة في الإصدار التجريبي.
  • يتيح هذا الخيار استخدام إعلانات البانر.
  • يتوافق مع الإصدار 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 من محوّل Android في Unity الإعلانية.
  • يتوافق مع الإصدار 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) لنظام التشغيل Android من Unity الإعلانية.
  • يتوافق مع الإصدار 2.2.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Unity Ads.
  • تمت إضافة طريقة UnityAds.SetGdprConsentMetaData() لطلب موافقة المستخدم يدويًا على الإعلانات المستهدفة.

الإصدار 1.1.1

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

الإصدار 1.1.0

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

الإصدار 1.0.0

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