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

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

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

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

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

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

المتطلبات

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

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

• أحدث GMA Next-Gen SDK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عليك إضافة ironSource Ads إلى إعدادات التوسّط الخاصة بوحدتك الإعلانية.

أولاً، سجِّل الدخول إلى حسابك على AdMob. بعد ذلك، انتقِل إلى علامة التبويب التوسّط. إذا كانت لديك مجموعة توسّط حالية تريد تعديلها، انقر على اسم مجموعة التوسّط هذه لتعديلها، ثم انتقِل إلى القسم إضافة "إعلانات ironSource" كمصدر إعلان.

لإنشاء مجموعة توسّط جديدة، انقر على إنشاء مجموعة توسّط.

أدخِل شكل الإعلان والمنصة، ثم انقر على متابعة.

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

اربط مجموعة التوسّط هذه بواحدة أو أكثر من وحداتك الإعلانية الحالية على AdMob. بعد ذلك، انقر على تم.

من المفترض أن تظهر الآن بطاقة الوحدات الإعلانية مملوءة بالوحدات الإعلانية التي اخترتها:

إضافة ironSource Ads كمصدر إعلان

عروض الأسعار

ضمن بطاقة عروض الأسعار في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان. بعد ذلك، انقر على ironSource Ads.

انقر على كيفية التوقيع على اتفاقية شراكة وإعداد شراكة مستندة إلى عروض الأسعار مع ironSource Ads.



انقر على الإقرار والموافقة، ثم انقر على متابعة.



إذا سبق لك ربط حسابك على ironSource Ads، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.



بعد ذلك، أدخِل مفتاح التطبيق ورقم تعريف المثيل الذي حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.

شلال

ضمن بطاقة العرض بدون انقطاع في قسم مصادر الإعلانات، انقر على إضافة مصدر إعلان.

اختَر ironSource Ads وفعِّل خيار التحسين. أدخِل المفتاح السري ورمز التحديث اللذين حصلت عليهما في القسم السابق لإعداد ميزة تحسين مصدر الإعلانات في ironSource Ads. بعد ذلك، أدخِل قيمة التكلفة الفعلية لكل ألف ظهور لـ ironSource Ads وانقر على متابعة.



إذا كان لديك ربط حالي لحسابك على ironSource Ads، يمكنك اختياره. بخلاف ذلك، انقر على إضافة عملية ربط.

بعد ذلك، أدخِل مفتاح التطبيق ورقم تعريف المثيل الذي حصلت عليهما في القسم السابق. بعد ذلك، انقر على تم.

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

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

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

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

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

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

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

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")
}

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

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

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

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

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

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

قواعد Proguard

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

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

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

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

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

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

رموز الخطأ

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

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

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