DocumentatieAnalyticsHandleiding voor het streamen van media

Verouderd - Overzicht van de installatie van Media SDK setup-overview

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

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

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

Algemene uitvoeringsrichtsnoeren general-implementation-guidelines

Er zijn drie belangrijke componenten SDK die in het volgen met de Streaming Invoegtoepassing van de Inzameling van Media worden gebruikt:

  • Configuratie van de mediaritmische hartslag: MediaHeartbeatConfig bevat de basisinstellingen voor rapportage.
  • Media Heartbeat Delegate—De MediaHeartbeatDelegate Bepaalt de afspeeltijd en het object QoS.
  • Media Heartbone—De MediaHeartbeat is de primaire bibliotheek met leden en methoden.

De SDK voor streaming media implementeren

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

  1. 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. Implementeer de MediaHeartbeatDelegate.

    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() Hiermee wordt het MediaObject instantie die de huidige informatie QoS 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.
    Wanneer de speler voor live streaming geen informatie over de duur van de inhoud geeft, kan de waarde worden opgegeven als het aantal seconden dat is verstreken sinds middernacht UTC van die dag.
    Opmerking: wanneer u voortgangsmarkeringen gebruikt, is de duur van de inhoud vereist en moet de afspeelkop worden bijgewerkt in 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 de MediaHertbeatConfig en MediaHertbeatDelegate om de MediaHeartbeat -instantie.

    note important
    IMPORTANT
    Zorg ervoor dat uw MediaHeartbeat -instantie is toegankelijk en wordt pas aan het einde van de sessie toegewezen. Deze instantie wordt gebruikt voor alle volgende gebeurtenissen voor het bijhouden van media.
    note tip
    TIP
    MediaHeartbeat vereist een instantie van AppMeasurement om oproepen 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-server (AppMeasurement)
    Voor meer informatie over het volgen van serveropties, zie De variabelen trackingServer en trackingServerSecure correct vullen.

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

    De analysetrackingserver moet eindigen op ".sc.omtrdc.net" of een CNAME zijn.

  • ​ Media Analytics (Heartbeats) server Dit heeft altijd de indeling "[your_namespace].hb.omtrdc.net". De waarde van "[your_namespace]" geeft uw bedrijf aan en wordt via 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