Implementierung von Server-Side Ads mit den nativen SDKs

In diesem Thema erfahren Sie, wie Sie serverseitige Anzeigen mit den Brightcove Native Player-SDKs von Videos abspielen, die für die dynamische Bereitstellung aufgenommen wurden.

Überblick

Mit der serverseitigen Anzeigeneinfügung (SSAI) können Sie Anzeigen in Ihre Videos einbetten, sodass sie nicht von Werbeblockern im Browser blockiert werden können. Dynamic Delivery ist das Ingest- und Delivery-System der nächsten Generation, das Ihren Speicherbedarf reduziert und Medien dynamisch verpackt. Erfahren Sie mehr über die Verwendung Dynamische Lieferung für deine Videos.

SSAI arbeitet sowohl mit DRM- als auch mit Nicht-DRM-Inhalten.

Jedes Video, das Sie aus der Video Cloud abrufen, das mit Dynamic Delivery aufgenommen wurde, enthält die in der VMAP-Datei angegebenen Anzeigen in Ihre Anzeigenkonfiguration.

Serverseitige Anzeige
Serverseitige Anzeige

Führen Sie die folgenden Schritte aus, um serverseitige Anzeigen mit Ihren in Video Cloud gespeicherten Videoinhalten abzuspielen:

  1. Erstellen Sie eine Anzeigenkonfiguration

  2. Erstellen Sie Ihre App:

  3. Ein Video mit Werbung abspielen

Erstellen Sie eine Anzeigenkonfiguration

Die Anzeigenkonfiguration definiert verschiedene Aspekte der SSAI-Wiedergabe, einschließlich einer URL zu Ihrer Video Multiple Ad Playlist (VMAP)-Datei, Beacons und anderen Konfigurationen. Gehen Sie wie folgt vor, um eine Anzeigenkonfiguration zu erstellen:

  1. Erweitern Sie in Video Cloud Studio das ADMINISTRATOR Menü und wählen Sie Serverseitige Anzeigeneinstellungen.

    Anzeigenkonfigurationsadministrator
    Anzeigenkonfigurationsadministrator

  2. Fügen Sie Informationen für Ihre Anzeigenkonfiguration hinzu und wählen Sie Speichern.

    Anzeigeneinstellungen
    Anzeigeneinstellungen

Einzelheiten finden Sie im Serverseitige Anzeigeneinstellungen konfigurieren dokumentieren.

Informationen zum Erstellen einer Anzeigenkonfiguration mit der SSAI-API finden Sie im Video Cloud SSAI-Anzeigenkonfigurations-API dokumentieren.

Android-Implementierung

Befolgen Sie diese Schritte in Ihrer App, um Ihre Anzeigenkonfiguration abzurufen und Ihr Video abzuspielen:

  1. Öffnen Sie in Android Studio Ihr MainActivity.java Datei.
  2. Fügen Sie die folgenden Importanweisungen hinzu: 
    import com.brightcove.ssai.SSAIComponent;
import com.brightcove.player.network.HttpRequestConfig;
  3. Definieren Sie Konstanten für Ihre Konto-ID, Richtlinienschlüssel, Video-ID und Ihre Anzeigenkonfigurations-ID. 
    private String accountId = "your account id";
private String policyKey = "your policy key";
private String videoId = "your video id";
private String adConfigId = "your ad configuration id";
  4. Erstellen Sie eine Instanz des Katalogdienstes, der asynchrone Methoden zum Abrufen von Daten aus der Playback-API bereitstellt. Erstellen Sie eine Instanz der SSAI-Komponente. 
    Catalog catalog = new Catalog(eventEmitter, myAccountId, myPolicyKey);
SSAIComponent plugin = new SSAIComponent(appContext, getBrightcoveVideoView());
  5. Legen Sie die adConfigId als URL-Parameter fest. 
    HttpRequestConfig httpRequestConfig = new HttpRequestConfig.Builder()
  .addQueryParameter("ad_config_id", myAdConfig)
  .build();
  6. Rufen Sie den Katalogdienst an, um Ihr Video zusammen mit Ihrer Anzeigenkonfiguration von der Playback-API abzurufen. Starten Sie die Videowiedergabe mit Ihren angegebenen Anzeigen. 
    catalog.findVideoByID(myVideoId, httpRequestConfig, new VideoListener() {
    @Override
    public void onVideo(Video video) {

    // Process the Video
    plugin.processVideo(video);
  }
});

Bildunterschriften

Veranstaltungen

Einzelheiten zu Ereignissen im Zusammenhang mit der serverseitigen Anzeigeneinfügung finden Sie unter:

Suche ohne Werbung

Wenn Sie die Anzeigenwiedergabe deaktivieren möchten, während der Nutzer das Video durchsucht, lesen Sie die Suche ohne Werbung Code-Auszug.

Codebeispiel

Hier ist ein vollständiges Codebeispiel:

iOS-Implementierung

Befolgen Sie diese Schritte in Ihrer App, um Ihre Anzeigenkonfiguration abzurufen und Ihr Video abzuspielen:

  1. Öffne in Xcode dein ViewController.m Datei.
  2. Importieren Sie das SSAI-Plugin für iOS. 
    import BrightcoveSSAI
  3. Definieren Sie Konstanten für Ihre Konto-ID, Richtlinienschlüssel, Video-ID und Ihre Anzeigenkonfigurations-ID. 
    struct Constants {
  static let AccountID = "your account id"
  static let PlaybackServicePolicyKey = "your policy key"
  static let VideoId = "your video id"
  static let AdConfigId = "your ad configuration id"
}
  4. Definiere das BCOVPlaybackService -Klasse, die asynchrone Methoden zum Abrufen von Daten aus der Playback-API bereitstellt. 
    private lazy var playbackService: BCOVPlaybackService = {
  let factory = BCOVPlaybackServiceRequestFactory(accountId: Constants.AccountID, policyKey: Constants.PlaybackServicePolicyKey, baseURLStr: "https://edge.api.brightcove.com/playback/v1")
  return BCOVPlaybackService(requestFactory: factory)
}()
  5. Legen Sie den Abfrageparameterwert auf Ihre Anzeigenkonfigurations-ID fest. 
    let queryParameters = [kBCOVPlaybackServiceParamaterKeyAdConfigId: Constants.AdConfigId]

  6. Ruf die playbackService um Ihr Video zusammen mit Ihrer Anzeigenkonfiguration von der Playback API abzurufen. Starten Sie die Videowiedergabe mit Ihren angegebenen Anzeigen.

    playbackService.findVideo(withVideoID: Constants.VideoId, parameters: queryParameters) { [weak self] (video: BCOVVideo?, jsonResponse: [AnyHashable: Any]?, error: Error?) -> Void in

  guard let _video = video else {
    print("ViewController Debug - Error retrieving video: \(error?.localizedDescription ?? "unknown error")")
    return
  }

  self?.playbackController?.setVideos([_video] as NSFastEnumeration)
}

Veranstaltungen

Einzelheiten zu Ereignissen im Zusammenhang mit der serverseitigen Anzeigeneinfügung finden Sie unter:

Suche ohne Werbung

Wenn Sie die Anzeigenwiedergabe deaktivieren möchten, während der Nutzer das Video durchsucht, lesen Sie die Suche ohne Werbung Abschnitt der SDK-Referenz.

Codebeispiel

Hier ist ein vollständiges Codebeispiel:

Verwandte Themen

Weitere Einzelheiten finden Sie unter:

tvOS-Implementierung

Der Code zum Implementieren von SSAI mit dem Native SDK für tvOS ähnelt dem iOS-Implementierung Oben.

Veranstaltungen

Einzelheiten zu Ereignissen im Zusammenhang mit der serverseitigen Anzeigeneinfügung finden Sie unter:

Codebeispiel

Hier ist ein vollständiges Codebeispiel: