DokumentationAnalyticsStreaming Media Collection-Handbuch

Implementieren des Add-ons für Streaming-Mediensammlung mit dem Edge Network

Last update: Wed Sep 25 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 das Adobe Streaming-Mediensammlungs-Add-on implementiert werden kann, um Experience Platform Edge zu verwenden und 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 Implementierungsmethoden, die Experience Platform Edge nicht verwenden, finden Sie unter Implementieren des Add-ons für Streaming-Mediensammlung.

Unabhängig davon, ob Sie das Adobe Experience Platform Web SDK, das Adobe Experience Platform Mobile SDK, das Adobe Experience Platform Roku SDK oder die API verwenden, um das Streaming Media Collection Add-on mit Experience Edge zu implementieren, müssen Sie zunächst die folgenden Abschnitte ausführen:

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.

Erstellen und Einrichten eines Schemas:

  1. Beginnen Sie in Adobe Experience Platform mit der Erstellung des Schemas, wie in 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 aus.

  5. Wählen Sie im Bereich Komposition im Abschnitt Feldergruppen die Option Hinzufügen aus und suchen Sie dann nach den folgenden neuen Feldergruppen und fügen Sie sie zum 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. Wählen Sie Speichern aus, 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, ist jedoch nicht erforderlich. Diese Felder beziehen sich nur auf die Felder in der Feldgruppe MediaAnalytics Interaction Details .

Erweitern Sie hier , um Anweisungen zu Feldern anzuzeigen, die Sie ausblenden können.

  1. Wählen Sie im Bereich Struktur das Feld Media Collection Details und dann Zugehörige Felder verwalten aus.

    manage-related-fields

  2. Aktivieren Sie die Option auf Anzeigenamen für Felder anzeigen und aktualisieren Sie das Schema dann 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.

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

      Medienkollektionsstatus 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

    • Verstecken Sie im Feld Media Collection Details > Qoe Data Details die folgenden Berichtsfelder: 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 8}.Total Stalling Duration

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

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

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

  5. Wählen Sie Zugehörige Felder verwalten und aktualisieren Sie das Schema dann 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.

    • Verstecken Sie im Feld List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details die folgenden Berichtsfelder: 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, 8 und 19.Total Buffer Duration Total Stalling Duration

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

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

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

  7. Wählen Sie im Bereich Struktur das Feld Media Reporting Details aus und wählen Sie Zugehörige Felder verwalten aus.

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

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

  9. Wählen Sie Bestätigen > Speichern aus, 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 einschließen, die für bestimmte Anforderungen oder Kontexte angepasst werden können. Diese Flexibilität ist nützlich in Szenarien, in denen vorhandene Schemas keine gewünschten Datenpunkte 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 Organisationen > Organisationsname > Mandant auswählen.

    Diese benutzerdefinierten Felder werden über diesen Pfad empfangen. (Beispiel: Name des Mandanten: _dcbl → myCustomField path: _dcbl.myCustomField.)

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

    add-custom-metadata

  3. Fügen Sie der Feldergruppe benutzerdefinierte Felder hinzu, die Sie verfolgen möchten.

    add-custom-metadata

  4. Verwenden Sie den generierten Pfad für das benutzerdefinierte Feld in Ihrer Anfrage-Payload.

    add-custom-metadata

  1. Fahren Sie mit Erstellen Sie einen Datensatz in Adobe Experience Platform fort.

Datensatz in Adobe Experience Platform erstellen

  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 Benutzerhandbuch zur Datensatzbenutzeroberfläche beschrieben.

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

  3. Fahren Sie mit Konfigurieren eines Datastreams in Customer Journey Analytics fort.

Konfigurieren eines Datenspeichers in Adobe Experience Platform

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

  2. Erstellen Sie einen neuen Datastream wie in Konfigurieren eines Datastreams beschrieben.

    Stellen Sie beim Erstellen des Datastreams sicher, dass Sie die folgenden Konfigurationsoptionen vornehmen:

    • Wählen Sie im Feld Ereignisschema beim Erstellen des Datenspeichers das Schema aus, das Sie anhand der Anweisungen unter Schema in Adobe Experience Platform einrichten erstellt haben. Wählen Sie Speichern aus.

      note important
      IMPORTANT
      Wählen Sie nicht Speichern und Zuordnung hinzufügen aus, da dies zu Zuordnungsfehlern für das Feld "Zeitstempel"führt.

      Erstellen Sie einen Datastraam und wählen Sie Schema aus

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

      • Adobe Analytics (bei Verwendung von Adobe Analytics)

        Wenn Sie Adobe Analytics verwenden, stellen Sie sicher, dass Sie eine Report Suite definieren, wie unter Report Suite erstellen beschrieben.

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

      Informationen zum Hinzufügen eines Dienstes zu einem Datastream finden Sie im Abschnitt "Dienste zu einem Datastream hinzufügen"in Konfigurieren eines Datastreams.

      Hinzufügen des Adobe Analytics-Dienstes

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

      Medienanalyseoption

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

    Nachdem Sie einige Daten erfasst haben, können Sie eine 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 Datastream erstellt haben, wie in Konfigurieren eines Datastreams in Customer Journey Analytics beschrieben.

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

    Beim Erstellen der Verbindung sind für die Implementierung des Add-ons für die Streaming-Mediensammlung die folgenden Konfigurationsoptionen erforderlich:

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

    2. Stellen Sie sicher, dass die Einstellung Alle neuen Daten importieren aktiviert ist.

  3. Fahren Sie mit Erstellen Sie eine Datenansicht in Customer Journey Analytics fort.

Erstellen einer Datenansicht unter Customer Journey Analytics

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

  1. Stellen Sie sicher, dass Sie eine Verbindung auf dem 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 in Erstellen oder Bearbeiten einer Datenansicht beschrieben.

    Beim Erstellen der Datenansicht sind für die Implementierung des Streaming-Mediensammlungs-Add-ons die folgenden Konfigurationsoptionen erforderlich:

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

      Es kann bis zu 15 Minuten dauern, bis die von Ihnen erstellte Verbindung ausgewählt werden kann.

    2. Suchen Sie auf der Registerkarte Komponenten im Abschnitt Schemafelder nach den einzelnen Komponenten, die in den Tabellen unten aufgeführt sind, und ziehen Sie sie in den Bereich 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 - Metriken für Kapitel und Anzeigen

      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
      Wiedergabe des Kapitels mediaReporting.chapterDetails.timePlayed
      Anzeigenstarts 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 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-Statusset mediaReporting.states.isSet
      Player-Statusanzahl mediaReporting.states.count
      Player-Statuszeit mediaReporting.states.time

    3. Aktualisieren Sie die Beschriftungen (im Dropdown-Menü Kontextbezeichnungen ) für die Komponenten in der folgenden Tabelle. Suchen Sie nach Komponenten, die sich noch nicht im Metrikbereich befinden, und ziehen Sie sie in den Bereich.

      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 dem letzten Aufruf
      Besuchszeit für Medien Medien: Besuchszeit für Medien
      Gesamtpufferdauer Medien: Gesamtpufferdauer
      Zeit bis Start Medien: Zeit bis Start
      Pausierung – Gesamtdauer Medien: Pausierung - Gesamtdauer

    4. Um Ihrem Customer Journey Analytics-Projekt Aufschlüsselungen hinzuzufügen, fügen Sie die folgenden Dimensionen zum Bereich 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 weitere Dimensionen hinzufügen, die Sie zum Filtern von Daten in Customer Journey Analytics-Projekten bereitstellen möchten.

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

  4. Fahren Sie mit Erstellen und konfigurieren Sie ein Projekt in Customer Journey Analytics.

Erstellen und Konfigurieren eines Projekts im 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. Wählen Sie unter Customer Journey Analytics auf der Registerkarte Workspace im Bereich Projekte die Option Projekt erstellen aus.

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

  4. Wählen Sie im neuen Projekt die zuvor erstellte Datenansicht aus.

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

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

    Bedienfeld Hauptinhalt

    Bedienfeld Kapitel und Anzeigen

    QoE-Bedienfeld

    Platzierungsstatusbereich

  5. Wählen Sie in der linken Leiste das Symbol Bedienfelder aus und ziehen Sie dann in den Bereich Gleichzeitige Medienbetrachter und in den Bereich Besuchszeit für Medienwiedergabe .

    Die beiden Bedienfelder sollten wie folgt aussehen:

    Bedienfeld Gleichzeitige Medienbetrachter

    Zeitfenster für die Medienwiedergabe

  6. (Bedingt) Wenn Sie Ihrem Schema benutzerdefinierte Metadaten 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 den Einstellungen der Persistenz-Komponente 🔗 im Customer Journey Analytics-Handbuch beschrieben.

    Wenn Daten in 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 Datastream 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 wie in Projekte freigeben beschrieben frei.

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

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

Daten an Experience Platform Edge senden

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

Web: Verwenden des Adobe Experience Platform Web SDK

Mobile: Verwenden des 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 Methode zum Senden von Webdaten an Experience Platform Edge.

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