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

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

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

يتضمّن برنامج التكيّف الخاص بالتوسّط في AdMob لشبكة Unity Ads الإمكانات التالية:

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

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

• أحدث إصدار من Google Mobile Ads Flutter Plugin
• الإصدار 3.7.0 أو إصدار أحدث من إطار عمل Flutter
• [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم مكوّنًا إضافيًا للتوسّط في "إعلانات Google على الأجهزة الجوّالة" لـ Unity Ads 1.1.0 أو إصدار أحدث (يُنصح باستخدام أحدث إصدار).
• للنشر على Android
  • المستوى 24 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث
• للنشر على iOS
  • الإصدار 13.0 من نظام التشغيل iOS أو إصدار أحدث
• مشروع Flutter يعمل تم إعداده باستخدام Google Mobile Ads Flutter Plugin لمزيد من التفاصيل، يمكنك الاطّلاع على إعداد Google Mobile Ads Flutter Plugin.
• إعداد ميزة "توسّط AdMob"

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

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

إنشاء مشروع

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

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

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

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

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

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

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

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

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

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

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

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

العثور على مفتاح Unity Ads Reporting API

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

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

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

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

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

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

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

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

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

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

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

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

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

التكامل من خلال pub.dev

أضِف مصدر الاعتمادية التالي مع أحدث إصدارات حزمة Unity Ads SDK والمحوّل في ملف pubspec.yaml الخاص بالحزمة:

dependencies:
  gma_mediation_unity: ^1.11.1

عملية الدمج اليدوية

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

dependencies:
  gma_mediation_unity:
    path: path/to/local/package

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

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

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

يتيح الإصدار 1.10.0 من Unity Ads Flutter adapter والإصدارات الأحدث تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" من منصات إدارة الموافقة المتكاملة مع "إطار الشفافية والموافقة" الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) الخاصة بـ Unity Ads. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد موافقة ضمن "إطار الشفافية والموافقة" أو خارجه.

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

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

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

import 'package:gma_mediation_unity/gma_mediation_unity.dart';
// ...

GmaMediationUnity.setCCPAConsent(true);

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

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

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

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

الخطوة 6: اختبار عملية الإعداد

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

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

تأكيد الإعلانات الاختبارية

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

رموز الخطأ

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

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

GADMAdapterUnity
GADMediationAdapterUnity

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

سجلّ التغيير في محوّل التوسّط في Unity Ads Flutter

الإصدار 1.11.1

• يتوافق مع الإصدار 4.20.1.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.20.1.0 من محوّل Unity iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.11.0

• يتوافق مع الإصدار 4.20.0.1 من محوّل Unity Android.
• يتوافق مع الإصدار 4.20.0.0 من محوّل Unity iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.10.0

• تم التحديث لدعم الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• إضافة إمكانية استخدام Swift Package Manager
• يتوافق مع الإصدار 4.20.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.19.0.1 من محوّل Unity iOS.
• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 9.1.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.9.0

• تم تعديلها لتتوافق مع الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• يتوافق مع الإصدار 4.19.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.19.0.0 من محوّل Unity iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 9.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.8.1

• يتوافق مع الإصدار 4.18.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.18.1.0 من محوّل Unity iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.8.0

• يتوافق مع الإصدار 4.18.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.18.0.0 من محوّل Unity iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.7.0

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.38.1.
• تم التحديث لدعم الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.
• يتوافق مع الإصدار 4.17.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.17.0.0 من محوّل Unity iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 8.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.6.5

• يتوافق مع الإصدار 4.16.6.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.16.6.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.6.4

• تم تعديل الحد الأدنى لإصدار Flutter إلى 3.35.1
• تم تعديلها لتتوافق مع الإصدار 7.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads
• يتوافق مع الإصدار 4.16.5.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.16.5.0 من محوّل Unity iOS.

الإصدار 1.6.3

• متوافق مع الإصدار 4.16.3.0 من محوّل Unity Android
• يتوافق مع الإصدار 4.16.3.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.6.2

• متوافق مع الإصدار 4.16.3.0 من محوّل Unity Android
• يتوافق مع الإصدار 4.16.2.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.6.1

• يتوافق مع الإصدار 4.16.1.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.16.1.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.6.0

• يتطلّب الآن الإصدار 13.0 من نظام التشغيل iOS كحدّ أدنى.
• يتوافق مع الإصدار 4.16.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.16.0.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.5.1

• يتوافق مع الإصدار 4.15.1.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.15.1.0 من أداة Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.5.0

• يتوافق مع الإصدار 4.15.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.15.0.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.4.1

• يتوافق مع الإصدار 4.14.2.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.14.2.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.4.0

• يتوافق مع الإصدار 4.14.1.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.14.1.1 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 6.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.3.0

• يتوافق مع الإصدار 4.13.1.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.13.1.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.2.0

• يتوافق مع الإصدار 4.13.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.12.5.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.3.1 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.1.0

• يتوافق مع الإصدار 4.12.3.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.12.3.1 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.2.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.

الإصدار 1.0.0

• الإصدار الأوّلي
• يتوافق مع الإصدار 4.10.0.0 من محوّل Unity Android.
• يتوافق مع الإصدار 4.10.0.0 من محوّل Unity iOS.

• تم إنشاء هذا التطبيق واختباره باستخدام الإصدار 5.0.0 من مكوّن Flutter الإضافي لـ Google Mobile Ads.