حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" في وضع الصيانة للحصول على آخر التحديثات والميزات، عليك migrate وإعداد "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".

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

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

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

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

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

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

مستوى واجهة برمجة التطبيقات لنظام التشغيل Android 24 أو الإصدارات الأحدث

أحدث إصدار من Google Mobile Ads SDK (Legacy)
إعداد التوسّط

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

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

بعد ذلك، أدخِل عنوان URL لتطبيقك على Google Play.

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

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

إعلان بيني

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

تمت المكافأة

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

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

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

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

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

تعديل ملف app-ads.txt

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

لتنفيذ app-ads.txt لشبكة myTarget، يُرجى الاطّلاع على مقالة كيفية إنشاء ملف ونشره.

تفعيل "الوضع التجريبي"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

في ملف gradle على مستوى التطبيق، أضِف تبعيات التنفيذ التالية:

Kotlin

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

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:mytarget:5.52.5.0'
}

الدمج اليدوي

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

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

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

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

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

جافا

MyTargetPrivacy.setUserConsent(true);MyTargetMediationSnippets.java

Kotlin

MyTargetPrivacy.setUserConsent(true)MyTargetMediationSnippets.kt

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

جافا

MyTargetPrivacy.setUserAgeRestricted(true);MyTargetMediationSnippets.java

Kotlin

MyTargetPrivacy.setUserAgeRestricted(true)MyTargetMediationSnippets.kt

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

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

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

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

جافا

MyTargetPrivacy.setCcpaUserConsent(true);MyTargetMediationSnippets.java

Kotlin

MyTargetPrivacy.setCcpaUserConsent(true)MyTargetMediationSnippets.kt

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

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

لا يلزم استخدام رمز إضافي لدمج myTarget.

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

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

تأكَّد من تسجيل جهازك الاختباري في "إدارة الإعلانات" وتفعيل وضع الاختبار في واجهة مستخدم myTarget.

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

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

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

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

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

يعرض محوّل myTarget "الإعلانات المدمجة مع المحتوى" كعناصر NativeAd. يتم ملء الحقول التالية لـ NativeAd.

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

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

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

يستخدم "Google Mobile Ads SDK (Legacy)" عمليات الاستدعاء في حزمة تطوير البرامج (SDK) الخاصة بـ myTarget لتتبُّع مرّات الظهور والنقرات، لذا يجب أن تتطابق التقارير من كلا المصدرَين مع وجود اختلافات قليلة أو عدم وجودها.

رموز الخطأ

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

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

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

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