إعداد التوسّط

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

يوضّح لك هذا الدليل كيفية دمج محوّل توسّط مع تطبيقك على iOS.

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

قبل أن تتمكّن من دمج التوسّط لشكل إعلان، عليك دمج شكل الإعلان هذا في تطبيقك:

هل أنت مستخدم جديد للتوسّط؟ يمكنك قراءة مقدّمة عن التوسّط.

بالنسبة إلى عروض الأسعار: Google Mobile Ads SDK 7.53.1 أو إصدار أحدث.

إعداد Google Mobile Ads SDK

يوضّح لك دليل البدء السريع كيفية إعداد Google Mobile Ads SDK. أثناء طلب الإعداد هذا، يتم أيضًا إعداد محوّلات التوسّط. من المهم الانتظار إلى حين اكتمال الإعداد قبل تحميل الإعلانات للتحقّق من المشاركة الكاملة من كل شبكة إعلانات في طلب عرض الإعلان الأول.

يوضّح نموذج الرمز البرمجي التالي كيفية التحقّق من حالة إعداد كل محوّل قبل تقديم طلب عرض إعلان.

Swift

MobileAds.shared.start { initializationStatus in
  // Check each adapter's initialization status.
  for (adapterName, status) in initializationStatus.adapterStatusesByClassName {
    print(
      "Adapter: \(adapterName), Description: \(status.description), Latency: \(status.latency)")
  }
}

Objective-C

[[GADMobileAds sharedInstance]
    startWithCompletionHandler:^(GADInitializationStatus *_Nonnull status) {
      // Check each adapter's initialization status.
      NSDictionary<NSString *, GADAdapterStatus *> *adapterStatuses =
          status.adapterStatusesByClassName;
      for (NSString *adapterName in adapterStatuses) {
        GADAdapterStatus *adapterStatus = adapterStatuses[adapterName];
        NSLog(@"Adapter: %@, Description: %@, Latency: %f", adapterName,
              adapterStatus.description, adapterStatus.latency);
      }
    }];

معرفة الشبكة الإعلانية التي تفوز

يحتوي كل صف من صفوف أشكال الإعلانات على السمة GADResponseInfo التي تحتوي على adNetworkClassName التي تعرض اسم صف الشبكة الإعلانية للإعلان الحالي. لا تتضمّن adNetworkClassName قيمة إلا بعد تحميل إعلان بنجاح. يوضّح لك الرمز البرمجي التالي كيفية الحصول على هذه المعلومات لإعلانات البانر.

Swift

print(
  "Adapter class name: \(ad.responseInfo?.loadedAdNetworkResponseInfo?.adNetworkClassName ?? "Unknown")"
)

Objective-C

NSLog(@"Adapter class name: %@",
      ad.responseInfo.loadedAdNetworkResponseInfo.adNetworkClassName ?: @"Unknown");

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

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

استخدام الإعلانات المدمجة مع المحتوى مع التوسّط

في ما يلي بعض أفضل الممارسات التي يجب أخذها في الاعتبار عند تنفيذ التوسّط للإعلانات المدمجة مع المحتوى.

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

قوانين الخصوصية في الولايات الأمريكية واللائحة العامة لحماية البيانات (GDPR)

إذا كنت بحاجة إلى الامتثال لقوانين الخصوصية في الولايات الأمريكية أو اللائحة العامة لحماية البيانات (GDPR)، اتّبِع الخطوات الواردة في إعدادات اللوائح التنظيمية في الولايات الأمريكية أو إعدادات اللائحة العامة لحماية البيانات (GDPR) لإضافة شركاء التوسّط في قائمة شركاء الإعلانات في الولايات الأمريكية أو قائمة شركاء الإعلانات في اللائحة العامة لحماية البيانات (GDPR) ضمن الخصوصية والمراسلة في Ad Manager. قد يؤدي عدم اتّباع هذه الخطوات إلى عدم تمكُّن الشركاء من عرض الإعلانات على تطبيقك.

مزيد من المعلومات عن تفعيل وضع المعالجة المحدودة للبيانات (RDP) والحصول على الموافقة بموجب اللائحة العامة لحماية البيانات (GDPR) باستخدام حزمة Google User Messaging Platform (UMP) SDK.

التالي
اختيار مصادر الإعلانات