حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في وضع الصيانة للحصول على آخر التحديثات والميزات، عليك migrate وإعداد "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".

تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث

[لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم الإصدار 4.16.0.1 من محوِّل Unity أو إصدارًا أحدث (يُنصح باستخدام أحدث إصدار).

أحدث إصدار من Google Mobile Ads SDK (Legacy)
إعداد ميزة "توسّط AdMob"

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

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

إنشاء مشروع

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

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

انتقِل إلى Unity Ads Monetization، ثم انقر على Get started (البدء).

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

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

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

عروض الأسعار

شلال

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

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

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

انتقِل إلى Unity Ads Monetization > Placements، ثم اختَر مشروعك وانقر على إضافة وحدة إعلانية.

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

عروض الأسعار

اختَر عروض الأسعار في الإعداد. ضمن موضع الإعلان، أدخِل اسم موضع الإعلان.

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

شلال

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

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

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

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

عروض الأسعار

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

شلال

انتقِل إلى Unity Ads Monetization > API management ودوِّن مفتاح واجهة برمجة التطبيقات في Monetization Stats API Access.

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

تعديل ملف app-ads.txt

مبادرة "البائعون المعتمَدون للتطبيقات" (app-ads.txt) هي مبادرة من "المختبَر التقني لمكتب الإعلانات التفاعلية" (IAB Tech Lab) تساعد على ضمان عدم بيع المساحات الإعلانية المتاحة في تطبيقاتك إلا من خلال القنوات التي حدّدتها على أنها مخوّلة. لتجنُّب حدوث خسائر كبيرة في إيرادات الإعلانات، عليك استخدام ملف app-ads.txt. إذا لم يسبق لك إجراء ذلك، أعِدّ ملف app-ads.txt لتطبيقك.

لتنفيذ ملف app-ads.txt في Unity Ads، يُرجى الاطّلاع على إعداد ملف app-ads.txt للمرة الأولى.

تفعيل "الوضع التجريبي"

يمكن تفعيل "وضع الاختبار" من لوحة بيانات Unity Ads. انتقِل إلى تحقيق الربح من Unity Ads > الاختبار.

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

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

أدخِل تفاصيل جهازك الاختباري، ثم انقر على حفظ.

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

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

عليك إضافة Unity Ads إلى إعدادات التوسّط لوحدتك الإعلانية.

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

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

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

اربط مجموعة التوسط هذه بوحدة إعلانية واحدة أو أكثر من وحداتك الإعلانية الحالية في AdMob. بعد ذلك، انقر على تم.

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية معبأة بالوحدات الإعلانية التي اخترتها:

إضافة Unity Ads كمصدر إعلان

عروض الأسعار

في قسم مصادر الإعلانات، ابحث عن بطاقة عروض الأسعار وانقر على إضافة مصدر إعلان. بعد ذلك، اختَر Unity Ads.

انقر على كيفية توقيع اتفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع Unity Ads.

انقر على الإقرار والموافقة، ثم على متابعة.

إذا سبق لك إنشاء تعيين لـ Unity Ads، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.

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

شلال

ضمن بطاقة العرض الإعلاني بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

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

إذا كان لديك تعيين حالي لـ Unity Ads، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.

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

ملاحظة: يستغرق تحسين مصدر الإعلان بضعة أيام لجمع بيانات كافية من أجل احتساب التكلفة الفعلية لكل ألف ظهور بدقة لشبكة التوسط. في هذه الأثناء، تكون حالة تحسين مصدر الإعلان هي PENDING، لذا عليك ضبط قيمة التكلفة الفعلية لكل ألف ظهور يدويًا للشبكة. بعد احتساب التكلفة الفعلية لكل ألف ظهور، يبدأ مصدر الإعلان تلقائيًا بتعديل التكلفة الفعلية لكل ألف ظهور نيابةً عنك.

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

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

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

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

في ملف gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.unity3d.ads:unity-ads:4.21.0")
    implementation("com.google.ads.mediation:unity:4.21.0.0")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.unity3d.ads:unity-ads:4.21.0'
    implementation 'com.google.ads.mediation:unity:4.21.0.0'
}

الدمج اليدوي

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

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

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

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

يتيح الإصدار 4.19.0.1 والإصدارات الأحدث من محوّل Unity Ads لنظام التشغيل Android تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من منصّات إدارة الموافقة التي تتكامل مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) لخدمة Unity Ads. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إعداد إعدادات الموافقة المتوافقة أو غير المتوافقة مع "إطار الشفافية والموافقة".

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

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

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

جافا

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

Kotlin

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

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

ضبط إعدادات معالجة الطلبات حسب العمر

يُعيد الإصدار 4.16.6.0 والإصدارات الأحدث من محوّل التوسّط في Unity Ads توجيه الإعدادات الموجّهة إلى الأطفال وإعدادات المستخدمين دون سن الرشد إلى Unity Ads.

لمعالجة هذه الإشارات لكل مستخدم على حدة، تتطلب منك Unity Ads تفعيل تصنيف الجمهور المختلط في لوحة بيانات Unity Monetization. لمزيد من المعلومات حول تفعيل تصنيف الجمهور المختلط في مشروعك، يُرجى الاطّلاع على مقالة ضبط التصنيفات العمرية على مستوى اللعبة.

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

تحميل الإعلان باستخدام سياق النشاط

يجب تمرير سياق Activity عند تحميل أشكال "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات المدمجة مع المحتوى". بدون سياق النشاط، سيتعذّر تحميل الإعلان.

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

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

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

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

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

رموز الخطأ

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

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

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

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

سجلّ التغييرات في محوّل التوسّط من Unity Ads لنظام التشغيل Android