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

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

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

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

يتضمّن وسيط التوسّط في ironSource Ads الإمكانات التالية:

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

¹ لا يتوافق هذا التنسيق إلا مع عملية الدمج المتسلسلة.

المتطلبات

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

• [لتقديم عروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم الإصدار 8.5.0.1 أو الإصدارات الأحدث من IronSource adapter (يُنصح باستخدام أحدث إصدار).

• أحدث GMA Next-Gen SDK

• أكمِل دليل البدء الخاص بالتوسّط.

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

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

إضافة تطبيق جديد

لإضافة تطبيق جديد، انتقِل إلى الإعلانات > التطبيقات وانقر على إضافة تطبيق.

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

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

إنشاء نسخة افتراضية

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

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

عروض الأسعار

املأ النموذج واختَر عروض الأسعار في قسم التسعير. انقر على حفظ وإغلاق.

ملاحظة: تفرض منصة ironSource Ads حدًا أقصى على عدد الحالات التي يمكنك إنشاؤها. إذا تلقّيت رسالة خطأ تفيد بأنّه لا يمكنك إنشاء المزيد من الوحدات، يُرجى التواصل مع فريق دعم ironSource Ads للحصول على المساعدة.

ملاحظة مهمة: إذا أردت إتاحة الإعلانات البينية مقابل مكافآت، اختَر تنسيق الفيديو مقابل مكافآت، واستخدِم معرّف الوحدة الإعلانية عند إضافة ironSource Ads كمصدر إعلاني في الخطوة 2. بالإضافة إلى ذلك، عليك التواصل مع فريق دعم ironSource Ads على [e-mail] لإعداد مثيلك من أجل إتاحة عرض "الإعلانات البينية مقابل مكافآت".

دوِّن رقم تعريف المثيل.

شلال

املأ النموذج وانقر على حفظ وإغلاق.

ملاحظة: تفرض منصة ironSource Ads حدًا أقصى على عدد الحالات التي يمكنك إنشاؤها. إذا تلقّيت رسالة خطأ تفيد بأنّه لا يمكنك إنشاء المزيد من الوحدات، يُرجى التواصل مع فريق دعم ironSource Ads للحصول على المساعدة.

ملاحظة مهمة: إذا أردت إتاحة الإعلانات البينية مقابل مكافآت، اختَر تنسيق الفيديو مقابل مكافآت، واستخدِم معرّف الوحدة الإعلانية عند إضافة ironSource Ads كمصدر إعلاني في الخطوة 2. بالإضافة إلى ذلك، عليك التواصل مع فريق دعم ironSource Ads على [e-mail] لإعداد مثيلك من أجل إتاحة عرض "الإعلانات البينية مقابل مكافآت".

دوِّن رقم تعريف المثيل.

تحديد موقع مفتاح Reporting API

عروض الأسعار

هذه الخطوة غير مطلوبة لعمليات دمج عروض الأسعار.

شلال

ملاحظة: يمكن فقط للمستخدمين الذين لديهم أذونات مساهم أو مشرف الوصول إلى مفاتيح واجهة برمجة التطبيقات.

انقر على علامة التبويب API في صفحة "حسابي"، ودوِّن المفتاح السري والرمز المميز لإعادة التحميل.

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

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

لتنفيذ app-ads.txt في ironSource، يُرجى الاطّلاع على المورّدون المعتمَدون في ironSource.

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

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

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

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

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

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

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

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

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

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

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

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

ملاحظة مهمة: يجب ربط مفتاح التطبيق بالتطبيق المستهدَف كما هو الحال في واجهة مستخدم "إعلانات ironSource".

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

ملاحظة: يستغرق جمع البيانات تلقائيًا بضعة أيام قبل أن يتمكّن من احتساب قيمة "التكلفة الديناميكية لكل ألف ظهور" بدقة لشبكة وسيطة. بعد احتساب التكلفة الفعلية لكل ألف ظهور، سيتم تعديلها تلقائيًا نيابةً عنك.

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

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

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

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

ملاحظة: قد يؤدي عدم دمج إصدارات متوافقة من حزمة تطوير البرامج (SDK) لكلّ من "إعلانات ironSource" و"إعلانات Google على الأجهزة الجوّالة" إلى حدوث مشاكل في الإصدار.

دمج Android Studio (يُنصح به)

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

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

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

Kotlin

dependencies {
    implementation("com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02")
    implementation("com.google.ads.mediation:ironsource:9.3.0.1")
}

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

Groovy

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:0.24.0-beta02'
    implementation 'com.google.ads.mediation:ironsource:9.3.0.1'
}

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

الدمج اليدوي

1. نزِّل أحدث إصدار من ironSource Ads Android SDK وأضِفه إلى مشروعك.

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

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

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

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

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

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

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

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

جافا

LevelPlay.setMetaData("do_not_sell", "true");
IronSourceMediationSnippets.java

Kotlin

LevelPlay.setMetaData("do_not_sell", "true")
IronSourceMediationSnippets.kt

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

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

تحميل الإعلان باستخدام سياق النشاط

مرِّر سياق Activity عند تحميل أشكال "إعلانات البانر" و"الإعلانات البينية" و"الإعلانات مقابل مكافأة". بدون سياق النشاط، سيتعذّر تحميل الإعلان.

قواعد Proguard

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

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

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

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

ملاحظة مهمة: عليك إيقاف وضع الاختبار في "إدارة الإعلانات" وironSource Ads قبل إصدار تطبيقك.

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

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

رموز الخطأ

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

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

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

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