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

اختيار النظام الأساسي: Android (إصدار تجريبي) Android iOS Unity Flutter

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

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

يتضمّن برنامج التكيّف للتوسّط في Unity Ads الميزات التالية:

المتطلبات

• المستوى 24 لواجهة برمجة التطبيقات Android أو مستوى أعلى

• [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم الإصدار 4.16.0.1 أو الإصدارات الأحدث من Unity adapter (يُنصح باستخدام أحدث إصدار).

• أحدث محتوى من قناة GMA Next-Gen SDK

• إكمال دليل البدء الخاص بالتوسّط

الخطوة 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 في "مدير إعلانات Google".

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

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

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

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

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

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

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

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

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

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

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

السماح بمشاركة الإشارات الآمنة في ميزة "عروض الأسعار باستخدام حِزم تطوير البرامج (SDK)"

ضبط عروض الأسعار في Unity Ads

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

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

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

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

دمج "استوديو Android" (يُنصح به)

في ملف Gradle على مستوى التطبيق، أضِف عمليات التنفيذ التالية والاعتمادات والإعدادات:

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.unity3d.ads:unity-ads:4.16.5")
    implementation("com.google.ads.mediation:unity:4.16.6.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.unity3d.ads:unity-ads:4.16.5'
    implementation 'com.google.ads.mediation:unity:4.16.6.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

الدمج اليدوي

1. نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) الخاصة بـ Unity Ads (unity-ads.aar) من مستودع GitHub وأضِفه إلى مشروعك.

2. انتقِل إلى عناصر محوّل Unity Ads البرمجية في مستودع Maven من Google. اختَر أحدث إصدار، ثم نزِّل ملف .aar لمحوّل Unity Ads وأضِفه إلى مشروعك.

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

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

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

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

MetaData gdprMetaData = new MetaData(this);
gdprMetaData.set("gdpr.consent", true);
gdprMetaData.commit();
UnityAdsMediationSnippets.java

val gdprMetaData = MetaData(this)
gdprMetaData["gdpr.consent"] = true
gdprMetaData.commit()
UnityAdsMediationSnippets.kt

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

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

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

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

MetaData ccpaMetaData = new MetaData(this);
ccpaMetaData.set("privacy.consent", true);
ccpaMetaData.commit();
UnityAdsMediationSnippets.java

val ccpaMetaData = MetaData(this)
ccpaMetaData["privacy.consent"] = true
ccpaMetaData.commit()
UnityAdsMediationSnippets.kt

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

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

تحميل الإعلان باستخدام سياق النشاط

مرِّر سياق Activity عند تحميل أشكال الإعلانات "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات المدمجة مع المحتوى". بدون سياق النشاط، سيتعذّر تحميل الإعلان.

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

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

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

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

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

رموز الخطأ

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

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

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