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

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

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

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

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

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

المتطلبات

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

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

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

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

لإضافة تطبيقك إلى لوحة بيانات ironSource، انقر على زر New App (تطبيق جديد).

إدخال تفاصيل التطبيق

اختَر تطبيق مباشر، وأدخِل Google Play عنوان URL لتطبيقك، ثم انقر على استيراد معلومات التطبيق.

إذا لم يكن تطبيقك متاحًا، اختَر التطبيق غير متاح في متجر التطبيقات وأدخِل اسمًا مؤقتًا لتطبيقك، ثم اختَر نظامك الأساسي.

املأ البيانات المتبقية في النموذج وانقر على إضافة تطبيق.

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

إنشاء مثيل

بعد ذلك، اضبط مثيل شبكة للتطبيق الذي أضفته.

انتقِل إلى الإعلانات > الإعداد > المثيلات. اختَر التطبيق وانقر على إنشاء مثيل.

أدخِل التفاصيل اللازمة، ثم انقر على حفظ وإغلاق.

بعد إنشاء المثيل، يتم إدراج رقم تعريف المثيل في حقل رقم تعريف المثيل.

تحديد موقع مفتاح واجهة برمجة التطبيقات Reporting API

بالإضافة إلى مفتاح التطبيق ورقم تعريف المثيل، ستحتاج أيضًا إلى المفتاح السري لإعلانات ironSource والرمز المميز لإعادة التحميل لإعداد Ad Manager رقم تعريف الوحدة الإعلانية.

انتقِل إلى حسابي في لوحة بيانات الناشر لإعلانات ironSource ثم انقر على علامة التبويب واجهة برمجة التطبيقات. دوِّن المفتاح السري والرمز المميز لإعادة التحميل.

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

اتّبِع التعليمات الواردة في دليل اختبار الدمج لإعلانات ironSource حول كيفية تفعيل الإعلانات التجريبية في ironSource.

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

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

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

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

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

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

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

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

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

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

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

إضافة 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. الاطّلاع على المستندات لمزيد من التفاصيل.