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

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

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

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

يتضمّن محوّل التوسّط في "مدير الإعلانات" لشبكة Unity Ads الإمكانات التالية:

المتطلبات

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

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

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

إنشاء مشروع

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تحديد موقع مفتاح 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 > الاختبار.

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

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

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

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

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

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

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

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

الدمج من خلال pub.dev

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

dependencies:
  gma_mediation_unity: ^1.8.0

الدمج اليدوي

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

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

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

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

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

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

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

GmaMediationUnity.setGDPRConsent(true);

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

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

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

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

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات" وتفعيل وضع الاختبار في واجهة مستخدم 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 Mediation Adapter

الإصدار 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.