الإعداد

تتيح لك الأحداث المخصّصة إضافة توسّط العرض الإعلاني بدون انقطاع لشبكة إعلانات غير شبكة إعلانية متوافقة. أنت هذا عن طريق تنفيذ محوّل حدث مخصّص لشبكة الإعلانات التي تريد التكامل.

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

قبل أن تتمكّن من إنشاء أحداث مخصّصة، يجب أولاً دمج أحد شكل الإعلان التالي في تطبيقك:

• بانر
• الإعلانات البينية
• مدمج مع المحتوى
• إعلان بمكافأة

إنشاء حدث مخصّص في واجهة المستخدم

يجب أولاً إنشاء حدث مخصّص في "مدير الإعلانات" واجهة مستخدم اطّلِع على التعليمات الواردة في إنشاء الأرباح وإدارتها المجموعات.

يجب تقديم ما يلي:

اسم الصف

الاسم المؤهّل بالكامل للفئة التي تنفّذ الحدث المخصّص محوّل — على سبيل المثال، SampleCustomEvent؛ أو إذا تم تنفيذ فئتك باستخدام Swift، MediationExample.SampleCustomEventSwift

يجب إدخال اسم الهدف إذا كانت لديك أهداف متعددة في مشروعك أو إذا اختلاف اسم المشروع عن اسم الهدف. باستخدام الاسم المستهدف، سيظهر بالشكل التالي: appName_targetName.className. بالإضافة إلى ذلك، تذكر لاستبدال أي أحرف غير أبجدية رقمية مثل الشرطات بشرطات سفلية. مثال:

التصنيف

اسم فريد يحدِّد مصدر الإعلان.

المعلمة

وسيطة سلسلة اختيارية يتم تمريره إلى محوّل الحدث المخصّص.

تنفيذ GADMediationAdapter

تتمثل الخطوة الأولى لإنشاء حدث مخصص في تنفيذ بروتوكول GADMediationAdapter كما هو موضّح في الفئة SampleCustomEvent في مثالنا.

وتقع على عاتق هذه الفئة مسئولية تلقي الرسائل من "مدير الإعلانات" وتفويض مسؤولية إنشاء شكل الإعلان الصحيح.

تهيئة المحوّل

عند إعداد حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" setUpWithConfiguration:completionHandler: يتم استدعاءها على جميع المحوّلات التابعة لجهات خارجية والأحداث المخصّصة التي تم ضبطها للتطبيق ضمن واجهة مستخدم "مدير الإعلانات" استخدِم هذه الطريقة إجراء أي عمليات إعداد أو ضبط ضرورية على حزمة تطوير البرامج (SDK) التابعة لجهة خارجية للحدث المخصّص

Swift

import GoogleMobileAds

class SampleCustomEvent: NSObject, GADMediationAdapter {

  static func setUpWith(
    _ configuration: GADMediationServerConfiguration,
    completionHandler: @escaping GADMediationAdapterSetUpCompletionBlock
  ) {
    // This is where you will initialize the SDK that this custom event is built
    // for. Upon finishing the SDK initialization, call the completion handler
    // with success.
    completionHandler(nil)
  }
}

Objective-C

#import "SampleCustomEvent.h"

@implementation SampleCustomEvent

+ (void)setUpWithConfiguration:(nonnull GADMediationServerConfiguration *)configuration
             completionHandler:(nonnull GADMediationAdapterSetUpCompletionBlock)completionHandler {
  // This is where you initialize the SDK that this custom event is built
  // for. Upon finishing the SDK initialization, call the completion handler
  // with success.
  completionHandler(nil);
}

أرقام إصدارات التقرير

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

Swift

static func adSDKVersion() -> GADVersionNumber {
  let versionComponents = String(SampleSDKVersion).components(
    separatedBy: ".")

  if versionComponents.count >= 3 {
    let majorVersion = Int(versionComponents[0]) ?? 0
    let minorVersion = Int(versionComponents[1]) ?? 0
    let patchVersion = Int(versionComponents[2]) ?? 0

    return GADVersionNumber(
      majorVersion: majorVersion, minorVersion: minorVersion, patchVersion: patchVersion)
  }

  return GADVersionNumber()
}

static func adapterVersion() -> GADVersionNumber {
  let versionComponents = String(SampleAdSDK.SampleAdSDKVersionNumber).components(
    separatedBy: ".")
  var version = GADVersionNumber()
  if versionComponents.count == 4 {
    version.majorVersion = Int(versionComponents[0]) ?? 0
    version.minorVersion = Int(versionComponents[1]) ?? 0
    version.patchVersion = Int(versionComponents[2]) * 100 + Int(versionComponents[3])
  }
  return version
}

Objective-C

+ (GADVersionNumber)adSDKVersion {
  NSArray *versionComponents =
      [SampleSDKVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count >= 3) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue];
  }
  return version;
}

+ (GADVersionNumber)adapterVersion {
  NSArray *versionComponents =
      [SampleCustomEventAdapterVersion componentsSeparatedByString:@"."];
  GADVersionNumber version = {0};
  if (versionComponents.count == 4) {
    version.majorVersion = [versionComponents[0] integerValue];
    version.minorVersion = [versionComponents[1] integerValue];
    version.patchVersion = [versionComponents[2] integerValue] * 100 +
                           [versionComponents[3] integerValue];
  }
  return version;
}

طلب إعلان

لطلب إعلان، راجِع التعليمات المتعلّقة بشكل الإعلان:

• بانر
• الإعلانات البينية
• مدمج مع المحتوى
• إعلان بمكافأة