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

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

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

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

يوفّر Ad Manager محوِّل التوسط لـ ironSource الإمكانات التالية:

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

المتطلّبات

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

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

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

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

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

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

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

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

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

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

إنشاء مثيل

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

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

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

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

بالإضافة إلى APP KEY ورقم تعريف المثيل، ستحتاج أيضًا إلى المفتاح السري لـ 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 على مستوى التطبيق، أضِف تبعيات التنفيذ وإعداداته التالية. استخدِم أحدث إصدار من حزمة ironSource SDK والمحوّل:

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

الدمج اليدوي

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

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

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

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

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

Java

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

IronSource.setConsent(true);

Kotlin

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

IronSource.setConsent(true)

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

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

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

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

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 في صفحة الإعدادات المتقدّمة للتنظيم للحصول على مزيد من التفاصيل والقيم التي يمكن تقديمها من خلال الطريقة.

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

مراحل نشاط التطبيق

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

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 قواعد ProGuard إضافية لمشروعك. راجِع دليل دمج حزمة تطوير البرامج (SDK) لنظام التشغيل Android من IronSource للحصول على مزيد من المعلومات.

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

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

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

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

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

رموز الخطأ

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

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.
106	لم يتم إعداد حزمة تطوير برامج ironSource.
501-1056	أخطاء ironSource SDK يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.
101	مَعلمات خادم ironSource التي تم ضبطها في Ad Manager واجهة المستخدم غير متوفّرة/غير صالحة.
102	لا تتيح أداة ironSource Adapter استخدام شكل الإعلان المطلوب.
103	سبق أن تم تحميل إعلان ironSource لضبط إعدادات الشبكة هذه.
104	الحجم المطلوب لإعلان البانر غير متوافق مع ironSource.
508-1037	أخطاء ironSource SDK يمكنك الاطّلاع على المستندات لمزيد من التفاصيل.