يوضِّح لك هذا الدليل كيفية استخدام حزمة "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
الخطوة 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.