Documentatie Analytics Handleiding voor Streaming Media-services

Legacy 2.x Streaming Media SDK Setup - Overzicht setup-overview

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

Gebruiker
Beheerder
Ontwikkelaar

De instructies in deze sectie zijn op erfenis 2.x Media SDKs van toepassing.

Voor informatie over het uitvoeren van een versie 1.x van Media SDK, zie de 1.x Documentatie van Media SDK.
Voor integrators Primetime, zie de Documentatie van SDK van Media Primetime.

IMPORTANT

Met het einde van de ondersteuning voor versie 4 Mobile SDK's op 31 augustus 2021 beëindigt Adobe ook de ondersteuning voor de Media Analytics SDK's voor iOS en Android. Voor extra informatie, zie Analytics SDK End-of-Support FAQs .

Ondersteuning voor minimale platformversie minimum-platform-version

In de volgende tabel worden de minimale platformversies beschreven die worden ondersteund voor elke SDK, vanaf 19 februari 2019.

OS/Browser

Minimumversie vereist

iOS

iOS 6+

Android

Android 5.0+ - Lollipop

Chrome

v22+

Mozilla

v27+

Safari

v7+

v11+

Algemene uitvoeringsrichtsnoeren general-implementation-guidelines

Er zijn drie belangrijke SDK-componenten die betrokken zijn bij mediatracering:

Configuratie van de Hartslag van media - config bevat de basismontages voor het melden.
De Afgevaardigde van het Hoogtepunt van media - de afgevaardigde controleert playbacktijd en het voorwerp QoS.
Mediahartslag - De primaire bibliotheek met leden en methoden.

Voer de volgende stappen uit voor de implementatie:

Maak een MediaHeartbeatConfig -instantie en stel de configuratieparameterwaarden 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, dus "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

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

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.

Combineer alle stukken.

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

code language-javascript

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);

// 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 het 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
Voor de Experience Cloud Visitor ID-service is een RDC-trackingserver of CNAME vereist die een RDC-server oplost.

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: