IMA Open Measurement mit den nativen SDKs

In diesem Thema erfahren Sie, wie Sie das Open Measurement SDK mit den IMA-Plugins für die nativen SDKs von Brightcove verwenden können.

Überblick

Die Brightcove Native SDKs unterstützen jetzt die Verwendung der Messungs-SDK öffnen (OM-SDK). Das in Google IMA integrierte OM SDK ermöglicht Ihnen die Verwendung von Drittanbietertools zur Anzeigenmessung und -überprüfung.

Das Open Measurement SDK betrachtet alle Ansichten, die das Werbemittelelement überlagern, als Hindernisse und reduziert die Sichtbarkeit der Werbung. Videokontrollen können als "freundliche" Hindernisse angesehen werden, müssen jedoch beim OM SDK registriert werden, um von der Messung der Anzeigensichtbarkeit ausgeschlossen zu werden.

iOS

Das Brightcove Native SDK für iOS unterstützt die Verwendung des OM SDK. Weitere Informationen zur Implementierung der Anzeigenmessung durch Drittanbieter finden Sie im Messung im IMA SDK für iOS öffnen dokumentieren.

UI-Overlays

Wenn Sie UI-Steuerelemente verwenden, die die IMA-Anzeigenansicht überlagern, sollten Sie diese beim OM SDK registrieren. Einzelheiten finden Sie im Anzeigen-Overlays registrieren Abschnitt der Native SDK für iOS-Referenz.

IMA-Einstellungen

Standardmäßig legt das Brightcove Native SDK für iOS die playerType und playerVersion Eigenschaften mit folgenden Werten:

imaSettings.playerType = @"bcov/ios-sdk-player";
imaSettings.playerVersion = [BCOVIMAComponent versionIdentifier];

Möglicherweise möchten Sie diese Werte überschreiben. Ein Beispiel wäre, Werbemesswerte direkt von Google IMA zu melden. Um Ihre eigenen Werte zu verwenden, stellen Sie Folgendes auf dem imaSettings Objekt:

imaSettings.playerType = @"your-player-type";
imaSettings.playerVersion = @"your-player-version"

Codedetails zur Verwendung von IMA-Anzeigen mit dem Native SDK für iOS finden Sie im BasicIMAPlayer-Beispiel.

Android

Das Brightcove Native SDK für Android unterstützt die Verwendung des OM SDK. Weitere Informationen zur Implementierung der Anzeigenmessung durch Drittanbieter finden Sie im Messung im IMA SDK für Android öffnen dokumentieren.

UI-Overlays

Wenn Sie UI-Steuerelemente verwenden, die die IMA-Anzeigenansicht überlagern, sollten Sie diese beim OM SDK registrieren. Um dies zu tun, würde Ihr Code in etwa so aussehen:

public class MainActivity extends BrightcovePlayer {
 // ...
 private AdDisplayContainer adDisplayContainer;
 private View adOverlayView;
 // ...

 @Override
 protected void onCreate(Bundle savedInstanceState) {
   // ...
   adOverlayView = findViewById(R.id.ad_overlay);
   setupGoogleIMA();
   // ...
 }

 private void setupGoogleIMA() {
   // Show adOverlayView
   eventEmitter.on(EventType.AD_BREAK_STARTED, (event) ->  {
       adOverlayView.setVisibility(View.VISIBLE);
   });

   // Hide adOverlayView
   eventEmitter.on(EventType.AD_BREAK_COMPLETED, (event) ->  {
       adOverlayView.setVisibility(View.GONE);
   });

   // Create ImaSdkFactory
   final ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
   eventEmitter.on(GoogleIMAEventType.ADS_REQUEST_FOR_VIDEO, new EventListener() {
     @Override
     public void processEvent(Event event) {
       // Create a container object to register the friendly obstructions.
       adDisplayContainer = sdkFactory.createAdDisplayContainer();
       adDisplayContainer.registerVideoControlsOverlay(adOverlayView);
       // ...
     }
   });

   eventEmitter.on(EventType.COMPLETED, (event) -> {
     if (adDisplayContainer != null) {
       // Unregister the friendly obstructions
       adDisplayContainer.unregisterAllVideoControlsOverlays();
     }
   });
 }
}

IMA-Einstellungen

Standardmäßig legt das Brightcove Native SDK für iOS die playerType und playerVersion Eigenschaften mit folgenden Werten:

imaSdkSettings.setPlayerType("bcov/and-sdk-player");
imaSdkSettings.setPlayerVersion("<replaced with current sdk version>");

Möglicherweise möchten Sie diese Werte überschreiben. Ein Beispiel wäre, Werbemesswerte direkt von Google IMA zu melden. Um Ihre eigenen Werte zu verwenden, stellen Sie Folgendes auf dem imaSdkSettings Objekt:

ImaSdkSettings imaSdkSettings = imaSdkFactory.createImaSdkSettings();
imaSdkSettings.setPlayerType("your-player-type");
imaSdkSettings.setPlayerVersion("your-player-version");
GoogleIMAComponent googleIMAComponent = new GoogleIMAComponent(brightcoveVideoView, eventEmitter, imaSdkSettings);

Codedetails zur Verwendung von IMA-Anzeigen mit dem Native SDK für Android finden Sie im AdRulesIMASampleApp-Beispiel.