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

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

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

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

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

التكامل
عروض الأسعار
شلال  1
التنسيقات
بانر
إعلان بيني
تمت المكافأة

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

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

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

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

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

    إنشاء مشروع

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

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

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

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

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

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

    عروض الأسعار

    شلال

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

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

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

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

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

    Android

    iOS

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

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

    Android

    iOS

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

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

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

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

    عروض الأسعار

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

    شلال

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

    بعد ذلك، انتقِل إلى Unity Ads Monetization > Organization Settings ودوِّن Organization core ID.

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

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

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

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

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

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

    Android

    iOS

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

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

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

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

    Android

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل Android.

    iOS

    للحصول على التعليمات، يُرجى الاطّلاع على الخطوة 2 في دليل iOS.

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

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

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

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

    أضِف التبعية التالية مع أحدث إصدارات حزمة تطوير البرامج (SDK) ومحوّل Unity Ads في ملف 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 تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من منصات إدارة الموافقة التي تتكامل مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) لخدمة 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: إضافة الرمز المطلوب

    Android

    لا حاجة إلى استخدام رمز إضافي لعمليات دمج Unity Ads على Android.

    iOS

    تكامل SKAdNetwork

    اتّبِع مستندات Unity Ads لإضافة معرّفات SKAdNetwork إلى ملف Info.plist الخاص بمشروعك.

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

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

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

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

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

    رموز الخطأ

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

    Android

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

    iOS

    GADMAdapterUnity
GADMediationAdapterUnity

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

    Android

    رمز الخطأ السبب
    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. يمكنك الاطّلاع على الرمز لمزيد من التفاصيل.

    iOS

    0-9 عرضت حزمة تطوير البرامج (SDK) لخدمة UnityAds خطأً. يمكنك الاطّلاع على مستندات Unity لمزيد من التفاصيل.
    101 مَعلمات خادم UnityAds التي تم ضبطها في واجهة مستخدم "إدارة إعلانات Google" غير متوفّرة أو غير صالحة.
    102 الجهاز غير متوافق مع UnityAds.
    103 انتهت UnityAds من العرض مع حالة الخطأ kUnityAdsFinishStateError.
    104 يكون عنصر إعلان Unity فارغًا بعد استدعاء دالة الإعداد الخاصة به.
    105 تعذّر عرض إعلانات Unity Ads لأنّ الإعلان غير جاهز.
    107 أجرت UnityAds استدعاءً لتغيير موضع الإعلان مع حالة الموضع kUnityAdsPlacementStateDisabled.
    108 تم تحميل إعلان مسبقًا لموضع الإعلان هذا. لا تتيح حزمة تطوير البرامج (SDK) لخدمة UnityAds تحميل إعلانات متعددة للموضع نفسه.
    109 لا يتطابق إعلان البانر الذي تعرضه UnityAds مع الحجم المطلوب.
    110 عرضت UnityAds خطأً في الإعداد.
    111 شكل الإعلان غير متوافق.
    112 عرضت UnityAds رمزًا مميزًا فارغًا أو غير صالح لعروض الأسعار.

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

    الإصدار 1.12.0 (قيد التطوير)

    الإصدار 1.11.1

    الإصدار 1.11.0

    الإصدار 1.10.0

    الإصدار 1.9.0

    الإصدار 1.8.1

    الإصدار 1.8.0

    الإصدار 1.7.0

    الإصدار 1.6.5

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

    الإصدار 1.6.4

    الإصدار 1.6.3

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

    الإصدار 1.6.2

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

    الإصدار 1.6.1

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

    الإصدار 1.6.0

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

    الإصدار 1.5.1

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

    الإصدار 1.5.0

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

    الإصدار 1.4.1

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

    الإصدار 1.4.0

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

    الإصدار 1.3.0

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

    الإصدار 1.2.0

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

    الإصدار 1.1.0

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

    الإصدار 1.0.0

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