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

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

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

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

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

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

المتطلّبات

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

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

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

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

إنشاء مشروع

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.unity3d.ads:unity-ads:4.9.3")
    implementation("com.google.ads.mediation:unity:4.9.3.0")
}

الدمج اليدوي

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

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

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

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

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

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

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

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

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

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

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

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

رموز الخطأ

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

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

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

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