تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

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

المتطلّبات

المستوى 19 أو أعلى من واجهة برمجة تطبيقات Android
[بالنسبة إلى عروض الأسعار]: محوّل Tapjoy 12.2.1.1 أو إصدار أحدث (يُنصح بأحدث إصدار

أحدث حزمة SDK لإعلانات Google على الجوال

الخطوة 1: إعداد Tapjoy

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

إضافة تطبيق

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

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

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

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

موضع إعلان

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

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

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

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

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

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

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

المحتوى

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

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

عروض الأسعار

إعلان بيني

انقر على الزر إنشاء لمحتوى الفيديو البيني الآلي.

أدخِل اسمًا للمحتوى واختَر Android بصفته المنصة.

اختيار العملة الافتراضية التي تمّ إنشاؤها سابقًا على أنها العملة الافتراضية

اختَر موضع الإعلان البيني الذي تم إنشاؤه في وقت سابق. انقر على الزر حفظ في الجزء السفلي عند الانتهاء لإنشاء المحتوى.

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

انقر على الزر إنشاء لمحتوى إعلانات الفيديو الآلية بمكافأة.

أدخِل اسمًا للمحتوى واختَر Android بصفته المنصة.

اختيار العملة الافتراضية التي تمّ إنشاؤها سابقًا على أنها العملة الافتراضية

اختَر موضع الإعلان الذي تم إنشاؤه في وقت سابق. انقر على الزر حفظ في الجزء السفلي عند الانتهاء لإنشاء المحتوى.

الشلال

إعلان بيني

انقر على الزر إنشاء لمحتوى الفيديو البيني.

أدخِل اسمًا للمحتوى واختَر Android بصفته المنصة.

اختيار العملة الافتراضية التي تمّ إنشاؤها سابقًا على أنها العملة الافتراضية

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

انقر على الزر إنشاء لمحتوى الفيديو بمكافأة.

أدخِل اسمًا للمحتوى واختَر Android بصفته المنصة.

اختيار العملة الافتراضية التي تمّ إنشاؤها سابقًا على أنها العملة الافتراضية

تحديد موقع مفتاح SDK

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

انتقل إلى الإعدادات > إعدادات التطبيق. يمكن الحصول على مفتاح SDK من معلومات التطبيق ضمن علامة تبويب وسائط عرض الإعلانات في التطبيقات.

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

عروض الأسعار

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

الشلال

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

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

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

يلزمك إضافة Tapjoy إلى تهيئة التوسط لوحدتك الإعلانية. أولاً، سجّل الدخول إلى حسابك في AdMob.

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

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

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

تراكب اختيار الوحدات الإعلانية

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

من المفترض أن تشاهد الآن بطاقة الوحدات الإعلانية التي تمت تعبئتها بالوحدات الإعلانية التي حدّدتها:

إضافة Tapjoy كمصدر إعلاني

عروض الأسعار

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

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

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

الشلال

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

اختَر Tapjoy وفعِّل مفتاح Optimize. أدخل مفتاح OAuth للناشر ومفتاح التوسط اللذين تم الحصول عليهما في القسم السابق لإعداد تحسين مصدر الإعلان لـ Tapjoy. ثم أدخل قيمة للتكلفة الفعلية لكل ألف ظهور لـ Tapjoy وانقر على متابعة.

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

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

الإعلانات بمكافأة

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

في حال عدم تطبيق هذا الإعداد، سيتم ضبط محوّل Tapjoy تلقائيًا على مكافأة من النوع "" (سلسلة فارغة) بقيمة 1. لا تقدم حزمة TapJoy SDK قيم مكافآت معينة للإعلانات بمكافأة.

لمزيد من المعلومات عن إعداد قيم المكافآت للوحدات الإعلانية في AdMob، يُرجى الاطّلاع على إنشاء وحدة إعلانية.

الخطوة 3: استيراد محوّل حزمة تطوير البرامج Tapjoy ومهايئه

دمج "استوديو Android" (موصى به)

أضِف تبعية التنفيذ التالية مع أحدث إصدار من حزمة تطوير البرامج Tapjoy SDK والمحوّل في ملف build.gradle على مستوى التطبيق:

repositories {
    google()
    maven {
       url "https://sdk.tapjoy.com/"
    }
}

...
dependencies {
    implementation 'com.google.android.gms:play-services-ads:21.4.0'
    implementation 'com.google.ads.mediation:tapjoy:12.11.1.0'
}
...

الدمج اليدوي

يمكنك تنزيل Tapjoy Android SDK واستخراج tapjoyconnectlibrary.jar من مجلد Libraries وإضافته إلى مشروعك.

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

الخطوة 4: يلزم إدخال رمز إضافي

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

الخطوة 5: اختبار التنفيذ

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

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

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

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

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

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

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

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

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

لغة Java

import com.tapjoy.TJPrivacyPolicy;
import com.tapjoy.Tapjoy;
...

TJPrivacyPolicy privacyPolicy = Tapjoy.getPrivacyPolicy();
privacyPolicy.setSubjectToGDPR(true);
privacyPolicy.setUserConsent("0");

Kotlin

import com.tapjoy.Tapjoy
...

val privacyPolicy = Tapjoy.getPrivacyPolicy()
privacyPolicy.setSubjectToGDPR(true)
privacyPolicy.setUserConsent("0")

انتقِل إلى Tapjoy دليل خصوصية المستخدم لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة

إضافة Tapjoy إلى قائمة شركاء الإعلانات باللائحة العامة لحماية البيانات

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

قانون خصوصية المستهلك في كاليفورنيا (CCPA)

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

لغة Java

import com.tapjoy.TJPrivacyPolicy;
import com.tapjoy.Tapjoy;
...

TJPrivacyPolicy privacyPolicy = Tapjoy.getPrivacyPolicy();
privacyPolicy.setUSPrivacy(“1YYY”);

Kotlin

import com.tapjoy.Tapjoy
...

val privacyPolicy = Tapjoy.getPrivacyPolicy()
privacyPolicy.setUSPrivacy(“1YYY”)

انتقِل إلى Tapjoy دليل خصوصية المستخدم لمزيد من التفاصيل والقيم التي يمكن تقديمها في كل طريقة

إضافة Tapjoy إلى قائمة شركاء الإعلانات وفقًا لقانون خصوصية المستهلك في كاليفورنيا (CCPA)

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

الأذونات

لتحقيق الأداء الأمثل، توصي Tapjoy بإضافة الأذونات الاختيارية التالية إلى ملف AndroidManifest.xml لتطبيقك:

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

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

يدعم محول Tapjoy معلمة طلب إضافية يمكن تمريرها إلى المحوّل باستخدام فئة TapjoyExtrasBundleBuilder. يتضمن TapjoyExtrasBundleBuilder الطريقة التالية:

setDebug(bool): يتيح لك تفعيل وضع تصحيح الأخطاء في حزمة تطوير البرامج Tapjoy SDK الاطّلاع على إجراءات متنوعة في Tapjoy في Play Console. هذه المعلمة متاحة لجميع أشكال الإعلانات.

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

لغة Java

Bundle extras = new TapjoyAdapter.TapjoyExtrasBundleBuilder()
          .setDebug(true)
          .build();
AdRequest adRequest = new AdRequest.Builder()
          .addNetworkExtrasBundle(TapjoyAdapter.class, extras)
          .build());

Kotlin

val extras = TapjoyExtrasBundleBuilder()
          .setDebug(true)
          .build()
val adRequest = AdRequest
          .addNetworkExtrasBundle(TapjoyAdapter::class.java, extras)
          .build()

التحقق من المحوّل وإصدارات حزمة تطوير البرامج (SDK)

لتسجيل إصدارَي المحول والحزمة SDK، استخدم مقتطف الشفرة التالي:

TapjoyMediationAdapter adapter = new TapjoyMediationAdapter();
VersionInfo adapterVersion = adapter.getVersionInfo();
VersionInfo sdkVersion = adapter.getSDKVersionInfo();
// Log the adapter patch version to 3 digits to represent the x.x.x.x versioning
// used by adapters.
Log.d("TAG", String.format(
    "Adapter version: %d.%d.%03d",
    adapterVersion.getMajorVersion(),
    adapterVersion.getMinorVersion(),
    adapterVersion.getMicroVersion()));
Log.d("TAG", String.format(
    "SDK version: %d.%d.%d",
    sdkVersion.getMajorVersion(),
    sdkVersion.getMinorVersion(),
    sdkVersion.getMicroVersion()));

رموز الخطأ

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

الشكل	اسم الصف
إعلان بيني	مهايئ النقر
تم منح المكافأة	محوِّل TapJoyMediation

في ما يلي الرموز والرسائل المصاحبة التي يقدمها محول Tapjoy عندما يخفق تحميل أحد الإعلانات:

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