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

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

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

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

يتمتع Ad Manager محوّل التوسط الخاص بـ myTarget بالإمكانيات التالية:

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

المتطلّبات

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

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

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

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

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

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

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

إعلان بيني

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الدمج اليدوي

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

الخطوة 4: تنفيذ إعدادات الخصوصية في حزمة myTarget SDK

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

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

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

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

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

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

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

رموز الخطأ

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

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	لم يتم إدخال مواد عرض الإعلانات المدمجة مع المحتوى.