دمج AdColony مع التوسّط

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

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

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

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

المتطلّبات

  • Unity 5.6 أو إصدار أحدث
  • أحدث حزمة SDK لإعلانات Google على الأجهزة الجوّالة
  • [لتقديم عروض الأسعار]: المكوّن الإضافي لتوسّط "إعلانات Google" على الأجهزة الجوّالة للإصدار 1.0.5 من AdColony أو الإصدارات الأحدث (أحدث إصدار يُنصح به)
  • للنشر على Android:
    • المستوى 19 أو أعلى لواجهة برمجة تطبيقات Android
  • للنشر على iOS:
    • هدف نشر iOS هو 12.0 أو إصدار أحدث
  • مشروع Unity عملي تم إعداده باستخدام "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة". يمكنك الاطّلاع على البدء للحصول على مزيد من التفاصيل.
  • إكمال عملية التوسّط دليل البدء

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

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

إعداد تطبيق جديد في AdColony

املأ النموذج وانقر على إنشاء في أسفل الصفحة لإضافة تطبيقك إلى AdColony.

Android

إنشاء تطبيق AdColony

iOS

إنشاء تطبيق AdColony

بعد إنشاء تطبيقك، يمكنك الحصول على رقم تعريف التطبيق من خلال الانتقال إلى تحقيق الربح > التطبيقات ضمن القسم معلومات التطبيق الأساسية لتطبيقك.

Android

رقم تعريف تطبيق AdColony

iOS

رقم تعريف تطبيق AdColony

بعد ذلك، يمكنك إنشاء منطقة إعلانية جديدة بالنقر على الزر إعداد منطقة إعلانية جديدة في قسم المناطق الإعلانية في صفحة تطبيقك. نقترح عليك إنشاء منطقة إعلانية جديدة للتوسّط مع AdMob حتى إذا سبق لك إنشاؤها.

Android

منطقة إعداد AdColony

iOS

منطقة إعداد AdColony

للحصول على تعليمات إضافية حول إنشاء موضع الإعلان، حدد علامة التبويب المناسبة لشكل الإعلان المفضّل لديك.

  1. اضبط المنطقة نشطة؟ على نعم.

  2. أدخِل اسمًا للمنطقة الإعلانية.

  3. اختر إعلان البانر باعتباره حجم منطقة الإعلان.

  4. يُرجى إدخال قيمة في حقل الحد الأقصى اليومي لمرات التشغيل.

إعلان بيني

  1. اضبط المنطقة نشطة؟ على نعم.

  2. أدخِل اسمًا للمنطقة الإعلانية.

  3. اختر ما قبل التشغيل/إعلان بيني باعتباره نوع المنطقة.

  4. يُرجى إدخال قيمة في حقل الحد الأقصى اليومي لمرات التشغيل.

تم منح المكافأة

  1. اضبط المنطقة نشطة؟ على نعم.

  2. أدخِل اسمًا للمنطقة الإعلانية.

  3. اختَر تبادل القيمة/V4VC باعتباره نوع المنطقة.

  4. اضبط من جهة العميل فقط؟ على نعم وأدخِل اسم العملة الافتراضية والحد الأقصى اليومي للفيديوهات لكل مستخدم ومبلغ المكافأة.

  5. يُرجى إدخال قيمة في حقل الحد الأقصى اليومي لمرات التشغيل.

انقر على الزر إنشاء عند الانتهاء من إنشاء "المنطقة الإعلانية".

بعد إنشاء "المنطقة الإعلانية"، يمكنك العثور على رقم تعريف المنطقة ضمن قسم الدمج في "المنطقة الإعلانية". سيتم استخدام رقم تعريف المنطقة في الخطوة التالية.

رقم تعريف منطقة AdColony

تحديد موقع مفتاح واجهة برمجة تطبيقات AdColony

عروض الأسعار

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

شلال

ستحتاج إلى مفتاح واجهة برمجة تطبيقات AdColony لإعداد AdMob رقم تعريف الوحدة الإعلانية. انتقِل إلى إعدادات الحساب في لوحة بيانات الناشر في AdColony لتحديد موقع مفتاح واجهة برمجة التطبيقات.

إعدادات AdColony

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

لتفعيل الإعلانات الاختبارية على AdColony، انتقِل إلى لوحة بيانات AdColony وانتقِل إلى تحقيق الربح > التطبيقات. اختَر المنطقة التي تريد تفعيل الإعلانات الاختبارية لها ضمن قسم مناطق الإعلانات في تطبيقك. ويمكن تفعيل الإعلانات الاختبارية من خلال تحديد نعم إلى عرض الإعلانات الاختبارية فقط؟ ضمن قسم التطوير.

اختبار AdColony

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

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

Android

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

iOS

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

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

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

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) الخاصة بخدمة AdColony ومحوّلها

نزِّل أحدث إصدار من المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة في AdColony من رابط التنزيل في سجلّ التغييرات واستخرج GoogleMobileAdsAdColonyMediation.unitypackage من ملف ZIP.

في محرر مشروع Unity، حدد Assets >Import Package > Custom Package وابحث عن الملف GoogleMobileAdsAdColonyMediation.unitypackage الذي قمت بتنزيله. تأكَّد من اختيار جميع الملفات وانقر على استيراد.

بعد ذلك، اختَر مواد العرض > أداة حل خدمات Play > أداة حل Android > فرض الحل. ستنفِّذ مكتبة "أداة إدارة التبعيات الخارجية" حلّاً للتبعية من البداية وتنسخ التبعيات المُعلَنة إلى دليل Assets/Plugins/Android في تطبيق Unity.

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

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

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

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.GDPR, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.GDPR, "myPrivacyConsentString");

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

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

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

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

using GoogleMobileAds.Api.Mediation.AdColony;
// ...

AdColonyAppOptions.SetPrivacyFrameworkRequired(AdColonyPrivacyFramework.CCPA, true);
AdColonyAppOptions.SetPrivacyConsentString(AdColonyPrivacyFramework.CCPA, "myPrivacyConsentString");

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

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

Android

ما مِن رمز إضافي مطلوب لدمج AdColony.

iOS

دمج SKAdNetwork

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

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

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

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

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

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

خطوات اختيارية

Android

الأذونات

لتحقيق الأداء الأمثل، تنصح AdColony بإضافة الأذونات الاختيارية التالية إلى ملف AndroidManifest.xml المتوفّر ضمن دليل Assets/Plugins/Android/GoogleMobileAdsPlugin لمشروع Unity.

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.VIBRATE" />

iOS

ليس من المطلوب اتّخاذ أي خطوات إضافية للتكامل مع نظام iOS.

المعلمات الخاصة بالشبكة

تتوافق حزمة توسّط AdColony مع مَعلمات الإعدادات والطلبات الإضافية، والتي يمكن تمريرها إلى المحوّل باستخدام الفئتَين AdColonyMediationExtras وAdColonyAppOptions.

تتضمّن الفئة AdColonyMediationExtras الطرق التالية:

SetShowPrePopup(bool)
تضبط ما إذا كان سيتم عرض نافذة منبثقة قبل عرض الإعلان أم لا. يمكنك ضبط القيمة على "خطأ" إذا كنت لا تريد عرض نافذة منبثقة قبل عرض الإعلانات.
SetShowPostPopup(bool)
تضبط ما إذا كان سيتم عرض نافذة منبثقة بعد عرض إعلان أم لا. يمكنك الضبط على "خطأ" إذا كنت لا تريد عرض نافذة منبثقة بعد عرض الإعلانات

تتضمّن الفئة AdColonyAppOptions الطرق التالية:

SetUserId(string)
اضبط رقم تعريف المستخدم لحزمة AdColony SDK التي تقدِّم إحصاءات إضافية إلى خادم إعلانات AdColony.
SetTestMode(bool)
يضبط هذا الإعداد ما إذا كان سيتم تفعيل وضع الاختبار لحزمة تطوير البرامج (SDK) في AdColony أم لا.

في ما يلي مثال رمز برمجي لكيفية تعيين هذه الإعدادات ومَعلمات طلبات الإعلان:

// Set app-level configurations
AdColonyAppOptions.SetUserId("myUser");
AdColonyAppOptions.SetTestMode(true);

// Set ad request parameters
AdColonyMediationExtras extras = new AdColonyMediationExtras();
extras.SetShowPrePopup(true);
extras.SetShowPostPopup(true);

AdRequest request = new AdRequest.Builder()
        .AddMediationExtras(extras)
        .Build();

رموز الخطأ

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

Android

com.jirbo.adcolony.AdColonyAdapter
com.google.ads.mediation.adcolony.AdColonyMediationAdapter

iOS

GADMAdapterAdColony
GADMediationAdapterAdColony

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

Android

رمز الخطأ السبب
100 حدث خطأ في حزمة تطوير البرامج (SDK) الخاصة بخدمة AdColony.
101 معلَمات الخادم غير صالحة (مثلاً، رقم تعريف المنطقة غير متوفّر).
102 سبق أن تم طلب إعلان لرقم تعريف المنطقة نفسه.
103 حدث خطأ في الإعداد في حزمة تطوير البرامج (SDK) الخاصة بخدمة AdColony.
104 حجم البانر المطلوب غير مرتبط بحجم إعلان صالح في AdColony.
105 حدث خطأ في العرض التقديمي بسبب عدم تحميل الإعلان.
106 لم يكن السياق المستخدَم لإعداد حزمة AdColony SDK من أمثلة Activity.

iOS

رمز الخطأ السبب
من 0 إلى 3 حدث خطأ في حزمة تطوير البرامج (SDK) الخاصة بخدمة AdColony. يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.
101 معلَمات الخادم غير صالحة (مثلاً، رقم تعريف المنطقة غير متوفّر).
102 وحدة التحكّم في العرض الجذر التي تعرض الإعلان هي nil.
103 حدث خطأ في الإعداد في حزمة تطوير البرامج (SDK) الخاصة بخدمة AdColony.
104 لا تتيح حزمة تطوير البرامج (SDK) في AdColony ضبط إعداداتها مرتين خلال فترة خمس ثوانٍ.
105 تعذّر عرض الإعلان.
106 إنّ المنطقة المستخدَمة لعرض المكافآت ليست منطقة مكافآت على بوابة AdColony.

سجلّ تغييرات المكوّن الإضافي لتوسّط AdColony Unity

الإصدار 2.6.3 (قيد التقدّم)

  • تم إصلاح التحذير بشأن تعريف مكرّر لـ MediationExtras.

الإصدار 2.6.2

الإصدار 2.6.1

  • تم تعديل واجهات برمجة التطبيقات المتعلّقة بالخصوصية من الفئة AdColonyAppOptions إلى الطرق التالية للتوافق مع اللائحة العامة لحماية البيانات (GDPR) وقانون خصوصية المستهلك في كاليفورنيا (CCPA):
    • SetGDPRRequired(bool) -> SetPrivacyFrameworkRequired(AdColonyPrivacyFramework, bool)
    • IsGDPRRequired() -> GetPrivacyFrameworkRequired(AdColonyPrivacyFramework)
    • SetGDPRConsentString(string)-> SetPrivacyConsentString(AdColonyPrivacyFramework, string)
    • GetGDPRConsentString() -> GetPrivacyConsentString(AdColonyPrivacyFramework)
  • يتوافق مع الإصدار 4.8.0.1 من محوّل AdColony لنظام التشغيل Android.
  • يتوافق مع الإصدار 4.9.0.2 من محوّل AdColony لنظام التشغيل iOS.
  • تم إنشاء الإصدار 7.4.1 من المكوّن الإضافي Unity لإعلانات Google على الأجهزة الجوّالة واختبارها باستخدام الإصدار 7.4.1.

الإصدار 2.6.0

الإصدار 2.5.0

الإصدار 2.4.1

الإصدار 2.4.0

الإصدار 2.3.0

الإصدار 2.2.0

الإصدار 2.1.0

الإصدار 2.0.3

الإصدار 2.0.2

الإصدار 2.0.1

الإصدار 2.0.0

الإصدار 1.0.6

الإصدار 1.0.5

  • تم نقل الطُرق التالية من فئة أداة إنشاء AdColonyMediationExtras إلى الفئة AdColonyAppOptions:
    • SetGDPRRequired()
    • SetGDPRConsentString()
    • SetUserId()
    • SetTestMode()
  • تمت إضافة الطرق التالية إلى الفئة AdColonyAppOptions:
    • IsGDPRRequired()
    • GetGDPRConsentString()
    • GetUserId()
    • IsTestMode()
  • تمت إزالة الطريقة SetZoneId() من فئة أداة إنشاء AdColonyMediationExtras.
  • يتوافق مع الإصدار 3.3.10.1 من محوّل AdColony لنظام التشغيل Android.
  • يتوافق مع الإصدار 3.3.7.2 من محوّل AdColony لنظام التشغيل iOS.

الإصدار 1.0.4

  • تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات Rewarded API الجديدة والمفتوحة.
  • يتوافق مع الإصدار 3.3.8.1 من محوّل AdColony لنظام التشغيل Android.
  • يتوافق مع الإصدار 3.3.6.1 من محوّل AdColony لنظام التشغيل iOS.

الإصدار 1.0.3

  • يتوافق مع الإصدار 3.3.5.1 من محوّل AdColony لنظام التشغيل Android.
  • يتوافق مع الإصدار 3.3.5.0 من محوّل AdColony لنظام التشغيل iOS.

الإصدار 1.0.2

  • يتوافق مع الإصدار 3.3.4 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AdColony.
  • يتوافق مع الإصدار 3.3.4 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من AdColony.
  • يتم الآن تجاهل SetTestMode() من فئة "أداة إنشاء AdColonyMediationExtras" لنظام التشغيل Android. يمكن للناشرين الآن طلب إعلانات اختبارية من AdColony لنظام التشغيل Android عن طريق تحديد جهاز اختباري عبر AddTestDevice() من فئة AdRequest Builder.
  • تمت إضافة الطرق التالية إلى فئة "أداة إنشاء AdColonyMediationExtras":
    • SetGDPRRequired()
    • SetGDPRConsentString()

الإصدار 1.0.1

  • يتوافق مع الإصدار 3.3.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AdColony.
  • يتوافق مع الإصدار 3.3.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من AdColony.

الإصدار 1.0.0

  • الإصدار الأول
  • يتوافق مع الإصدار 3.3.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل Android من AdColony.
  • يتوافق مع الإصدار 3.3.0 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من AdColony.