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

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

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

يتضمّن AdMob محوّل التوسّط في Unity Ads الإمكانات التالية:

¹ تم إغلاق عملية دمج عروض الأسعار. تجريبيًا، يُرجى التواصل مع مدير حسابك لطلب الإذن بالوصول.

المتطلبات

• أحدث إصدار من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
• ‫Flutter 3.7.0 أو إصدار أحدث
• للنشر على Android
  • المستوى 21 أو إصدار أحدث من واجهة برمجة التطبيقات لنظام التشغيل Android
• للنشر على أجهزة iOS
  • إصدار 12.0 أو إصدار أحدث من نظام التشغيل iOS مستهدف للنشر
• Flutter مشروع صالح تم إعداده باستخدام حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة عرض البدء لمعرفة التفاصيل.
• إكمال عملية التوسّط دليل البدء

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

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

إنشاء مشروع

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

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

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

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

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

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

سجِّل معرّف اللعبة.

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

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

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

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

إضافة موضع إعلان

تحديد موضع مفتاح Unity Ads Reporting API

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

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

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

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

املأ النموذج وانقر على حفظ.

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

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

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

الخطوة 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 Ads

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

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

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

GmaMediationUnity.setCCPAConsent(true);

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

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

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

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

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

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

رموز الخطأ

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

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

GADMAdapterUnity
GADMediationAdapterUnity

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل UnityAds عند فشل تحميل إعلان:

سجلّ التغييرات في أداة الربط بين Unity Ads وFlutter

الإصدار 1.1.0

• تم التحقّق من التوافق مع الإصدار 4.12.2.0 لمحوّل Unity لنظام التشغيل Android.
• تم التحقّق من التوافق مع الإصدار 4.12.2.0 لمحوّل Unity لنظام التشغيل iOS.
• تم إنشاؤه واختباره باستخدام الإصدار 5.1.0 من "مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة".

الإصدار 1.0.0

• الإصدار الأولي.
• تم التحقّق من التوافق مع الإصدار 4.10.0.0 من محوِّل Unity Android
• تم التحقّق من التوافق مع الإصدار 4.10.0.0 لمحوّل Unity لنظام التشغيل iOS.
• تم إنشاء هذا المكوّن الإضافي واختباره باستخدام الإصدار 5.0.0 من مكوّن Flutter الإضافي لإعلانات Google على الأجهزة الجوّالة.