دمج BidMachine مع "التوسّط"

اختيار النظام الأساسي: Android iOS Unity Flutter Android (قديم)

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

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

يوفّر محوّل التوسّط في BidMachine الإمكانات التالية:

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

1 يتوفّر دمج العرض الانحداري لطلبات الشبكة في إصدار تجريبي مغلق. يُرجى التواصل مع مدير حسابك لطلب الوصول إليه.

المتطلبات الأساسية

قبل المتابعة، يُرجى التحقّق مما يلي:

  • المستوى 24 من واجهة برمجة التطبيقات Android أو الإصدارات الأحدث
  • [لعروض الأسعار]: لدمج جميع أشكال الإعلانات المتوافقة في عروض الأسعار، استخدِم محوِّل BidMachine‏ 3.4.0.1 أو إصدارًا أحدث (يُنصح باستخدام أحدث إصدار).

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

سجِّل الدخول إلى لوحة بيانات حسابك على BidMachine.

إنشاء مواضع إعلانات جديدة

انتقِل إلى علامة التبويب المصدر، ثم انقر على الزر تعديل ضمن جدول المصادر.

لوحة بيانات المصادر

ستظهر لك قائمة بجميع مواضع الإعلانات التي لديك. لإنشاء موضع إعلان جديد، انقر على الزر إضافة موضع إعلان في مربّع الحوار.

مربّع حوار "تعديل المصدر"

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

إنشاء موضع إعلان

أخيرًا، دوِّن رقم تعريف موضع الإعلان.

تفاصيل الموضع

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

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

لتنفيذ app-ads.txt في BidMachine، انتقِل إلى علامة التبويب app-ads.txt من لوحة البيانات. بعد ذلك، انسخ القائمة وأضِفها إلى ملف app-ads.txt الخاص بموقعك الإلكتروني.

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

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

إضافة BidMachine في "الشركات"

عروض الأسعار

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

شلال

انتقِل إلى المشرف > الشركات، ثم انقر على الزر شركة جديدة في علامة التبويب جميع الشركات. اختَر شبكة الإعلانات.

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

ليس عليك إدخال اسم مستخدم أو كلمة مرور. انقر على حفظ عند الانتهاء.

تفعيل ميزة "مشاركة الإشارات الآمنة"

عروض الأسعار

انتقِل إلى المشرف > الإعدادات العامة. انتقِل إلى علامة التبويب إعدادات حساب Ad Exchange وراجِع مشاركة الإشارات الآمنة وفعِّلها. انقر على حفظ.

شلال

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

مشاركة الإشارة الآمنة في طلبات عروض الأسعار

عروض الأسعار

انتقِل إلى المساحات الإعلانية المتاحة > الإشارات الآمنة. ضمن الإشارات الآمنة، ابحث عن BidMachine وفعِّل تفعيل الدمج على التطبيق.

انقر على حفظ.

شلال

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

السماح بمشاركة الإشارات الآمنة في عروض أسعار SDK

عروض الأسعار

انتقِل إلى عرض الإعلانات > إعدادات قنوات طلبات الإعلانات. في علامة التبويب الإعدادات التلقائية، فعِّل الخيار السماح بمشاركة الإشارات الآمنة من أجل عروض أسعار حزمة تطوير البرامج (SDK).

انقر على حفظ.

شلال

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

ضبط عروض أسعار BidMachine

عروض الأسعار

انتقِل إلى عرض الإعلانات > أنظمة عروض الأسعار، وانقر على الانتقال إلى ميزة "عروض أسعار باستخدام حِزم تطوير البرامج (SDK)".

انقر على مزايد جديد.

اختَر BidMachine كمقدّم عرض الأسعار.

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

انقر على تم.

شلال

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

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

عروض الأسعار

انتقِل إلى عرض الإعلانات > مقدّمو عروض الأسعار، وانقر على الانتقال إلى عروض أسعار باستخدام حِزم تطوير البرامج (SDK).

اختَر الشركة التي تريد استخدام BidMachine معها.

انتقِل إلى علامة التبويب تعيين الوحدات الإعلانية وانقر على تعيين وحدة إعلانية جديدة.

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

وأخيرًا، انقر على حفظ.

شلال

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

انتقِل إلى شركاء الأرباح وانقر على إضافة شريك توسّط.

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

أدخِل معرّف موضع الإعلان الذي حصلت عليه في القسم السابق، وقيمة التكلفة التلقائية لكل ألف ظهور. انقر على حفظ.

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

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

الخطوة 3: استيراد حزمة تطوير البرامج (SDK) ومحوِّل BidMachine

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

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifactory.bidmachine.io/bidmachine")
    }
  }
}

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

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:bidmachine:3.8.0.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:bidmachine:3.8.0.1'
}

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

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

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

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

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

تقرأ BidMachine تلقائيًا موافقة GPP التي تم ضبطها من خلال منصات إدارة الموافقة، بما في ذلك حزمة تطوير البرامج لمنصة UMP. لمزيد من المعلومات، يُرجى الاطّلاع على GPP.

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

لا يلزم استخدام أي رمز إضافي لدمج BidMachine.

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

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

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

اتّبِع التعليمات الواردة في مستندات BidMachine لنظام التشغيل Android من أجل تفعيل وضع الاختبار في BidMachine.

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

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

خطوات اختيارية

إعلانات مدمجة مع المحتوى

عرض الإعلانات

تعرض أداة BidMachine الإعلانات المدمجة مع المحتوى على شكل عناصر NativeAd. يتم ملء الحقول التالية لـ NativeAd.

الحقل مواد العرض التي يتم تضمينها دائمًا من خلال أداة BidMachine
العنوان
صورة
النص
رمز
الحث على اتخاذ إجراء
التقييم بالنجوم
المتجر
السعر
المعلِن

رموز الخطأ

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

io.bidmachine
com.google.ads.mediation.bidmachine

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

رمز الخطأ النطاق السبب
100 com.google.ads.mediation.bidmachine تم تلقّي معرّف موضع إعلان غير صالح أو فارغ.
101 com.google.ads.mediation.bidmachine حدث خطأ أثناء جمع الإشارات: لم يتم العثور على إعدادات بيانات الإشارات.
102 com.google.ads.mediation.bidmachine تم تلقّي شكل إعلان غير صالح أثناء جمع الإشارات.
103 com.google.ads.mediation.bidmachine تعذّر ربط حجم الإعلان المطلوب بـ bidmachine.BannerSize
104 com.google.ads.mediation.bidmachine انتهت صلاحية طلب عرض الإعلان الذي تم تحميله من BidMachine.
105 com.google.ads.mediation.bidmachine تعذّر عرض الإعلان بملء الشاشة.
106 com.google.ads.mediation.bidmachine عرضت حزمة تطوير البرامج (SDK) لـ BidMachine استدعاء onAdLoaded() مع بيانات إعلان null.

سجلّ تغييرات محوّل التوسّط في Android من BidMachine

الإصدار 3.8.0.1

  • ثبِّت تبعية Kotlin للمحوّل على الإصدار 1.9.0 (الحد الأدنى لإصدار Kotlin المتوافق مع الجيل التالي من حزمة SDK لإعلانات Google على الأجهزة الجوّالة).

تم التصميم والاختبار باستخدام:

  • الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.8.0 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.8.0.0

  • تم التحقّق من التوافق مع الإصدار 3.8.0 من حزمة تطوير البرامج (SDK) لمنصة BidMachine.

تم التصميم والاختبار باستخدام:

  • الإصدار 25.4.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.4.0 من "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.8.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة BidMachine

الإصدار 3.7.1.1

  • يتم الربط بين AgeRestrictedTreatment وواجهة برمجة التطبيقات الخاصة بقانون حماية خصوصية الأطفال على الإنترنت (COPPA) في BidMachine.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 25.4.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 1.2.1 من الجيل التالي من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.7.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة BidMachine

الإصدار 3.7.0.0

  • تم التأكّد من التوافق مع الإصدار 3.7.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة BidMachine.

تم التصميم والاختبار باستخدام:

  • الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 1.1.0 من الجيل التالي من حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 3.7.0 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.6.1.0

  • تمت إضافة سمة لإنشاء المحوّل مع مصدر الاعتمادية الخاص بـ "الجيل التالي من SDK لإعلانات Google على الأجهزة الجوّالة".
  • تم إثبات التوافق مع الإصدار 3.6.1 من حزمة تطوير البرامج (SDK) الخاصة بمنصة BidMachine.

تم التصميم والاختبار باستخدام:

  • الإصدار 25.1.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.6.1 من حزمة تطوير البرامج (SDK) لمنصة BidMachine

الإصدار 3.5.1.2

  • تم تعديل BidMachine Adapter لاستخدام AdPlacementConfig.

تم التصميم والاختبار باستخدام:

  • الإصدار 24.9.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 3.5.1 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.5.1.1

  • تمت إضافة إمكانية إعادة توجيه مَعلمة tagForUnderAgeOfConsent في حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" إلى حزمة SDK لمنصة BidMachine.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 24.9.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 3.5.1 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.5.1.0

  • تم التحقّق من التوافق مع الإصدار 3.5.1 من حزمة تطوير البرامج (SDK) لمنصة BidMachine.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 24.9.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 3.5.1 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.5.0.0

  • تم التأكّد من التوافق مع الإصدار 3.5.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة BidMachine.

تم التصميم والاختبار باستخدام:

  • الإصدار 24.7.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 3.5.0 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.4.0.1

  • تمت إزالة المراجع على مستوى الفئة إلى عناصر Context للمساعدة في حلّ مشاكل تسرُّب الذاكرة.
  • تم تعديل المحوّل ليتيح طلبات عرض "إعلانات البانر" القريبة من حجم أشكال الإعلانات المتوافقة، بدلاً من طلب مطابقة الحجم بدقة.

تم التصميم والاختبار باستخدام:

  • الإصدار 24.7.0 من SDK لإعلانات Google على الأجهزة الجوّالة
  • الإصدار 3.4.0 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.4.0.0

  • تمّت إضافة إمكانية العرض بدون انقطاع لأشكال الإعلانات التالية: إعلانات البانر والإعلانات البينية والإعلانات التي تضم مكافأة والإعلانات المدمجة مع المحتوى.
  • يعيد المحوّل الآن توجيه onAdOpened() مع onAdImpression() للإعلانات بملء الشاشة.
  • تم التحقّق من التوافق مع الإصدار 3.4.0 من حزمة SDK لمنصة BidMachine.

تم إنشاؤه واختباره باستخدام:

  • الإصدار 24.6.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • الإصدار 3.4.0 من حزمة تطوير البرامج (SDK) لـ BidMachine

الإصدار 3.3.0.0

  • الإصدار الأوّلي

تم التصميم والاختبار باستخدام:

  • الإصدار 24.5.0 من حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"
  • إصدار 3.3.0 من حزمة تطوير البرامج (SDK) الخاصة بمنصة BidMachine