تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

دمج إعلانات Unity مع ميزة "التوسّط"

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

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

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

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

المتطلبات

المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى

أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء

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

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

إنشاء مشروع

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عروض الأسعار

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

شلال

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

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

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

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

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

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

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

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

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

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

سجِّل الدخول إلى حسابك على "مدير الإعلانات".

انتقِل إلى عرض الإعلانات > مجموعات الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة الشبكات الإعلانية المدِرّة للأرباح جديدة.

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

بعد ذلك، انقر على الزر إضافة شريك أرباح.

إذا كان لديك شريك أرباح في Unity Ads، يمكنك اختياره. إذا لم يكن لديك حساب، اختَر إنشاء شريك جديد لتحقيق الأرباح.

اختَر Unity Ads باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

فعِّل الجمع التلقائي للبيانات، وأدخِل API Key and Organization core ID الذي تم الحصول عليه في القسم السابق.

بعد اختيار الشريك المحقِّق للأرباح، اختر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid باعتبارها النظام الأساسي، ونشط كالحالة. أدخِل Game ID and Placement ID الذي تم الحصول عليه في القسم السابق. ثم أدخِل قيمة التكلفة التلقائية لكل ألف ظهور.

انقر على حفظ في أسفل الصفحة عند الانتهاء.

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

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

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

الدمج مع "استوديو Android" (يُنصح به)

في ملف build.gradle.kts على مستوى التطبيق، أضِف عملية التنفيذ التالية والتبعيات والتكوينات. استخدام أحدث إصدارات حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية والمحوّل:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.unity3d.ads:unity-ads:4.12.1")
    implementation("com.google.ads.mediation:unity:4.12.2.0")
}

الدمج اليدوي

يمكنك تنزيل أحدث حزمة تطوير برامج (SDK) لإعلانات Unity (unity-ads.aar) من مستودع GitHub وإضافته إلى مشروعك.
الانتقال إلى عناصر محوّل Unity Ads على مستودع Maven من Google. اختَر أحدث إصدار ونزِّل Unity ملف .aar لمحوّل الإعلانات، وإضافته إلى مشروعك.

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

موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات

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

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

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()

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

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

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

Java

import com.unity3d.ads.metadata.MetaData;
// ...

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();

Kotlin

import com.unity3d.ads.metadata.MetaData
// ...

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()

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

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

وليس عليك استخدام رمز إضافي لعمليات دمج Unity Ads.

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

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

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

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

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

رموز الخطأ

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

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

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل UnityAds عند فشل تحميل إعلان:

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