Zdarzenia niestandardowe pozwalają dodać zapośredniczenie kaskadowe dla sieci reklamowej, która nie jest obsługiwanej sieci reklamowej. Ty to poprzez wdrożenie adaptera zdarzenia niestandardowego dla sieci reklamowej, którą chcesz i integrację.
Wymagania wstępne
Zanim utworzysz zdarzenia niestandardowe, musisz zintegrować ten format reklamy do aplikacji:
Tworzenie zdarzenia niestandardowego w interfejsie
Zdarzenie niestandardowe należy najpierw utworzyć w usłudze Ad Manager Interfejs. Zapoznaj się z instrukcjami w sekcji Generowanie zysków i zarządzanie nimi grup.
Musisz dostarczyć:
- Nazwa zajęć
Pełna nazwa klasy, która implementuje zdarzenie niestandardowe np.
SampleCustomEvent
; lub jeśli klasa jest zaimplementowana w kodzie Swift,MediationExample.SampleCustomEventSwift
Nazwa miejsca docelowego jest wymagana, jeśli w projekcie masz wiele celów lub jeśli nazwa projektu jest inna niż nazwa miejsca docelowego. Dzięki nazwie elementu docelowego wygląda tak:
appName_targetName.className
. Pamiętaj też, , aby zastąpić wszystkie znaki niealfanumeryczne, na przykład łączniki z podkreśleniami. Przykład.- Etykieta
Unikalna nazwa określająca źródło reklam.
- Parametr
Opcjonalny argument w postaci ciągu przekazywany do adaptera zdarzeń niestandardowych.
Wdrażanie narzędzia GADMediationAdapter
Pierwszym krokiem do utworzenia zdarzenia niestandardowego jest zaimplementowanie tagu
Protokół GADMediationAdapter
pokazany przez klasę SampleCustomEvent
w naszym przykładzie.
Te zajęcia odpowiadają za otrzymywanie wiadomości od Ad Managera i przekazywać odpowiedzialność za tworzenie z prawidłowym formatem reklamy.
Zainicjuj adapter
Po uruchomieniu pakietu SDK do reklam mobilnych Google
setUpWithConfiguration:completionHandler:
jest wywoływana w przypadku wszystkich obsługiwanych adapterów innych firm i zdarzeń niestandardowych
dla aplikacji w interfejsie Ad Managera. Użyj tej metody, aby:
przeprowadź niezbędną konfigurację lub zainicjowanie wymaganego pakietu SDK innej firmy.
dla swojego zdarzenia niestandardowego.
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);
}
Numery wersji raportu
Wszystkie zdarzenia niestandardowe muszą raportować do pakietu SDK do reklam mobilnych Google zarówno wersję
samego adaptera zdarzeń niestandardowych oraz wersji pakietu SDK firmy zewnętrznej,
niestandardowych zdarzeń. Wersje są raportowane jako
GADVersionNumber
obiekty:
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;
}
Żądanie reklamy
Aby poprosić o reklamę, zapoznaj się z instrukcjami dotyczącymi danego formatu reklamy: