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

اختيار النظام الأساسي: Android (إصدار تجريبي) Android iOS Unity Flutter

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

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

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

المتطلبات

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

• أحدث إصدار من GMA Next-Gen SDK

• إكمال دليل البدء في التوسّط .

الخطوة 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 لـ "إدارة الإعلانات".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01")
    implementation("com.google.ads.mediation:mytarget:5.45.3.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.25.0-beta01'
    implementation 'com.google.ads.mediation:mytarget:5.45.3.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

التكامل اليدوي

• لتضمين حزمة myTarget SDK، يُرجى الرجوع إلى مستندات myTarget Android SDK myTarget.

• انتقِل إلى عناصر محوّل myTarget على مستودع Maven من Google. اختَر أحدث إصدار، ونزِّل ملف ‎ .aar الخاص بمحوّل myTarget، وأضِفه إلى مشروعك.

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

الموافقة بموجب "اللائحة العامة لحماية البيانات" والموافقة بموجب اللوائح التنظيمية الأوروبية

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

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

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

MyTargetPrivacy.setUserConsent(true);

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

MyTargetPrivacy.setUserConsent(true)

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

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

MyTargetPrivacy.setUserAgeRestricted(true);

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

MyTargetPrivacy.setUserAgeRestricted(true)

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

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

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

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

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

MyTargetPrivacy.setCcpaUserConsent(true);

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

MyTargetPrivacy.setCcpaUserConsent(true)

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

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

لا يلزم إضافة أي رمز برمجي إضافي لعملية التكامل مع myTarget.

الخطوة 6: اختبار عملية الإعداد

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

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

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

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

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

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

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

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

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

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

GMA Next-Gen SDK تستخدم معاودة الاتصال في حزمة myTarget SDK لتتبُّع مرّات الظهور و النقرات، لذا يجب أن تتطابق التقارير من كلا المصدرَين مع وجود اختلافات قليلة أو بدون أي اختلافات.

رموز الخطأ

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

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

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