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

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

يوضّح لك هذا الدليل كيفية استخدام GMA Next-Gen SDK لتحميل الإعلانات وعرضها من Unity Ads باستخدام توسّط AdMob، مع تغطية عمليات الدمج المتسلسلة وعروض الأسعار. توضّح هذه الصفحة كيفية إضافة 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 لتطبيقك.

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

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

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

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

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

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

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

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

عليك إضافة Unity Ads إلى إعدادات التوسّط الخاصة بوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، ثم انتقِل إلى إضافة Unity Ads كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

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

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية الحالية على AdMob. بعد ذلك، انقر على تم.

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة Unity Ads كمصدر إعلان

عروض الأسعار

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، اختَر Unity Ads .

انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع Unity Ads.



انقر على الإقرار والموافقة، ثم انقر على متابعة.



إذا كان لديك عملية ربط حالية في Unity Ads، يمكنك اختيارها. بخلاف ذلك، انقر على إضافة عملية ربط.



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

شلال

ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

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



إذا سبق لك ربط حسابك على Unity Ads، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.

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

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

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

الخطوة 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: اختبار عملية الإعداد

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

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