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

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

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

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

يتضمّن محوِّل AdMob التوسّط في Tapjoy الإمكانيات التالية:

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

المتطلّبات

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

أحدث حزمة تطوير برامج (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.

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

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

إذا كان لديك تعيين لـ Tapjoy، يمكنك ببساطة اختياره. بخلاف ذلك، انقر على إضافة تعيين.

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

شلال

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

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

إذا كان لديك تعيين لـ Tapjoy، يمكنك ببساطة اختياره. بخلاف ذلك، انقر على إضافة تعيين.

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

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

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

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

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

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

الدمج اليدوي

نزِّل حزمة SDK لتطبيق Tapjoy Android واستخرِج tapjoyconnectlibrary.jar من مجلد Libraries وأضِفه إلى مشروعك.

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

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

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

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

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

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

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

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

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

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

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

بموجب سياسة موافقة المستخدم في الاتحاد الأوروبي من Google، عليك التأكّد من تقديم بعض الإفصاحات إلى المستخدمين في المنطقة الاقتصادية الأوروبية (EEA) والموافقات التي يتم الحصول عليها منهم في ما يتعلق باستخدام معرّفات الأجهزة والبيانات الشخصية. وتراعي هذه السياسة متطلبات توجيه الاتحاد الأوروبي بشأن الخصوصية الإلكترونية واللائحة العامة لحماية البيانات (GDPR). عند طلب الحصول على موافقة، عليك تحديد كل شبكة مواقع إعلانية في سلسلة التوسّط قد تجمع البيانات الشخصية أو تتلقّاها أو تستخدمها، وتقدم معلومات عن استخدام كل شبكة. ويتعذّر على 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 إلى قائمة الشركاء الإعلانيين الذين يخضعون للّائحة العامة لحماية البيانات (GDPR)

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

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

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

لغة 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 إلى قائمة الشركاء الإعلانيين حسب قانون خصوصية المستهلك في كاليفورنيا (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() ضمن الفئات التالية:

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

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

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

سجلّ التغييرات في محوِّل توسّط Android Tapjoy