DocumentatieAnalyticsHandleiding voor het streamen van mediaverzameling

Implementeer de invoegtoepassing voor het streamen van media-verzamelingen met de Edge Network

Last update: Wed Sep 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

Met de Adobe Experience Platform-Edge Network kunt u gegevens die bestemd zijn voor meerdere producten naar een gecentraliseerde locatie verzenden. De ervaring met Edge geeft de juiste informatie door aan de gewenste producten. Met dit concept kunt u de implementatie-inspanningen consolideren, met name voor het overspannen van meerdere gegevensoplossingen.

In de volgende afbeelding ziet u hoe de invoegtoepassing voor het streamen van media-Adobe kan worden geïmplementeerd om Experience Platform Edge te gebruiken om gegevens beschikbaar te maken in Analysis Workspace, in Adobe Analytics of Customer Journey Analytics:

CJA werkschema

Voor een overzicht van alle implementatieopties, met inbegrip van implementatiemethodes die geen Experience Platform Edge gebruiken, zie de Streaming Invoegtoepassing van de Inzameling van Media uitvoeren.

Ongeacht of u de Adobe Experience Platform Web SDK, de Adobe Experience Platform Mobile SDK, de Adobe Experience Platform Roku SDK, of API gebruikt om de Invoegtoepassing van de Inzameling van de Media van de Verzameling van het Streaming met Ervaring Edge uit te voeren, moet u eerst de volgende secties voltooien:

Schema instellen in Adobe Experience Platform

Om gegevensinzameling voor gebruik over toepassingen te standaardiseren die hefboomwerking Adobe Experience Platform, heeft de Adobe de open en openbaar gedocumenteerde norm, het Model van de Gegevens van de Ervaring (XDM) gecreeerd.

Een schema maken en instellen:

  1. In Adobe Experience Platform, begin creërend het schema zoals die in wordt beschreven creeer en geef schema's in UIuit.

  2. Op de pagina van de details van het Schema wanneer het creëren van het schema, kies {de Gebeurtenis van de 0} Ervaring wanneer het kiezen van de basisklasse voor het schema.

    Toegevoegde gebiedsgroepen

  3. Selecteer daarna.

  4. Specificeer een naam en een beschrijving van de schemavertoning, dan uitgezochte Afwerking.

  5. In het gebied van de Samenstelling, in de 3} sectie van de Groepen van het Gebied {, uitgezocht ​ voeg ​ toe, dan onderzoek naar en voeg de volgende nieuwe gebiedsgroepen aan het schema toe:

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

    Nadat u de gebiedsgroepen toevoegt, zouden zij in de sectie van de Groepen van het Gebied, als volgt moeten tonen:

    Toegevoegde gebiedsgroepen

  6. Selecteer sparen om uw veranderingen te bewaren.

  7. (Optioneel) U kunt bepaalde velden verbergen die niet worden gebruikt door de Media Edge API. Het verbergen van deze gebieden maakt het schema gemakkelijker te lezen en te begrijpen, maar het wordt niet vereist. Deze velden verwijzen alleen naar de velden in de veldgroep MediaAnalytics Interaction Details .

Vouw hier uit om instructies weer te geven voor velden die u kunt verbergen.

  1. Op het gebied van de Structuur, selecteer het Media Collection Details gebied, dan uitgezocht beheer verwante gebieden.

    leiden-verwant-gebieden

  2. Laat de optie toe om vertoningsnamen voor gebieden te tonen, dan het schema als volgt bij te werken:

    • Verberg in het veld Media Collection Details > Advertising Details de volgende rapportvelden: Ad Completed , Ad Started en Ad Time Played .

    • Verberg het volgende rapportveld in het veld Media Collection Details > Advertising Pod Details : Ad Break ID

    • Verberg in het veld Media Collection Details > Chapter Details de volgende rapportvelden: Chapter Completed , Chapter ID , Chapter Started en Chapter Time Played .

    • Verberg het veld List Of States in het veld Media Collection Details .

      verbergt media inzamelingsstaten

    • Verberg in het veld Media Collection Details > List Of States End en Media Collection Details > List Of States Start de volgende rapportvelden: Player State Count , Player State Set en Player State Time .

      te verbergen gebieden

    • Verberg in het veld Media Collection Details > Qoe Data Details de volgende rapporteringsvelden: 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 en Total Stalling Duration 8}.

    • Verberg in het veld Media Collection Details > Session Details de volgende rapporteringsvelden: 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, Pause Impacted Streams 8}, Media Session Server Timeout, Media Time Spent, Pause Events, Media Session ID, Pev3, Pccr, Total Pause Duration, Unique Time Played en Video Segment .

  3. Selecteer bevestigen om uw veranderingen te bewaren.

  4. Op het gebied van de Structuur, laat de optie toe vertoningsnamen voor gebieden tonen, dan het List Of Media Collection Downloaded Content Events gebied selecteren.

  5. Selecteer beheer verwante gebieden, dan werk het schema als volgt bij:

    • Verberg in het veld List Of Media Collection Downloaded Content Events > Media Details > Advertising Details de volgende rapportvelden: Ad Completed , Ad Started en Ad Time Played .

    • Verberg het volgende rapportveld in het veld List Of Media Collection Downloaded Content Events > Media Details > Advertising Pod Details : Ad Break ID

    • Verberg in het veld List Of Media Collection Downloaded Content Events > Media Details > Chapter Details de volgende rapportvelden: Chapter Completed , Chapter ID , Chapter Started en Chapter Time Played .

    • Verberg het veld List Of States in het veld List Of Media Collection Downloaded Content Events > Media Details .

    • Verberg in het veld List Of Media Collection Downloaded Content Events > Media Details > List Of States End en Media Collection Details > List Of States Start de volgende rapportvelden: Player State Count, Player State Set en Player State Time .

    • Verberg in het veld List Of Media Collection Downloaded Content Events > Media Details > Qoe Data Details de volgende rapporteringsvelden: 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 8} en Total Stalling Duration .

    • Verberg in het veld List Of Media Collection Downloaded Content Events > Media Details > Session Details de volgende rapporteringsvelden: 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, Pause Events 8}, Media Session Server Timeout, Media Starts, Media Time Spent, Media Session ID, Pause Impacted Streams, Pccr, Pev3, Total Pause Duration, Unique Time Played en Video Segment .

    • Verberg het veld Media Session ID in het veld List Of Media Collection Downloaded Content Events > Media Details .

  6. Selecteer bevestigen om uw veranderingen te bewaren.

  7. Op het gebied van de Structuur, selecteer het Media Reporting Details gebied, uitgezocht beheer verwante gebieden.

  8. Laat de optie toe om vertoningsnamen voor gebieden te tonen, dan het schema als volgt bij te werken:

    • Verberg in het veld Media Reporting Details de volgende velden: Error Details , List Of States End , List of States Start en Media Session ID .

  9. Selecteer bevestigen > sparen om uw veranderingen te bewaren.

  1. (Optioneel) U kunt aangepaste metagegevens toevoegen aan uw schema. Op deze manier kunt u aanvullende, door de gebruiker gedefinieerde metagegevens opnemen die u kunt aanpassen aan specifieke behoeften of contexten. Deze flexibiliteit is handig in situaties waarin bestaande schema's de gewenste gegevenspunten niet dekken. (U kunt ook werken met aangepaste metagegevens met Media Edge API's. Voor meer informatie, zie douanemetagegevens met Media Edge APIscreëren.)
Vouw hier uit om instructies weer te geven over het toevoegen van aangepaste metagegevens aan uw schema.

  1. Bepaal de plaats van de naam van de huurder van de org door Info van de Rekening > Toegewezen organen > organnaam > huurder te selecteren.

    Deze aangepaste velden worden via dit pad ontvangen. (Bijvoorbeeld naam huurder: _dcbl → myCustomField path: _dcbl.myCustomField.)

  2. Voeg een aangepaste veldgroep toe aan het door u gedefinieerde mediaschema.

    toe:voegen-douane-meta-gegevens

  3. Voeg aangepaste velden die u wilt bijhouden toe aan de veldgroep.

    toe:voegen-douane-meta-gegevens

  4. Gebruik de weg dievoor het douanegebied in uw verzoeklading wordt geproduceerd.

    toe:voegen-douane-meta-gegevens

  1. Ga met verder creeer een dataset in Adobe Experience Platform.

Een gegevensset maken in Adobe Experience Platform

  1. Zorg ervoor dat u opstelling een schema zoals die in wordt beschreven opstelling het Schema in Adobe Experience Platform.

  2. In Adobe Experience Platform, begin creërend de dataset zoals die in wordt beschreven gids UI van Datasets.

    Wanneer het selecteren van een schema voor uw dataset, kies het schema dat u eerder creeerde, zoals die in wordt beschreven Opstelling het Schema in Adobe Experience Platform.

  3. Ga met verder vormen een gegevensstroom in Customer Journey Analytics.

Een gegevensstroom configureren in Adobe Experience Platform

  1. Zorg ervoor dat u een dataset zoals die in wordt beschreven creeerde een dataset in Adobe Experience Platform.

  2. Creeer een nieuwe gegevensstroom zoals die in wordt beschreven vormt een datastream.

    Zorg er bij het maken van de gegevensstroom voor dat u de volgende configuratieselecties maakt:

    • Op het Schema van de Gebeurtenis gebied wanneer het creëren van de gegevensstroom, zorg ervoor dat u het schema selecteert dat u in opstelling het schema in Adobe Experience Platformcreeerde. Selecteer sparen.

      note important
      IMPORTANT
      Selecteer niet sparen en voeg Toewijzing toe omdat het doen dit in afbeeldingsfouten voor het gebied van de Chronologie zal resulteren.

      creeer gegevensstroom en selecteer schema

    • Voeg een van de volgende services toe aan de gegevensstroom, afhankelijk van of u Adobe Analytics of Customer Journey Analytics gebruikt:

      • Adobe Analytics (als het gebruiken van Adobe Analytics)

        Als u Adobe Analytics gebruikt, zorg ervoor u een rapportreeks bepaalt, zoals die in wordt beschreven creeer een rapportreeks.

      • Adobe Experience Platform (als het gebruiken van Customer Journey Analytics)

      Voor informatie over hoe te om de dienst aan een datastream toe te voegen, zie de "diensten aan een datastream"sectie in een datastreamvormen.

      voeg de dienst van Adobe Analytics toe

      • Breid Geavanceerde Opties uit, dan laat de Analytics van Media optie toe.

      de optie van Analytics van Media

  3. U bent nu klaar om Media Edge APIof Media Edge SDKuit te voeren om media analysegegevens te beginnen verzamelen.

    Nadat u wat gegevens hebt verzameld, kunt u een verbinding in Customer Journey Analyticstot stand brengen.

Verbinding maken in Customer Journey Analytics

NOTE
De volgende procedure is alleen vereist als u Customer Journey Analytics gebruikt.

  1. Zorg ervoor dat u een gegevensstroom zoals die in wordt beschreven vormde een gegevensstroom in Customer Journey Analytics.

  2. In Customer Journey Analytics, creeer een verbinding zoals die in wordt beschreven creeer een verbinding.

    Bij het maken van de verbinding zijn de volgende configuratieselecties vereist voor de implementatie van de invoegtoepassing voor het streamen van media-verzamelingen:

    1. Selecteer de dataset die u eerder creeerde, zoals die in wordt beschreven creeer een dataset in Adobe Experience Platform.

    2. Zorg ervoor dat de Invoer alle nieuwe gegevens het plaatsen wordt toegelaten.

  3. Ga met verder creeer een gegevensmening in Customer Journey Analytics.

Een gegevensweergave maken in Customer Journey Analytics

NOTE
De volgende procedure is alleen vereist als u Customer Journey Analytics gebruikt.

  1. Zorg ervoor dat u een verbinding in Customer Journey Analytics zoals die in wordt beschreven creeerde een verbinding in Customer Journey Analytics.

  2. In de Analtyics van de Reis van de Klant, creeer een gegevensmening zoals die in wordt beschreven creeer of geef een gegevensmeninguit.

    Wanneer het creëren van de gegevensmening, worden de volgende configuratieselecties vereist voor het uitvoeren van de Streaming Invoegtoepassing van de Inzameling van Media:

    1. Op het gebied van de Verbinding, selecteer de verbinding die u eerder creeerde, zoals die in wordt beschreven creeer een verbinding in Customer Journey Analytics.

      Het kan 15 minuten duren voordat de verbinding die u hebt gemaakt beschikbaar is om te selecteren.

    2. Op het lusje van Componenten, in de gebieden van het Schema sectie, onderzoek naar elke component die in de lijsten hieronder wordt vermeld en sleep het in het Metriek paneel. Als er meerdere velden met dezelfde naam bestaan, gebruikt u het XDM-pad om te controleren of dit het juiste veld is.

      Belangrijkste inhoud - de metriek van de Inhoud

      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
      Componentnaam XDM-pad
      Start media mediaReporting.sessionDetails.isViewed
      Weergaven van mediasegment mediaReporting.sessionDetails.hasSegmentView
      Inhoud start mediaReporting.sessionDetails.isPlayed
      Inhoud voltooid mediaReporting.sessionDetails.isCompleted
      Tijd van inhoud besteed mediaReporting.sessionDetails.timePlayed
      Tijd besteed aan media mediaReporting.sessionDetails.totalTimePlayed
      Unieke afgespeelde tijd mediaReporting.sessionDetails.uniqueTimePlayed
      Voortgangsmarkering 10% mediaReporting.sessionDetails.hasProgress10
      Gemiddeld aantal minuten publiek mediaReporting.sessionDetails.averageMinuteAudience

      Hoofdstuk & Advertenties - Hoofdstuk & de metriek van Advertenties

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
      Componentnaam XDM-pad
      Hoofdstuk gestart mediaReporting.chapterDetails.isStarted
      Hoofdstuk voltooid mediaReporting.chapterDetails.isCompleted
      Afspeeltijd van hoofdstuk mediaReporting.chapterDetails.timePlayed
      Advertentie gestart mediaReporting.advertisingDetails.isStarted
      Advertentie voltooid mediaReporting.advertisingDetails.isCompleted
      Ad-tijd afgespeeld mediaReporting.advertisingDetails.timePlayed

      QoE - QoE metriek

      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
      Componentnaam XDM-pad
      Te starten tijd mediaReporting.qoeDataDetails.timeToStart
      Drops voordat wordt gestart mediaReporting.qoeDataDetails.isDroppedBeforeStart
      Door buffer beïnvloede stromen mediaReporting.qoeDataDetails.hasBufferImpactedStreams
      Door bitsnelheidwijziging beïnvloede stromen mediaReporting.qoeDataDetails.hasBitrateChangeImpactedStreams
      Wijzigingen in bitsnelheid mediaReporting.qoeDataDetails.bitrateChangeCount
      Gemiddelde bitsnelheid mediaReporting.qoeDataDetails.bitrateAverage
      Gedropte frames mediaReporting.qoeDataDetails.droppedFrames
      Fouten mediaReporting.qoeDataDetails.errorCount
      Fout beïnvloede stromen mediaReporting.qoeDataDetails.hasErrorImpactedStreams
      Gedropte framestromen mediaReporting.qoeDataDetails.hasDroppedFrameImpactedStreams

      staat van de Speler - de staatsmetriek van de Speler

      table 0-row-2 1-row-2 2-row-2 3-row-2
      Componentnaam XDM-pad
      Set spelerstatussen mediaReporting.states.isSet
      Aantal statussen van speler mediaReporting.states.count
      Frametijd van speler mediaReporting.states.time

    3. Werk de etiketten (in het drop-down menu van de Context labels) voor de componenten in de volgende lijst bij. Zoek naar componenten en sleep om het even welke componenten die nog niet in het metriekpaneel in het paneel zijn.

      table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
      Componentnaam Contextlabel
      Tijdslimiet mediasessie Media: Seconden sinds laatste vraag
      Tijd besteed aan media Media: media-tijd besteed
      Totale bufferduur Media: totale bufferduur
      Te starten tijd Media: Te starten tijd
      Totale pauzeduur Media: totale pauzeduur

    4. Om onderverdelingen aan uw project van de Customer Journey Analytics toe te voegen, voeg de volgende afmetingen aan het Dimensionen paneel toe:

      table 0-row-2 1-row-2 2-row-2
      XDM-pad Componentnaam
      mediaReporting.states.name Framenaam van speler
      mediaReporting.sessionDetails.ID Mediasessie-id

      Naast de afmetingen in deze lijst, kunt u in om het even welke andere afmetingen toevoegen die u aan filtergegevens door in projecten van de Customer Journey Analytics ter beschikking wilt stellen.

  3. Selecteer sparen en ga > ​ verder sparen en beëindigen om uw veranderingen te bewaren.

  4. Ga met voort creeer en vorm een project in Customer Journey Analytics.

Creeer en vorm een project in Customer Journey Analytics

  1. Zorg ervoor dat u een gegevensmening in Customer Journey Analytics zoals die in wordt beschreven creeerde een gegevensmening in Customer Journey Analytics.

  2. In Customer Journey Analytics, in het Workspace lusje, in het gebied van Projecten, uitgezocht creeer project.

  3. Selecteer Leeg project > creëren.

  4. Selecteer in het nieuwe project de gegevensweergave die u eerder hebt gemaakt.

    Wanneer het creëren van panelen in uw project, kunt u om het even welke componenten gebruiken die u aan uw gegevensmening toevoegde, zoals die in wordt beschreven creeer een gegevensmening in Customer Journey Analytics.

    De volgende vier deelvensters zijn voorbeelden van deelvensters die u kunt maken:

    Belangrijkste paneel van de Inhoud

    Hoofdstuk en advertenties paneel

    QoE paneel

    Plater staatspaneel

  5. Selecteer het pictogram van Panelen in het linkerspoor, dan belemmering in het gelijktijdige kijkers van Media paneel en de doorgebrachte tijd van de media playback paneel.

    De twee deelvensters moeten er als volgt uitzien:

    Medium gezamenlijke kijkers paneel

    de playbacktijd van media bestede paneel

  6. (Voorwaardelijk) als u douanemetagegevens aan uw schema toevoegde, zoals die in Stap 8 van worden beschreven opstelling het schema in Adobe Experience Platform, dan moet u de persistentie voor de douanegebieden plaatsen, zoals die in de montages van de componenten van de Persistentiein de gids van de Customer Journey Analytics wordt beschreven.

    Wanneer de gegevens in Customer Journey Analytics aankomen, zal de dimensie van de Gebruiker van de Douane beschikbaar zijn.

    opstelling-douane-meta-gegevens

    note note
    NOTE
    Als u Adobe Analytics instelt als een upstream voor uw gegevensstroom, zijn de aangepaste metagegevens ook aanwezig in ContextData, met de naam die u instelt in het schema (zonder het voorvoegsel van de huurder, bijvoorbeeld myCustomField). Dit maakt het mogelijk om alle eigenschappen van Adobe Analytics beschikbaar voor ContextData, zoals te gebruiken creërend een verwerkingsregel.

  7. Deel het project zoals die in wordt beschreven de projecten van het Aandeel.

    note note
    NOTE
    Als de gebruikers u wilt delen met niet beschikbaar zijn, zorg ervoor de gebruikers gebruiker en admin toegang tot Customer Journey Analytics in Adobe Admin Console hebben.

  8. Ga met verder verzenden gegevens naar Experience Platform Edge.

Gegevens verzenden naar Experience Platform Edge

Afhankelijk van het type gegevens dat u naar Experience Platform Edge wilt verzenden, kunt u een van de volgende methoden gebruiken:

Web: De SDK van het Web van Adobe Experience Platform gebruiken

Mobiel: gebruik de Adobe Experience Platform Mobile SDK

Gebruik de volgende documentatiebronnen om de implementatie voor zowel iOS als Android te voltooien:

Roku: Adobe Experience Platform Roku SDK

API: Web en andere

De API is momenteel de enige ondersteunde manier om webgegevens naar Experience Platform Edge te verzenden.

De API is ook beschikbaar als u een aangepaste implementatie van de Edge API's wilt gebruiken.

Zie de volgende bronnen voor meer informatie over de media Edge API:

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