Jeśli masz pakiet SDK dostawcy sygnałów, który generuje sygnały określania stawek w czasie rzeczywistym (RTB), możesz utworzyć adapter bezpiecznych sygnałów, aby umożliwić usłudze Google Mobile Ads SDK zbieranie sygnałów z Twojego pakietu SDK.
Google Mobile Ads SDK przekazuje Twoje sygnały wybranym kupującym korzystającym z Authorized Buyers i Otwartego ustalania stawek.
Diagram poniżej przedstawia cykl życia żądania i odpowiedzi w przypadku zbierania bezpiecznych sygnałów:
Adapter bezpiecznych sygnałów odpowiada za inicjowanie adaptera i zbieranie sygnałów.
Implementowanie adaptera bezpiecznych sygnałów
Zaimplementuj adapter bezpiecznych sygnałów dla: Google Mobile Ads SDK, aby zbierać sygnały z pakietu SDK.
Z tego przewodnika dowiesz się, jak wdrożyć adapter bezpiecznych sygnałów przez implementację protokołu GADRTBAdapter.
Ten przykład implementuje protokół GADRTBAdapter:
Objective-C
@interface SampleAdapterSnippets : NSObject <GADRTBAdapter>
@end
Inicjowanie adaptera
Google Mobile Ads SDK wywołuje metodę setUpWithConfiguration:completionHandler:, gdy Google Mobile Ads SDK tworzy instancję adaptera bezpiecznych sygnałów. Użyj tej metody, aby zainicjować pakiet SDK.
Gdy pakiet SDK zostanie w pełni zainicjowany i będzie gotowy do zbierania sygnałów przez Google Mobile Ads SDK, wywołaj blok ukończenia GADMediationAdapterSetUpCompletionBlock.
Jeśli adapter bezpiecznych sygnałów nie wywoła funkcji zwrotnej, Google Mobile Ads SDK nie będzie zbierać sygnałów z tego adaptera.
W tym przykładzie wywoływany jest moduł obsługi zakończenia, który informuje Google Mobile Ads SDK, że pakiet SDK został zainicjowany:
Objective-C
+ (void)setUpWithConfiguration:(GADMediationServerConfiguration *)configuration
completionHandler:(GADMediationAdapterSetUpCompletionBlock)completionHandler {
// Add your SDK initialization logic here.
// Invoke the completionHandler once initialization completes. Pass a nil
// error to indicate initialization succeeded.
completionHandler(nil);
}
Zgłaszanie wersji adaptera i pakietu SDK
Adapter bezpiecznych sygnałów musi podawać zarówno wersję adaptera, jak i wersję pakietu SDK. Google Mobile Ads SDK używa tych wersji do raportowania i rozwiązywania problemów.
Jeśli pakiet SDK implementuje ten adapter w tym samym pliku binarnym, możesz zwrócić tę samą wersję zarówno dla adaptera, jak i pakietu SDK.
Ten przykład zwraca wersję adaptera bezpiecznych sygnałów:
Objective-C
+ (GADVersionNumber)adapterVersion {
// If your secure signals SDK implements this adapter in the same binary
// return the same version as your SDK.
// return [self adSDKVersion];
// If you built a separate binary for this secure signals adapter, return
// the adapter's version here.
GADVersionNumber version = {};
version.majorVersion = 4;
version.minorVersion = 5;
version.patchVersion = 6;
return version;
}
Ten przykład zwraca wersję pakietu SDK, z którą współpracuje adapter bezpiecznych sygnałów:
Objective-C
Zastąp kSDKVersionString ciągiem znaków wersji pakietu SDK.
Zbieranie sygnałów
Przy każdym żądaniu reklamy Google Mobile Ads SDK zbiera sygnały jednocześnie ze wszystkich adapterów w wątku w tle.
W tym przykładzie sygnały są zbierane i zwracane do Google Mobile Ads SDK przez wywołanie modułu obsługi zakończenia GADRTBSignalCompletionHandler:
Objective-C
Zastąp kSampleSignalPlaceholder ciągiem znaków bezpiecznego sygnału.
Zbieranie sygnałów musi zakończyć się w ciągu 1 sekundy. Jeśli zbieranie sygnałów trwa dłużej niż sekundę, rozważ zapisanie sygnałów w pamięci podręcznej w adapterze bezpiecznych sygnałów lub w pakiecie SDK podczas inicjowania adaptera.
Jeśli adapter bezpiecznych sygnałów nie może zebrać sygnałów,
wywołaj moduł obsługi zakończenia z sygnałami nil i obiektem NSError.
Zasłanianie sygnałów
Gdy udostępniasz bezpieczne sygnały licytującym i partnerom wyboru, musisz je zaciemnić.
Zwracanie wartości nil w przypadku dodatkowych informacji wysyłanych z żądaniem reklamy
Adaptery bezpiecznych sygnałów nie wymagają dodatkowych parametrów sieci.
W tym przykładzie metoda +networkExtrasClass zwraca wartość nil:
Objective-C
+ (nullable Class<GADAdNetworkExtras>)networkExtrasClass {
// Network extras are not applicable because signal providers do not request ads.
return nil;
}