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

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

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

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

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

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

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

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

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

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

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

أحدث إصدار من Google Mobile Ads SDK (Legacy)
إعداد ميزة "توسّط AdMob"

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

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

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

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

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

إعلان بيني

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

تمت المكافأة

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

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

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

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

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

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

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

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

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

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

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

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

عليك إضافة myTarget إلى إعدادات التوسّط لوحدتك الإعلانية.

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

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

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

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

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية معبأة بالوحدات الإعلانية التي اخترتها:

إضافة myTarget كمصدر إعلان

ضمن بطاقة العرض الإعلاني بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

اختَر myTarget وفعِّل مفتاح التبديل تحسين. أدخِل رمز الدخول الدائم الذي حصلت عليه في القسم السابق لإعداد ميزة "تحسين مصدر الإعلان" لشبكة myTarget. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لشبكة myTarget وانقر على متابعة.

إذا كان لديك تعيين في myTarget، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.

بعد ذلك، أدخِل معرّف الخانة الذي حصلت عليه في القسم السابق. بعد ذلك، انقر على تم.

ملاحظة: يستغرق تحسين مصدر الإعلان بضعة أيام لجمع بيانات كافية من أجل احتساب التكلفة الفعلية لكل ألف ظهور بدقة لشبكة التوسط. في هذه الأثناء، تكون حالة تحسين مصدر الإعلان هي PENDING، لذا عليك ضبط قيمة التكلفة الفعلية لكل ألف ظهور يدويًا للشبكة. بعد احتساب التكلفة الفعلية لكل ألف ظهور، يبدأ مصدر الإعلان تلقائيًا بتعديل التكلفة الفعلية لكل ألف ظهور نيابةً عنك.

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

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

الخطوة 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: اختبار عملية التنفيذ

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

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