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

دمج DT Exchange مع التوسّط

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

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

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

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

المتطلبات

المستوى 21 من واجهة برمجة تطبيقات Android أو المستويات الأعلى

أحدث حزمة تطوير برامج (SDK) لإعلانات Google على الأجهزة الجوّالة
إكمال عملية التوسّط دليل البدء

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

إضافة تطبيق جديد وموضع إعلان جديد

الاشتراك أو تسجيل الدخول إلى DT Exchange Console

انقر على الزر إضافة تطبيق لإضافة تطبيقك.

إدارة التطبيقات

حدد النظام الأساسي، واملأ بقية النموذج، ثم انقر على إضافة مواضع إعلانات.

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

ضبط إعدادات الجهاز

رقم تعريف التطبيق ورقم تعريف موضع الإعلان

افتح شريط التنقل الأيمن من خلال تمرير مؤشر الماوس فوقه. ثم انقر على التطبيقات من القائمة اليمنى.

في صفحة إدارة التطبيق، دوِّن رقم تعريف التطبيق بجانب تطبيقك.

رقم تعريف التطبيق

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

رقم تعريف موضع الإعلان

الرقم التعريفي للناشر ومفتاح المستهلك وسر العميل

انقر على اسم المستخدم من القائمة اليمنى واختَر الملف الشخصي للمستخدم.

دوِّن الرقم التعريفي للناشر ومفتاح المستهلك وسر المستخدم لأنها مطلوبة في الخطوة التالية.

الخطوة 2: إعداد طلب DT Exchange في واجهة المستخدم Ad Manager

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

سجِّل الدخول إلى حسابك على "مدير الإعلانات".

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

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

بعد ذلك، انقر على الزر إضافة شريك أرباح.

إذا كان لديك شريك أرباح في DT Exchange، يمكنك اختياره. إذا لم يكن لديك حساب، اختَر إنشاء شريك جديد لتحقيق الأرباح.

اختَر DT Exchange باعتبارها شبكة الإعلانات، وأدخِل اسمًا فريدًا وفعِّل التوسّط.

فعِّل الجمع التلقائي للبيانات، وأدخِل Publisher ID, Consumer Secret and Consumer Key الذي تم الحصول عليه في القسم السابق.

بعد اختيار الشريك المحقِّق للأرباح، اختر توسّط حزمة تطوير البرامج (SDK) للأجهزة الجوّالة كـ نوع الدمج، وAndroid باعتبارها النظام الأساسي، ونشط كالحالة. أدخِل Application ID and Placement ID الذي تم الحصول عليه في القسم السابق. ثم أدخِل قيمة التكلفة التلقائية لكل ألف ظهور.

انقر على حفظ في أسفل الصفحة عند الانتهاء.

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

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

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

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

في ملف build.gradle.kts على مستوى التطبيق، أضِف عملية التنفيذ التالية والتبعيات والتكوينات. استخدام أحدث إصدارات من حزمة تطوير البرامج (SDK) الخاصة بـ DT Exchange والمحوّل:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.3.0")
    implementation("com.google.ads.mediation:fyber:8.3.0.0")
}

الدمج اليدوي

نزِّل أحدث إصدار من حزمة تطوير البرامج (SDK) لـ DT Exchange لنظام التشغيل Android الملفات التالية إلى مشروعك:
- ia-mraid-kit-release-x.y.z.aar
- ia-sdk-core-release-x.y.z.aar
- ia-video-kit-release-x.y.z.aar
الانتقال إلى عناصر محوّل DT Exchange على مستودع Maven من Google. اختَر أحدث إصدار ونزِّل DT ملف .aar لمحوّل Exchange، وإضافته إلى مشروعك.

الخطوة 4: تنفيذ إعدادات الخصوصية على DT Exchange SDK

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

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

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

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setGdprConsent(true);
InneractiveAdManager.setGdprConsentString("myGdprConsentString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setGdprConsent(true)
InneractiveAdManager.setGdprConsentString("myGdprConsentString")

يمكنك الانتقال إلى صفحة مراجع اللائحة العامة لحماية البيانات على DT Exchange دليل تنفيذ اللائحة العامة لحماية البيانات لمعرفة مزيد من التفاصيل والقيم التي قد يتم تقديمها في الطريقة.

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

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

Java

import com.fyber.inneractive.sdk.external.InneractiveAdManager;
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString");

Kotlin

import com.fyber.inneractive.sdk.external.InneractiveAdManager
// ...

InneractiveAdManager.setUSPrivacyString("myUSPrivacyString")

يمكنك زيارة صفحة مراجع CCPA على DT Exchange دليل تنفيذ قانون خصوصية المستهلك في كاليفورنيا (CCPA) لمعرفة مزيد من التفاصيل والقيم التي قد يتم تقديمها في الطريقة.

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

ليس عليك استخدام رمز إضافي لدمج DT Exchange.

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

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

احرص على تسجيل جهاز الاختبار من أجل Ad Manager.

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

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

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

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

يتوافق محوّل DT Exchange مع معلَمات طلب إضافية يمكن يتم تمريره إلى المحوّل كحزمة Android. يبحث المحوّل عن ما يلي: في الحزمة:

طلب المعلَمات والقيم
`InneractiveMediationDefs.KEY_AGE`	عدد صحيح. عمر المستخدم
`FyberMediationAdapter.KEY_MUTE_VIDEO`	منطقي. كتم صوت الفيديو أو إعادته

في ما يلي مثال على رمز برمجي يوضّح كيفية ضبط مَعلمات طلب الإعلان:

Java

Bundle extras = new Bundle();
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10);
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false);

AdRequest request = new AdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter.class, extras)
   .build();

Kotlin

var extras = Bundle()
extras.putInt(InneractiveMediationDefs.KEY_AGE, 10)
extras.putBoolean(FyberMediationAdapter.KEY_MUTE_VIDEO, false)

val request = AdRequest.Builder()
   .addNetworkExtrasBundle(FyberMediationAdapter::class.java, extras)
   .build()

رموز الخطأ

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

com.google.ads.mediation.fyber.FyberMediationAdapter

في ما يلي الرموز والرسائل المرفقة التي يطرحها محوّل DT Exchange عند تعذّر تحميل إعلان:

رمز الخطأ	السبب
101	معلَمات خادم DT Exchange التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
103	لا يتطابق حجم الإعلان المطلوب مع حجم البانر المتوافق مع DT Exchange.
105	حمَّلت حزمة DT Exchange SDK أحد الإعلانات، ولكنه عرض وحدة تحكُّم غير متوقعة.
106	الإعلان غير جاهز للعرض.
200-399	حدث خطأ في حزمة DT Exchange SDK. الاطّلاع على الرمز لمزيد من التفاصيل.