DocumentatieAnalyticsHandleiding voor het streamen van mediaverzameling

Verouderd - Media SDK Setup - Overzicht setup-overview

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

Nadat u de Media SDK voor uw video-app of -speler hebt gedownload, volgt u de informatie in deze sectie om de Media SDK in te stellen en te implementeren.

Algemene uitvoeringsrichtsnoeren general-implementation-guidelines

Er zijn drie belangrijke SDK-componenten die worden gebruikt voor het bijhouden van streaming media Collection:

  • Configuratie van mediageletterdheid - De MediaHeartbeatConfig bevat de basisinstellingen voor rapportage.
  • Media Heartmaatdelegatie - De MediaHeartbeatDelegate bestuurt de afspeeltijd en het QoS-object.
  • Mediahartslag - De MediaHeartbeat is de primaire bibliotheek met leden en methoden.

Implementeer de Streaming Media SDK

Voer de volgende implementatiestappen uit om de Streaming Media SDK in te stellen en te gebruiken:

  1. Maak een MediaHeartbeatConfig -instantie en stel de parameterwaarden voor de configuratie in.

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4 3-align-center 8-align-center 13-align-center 18-align-center 23-align-center 28-align-center 33-align-center 38-align-center
    Naam variabele Beschrijving Vereist Standaardwaarde
    trackingServer Volgserver voor mediaanalyses. Dit is anders dan de analysetrackserver. Ja Lege tekenreeks
    channel Kanaalnaam Nee Lege tekenreeks
    ovp Naam van het online-mediaplatform waarmee inhoud wordt gedistribueerd Nee Lege tekenreeks
    appVersion Versie van de mediaspeler-app/SDK Nee Lege tekenreeks
    playerName Naam van de mediaspeler in gebruik, d.w.z. "AVPlayer", "HTML5 Player", "My Custom Player" Nee Lege tekenreeks
    ssl Geeft aan of aanroepen moeten worden uitgevoerd via HTTPS Nee false
    debugLogging Geeft aan of foutopsporingslogbestand is ingeschakeld Nee false

  2. Voer MediaHeartbeatDelegate uit.

    table 0-row-3 1-row-3 2-row-3 3-align-center 7-align-center 11-align-center
    Naam van methode Beschrijving Vereist
    getQoSObject() Retourneert de MediaObject -instantie die de huidige QoS-informatie bevat. Deze methode wordt meerdere keren aangeroepen tijdens een afspeelsessie. De implementatie van de speler moet altijd de recentst beschikbare gegevens terugkeren QoS. Ja
    getCurrentPlaybackTime() Retourneert de huidige positie van de afspeelkop.
    Voor het bijhouden van VOD wordt de waarde opgegeven in seconden vanaf het begin van het media-item.
    Als de speler voor live streaming geen informatie geeft over de duur van de inhoud, kan de waarde worden opgegeven als het aantal seconden sinds middernacht UTC van die dag.
    Opmerking: wanneer u voortgangsmarkeringen gebruikt, is de duur van de inhoud vereist en moet de afspeelkop worden bijgewerkt tot het aantal seconden vanaf het begin van het media-item, te beginnen met 0.    		 Ja
    note tip
    TIP
    Het object Quality of Service (QoS) is optioneel. Als QoS-gegevens beschikbaar zijn voor uw speler en u wilt die gegevens bijhouden, zijn de volgende variabelen vereist:
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center
    Naam variabele Beschrijving Vereist
    bitrate De bitsnelheid van media in bits per seconde. Ja
    startupTime De opstarttijd van media in milliseconden. Ja
    fps De frames die per seconde worden weergegeven. Ja
    droppedFrames Het aantal gedropte frames tot nu toe. Ja

  3. Maak de MediaHeartbeat -instantie.

    Gebruik MediaHertbeatConfig en MediaHertbeatDelegate om de instantie MediaHeartbeat te maken.

    note important
    IMPORTANT
    Zorg ervoor dat uw MediaHeartbeat -instantie toegankelijk is en pas aan het einde van de sessie wordt gedealiteerd. Deze instantie wordt gebruikt voor alle volgende gebeurtenissen voor het bijhouden van media.
    note tip
    TIP
    MediaHeartbeat vereist een instantie van AppMeasurement om aanroepen naar Adobe Analytics te verzenden.

  4. Combineer alle stukken.

    De volgende voorbeeldcode gebruikt onze JavaScript 2.x SDK voor een HTML5 videospeler:

    code language-javascript 
    // Create local references to the heartbeat classes
var MediaHeartbeat = ADB.va.MediaHeartbeat;
var MediaHeartbeatConfig = ADB.va.MediaHeartbeatConfig;
var MediaHeartbeatDelegate = ADB.va.MediaHeartbeatDelegate;

//Media Heartbeat Config
var mediaConfig = new MediaHeartbeatConfig();
mediaConfig.trackingServer = "[your_namespace].hb.omtrdc.net";
mediaConfig.playerName = "HTML5 Basic";
mediaConfig.channel = "Video Channel";
mediaConfig.debugLogging = true;
mediaConfig.appVersion = "2.0";
mediaConfig.ssl = false;
mediaConfig.ovp = "";

// Media Heartbeat Delegate
var mediaDelegate = new MediaHeartbeatDelegate();

// Set mediaDelegate CurrentPlaybackTime
mediaDelegate.getCurrentPlaybackTime = function() {
    return video.currentTime;
};

// Set mediaDelegate QoSObject - OPTIONAL
mediaDelegate.getQoSObject = function() {
    return MediaHeartbeat.createQoSObject(video.bitrate,
                                          video.startuptime,
                                          video.fps,
                                          video.droppedframes);
}
// Create mediaHeartbeat instance
this.mediaHeartbeat =
  new MediaHeartbeat(mediaDelegate, mediaConfig, appMeasurementInstance);

Valideren validate

De volgende implementaties van de Analytics van media produceren twee soorten het volgen vraag:

  • De vraag van de media en van het begin van de advertentie wordt verzonden rechtstreeks naar de server van Adobe Analytics (AppMeasurement).

  • De vraag van de hartslag wordt verzonden naar de Media Analytics (hartslagen) volgende server, daar verwerkt, en tot de server van Adobe Analytics overgegaan.

  • Adobe Analytics (AppMeasurement) server
    Voor meer informatie over het volgen van serveropties, zie correct de variabelen trackingServer en trackingServerSecure bevolken.

    note important
    IMPORTANT
    Een RDC-trackingserver of CNAME die een RDC-server oplost, is vereist voor de service Bezoeker-id van Experience Cloud.

    De analytics tracking-server moet eindigen in ".sc.omtrdc.net" of een CNAME zijn.

  • ​ Media Analytics (Heartbeats)-server
    Dit heeft altijd het formaat "[your_namespace].hb.omtrdc.net". De waarde van "[your_namespace]"specificeert uw bedrijf, en door Adobe verstrekt.

Mediatracering werkt op alle platformen hetzelfde, zowel op het bureaublad als op mobiele apparaten. Audio bijhouden werkt momenteel op mobiele platforms. Voor alle volgende vraag zijn er een paar zeer belangrijke universele variabelen die moeten worden bevestigd:

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