Senden von Brightcove Analytics vom nativen SDK für iOS

In diesem Thema erfahren Sie, wie Sie mithilfe des Brightcove-SDK für iOS Eigenschaften in Brightcove Analytics von Ihrer mobilen App aus festlegen.

Analytics-Integration

Wenn Sie den Brightcove-Player verwenden und catalog die im SDK enthalten sind, um Videos abzurufen und abzuspielen, werden automatisch Analysedaten gesammelt und im Video Cloud Analytics-Modul angezeigt.

Wenn Sie den BCOVVideo Kurs überschreiben oder den Brightcove Player nicht verwenden catalog, müssen Sie Ihre Konto-ID an Video Cloud Analytics senden.

Eigenschaften anpassen

Ab Version 4.1.8 des Brightcove Mobile SDK für iOS können Sie benutzerdefinierte Werte für Konto-ID, Ziel-URI und Quell-URI von Ihrer App an Brightcove Analytics senden.

Ihre Konto-ID ist erforderlich, wird jedoch automatisch festgelegt, wenn Sie den Brightcove-Player und die catalog.

Sie können die Ziel- und Quell-URIs nach Belieben festlegen. Die Standardwerte basieren auf dem Namen des Anwendungspakets.

Diese Eigenschaften können in Ihrem ViewController Implementierungsdatei. Dies geschieht in der Regel nach dem Aufruf zum Erstellen der PlaybackController:

id<BCOVPlaybackController> controller =
    [[BCOVPlayerSDKManager sharedManager] createPlaybackController];

controller.analytics.account = your accountId;
controller.analytics.destination = valid URI;
controller.analytics.source = valid URI;

Konto

Verwenden Sie die account -Eigenschaft, um den Wert für die Konto-ID in Brightcove Analytics festzulegen. Diese Eigenschaft ist nur in Fällen nützlich, in denen die Metadaten des Videos keinen accountId Wert enthalten (z. B. wenn Ihre App eine Mischung aus Video Cloud-Videos verwendet, die die accountId Eigenschaft enthalten, und Nicht-Video Cloud-Videos, die die accountId Eigenschaft nicht enthalten).

controller.analytics.account = @"your accountId";

Wenn du die Kontoeigenschaft festlegst, wird der Wert dieser Eigenschaft für alle deine Videos verwendet, die noch nicht über eine accountId Eigentum. Der nützlichste Wert für diese Eigenschaft ist Ihre eigene Konto-ID. Diese Videos werden im Analytics-Modul gemeldet als Andere/Dritte da Brightcove Analytics derzeit keine detaillierte Berichterstellung für Videos unterstützt, die nicht über den Brightcove-Katalogdienst abgerufen werden.

Bei Video Cloud-Videos hat das Festlegen dieser Kontoüberschreibung keine Auswirkung auf die Berichterstellung, da das Video accountId Metadatenwert bleibt unverändert. Dieser Wert kann nicht durch Festlegen dieses Kontowerts überschrieben werden.

Ziel

Verwenden Sie die destination -Eigenschaft, um den Wert des Standorts festzulegen, von dem das Ereignis ausgeht. Der Wert der Zieleigenschaft MUSS das richtige URI-Format aufweisen, ähnlich wie in diesem Beispiel:

bcsdk://com.mhogben.source

Der Standardwert der Zieleigenschaft ist bcsdk:// gefolgt von der Bundle-ID der App, wie in der App aufgeführt info.plist Datei.

In einer iOS-Beispiel-App wäre der Standardzielwert beispielsweise bcsdk://com.brightcove.sampleAppMainScreen.Destination und es könnte wie folgt überschrieben werden:

controller.analytics.destination =
    @"myapp://com.mycompany.homescreen.destination";

Jeder Bildschirm in Ihrer App, der a instanziiert BCOVPlaybackController kann diese Zielüberschreibung auf einen bestimmten Wert setzen, um Videoaufrufe innerhalb der App selbst besser zu verfolgen.

Quelle

Verwenden Sie die source -Eigenschaft, um den URI festzulegen, der den Endbenutzer an den Ziel-URI gesendet hat. Wie beim Zielwert MUSS der Wert der Quelleigenschaft im richtigen URI-Format vorliegen, ähnlich wie in diesem Beispiel:

bcsdk://com.mhogben.source

Der Standardwert der source-Eigenschaft ist nil. Wenn der Wert nil ist, wird die source-Eigenschaft nicht an den Analytics-Server gesendet.

Hier ist ein Beispiel für das Festlegen der source-Eigenschaft:

controller.analytics.source =
    @"myapp://com.mycompany.homescreen.destination.source";

Analysen anzeigen

Im Video Cloud Analytics-Modul können Sie Metrikdaten auf Kontoebene oder auf detaillierter Ebene, z. B. per Video, anzeigen. Informationen dazu finden Sie in den folgenden Dokumenten: