Overzicht van setup

De volgende instructies zijn van toepassing op 2.x Media SDKs. Als u een 1.x-versie van de Media SDK implementeert, raadpleegt u de 1.x Media SDK Documentatie. Voor Primetime-integrators raadpleegt u Documentatie bij primaire media-SDK hieronder.

BELANGRIJK

Aan 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. Zie voor meer informatie Veelgestelde vragen over einde van ondersteuning voor Media Analytics SDK.

Ondersteuning voor minimale versie van Platform

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
Chroom v22+
Mozilla v27+
Safari v7+
IE v11+

Algemene uitvoeringsrichtsnoeren

Er zijn drie belangrijke componenten van SDK betrokken bij media het volgen:

  • 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:

  1. Een MediaHeartbeatConfig -instantie en stel uw configuratieparameterwaarden in.

    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.

    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 als het aantal seconden vanaf het begin van het media-item, te beginnen met 0.
    Ja
    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:

    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.

    BELANGRIJK

    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.

    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:

    // 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

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

  • Aanroepen voor media en advertenties worden rechtstreeks naar de Adobe Analytics-server (AppMeasurement) verzonden.

  • 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.

    BELANGRIJK

    Voor de Experience Cloud Bezoeker-id-service is een RDC-trackingserver of CNAME vereist die een RDC-server oplost.

    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 opgegeven door Adobe.

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:

SDK 1.x-documentatie

Video Analytics 1.x SDKs Ontwikkelaarshulplijnen (alleen PDF)
Android Configureren voor Android
AppleTV Configureren voor AppleTV
Chromecast Configureren voor Chromecast
iOS Configureren voor iOS
JavaScript Configureren voor JavaScript
Primetime
TVML Configureren voor TVML

Documentatie bij primaire media-SDK

Op deze pagina