يوضِّح لك هذا الدليل كيفية استخدام حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لتحميل وعرض الإعلانات من Unity Ads باستخدام التوسّط، التي تغطي عمليات دمج الشلال. يتناول كيفية إضافة إعلانات Unity إلى إعلان إعدادات التوسّط وكيفية دمج المحوّل وحزمة تطوير البرامج (SDK) لمنصة Unity Ads في Flutter التطبيق.
أشكال الإعلانات وعمليات الدمج المتوافقة
يتضمّن AdMob محوّل التوسّط في Unity Ads الإمكانات التالية:
| الدمج | ||
|---|---|---|
| عروض الأسعار | 1 | |
| شلال | ||
| التنسيقات | ||
| بانر | ||
| إعلان بيني | ||
| تم منح المكافأة | ||
المتطلبات
- أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
- Flutter 3.7.0 أو إصدار أحدث
- للنشر على Android
- المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى
- للنشر على iOS
- الإصدار 12.0 أو الإصدارات الأحدث من نشر نظام التشغيل iOS
- مشروع Flutter عامل تم إعداده باستخدام Google SDK لإعلانات الأجهزة الجوّالة. عرض البدء لمعرفة التفاصيل.
- إكمال عملية التوسّط دليل البدء
الخطوة 1: إعداد الإعدادات في واجهة مستخدم Unity Ads
اشترِك أو سجِّل الدخول إلى Unity Ads.
إنشاء مشروع
في لوحة بيانات Unity Ads، انتقِل إلى المشاريع وانقر على إنشاء مشروع.
املأ النموذج وانقر على إنشاء مشروع لإضافة مشروعك.
انتقِل إلى تحقيق الربح > البدء، ثمّ انقر على البدء.
في نموذج إعداد المشروع، اختَر أخطّط لاستخدام التوسّط وGoogle Admob بالنسبة إلى شريك التوسّط، ثمّ انقر على التالي.
اختَر إعدادات الإعلانات، ثم انقر على التالي.
املأ النموذج ثم انقر على إضافة مشروع.
دوِّن رقم تعريف اللعبة.
إنشاء وحدة إعلانية
انتقِل إلى تحقيق الربح > الوحدات الإعلانية، ثم انقر على إضافة وحدة إعلانية.
أدخِل اسم الوحدة الإعلانية، ثم اختَر النظام الأساسي وشكل الإعلان.
Android
iOS
أخيرًا، انقر على إنشاء لحفظ وحدتك الإعلانية.
إضافة موضع إعلان
عروض الأسعار
تواصَل مع مدير حسابك على Unity Ads لإنشاء مواضع إعلان مستندة إلى عروض الأسعار.
شلال
بعد إنشاء المشروع، انتقِل إلى تحقيق الربح > مواضع الإعلانات. لإنشاء موضع إعلان جديد، انقر على إضافة موضع لوحدتك الإعلانية.
املأ التفاصيل اللازمة وانقر على إضافة موضع إعلان.
دوِّن رقم تعريف موضع الإعلان.
Android
iOS
العثور على مفتاح واجهة برمجة التطبيقات لإعداد التقارير في 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
الدمج من خلال pub.dev
أضف التبعية التالية مع أحدث إصدارات
Unity Ads حزمة تطوير البرامج (SDK) والمحوّل في حزمتك
ملف pubspec.yaml:
dependencies:
gma_mediation_unity: ^1.0.0
الدمج اليدوي
تنزيل أحدث إصدار من مكوّن توسّط إعلانات Google على الأجهزة الجوّالة
Unity Ads،
استخراج الملف الذي تم تنزيله وإضافة مجلد المكون الإضافي المستخرج
(ومحتوياته) إلى مشروع Flutter ثم راجع المكون الإضافي في
pubspec.yaml عن طريق إضافة التبعية التالية:
dependencies:
gma_mediation_unity:
path: path/to/local/package
الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة تطوير البرامج (SDK) لإعلانات Unity الإعلانية
موافقة المستخدمين في الاتحاد الأوروبي واللائحة العامة لحماية البيانات
بموجب موافقة المستخدم في الاتحاد الأوروبي التي تتّبعها Google السياسة، يجب التأكّد من الإفصاح عن معلومات معيّنة الموافقات التي تم الحصول عليها من المستخدمين في المنطقة الاقتصادية الأوروبية في ما يتعلق استخدام معرّفات الأجهزة والبيانات الشخصية. تعكس هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية و"حماية البيانات العامة" اللائحة (اللائحة العامة لحماية البيانات). عند طلب الحصول على موافقة، عليك تحديد كل شبكة إعلانات. في سلسلة التوسط التي قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها تقدم معلومات حول استخدام كل شبكة. يتعذّر على Google حاليًا إجراء ما يلي: تمرير خيار موافقة المستخدم إلى هذه الشبكات تلقائيًا.
المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لبرنامج Unity Ads
تتضمن
GmaMediationUnity.setGDPRConsent()
. يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى
حزمة تطوير البرامج (SDK) لإعلانات Unity إذا اخترت استدعاء هذه الطريقة، فمن المستحسن أن تفعل
ذلك قبل طلب الإعلانات من خلال "SDK لإعلانات Google على الأجهزة الجوّالة".
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setGDPRConsent(true);
الاطّلاع على Unity Ads واجهات برمجة التطبيقات للموافقة على الخصوصية وواجهات برمجة التطبيقات للبيانات أو الالتزام باللائحة العامة لحماية البيانات لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة.
قوانين الخصوصية في الولايات الأمريكية
الولايات المتحدة قوانين الخصوصية السارية في الولايات تتطلب منح المستخدمين لإيقاف "التخفيضات" "معلوماتهم الشخصية" (كما يحدّد القانون هذه البنود)، مع ميزة الإيقاف المتوفرة من خلال ميزة "عدم بيع بياناتي الشخصية" المعلومات" حول "البيع" للصفحة الرئيسية. تشير رسالة الأشكال البيانية الولايات المتحدة خصوصية الولايات دليل الامتثال للقوانين إمكانية تفعيل المعالجة المحدودة للبيانات لعرض إعلانات Google، ولكن يتعذّر على Google تطبيق هذا الإعداد على كل إعلان الشبكة في سلسلة التوسط. وبالتالي، عليك تحديد كل شبكة إعلانات في سلسلة التوسط التي قد تشارك في بيع البضائع المعلومات واتباع الإرشادات من كل شبكة من تلك الشبكات للتأكد الامتثال.
المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة لبرنامج Unity Ads
تتضمن
GmaMediationUnity.setCCPAConsent()
. يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى
حزمة تطوير البرامج (SDK) لإعلانات Unity إذا اخترت استدعاء هذه الطريقة، فمن المستحسن أن تفعل
ذلك قبل طلب الإعلانات من خلال "SDK لإعلانات Google على الأجهزة الجوّالة".
import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...
GmaMediationUnity.setCCPAConsent(true);
الخطوة 5: إضافة الرمز المطلوب
Android
ليس من المطلوب استخدام رمز إضافي لعمليات الدمج مع Unity Ads على Android.
iOS
دمج SKAdNetwork
متابعة Unity Ads' المستندات
لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.
الخطوة 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 تحميل إعلانات متعدّدة لموضع الإعلان نفسه. |
سجلّ تغييرات مهايئ توسّط Flutter لإعلانات Unity
الإصدار 1.0.0
- الإصدار الأولي.
- تم التحقّق من التوافق مع الإصدار 4.10.0.0 لمحوّل Unity لنظام التشغيل Android.
- تم التحقّق من التوافق مع الإصدار 4.10.0.0 لمحوّل Unity لنظام التشغيل iOS.