تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

التكامل
عروض الأسعار
شلال	¹
التنسيقات
بانر
إعلان بيني
مقابل مكافأة
مدمج مع المحتوى

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

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

هدف نشر iOS‏ 13.0 أو إصدار أحدث
[بالنسبة إلى عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم الإصدار 4.14.1.1 أو إصدارًا أحدث من محوِّل Unity (يُنصح باستخدام أحدث إصدار).

أحدث إصدار من Google Mobile Ads SDK
إعداد التوسّط

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

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

إنشاء مشروع

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

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

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

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

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

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

عروض الأسعار

شلال

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

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

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

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

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

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

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

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

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

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

العثور على مفتاح واجهة برمجة التطبيقات لإعداد تقارير 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 > الاختبار.

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

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

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

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

سجِّل الدخول إلى حسابك على "إدارة إعلانات Google".

إضافة Unity Ads في "الشركات"

عروض الأسعار

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

شلال

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

اختَر Unity Ads كـ شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط. فعِّل جمع البيانات تلقائيًا، وأدخِل مفتاح واجهة برمجة التطبيقات والمعرّف الأساسي للمؤسسة اللذين حصلت عليهما في القسم السابق.

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

تفعيل ميزة "مشاركة الإشارات الآمنة"

عروض الأسعار

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange وراجِع مشاركة الإشارات الآمنة وفعِّلها. انقر على حفظ.

شلال

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

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

عروض الأسعار

انتقِل إلى المساحات الإعلانية المتاحة > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن Unity Ads وفعِّل تفعيل الدمج على التطبيق.

انقر على حفظ.

شلال

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

السماح بمشاركة الإشارات الآمنة في عروض أسعار SDK

عروض الأسعار

انتقِل إلى عرض الإعلانات > إعدادات قنوات طلبات الإعلانات. في علامة التبويب الإعدادات التلقائية، فعِّل الخيار السماح بمشاركة الإشارات الآمنة من أجل عروض أسعار حزمة تطوير البرامج (SDK).

انقر على حفظ.

شلال

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

ضبط عروض أسعار Unity Ads

عروض الأسعار

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى SDK Bidding.

انقر على مقدِّم عرض سعر جديد.

اختَر Unity Ads كمقدِّم عرض سعر.

انقر على متابعة لتفعيل ميزة "عروض أسعار باستخدام حِزم تطوير البرامج (SDK)" لمقدِّم عرض السعر هذا.

انقر على تم.

شلال

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

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

عروض الأسعار

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى SDK Bidding.

اختَر الشركة التي تمثّل Unity Ads.

انتقِل إلى علامة التبويب تعيين الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديدة.

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

أخيرًا، انقر على حفظ.

شلال

انتقِل إلى عرض الإعلانات > مجموعات الشبكات الإعلانية المدِرّة للأرباح وانقر على الزر مجموعة شبكات إعلانية مدِرّة للأرباح جديدة. اختَر المستودع والتطبيق.

انتقِل إلى شركاء الأرباح وانقر على إضافة شريك توسّط.

اختَر الشركة التي أنشأتها من أجل Unity Ads في القسم السابق. اختَر التوسّط في حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وiOS كـ النظام الأساسي، ونشط كـ الحالة.

أدخِل معرّف اللعبة ومعرّف موضع الإعلان الذي حصلت عليهما في القسم السابق، وقيمة التكلفة التلقائية لكل ألف ظهور. انقر على حفظ.

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

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

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

استخدام Swift Package Manager

قبل المتابعة، يجب أن يكون لديك الحد الأدنى من إصدار المحوّل المتوافق 4.16.0.0.

لإضافة حزمة تابعة إلى مشروعك، اتّبِع الخطوات التالية:

في Xcode، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة... (File > Add Package Dependencies...).
في الطلب الذي يظهر، ابحث عن عنوان URL للحزمة التالية:
```
https://github.com/googleads/googleads-mobile-ios-mediation-unity.git
```
في قاعدة التبعية، اختَر الفرع.
في حقل النص، أدخِل main.

استخدام CocoaPods

أضِف السطر التالي إلى ملف Podfile الخاص بمشروعك:
```
pod 'GoogleMobileAdsMediationUnity'
```
من سطر الأوامر، شغِّل:
```
pod install --repo-update
```

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لعرض الإعلانات على Unity، واربط UnityAds.framework في مشروعك.
نزِّل أحدث إصدار من محوّل Unity Ads من رابط التنزيل في سجلّ التغييرات واربط UnityAdapter.framework في مشروعك.

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

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

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

يتيح الإصدار 4.19.0.1 والإصدارات الأحدث من محوّل Unity Ads لنظام التشغيل iOS تمرير إشارات الموافقة بموجب "اللائحة العامة لحماية البيانات" (GDPR) من منصّات إدارة الموافقة التي تتكامل مع "إطار الشفافية والموافقة" (TCF) الصادر عن مكتب IAB إلى حزمة تطوير البرامج (SDK) لخدمة Unity Ads. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة إعداد إعدادات الموافقة بموجب "إطار الشفافية والموافقة" أو غيره.

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

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

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

Swift

let ccpaMetaData = UADSMetaData()
ccpaMetaData.set("privacy.consent", value: true)
ccpaMetaData.commit()UnityAdsMediationSwiftSnippets.swift

Objective-C

UADSMetaData *ccpaMetaData = [[UADSMetaData alloc] init];
[ccpaMetaData set:@"privacy.consent" value:@YES];
[ccpaMetaData commit];UnityAdsMediationObjectiveCSnippets.m

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

ضبط إعدادات المعالجة الموجّهة للفئة العمرية

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

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

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

تنفيذ SKAdNetwork

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

أخطاء في التجميع

Swift

لا يلزم استخدام رمز إضافي لعمليات الدمج في Swift.

Objective-C

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

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

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

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

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

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

رموز الخطأ

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

GADMAdapterUnity
GADMediationAdapterUnity

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

رمز الخطأ	السبب
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 رمزًا مميزًا فارغًا أو غير صالح لعروض الأسعار.