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

دمج MyTarget مع التوسط

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

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

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

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

المتطلبات

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

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

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

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

بعد ذلك، قدم عنوان URL لـ Google Play لتطبيقك.

عند إضافة أحد التطبيقات، تطلب منك myTarget إنشاء وحدة إعلانية قبل إكمال العملية.

اختَر BANNER من أشكال الإعلانات المتاحة، ثم انقر على الزر BANNER.

إعلان بيني

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

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

اختَر فيديو يتضمّن مكافأة من أشكال الإعلانات المتاحة، ثم انقر على الزر إضافة وحدة إعلانية.

مدمجة مع المحتوى

اختَر مبدأ الإعلان من أشكال الإعلانات المتاحة، ثم انقر على إضافة وحدة إعلانية.

في صفحة تفاصيل وحدتك الإعلانية، دوِّن رقم تعريف الخانة الذي يمكن العثور عليه ضمن إعدادات الوحدة الإعلانية على أنّه slot_id. سيتم استخدام رقم تعريف الخانة هذه لإعداد Ad Manager وحدتك الإعلانية في القسم التالي.

بالإضافة إلى slot_id، ستحتاج أيضًا إلى رمز الدخول الدائم myTarget لإعداد رقم تعريف وحدتك الإعلانية في AdMob. انتقِل إلى علامة التبويب الملف الشخصي واختَر رموز الدخول. انقر على إنشاء رمز مميّز أو إظهار الرمز المميّز لعرض رمز الدخول الدائم الخاص بـ myTarget.

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

اتّبِع التعليمات الواردة في مستندات myTarget لإضافة جهاز اختبار وضبط إعداداته في واجهة مستخدم myTarget.

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

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

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

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

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

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

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

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

فعِّل الجمع التلقائي للبيانات، وأدخِل Permanent Access Token الذي تم الحصول عليه في القسم السابق.

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

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

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

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

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

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

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

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

الدمج اليدوي

لتضمين حزمة myTarget SDK، يُرجى الرجوع إلى myTarget Android SDK. ذات الصلة.
انتقِل إلى محوّل myTarget العناصر على مستودع Maven من Google. حدد أحدث إصدار، ونزِّل ملف .aar الخاص بمحوّل myTarget، وإضافته إلى مشروعك.

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

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

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

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

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserConsent(true)

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

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setUserAgeRestricted(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setUserAgeRestricted(true)

الاطّلاع على أهداف دليل الخصوصية واللائحة العامة لحماية البيانات لمزيد من المعلومات والقيم التي يمكن تقديمها في الطريقة.

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

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

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

Java

import com.my.target.common.MyTargetPrivacy;
// ...

MyTargetPrivacy.setCcpaUserConsent(true);

Kotlin

import com.my.target.common.MyTargetPrivacy
// ...

MyTargetPrivacy.setCcpaUserConsent(true)

التواصل مع فريق دعم myTarget للحصول على مزيد من المعلومات والقيم التي يمكن تقديمها في الطريقة.

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

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

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

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

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

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

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

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

استخدام الإعلانات المدمجة مع المحتوى

عرض الإعلانات

يعرض محول myTarget إعلاناته المدمجة مع المحتوى في شكل NativeAd الأخرى. يملأ ما يلي الحقول لمدة NativeAd

الحقل	تتم التعبئة بواسطة محوّل myTarget
العنوان	دائمًا
صورة	دائمًا
النص الأساسي	دائمًا
رمز التطبيق	دائمًا
الحث على اتخاذ إجراء	دائمًا
التقييم النجمي	غير مضمونة
المتجر	غير مضمونة
السعر	غير مضمونة
Logo	غير مضمونة
المعلِن	دائمًا

تعرض حزمة myTarget SDK دائمًا 0 لنسبة العرض والارتفاع mediaView، وبالتالي فإن يعرض محوّل myTarget دائمًا 0 لمدة getAspectRatio() ستعمل حزمة تطوير البرامج (SDK) الخاصة بـ myTarget على حل هذه المشكلة في إصدار مستقبلي.

تتبُّع مرّات الظهور والنقرات

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

رموز الخطأ

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

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

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

رمز الخطأ	السبب
100	حدث خطأ في حزمة myTarget SDK.
101	معلَمات خادم myTarget التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
102	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع myTarget.
103	طلب الإعلان ليس طلب إعلان موحّد مدمج مع المحتوى.
104	يختلف الإعلان المدمج مع المحتوى الذي تم تحميله من myTarget عن الإعلان المدمج مع المحتوى المطلوب.
105	يفتقد الإعلان المدمج مع المحتوى الذي تم تحميله من myTarget إلى بعض مواد العرض المطلوبة (مثل الصورة أو الرمز).
100	لا يتوفّر أي إعلان في حزمة myTarget SDK حتى الآن.
101	معلَمات خادم myTarget التي تم ضبطها في واجهة المستخدم Ad Manager غير متوفّرة أو غير صالحة.
102	لا تتوافق myTarget Adapter مع شكل الإعلان المطلوب.
103	تمت محاولة عرض إعلان myTarget لم يتم تحميله.
104	لا يتطابق حجم الإعلان المطلوب مع حجم بانر متوافق مع myTarget.
105	مواد العرض المطلوبة للإعلانات المدمجة مع المحتوى غير متوفّرة.