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

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

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

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

يحتوي Ad Manager محوّل التوسّط لإعلانات ironSource على الإمكانات التالية:

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

المتطلبات

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

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

الخطوة 1: إعداد الإعدادات في واجهة مستخدم ironSource Ads

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

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

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

الخطوة 3: استيراد المحوّل وحزمة تطوير البرامج (SDK) الخاصة بإعلانات ironSource

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

في ملف settings.gradle.kts على مستوى المشروع، أضِف ما يلي: المستودعات:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://android-sdk.is.com/")
    }
  }
}

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

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

الدمج اليدوي

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

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

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

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

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

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setConsent(true);

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setConsent(true)

اطّلِع على مستندات ironSource Ads على الإعدادات المتقدِّمة للتنظيم لمزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

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

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

Java

import com.ironsource.mediationsdk.IronSource;
// ...

IronSource.setMetaData("do_not_sell", "true");

Kotlin

import com.ironsource.mediationsdk.IronSource
// ...

IronSource.setMetaData("do_not_sell", "true")

اطّلِع على مستندات ironSource Ads بشأن Regulation Advanced الإعدادات لمزيد من التفاصيل والقيم التي يمكن تقديمها في الطريقة.

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

دورة حياة التطبيق

إلغاء الطريقتين onPause() وonResume() في كل نشاط من أنشطتك من أجل لاستدعاء طرق ironSource Ads المقابلة على النحو التالي:

Java

@Override
public void onResume() {
    super.onResume();
    IronSource.onResume(this);
}

@Override
public void onPause() {
    super.onPause();
    IronSource.onPause(this);
}

Kotlin

public override fun onResume() {
    super.onResume()
    IronSource.onResume(this)
}

public override fun onPause() {
    super.onPause()
    IronSource.onPause(this)
}

قواعد Proguard

إذا كنت تقليص حجم تطبيقك وتشويشه وتحسينه ، تتطلب ironSource Ads قواعد ProGuard إضافية لمشروعك. استشارة دليل دمج حزمة تطوير البرامج (SDK) لنظام التشغيل Android في ironSource Ads لمزيد من المعلومات.

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

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

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

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

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

رموز الخطأ

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

com.google.ads.mediation.ironsource.IronSourceAdapter
com.google.ads.mediation.ironsource.IronSourceRewardedAdapter

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

رمز الخطأ	السبب
101	معلمات خادم إعلانات ironSource المهيأة في Ad Manager واجهة المستخدم غير متوفّرة أو غير صالحة.
102	تتطلب إعلانات ironSource سياقًا للنشاط لإعداد حزمة SDK الخاصة بها.
103	يمكن لإعلانات ironSource تحميل إعلان واحد فقط لكل رقم تعريف لمثيل إعلانات ironSource.
105	الحجم المطلوب لإعلان البانر غير متوافق مع ironSource Ads.
106	لم يتم إعداد حزمة تطوير البرامج (SDK) لإعلانات ironSource.
501-1056	أخطاء SDK لإعلانات ironSource. الاطّلاع على المستندات لمزيد من التفاصيل.