دمج ميزة Tapjoy مع التوسّط

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

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

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

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

المتطلّبات

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

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

اشترِك أو سجِّل الدخول إلى لوحة بيانات Tapjoy.

إضافة تطبيق

أضِف تطبيقك إلى لوحة بيانات Tapjoy من خلال الانتقال إلى قائمة التطبيقات في أعلى يسار الصفحة والنقر على الزر إضافة تطبيق. تتم مطالبتك بعد ذلك بإدخال تفاصيل حول تطبيقك.

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

يمكنك تخطي خطوات الدمج التي تقدّمها Tapjoy والانتقال إلى إنشاء مواضع الإعلانات لاستخدامها مع AdMob التوسّط.

إذا كان تطبيقك يتوافق مع كِلا النظامين الأساسيين، اختَر كلا النظامين كنظام أساسي.

Android

iOS

موضع الإعلان والعملة الافتراضية والمحتوى

موضع إعلان

انتقِل إلى تحقيق الربح > مواضع الإعلانات ثم انقر على الزر إنشاء موضع إعلان في أعلى يسار الصفحة. حتى إذا كان لديك موضع إعلان حالي، من الأفضل أن تنشئ موضعًا جديدًا من أجل AdMob حتى يمكن تتبُّعه وإعداد تقارير عنه بشكل منفصل.

أدخِل اسمًا لموضع الإعلان، وضَع علامة في مربّع الاختيار التوسّط، ثم اختَر AdMob من القائمة المنسدلة. انقر على إنشاء عند الانتهاء.

يُستخدم اسم موضع الإعلان الذي تم إدخاله هنا لإعداد AdMob وحدتك الإعلانية للتوسّط في القسم التالي. تم استخدام "AdMob التوسّط" في هذا المثال، ولكن يمكنك تسمية موضع الإعلان كما تشاء.

العملة الافتراضية

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

املأ النموذج وانقر على إنشاء الآن. استخدِم NO_CALLBACK كعنوان URL لمعاودة الاتصال. ويضمن هذا الإجراء تجنُّب الطلبات غير الضرورية بخادمك من خلال حزمة تطوير البرامج (SDK) لتطبيق Tapjoy.

لا تتم إعادة توجيه قيمة العملة واسمها من خلال محوّل Tapjoy، لذا يمكن اختيار أي قيم عامة لاسم عملتك ومبلغها.

Android

iOS

المحتوى

انتقِل إلى تحقيق الربح > إنشاء محتوى لإنشاء محتوى لعرضه مع مواضع الإعلانات.

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

عروض الأسعار

إعلان بيني

انقر على الزر إنشاء لمحتوى الفيديو البيني الآلي. أدخِل اسمًا للمحتوى واختَر المنصة التي تريدها. * {Android} * {iOS} يجب اختيار العملة الافتراضية التي تم إنشاؤها سابقًا على أنّها العملة الافتراضية. اختَر موضع الإعلان البيني الذي تم إنشاؤه سابقًا. انقر على الزر حفظ في الأسفل عند الانتهاء من إنشاء المحتوى.

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

انقر على الزر إنشاء لمحتوى إعلانات الفيديو التي تضم مكافأة. * {Android} * {iOS} اختَر العملة الافتراضية التي تم إنشاؤها سابقًا على أنّها العملة الافتراضية. اختَر موضع الإعلان بمكافأة الذي تم إنشاؤه سابقًا. انقر على الزر حفظ في الأسفل عند الانتهاء من إنشاء المحتوى.

شلال

إعلان بيني

انقر على الزر إنشاء لمحتوى فيديو بيني. أدخِل اسمًا للمحتوى واختَر المنصة التي تريدها. * {Android} * {iOS} يجب اختيار العملة الافتراضية التي تم إنشاؤها سابقًا على أنّها العملة الافتراضية. اختَر موضع الإعلان البيني الذي تم إنشاؤه سابقًا. انقر على الزر حفظ في الأسفل عند الانتهاء من إنشاء المحتوى.

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

انقر على الزر إنشاء لمحتوى فيديو يضمّ مكافأة. أدخِل اسمًا للمحتوى واختَر المنصة التي تريدها. * {Android} * {iOS} يجب اختيار العملة الافتراضية التي تم إنشاؤها سابقًا على أنّها العملة الافتراضية. اختَر موضع الإعلان بمكافأة الذي تم إنشاؤه سابقًا. انقر على الزر حفظ في الأسفل عند الانتهاء من إنشاء المحتوى.

تحديد موقع مفتاح حزمة تطوير البرامج (SDK)

بالإضافة إلى اسم موضع الإعلان، تحتاج أيضًا إلى مفتاح حزمة تطوير البرامج (SDK) لإعداد AdMob وحدتك الإعلانية.

انتقِل إلى الإعدادات > إعدادات التطبيق. يمكن الحصول على مفتاح حزمة تطوير البرامج (SDK) من معلومات التطبيق ضمن علامة التبويب منصات التطبيقات.

Android

iOS

تحديد مكان مفاتيح إعداد التقارير

عروض الأسعار

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

شلال

تحتاج إلى مفتاح OAuth للناشر ومفتاح التوسّط للمتابعة. يمكن الحصول على مفتاح OAuth للناشر في الصفحة نفسها ضمن علامة التبويب مفاتيح واجهة برمجة التطبيقات.

يمكن الحصول على مفتاح التوسط في الصفحة نفسها ضمن علامة التبويب مفاتيح التوسط ضمن العمود مفتاح واجهة برمجة تطبيقات إعداد التقارير. المفتاح هو "AdMob".

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

يمكن تفعيل الإعلانات الاختبارية في لوحة بيانات Tapjoy ضِمن الإعدادات > إعدادات التطبيق > أجهزة الاختبار. أنشئ جهاز اختبار جديدًا باستخدام المعرِّف الإعلاني للجهاز:

Android

يمكنك العثور على المعرّف الإعلاني لجهازك من خلال الانتقال إلى Google > الإعلانات في إعدادات جهازك.

iOS

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

Swift

let advertisingId: String = ASIdentifierManager.shared().advertisingIdentifier.uuidString
print("Advertising ID: \(advertisingId)")

Objective-C

NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
NSLog(@"Advertising ID: %@", advertisingId);

بعد ذلك، عدِّل المحتوى الذي أنشأته سابقًا.

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

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

Android

iOS

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

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

Android

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

iOS

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

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

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

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

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

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

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

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

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

يتضمّن المكوّن الإضافي لتوسّط إعلانات Google على الأجهزة الجوّالة للإصدار 1.1.1 من Tapjoy الطريقتَين SetUserConsent() وSubjectToGDPR(). يعرض الرمز النموذجي التالي كيفية تمرير معلومات الموافقة إلى حزمة تطوير البرامج Tapjoy SDK وإذا اخترت استدعاء هذه الطريقة، ننصحك بإجراء ذلك قبل طلب الإعلانات من خلال "SDK لإعلانات Google على الأجهزة الجوّالة".

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUserConsent("myUserConsent");

بالإضافة إلى ذلك، تتوفّر علامة اختيارية يمكن ضبطها للإشارة إلى ما إذا كان المستخدم خاضعًا للائحة العامة لحماية البيانات (GDPR).

Tapjoy.SubjectToGDPR(true);

راجِع دليل خصوصية المستخدم الخاص بـ Tapjoy لمعرفة مزيد من التفاصيل والقيم التي يمكن تقديمها بالطريقة.

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

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

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

using GoogleMobileAds.Api.Mediation.Tapjoy;
// ...

Tapjoy.SetUSPrivacy("myUSPrivacyString");

راجِع دليل خصوصية المستخدم الخاص بـ Tapjoy لمعرفة مزيد من التفاصيل والقيم التي يمكن تقديمها بالطريقة.

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

Android

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

iOS

دمج SKAdNetwork

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

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

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

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

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

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

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

Android

الأذونات

للحصول على الأداء الأمثل، تنصح Tapjoy بإضافة الأذونات الاختيارية التالية إلى ملف AndroidManifest.xml الخاص بتطبيقك. عدِّل ملف AndroidManifest.xml الموجود ضمن مجلد Assets/Plugins/Android/GoogleMobileAdsTapjoyMediation وضمِّن الأذونات الاختيارية التالية:

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

iOS

ما مِن خطوات إضافية لدمج نظام التشغيل iOS.

رموز الخطأ

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

Android

التنسيق اسم الصف
إعلان بيني TapjoyAdapter
تم منح المكافأة TapjoyMediationAdapter

iOS

التنسيق اسم الصف
إعلان بيني GADMAdapterTapjoy
تم منح المكافأة GADMAdapterTapjoy

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

Android

رمز الخطأ السبب
101 معلَمات خادم Tapjoy التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة.
103 يجب أن يطلب الناشر إعلانات تحتوي على سياق Activity.
104 تعذّر إعداد حزمة تطوير البرامج (SDK) Tapjoy.
105 حدث خطأ في العرض التقديمي Tapjoy أثناء تشغيل الفيديو.
106 يتعذّر على حزمة تطوير البرامج (SDK) في Tapjoy تحميل إعلانين برقم تعريف موضع الإعلان نفسه في آنٍ واحد.
107 لم يطلب التطبيق إعلانات مدمجة مع المحتوى.
108 لا يتوفّر محتوى إعلان في حزمة تطوير البرامج Tapjoy SDK.

iOS

رمز الخطأ السبب
101 معلَمات خادم Tapjoy التي تم ضبطها في واجهة المستخدم AdMob غير متوفّرة أو غير صالحة.
102 تعذّر إعداد حزمة تطوير البرامج (SDK) Tapjoy.
103 لا يتوافق محوّل Tapjoy مع شكل الإعلان المطلوب.
104 تم إرسال معاودة الاتصال بنجاح من خلال Tapjoy ولكن لم يكن هناك أي محتوى متاح.
105 سبق أن تم تحميل إعلان لإعداد الشبكة هذه.
106 عرضت حزمة تطوير البرامج (SDK) في Tapjoy رسالة خطأ في معاودة الاتصال بسبب تعذُّر الاتصال.

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

الإصدار 3.2.0

الإصدار 3.1.1

الإصدار 3.1.0

الإصدار 3.0.0

الإصدار 2.10.1

الإصدار 2.10.0

الإصدار 2.9.1

الإصدار 2.9.0

الإصدار 2.8.2

الإصدار 2.8.1

الإصدار 2.8.0

الإصدار 2.7.1

الإصدار 2.7.0

الإصدار 2.6.1

الإصدار 2.6.0

الإصدار 2.5.1

الإصدار 2.5.0

الإصدار 2.4.2

الإصدار 2.4.1

الإصدار 2.4.0

الإصدار 2.3.1

الإصدار 2.3.0

  • يتوافق الجهاز مع الإصدار 12.3.1.0 من محوّل Tapjoy المتوافق مع Android.
  • يتوافق متوافق مع الإصدار 12.3.1.0 من محوّل Tapjoy المتوافق مع iOS.

الإصدار 2.2.0

  • تم تحديث المكوّن الإضافي للتوافق مع واجهة برمجة التطبيقات الجديدة التي تضم مكافآت.
  • يتوافق متوافق مع الإصدار 12.2.1.0 من محوّل Tapjoy المتوافق مع Android.
  • يتوافق مع الإصدار 12.2.1.0 من محوّل Tapjoy المتوافق مع iOS.

الإصدار 2.1.0

  • يتوافق الجهاز مع الإصدار 12.2.0.0 من محوّل Tapjoy المتوافق مع Android.
  • يتوافق مع الإصدار 12.1.0.0 من محوّل Tapjoy المتوافق مع iOS.

الإصدار 2.0.1

  • يتوافق الجهاز مع الإصدار 12.0.0.1 من محوّل Tapjoy المتوافق مع Android.
  • يتوافق مع الإصدار 12.0.0.0 من محوّل Tapjoy المتوافق مع iOS.

الإصدار 2.0.0

  • يتوافق الجهاز مع الإصدار 12.0.0.0 من محوّل Tapjoy المتوافق مع Android.
  • يتوافق مع الإصدار 12.0.0.0 من محوّل Tapjoy المتوافق مع iOS.

الإصدار 1.1.1

  • يتوافق التطبيق مع الإصدار 11.12.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Tapjoy.
  • يتوافق هذا الإصدار مع الإصدار 11.12.2 من حزمة تطوير البرامج (SDK) لنظام التشغيل Tapjoy.
  • تمت إضافة طريقة "Tapjoy.SetUserConsent()" لإعادة توجيه حالة موافقة المستخدم إلى حزمة تطوير البرامج (SDK) Tapjoy في شكل سلسلة موافقة.
  • تمت إضافة طريقة Tapjoy.SubjectToGDPR() للإشارة إلى ما إذا كانت "اللائحة العامة لحماية البيانات" تنطبق على المستخدم أم لا.

الإصدار 1.1.0

  • يتوافق التطبيق مع الإصدار 11.12.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Tapjoy.
  • يتوافق هذا الإصدار مع الإصدار 11.12.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Tapjoy.

الإصدار 1.0.0

  • الإصدار الأول
  • يتوافق مع الإصدار 11.11.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Tapjoy.
  • يتوافق هذا الإصدار مع الإصدار 11.11.1 من حزمة تطوير البرامج (SDK) لنظام التشغيل Tapjoy.