Penyiapan

Peristiwa kustom memungkinkan Anda menambahkan mediasi waterfall untuk jaringan iklan yang bukan jaringan iklan yang didukung. Anda dapat melakukannya dengan menerapkan adaptor peristiwa kustom untuk jaringan iklan yang ingin diintegrasikan.

Anda dapat menemukan contoh lengkap project peristiwa kustom di repo GitHub kami.

Prasyarat

Agar dapat membuat peristiwa kustom, Anda harus mengintegrasikan salah satu format iklan berikut ke dalam aplikasi Anda terlebih dahulu:

• Banner
• Interstisial
• Native
• Reward

Membuat peristiwa kustom di UI

Peristiwa kustom harus dibuat terlebih dahulu di UI AdMob. Lihat petunjuknya di Menambahkan peristiwa kustom.

Anda harus menyediakan hal berikut:

Nama Kelas

Nama class yang sepenuhnya memenuhi syarat yang mengimplementasikan adaptor peristiwa kustom—misalnya, SampleCustomEvent; atau jika class Anda diterapkan di Swift, MediationExample.SampleCustomEventSwift.

Nama target diperlukan jika Anda memiliki beberapa target di project atau jika nama project berbeda dengan nama target. Dengan nama target, akan terlihat seperti ini: appName_targetName.className. Selain itu, jangan lupa untuk mengganti karakter non-alfanumerik seperti tanda hubung dengan garis bawah. Contoh.

Label

Nama unik yang menentukan sumber iklan.

Parameter

Argumen string opsional yang diteruskan ke adaptor peristiwa kustom Anda.

Menerapkan GWSMediationAdapter

Langkah pertama untuk membuat peristiwa kustom adalah menerapkan protokol GADMediationAdapter seperti yang ditunjukkan oleh class SampleCustomEvent dalam contoh kami.

Class ini bertanggung jawab untuk menerima pesan dari AdMob dan mendelegasikan tanggung jawab untuk membuat format iklan yang benar.

Melakukan inisialisasi adaptor

Saat Google Mobile Ads SDK melakukan inisialisasi, setUpWithConfiguration:completionHandler: akan dipanggil di semua adaptor pihak ketiga dan peristiwa kustom yang didukung yang dikonfigurasi untuk aplikasi dalam AdMob UI. Gunakan metode ini untuk menjalankan penyiapan atau inisialisasi yang diperlukan pada SDK pihak ketiga yang diperlukan untuk peristiwa kustom Anda.

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

Laporkan nomor versi

Semua peristiwa kustom harus melaporkan ke Google Mobile Ads SDK versi adaptor peristiwa kustom itu sendiri dan versi SDK pihak ketiga yang berinteraksi dengan antarmuka peristiwa kustom. Versi dilaporkan sebagai GADVersionNumber objek :

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;
}

Minta iklan

Untuk meminta iklan, lihat petunjuk yang spesifik untuk format iklan:

• Banner
• Interstisial
• Native
• Reward