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

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

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

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

يتضمّن محوِّل Ad Manager التوسّط الخاص بـ DT Exchange الإمكانات التالية:

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

المتطلّبات

المستوى 19 أو أعلى لواجهة برمجة تطبيقات 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 على مستوى التطبيق، أضِف تبعيات التنفيذ وعمليات الضبط التالية. استخدِم أحدث إصدار من DT Exchange SDK ومحوّل:

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

الدمج اليدوي

نزِّل أحدث إصدار من DT Exchange SDK for 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. اختَر أحدث إصدار ونزِّل ملف .aar لمحوّل DT Exchange وأضِفه إلى مشروعك.

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

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

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

var adrequest = 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. اطّلِع على الرمز البرمجي لمزيد من التفاصيل.
0-10	حدث خطأ في حزمة DT Exchange SDK. يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.
101	معلمات خادم DT Exchange التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة/غير صالحة.
102	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع DT Exchange.
103	تعذّر عرض الإعلان لأنّه سبق استخدام كائن الإعلان.
104	تعذّر عرض إعلانات DT Exchange لأنّ الإعلان غير جاهز.
105	عرضت حزمة DT Exchange SDK خطأ في الإعداد.