DokumentationAnalyticsStreaming Media Collection-Handbuch

Implementieren der Streaming-Mediensammlung mithilfe des Edge Networks

Last update: Fri Dec 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Benutzende
  • Admin
  • Entwickler

Mit Adobe Experience Platform Edge Network können Sie Daten, die für mehrere Produkte bestimmt sind, an einen zentralen Ort senden. Experience Edge leitet die entsprechenden Informationen an die gewünschten Produkte weiter. Mit diesem Konzept können Sie Implementierungsaufgaben zusammenfassen, insbesondere, wenn mehrere Datenlösungen vorhanden sind.

Die folgende Abbildung zeigt, wie die Adobe-Streaming-Mediensammlung implementiert werden kann, um mithilfe von Experience Platform Edge Daten in Analysis Workspace verfügbar zu machen, entweder in Adobe Analytics oder Customer Journey Analytics:

CJA-Workflow

Einen Überblick über alle Implementierungsoptionen, einschließlich der Implementierungsmethoden, die nicht Experience Platform Edge verwenden, finden Sie unter Implementieren der Streaming Media Collection.

Unabhängig davon, ob Sie Adobe Experience Platform Web SDK, Adobe Experience Platform Mobile SDK, Adobe Experience Platform Roku SDK oder die API zum Implementieren der Streaming Media Collection mit Experience Edge verwenden, müssen Sie zunächst die folgenden Abschnitte ausfüllen:

Einrichten des Schemas in Adobe Experience Platform

Um die Datenerfassung für die Verwendung in allen Anwendungen zu standardisieren, die Adobe Experience Platform nutzen, hat Adobe das offene und öffentlich dokumentierte Standard Experience-Datenmodell (XDM) erstellt.

So erstellen Sie ein Schema und richten es ein:

  1. Beginnen Sie in Adobe Experience Platform mit der Erstellung des Schemas, wie unter Erstellen und Bearbeiten von Schemas in der Benutzeroberfläche beschrieben.

  2. Wählen Sie auf der Seite mit den Schemadetails beim Erstellen des Schemas Erlebnisereignis aus, wenn Sie die Basisklasse für das Schema auswählen.

    Feldergruppen hinzugefügt

  3. Klicken Sie auf Weiter.

  4. Geben Sie einen Anzeigenamen und eine Beschreibung für das Schema an und wählen Sie dann Beenden.

  5. Wählen Sie im Bereich Komposition im Abschnitt Feldergruppen die Option Hinzufügen aus, suchen Sie dann nach den folgenden neuen Feldergruppen und fügen Sie sie dem Schema hinzu:

    • Adobe Analytics ExperienceEvent Template
    • Implementation Details
    • MediaAnalytics Interaction Details

    Nachdem Sie die Feldergruppen hinzugefügt haben, sollten sie wie folgt im Abschnitt Feldergruppen angezeigt werden:

    Feldergruppen hinzugefügt

  6. Klicken Sie Speichern, um Ihre Änderungen zu speichern.

  7. (Optional) Sie können bestimmte Felder ausblenden, die nicht von der Media Edge-API verwendet werden. Das Ausblenden dieser Felder erleichtert das Lesen und Verstehen des Schemas, es ist jedoch nicht erforderlich. Diese Felder beziehen sich nur auf die Felder in der MediaAnalytics Interaction Details Feldergruppe.

Hier erweitern, um Anweisungen zu Feldern anzuzeigen, die Sie ausblenden können.

  1. Wählen Sie Bereich Struktur“ das Feld Media Collection Details und dann Verwandte Felder verwalten aus.

    Verwalten von zugehörigen Feldern

  2. Aktivieren Sie die Option Anzeigenamen für Felder anzeigen und aktualisieren Sie dann das Schema wie folgt:

    • Blenden Sie im Feld Media Collection Details > Advertising Details die folgenden Berichtsfelder aus: Ad Completed, Ad Started und Ad Time Played.

    • Blenden Sie im Feld Media Collection Details > Advertising Pod Details das folgende Berichtsfeld aus: Ad Break ID

    • Blenden Sie im Feld Media Collection Details > Chapter Details die folgenden Berichtsfelder aus: Chapter Completed, Chapter ID, Chapter Started und Chapter Time Played.

    • Blenden Sie im Feld Media Collection Details das Feld List Of States aus.

      Status der Mediensammlung ausblenden

    • Blenden Sie im Feld Media Collection Details > List Of States End und Media Collection Details > List Of States Start die folgenden Berichtsfelder aus: Player State Count, Player State Set und Player State Time.

      Felder zum Ausblenden

    • Blenden Sie im Feld Media Collection Details > Qoe Data Details die folgenden Berichtsfelder aus: Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Impacted Streams, Buffer Events, Dropped Frame Impacted Streams, Drops Before Starts, Errors, External Error IDs, Error Impacted Streams, Media SDK Error IDs, Player SDK Error IDs, Stalling Impacted Streams, Stalling Events, Total Buffer Duration und Total Stalling Duration.

    • Blenden Sie im Feld Media Collection Details > Session Details die folgenden Berichtsfelder aus: 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Content Completes, Estimated Streams, Federated Data, Media Downloaded Flag, Chapter Count, Content Time Spent, Media Segment Views, Media Session ID, Media Starts, Media Session Server Timeout, Media Time Spent, Pause Events, Pause Impacted Streams, Pev3, Pccr Total Pause Duration Unique Time Played Video Segment, Content Starts, und .

  3. Wählen Bestätigen, um Ihre Änderungen zu speichern.

  4. Aktivieren Sie im Bereich Struktur die Option Anzeigenamen für Felder anzeigen und wählen Sie dann das List Of Media Collection Downloaded Content Events aus.

  5. Wählen Sie Verknüpfte Felder verwalten und aktualisieren Sie das Schema wie folgt:

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details > Advertising Details die folgenden Berichtsfelder aus: Ad Completed, Ad Started und Ad Time Played.

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details > Advertising Pod Details das folgende Berichtsfeld aus: Ad Break ID

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details > Chapter Details die folgenden Berichtsfelder aus: Chapter Completed, Chapter ID, Chapter Started und Chapter Time Played.

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details das Feld List Of States aus.

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details > List Of States End und Media Collection Details > List Of States Start die folgenden Berichtsfelder aus: Player State Count, Player State Set und Player State Time.

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details die folgenden Berichtsfelder aus: Average Bitrate, Average Bitrate Bucket, Bitrate Change Impacted Streams, Bitrate Changes, Buffer Events, Buffer Impacted Streams, Drops Before Starts, Dropped Frame Impacted Streams, Error Impacted Streams, Errors, External Error IDs, Media SDK Error IDs, Player SDK Error IDs, Stalling Events, Stalling Impacted Streams, Total Buffer Duration und Total Stalling Duration.

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details > Session Details die folgenden Berichtsfelder aus: 10% Progress Marker, 25% Progress Marker, 50% Progress Marker, 75% Progress Marker, 95% Progress Marker, Ad Count, Average Minute Audience, Content Time Spent, Estimated Streams, Media Downloaded Flag, Chapter Count, Content Starts, Media Session ID, Federated Data, Media Segment Views, Media Session Server Timeout, Media Starts, Media Time Spent, Content Completes, Pause Events, Pause Impacted Streams Pccr Pev3 Total Pause Duration Unique Time Played Video Segment, und .

    • Blenden Sie im Feld List Of Media Collection Downloaded Content Events > Media Details das Feld Media Session ID aus.

  6. Wählen Bestätigen, um Ihre Änderungen zu speichern.

  7. Wählen Sie Bereich Struktur“ das Feld Media Reporting Details und dann Verwandte Felder verwalten aus.

  8. Aktivieren Sie die Option Anzeigenamen für Felder anzeigen und aktualisieren Sie dann das Schema wie folgt:

    • Blenden Sie im Feld Media Reporting Details die folgenden Felder aus: Error Details, List Of States End, List of States Start und Media Session ID.

  9. Wählen Bestätigen > Speichern, um Ihre Änderungen zu speichern.

  1. (Optional) Sie können Ihrem Schema benutzerdefinierte Metadaten hinzufügen. Auf diese Weise können Sie zusätzliche, benutzerdefinierte Metadaten einbeziehen, die für bestimmte Anforderungen oder Kontexte angepasst werden können. Diese Flexibilität ist in Szenarien nützlich, in denen vorhandene Schemata die gewünschten Datenpunkte nicht abdecken. (Sie können auch mit benutzerdefinierten Metadaten mit Media Edge-APIs arbeiten. Weitere Informationen finden Sie unter Erstellen benutzerdefinierter Metadaten mit Media Edge-APIs.)
Erweitern Sie hier , um Anweisungen zum Hinzufügen benutzerdefinierter Metadaten zu Ihrem Schema anzuzeigen.

  1. Suchen Sie den Namen des Mandanten der Organisation, indem Sie Kontoinformationen > Zugewiesene > Organisationsname > Mandant auswählen.

    Diese benutzerdefinierten Felder werden über diesen Pfad empfangen. (Beispiel: Mandantenname: _dcbl → myCustomField-Pfad: _dcbl.myCustomField.)

  2. Fügen Sie eine benutzerdefinierte Feldergruppe zu Ihrem definierten Medienschema hinzu.

    add-custom-metadata

  3. Fügen Sie alle benutzerdefinierten Felder, die Sie verfolgen möchten, zur Feldergruppe hinzu.

    add-custom-metadata

  4. Verwenden Sie den generiertenfür das benutzerdefinierte Feld in Ihrer Anfrage-Payload.

    add-custom-metadata

  1. Fahren Sie mit Erstellen eines Datensatzes in Adobe Experience Platform fort.

Erstellen eines Datensatzes in Adobe Experience Platform

  1. Stellen Sie sicher, dass Sie ein Schema wie in Einrichten des Schemas in Adobe Experience Platform beschrieben einrichten.

  2. Beginnen Sie in Adobe Experience Platform mit der Erstellung des Datensatzes, wie im Handbuch zur Benutzeroberfläche von Datensätzen beschrieben.

    Wählen Sie bei der Auswahl eines Schemas für Ihren Datensatz das zuvor erstellte Schema aus, wie unter Einrichten des Schemas in Adobe Experience Platform beschrieben.

  3. Fahren Sie fort mit Konfigurieren eines Datenstroms auf Customer Journey Analytics.

Konfigurieren eines Datenstroms in Adobe Experience Platform

  1. Stellen Sie sicher, dass Sie einen Datensatz wie in Erstellen eines Datensatzes in Adobe Experience Platform beschrieben erstellt haben.

  2. Erstellen Sie einen neuen Datenstrom, wie in Konfigurieren eines Datenstroms beschrieben.

    Stellen Sie beim Erstellen des Datenstroms sicher, dass Sie die folgenden Konfigurationen auswählen:

    • Achten Sie im Feld Ereignisschema beim Erstellen des Datenstroms darauf, dass Sie das Schema auswählen, das Sie in erstellt haben Einrichten des Schemas in Adobe Experience Platform. Wählen Sie Speichern aus.

      note important
      IMPORTANT
      Wählen Sie nicht Speichern und Zuordnung hinzufügen da dies zu Zuordnungsfehlern für das Zeitstempelfeld führt.

      Erstellen eines Datenstroms und Auswählen eines Schemas

    • Fügen Sie einen der folgenden Services zum Datenstrom hinzu, je nachdem, ob Sie Adobe Analytics oder Customer Journey Analytics verwenden:

      • Adobe Analytics (bei Verwendung von Adobe Analytics)

        Wenn Sie Adobe Analytics verwenden, stellen Sie sicher, dass Sie eine Report Suite definieren, wie in Erstellen einer Report Suite beschrieben.

      • Adobe Experience Platform (bei Verwendung von Customer Journey Analytics)

      Informationen zum Hinzufügen eines Services zu einem Datenstrom finden Sie im Abschnitt „Hinzufügen von Services zu einem Datenstrom“ in Konfigurieren eines".

      Fügen Sie den Adobe Analytics-Service hinzu

      • Erweitern Sie Erweiterte Optionen und aktivieren Sie dann die Option Media Analytics.

      Media Analytics-Option

  3. Sie können jetzt die Media Edge-API oder Media Edge SDK implementieren, um mit der Erfassung von Medienanalysedaten zu beginnen.

    Nachdem Sie einige Daten erfasst haben, können Sie Verbindung in Customer Journey Analytics erstellen.

Erstellen einer Verbindung in Customer Journey Analytics

NOTE
Das folgende Verfahren ist nur erforderlich, wenn Sie Customer Journey Analytics verwenden.

  1. Stellen Sie sicher, dass Sie einen Datenstrom erstellt haben, wie in Konfigurieren eines Datenstroms auf Customer Journey Analytics beschrieben.

  2. Erstellen Sie beim Customer Journey Analytics eine Verbindung, wie in Verbindung erstellen beschrieben.

    Beim Erstellen der Verbindung sind die folgenden Konfigurationsoptionen erforderlich, um die Streaming Media-Sammlung zu implementieren:

    1. Wählen Sie den zuvor erstellten Datensatz aus, wie unter Erstellen eines Datensatzes in Adobe Experience Platform beschrieben.

    2. Stellen Sie sicher dass die Einstellung „Alle neuen importieren“ aktiviert ist.

  3. Fahren Sie mit Erstellen einer Datenansicht auf Customer Journey Analytics fort.

Datenansicht im Customer Journey Analytics erstellen

NOTE
Das folgende Verfahren ist nur erforderlich, wenn Sie Customer Journey Analytics verwenden.

  1. Stellen Sie sicher, dass Sie eine Verbindung auf Customer Journey Analytics erstellt haben, wie in Erstellen einer Verbindung auf Customer Journey Analytics beschrieben.

  2. Erstellen Sie in Customer Journey Analytics eine Datenansicht, wie unter Erstellen oder Bearbeiten einer Datenansicht beschrieben.

    Beim Erstellen der Datenansicht sind die folgenden Konfigurationsoptionen für die Implementierung der Streaming Media Collection erforderlich:

    1. Wählen Sie im Feld Verbindung die zuvor erstellte Verbindung aus, wie unter Erstellen einer Verbindung auf Customer Journey Analytics beschrieben.

      Es kann bis zu 15 Minuten dauern, bis die von Ihnen erstellte Verbindung zur Auswahl verfügbar ist.

    2. Suchen Sie auf der Komponenten im Abschnitt Schemafelder nach jeder Komponente, die in den Tabellen unten aufgeführt ist, und ziehen Sie sie in das Bedienfeld Metriken. Wenn mehrere Felder mit demselben Namen vorhanden sind, verwenden Sie den XDM-Pfad, um sicherzustellen, dass es sich um das richtige Feld handelt.

      Hauptinhalt - Inhaltsmetriken

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2
      Name der Komponente XDM-Pfad
      Medienstarts mediaReporting.sessionDetails.isViewed
      Mediensegmentansichten mediaReporting.sessionDetails.hasSegmentView
      Inhaltsstarts mediaReporting.sessionDetails.isPlayed
      Inhaltsbeendigungen mediaReporting.sessionDetails.isCompleted
      Inhaltsbesuchszeit mediaReporting.sessionDetails.timePlayed
      Besuchszeit für Medien mediaReporting.sessionDetails.totalTimePlayed
      Eindeutige Spielzeit mediaReporting.sessionDetails.uniqueTimePlayed
      10% Fortschrittsmarkierung mediaReporting.sessionDetails.hasProgress10
      Zielgruppendurchschnitt pro Minute mediaReporting.sessionDetails.averageMinuteAudience

      Kapitel und Anzeigen - Kapitel und Anzeigenmetriken

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
      Name der Komponente XDM-Pfad
      Kapitel gestartet mediaReporting.chapterDetails.isStarted
      Kapitel abgeschlossen mediaReporting.chapterDetails.isCompleted
      Kapitelzeit mediaReporting.chapterDetails.timePlayed
      Anzeige gestartet mediaReporting.advertisingDetails.isStarted
      Anzeige abgeschlossen mediaReporting.advertisingDetails.isCompleted
      Wiedergabezeit der Anzeige mediaReporting.advertisingDetails.timePlayed

      QoE - QoE-Metriken

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2
      Name der Komponente XDM-Pfad
      Zeit bis Start mediaReporting.qoeDataDetails.timeToStart
      Drops vor dem Start mediaReporting.qoeDataDetails.isDroppedBeforeStart
      Von Puffer betroffene Streams mediaReporting.qoeDataDetails.hasBufferImpactedStreams
      Von Bitratenänderung betroffene Streams mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
      Bitratenänderungen mediaReporting.qoeDataDetails.bitrateChangeCount
      Durchschnittliche Bitrate mediaReporting.qoeDataDetails.bitrateAverage
      Gelöschte Frames mediaReporting.qoeDataDetails.droppedFrames
      Fehler mediaReporting.qoeDataDetails.errorCount
      Von Fehlern betroffene Streams mediaReporting.qoeDataDetails.hasErrorImpactedStreams
      Von Dropped Frames betroffene Streams mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams

      Player-Status - Player-Statusmetriken

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Name der Komponente XDM-Pfad
      Player-Status festgelegt mediaReporting.states.isSet
      Anzahl der Player-Status mediaReporting.states.count
      Player-Statuszeit mediaReporting.states.time

    3. Aktualisieren Sie die Beschriftungen (im Kontextbeschriftungen Dropdown-Menü) für die Komponenten in der folgenden Tabelle. Suchen Sie nach Komponenten, die sich noch nicht im Bedienfeld Metriken befinden, und ziehen Sie sie in das Bedienfeld.

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
      Name der Komponente Kontext-Label
      Zeitüberschreitung des Mediensitzungs-Servers Medien: Sekunden seit letztem Aufruf
      Besuchszeit für Medien Medien: Besuchszeit für Medien
      Gesamtpufferdauer Medien: Gesamtdauer des Puffers
      Zeit bis Start Medien: Zeit bis zum Start
      Pausierung – Gesamtdauer Medien: Pausierung - Gesamtdauer

    4. Um Ihrem Customer Journey Analytics-Projekt Aufschlüsselungen hinzuzufügen, fügen Sie die folgenden Dimensionen zum Bedienfeld Dimensionen hinzu:

      table 0-row-2 1-row-2 2-row-2
      XDM-Pfad Name der Komponente
      mediaReporting.states.name Player-Statusname
      mediaReporting.sessionDetails.ID Mediensitzungs-ID

      Zusätzlich zu den Dimensionen in dieser Tabelle können Sie beliebige andere Dimensionen hinzufügen, die Sie für das Filtern von Daten nach in Customer Journey Analytics-Projekten verfügbar machen möchten.

  3. Wählen Sie Speichern und fortfahren > Speichern und beenden um Ihre Änderungen zu speichern.

  4. Fahren Sie mit Erstellen und Konfigurieren eines Projekts in Customer Journey Analytics fort.

Erstellen und Konfigurieren eines Projekts auf Customer Journey Analytics

  1. Stellen Sie sicher, dass Sie eine Datenansicht auf Customer Journey Analytics erstellt haben, wie in Erstellen einer Datenansicht auf Customer Journey Analytics beschrieben.

  2. Customer Journey Analytics Wählen Sie auf der Registerkarte Workspace im Bereich Projekte die Option Projekt erstellen.

  3. Wählen Sie Leeres Projekt > Erstellen aus.

  4. Wählen Sie im neuen Projekt die Datenansicht aus, die Sie zuvor erstellt haben.

    Beim Erstellen von Bedienfeldern in Ihrem Projekt können Sie alle Komponenten verwenden, die Sie Ihrer Datenansicht hinzugefügt haben, wie in Erstellen einer Datenansicht auf Customer Journey Analytics beschrieben.

    Die folgenden vier Bedienfelder sind Beispiele für Bedienfelder, die Sie erstellen können:

    Hauptinhaltsbedienfeld

    Kapitel- und Anzeigen-Bedienfeld

    QoE-Bedienfeld

    Player-State-Panel

  5. Wählen Sie das Symbol Bedienfelder in der linken Leiste aus und ziehen Sie dann das Bedienfeld Gleichzeitige Medienbetrachter und das Bedienfeld Bei Medienwiedergabe verbrachte Zeit.

    Die beiden Bedienfelder sollten wie folgt aussehen:

    Bedienfeld „Gleichzeitige Medienbetrachter“

    Panel „Verbrachte Zeit bei der Medienwiedergabe“

  6. (Bedingt) Wenn Sie benutzerdefinierte Metadaten zu Ihrem Schema hinzugefügt haben, wie in Schritt 8 von Einrichten des Schemas in Adobe Experience Platform beschrieben, müssen Sie die Persistenz für die benutzerdefinierten Felder festlegen, wie in Persistenzkomponenteneinstellungen im Customer Journey Analytics-Handbuch beschrieben.

    Wenn Daten auf Customer Journey Analytics eingehen, ist die Dimension Benutzerspezifische Benutzer-ID verfügbar.

    setup-custom-metadata

    note note
    NOTE
    Wenn Sie Adobe Analytics als Upstream für Ihren Datenstrom einrichten, sind die benutzerdefinierten Metadaten auch in ContextData mit dem Namen vorhanden, den Sie im Schema festgelegt haben (ohne das Mandantenpräfix, z. B. myCustomField). Dadurch können alle für ContextData verfügbaren Adobe Analytics-Funktionen verwendet werden, z. B „Erstellen einer Verarbeitungsregel.

  7. Geben Sie das Projekt frei, wie unter Freigeben von Projekten beschrieben.

    note note
    NOTE
    Wenn die Benutzer, für die Sie freigeben möchten, nicht verfügbar sind, stellen Sie sicher, dass die Benutzer über Benutzer- und Administratorzugriff auf das Customer Journey Analytics in der Adobe Admin Console verfügen.

  8. Fahren Sie fort mit Daten an Experience Platform Edge senden.

Senden von Daten an Experience Platform Edge

Je nach Datentyp, den Sie an Experience Platform Edge senden möchten, können Sie eine der folgenden Methoden verwenden:

Web: Verwenden der Adobe Experience Platform Web SDK

Mobile: Verwenden der Adobe Experience Platform Mobile SDK

Verwenden Sie die folgenden Dokumentationsressourcen, um die Implementierung für iOS und Android abzuschließen:

Roku: Adobe Experience Platform Roku SDK

API: Web und andere

Die -API ist derzeit die einzige unterstützte Möglichkeit, Web-Daten an Experience Platform Edge zu senden.

Die API ist auch verfügbar, wenn Sie eine benutzerdefinierte Implementierung der Edge-APIs verwenden möchten.

Weitere Informationen zur Media Edge-API finden Sie in den folgenden Ressourcen:

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb