DocumentatieAnalyticsHandleiding voor Streaming Media-services

Mobiele SDK v2.x instellen voor Roku set-up-roku

Last update: Tue Aug 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Gebruiker
  • Beheerder
  • Ontwikkelaar

Vereisten roku-prerequisites

  • verkrijg geldige configuratieparameters voor het stromen van Adobe media diensten

    Deze parameters kunt u verkrijgen van een Adobe-medewerker nadat u uw account hebt ingesteld voor de invoegtoepassing voor Adobe Streaming Media Collection of de Adobe Analytics for Streaming Media Add-on.

  • omvat volgende APIs in uw media speler

    • API om aan spelergebeurtenissen in te tekenen - de Media SDK vereist dat u een reeks eenvoudige APIs roept wanneer de gebeurtenissen in uw speler voorkomen.
    • API die spelerinformatie verstrekt - Deze informatie omvat details zoals de media naam en de positie van het spelhoofd.

Met Roku SDK 2.x for Experience Cloud Solutions kunt u Roku-toepassingen die in BrightScript zijn geschreven, gebruiken en gegevens van het publiek verzamelen via publieksbeheer en de betrokkenheid van video's meten via videogebeurtenissen.

Implementatie van mobiele bibliotheek / SDK

  1. Voeg uw gedownloadebibliotheek van Roku aan uw project toe.

    1. Het AdobeMobileLibrary-2.*-Roku.zip -downloadbestand bestaat uit de volgende softwarecomponenten:

      • adbmobile.brs: Dit bibliotheekbestand wordt opgenomen in de bronmap van de Roku-app.

      • ADBMobileConfig.json: Dit SDK-configuratiebestand wordt aangepast voor uw app.

    2. Voeg het bibliotheekbestand en het JSON-configuratiebestand toe aan uw projectbron.

      De JSON die wordt gebruikt om Adobe Mobile te configureren, heeft een exclusieve sleutel voor mediaverlichtingen met de naam mediaHeartbeat . Dit is waar de configuratieparameters voor media analyses behoren.

      note tip
      TIP
      Het pakket bevat een voorbeeld van een JSON-bestand van het type ADBMobileConfig . Neem voor de instellingen contact op met uw Adobe-vertegenwoordigers.

      Bijvoorbeeld:

      code language-none 
      {
  "version":"1.0",
  "analytics":{
    "rsids":"",
    "server":"",
    "charset":"UTF-8",
    "ssl":true,
    "offlineEnabled":false,
    "lifecycleTimeout":30,
    "batchLimit":50,
    "privacyDefault":"optedin",
    "poi":[ ]
},
"marketingCloud":{
  "org":""
},
"target":{
  "clientCode":"",
  "timeout":5
},
"audienceManager":{
  "server":""
},
"acquisition":{
  "server":"example.com",
  "appid":"sample-app-id"
},

"mediaHeartbeat":{
   "server":"example.com",
   "publisher":"sample-publisher",
   "channel":"sample-channel",
   "ssl":true,
   "ovp":"sample-ovp",
   "sdkVersion":"sample-sdk",
   "playerName":"roku"
   }
}
      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
      Configuratieparameter Beschrijving
      server Tekenreeks die de URL van het volgende eindpunt op de achtergrond vertegenwoordigt.
      publisher String that represents the content publisher unique identifier.
      channel Tekenreeks die de naam van het distributiekanaal van de inhoud vertegenwoordigt.
      ssl Boolean die aangeeft of SSL moet worden gebruikt voor het bijhouden van aanroepen.
      ovp Tekenreeks die de naam van de videospelerprovider vertegenwoordigt.
      sdkversion Tekenreeks die de huidige versie van de app/SDK vertegenwoordigt.
      playerName Tekenreeks die de naam van de speler vertegenwoordigt.
      note important
      IMPORTANT
      Als mediaHeartbeat verkeerd wordt gevormd, gaat de media module (VHL) een foutenstaat in en zal ophouden verzendend volgende vraag.

  2. Experience Cloud-bezoeker-id configureren.

    De Experience Cloud Visitor ID-service biedt een universele bezoeker-id voor alle Experience Cloud-oplossingen. De service voor bezoekers-id is vereist voor videogebeurtenissen en andere Marketing Cloud-integratie.

    Controleer of de ADBMobileConfig config uw marketingCloud -organisatie-id bevat.

    code language-none 
    "marketingCloud": {
    "org": "YOUR-MCORG-ID"
}

    Experience Cloud-organisatie-id's identificeren elk clientbedrijf op unieke wijze in de Adobe Marketing Cloud en lijken op de volgende waarde: 016D5C175213CCA80A490D05@AdobeOrg .

    note important
    IMPORTANT
    Zorg ervoor dat u @AdobeOrg opneemt.

    Nadat de configuratie volledig is, wordt een identiteitskaart van de Bezoeker van Experience Cloud geproduceerd en inbegrepen op alle treffers. Andere bezoeker-id's, zoals custom en automatically-generated , worden bij elke treffer verzonden.

    Methoden van de Dienst van identiteitskaart van de Bezoeker van Experience Cloud

    note tip
    TIP
    De methoden voor Experience Cloud Visitor ID worden vooraf ingesteld door visitor .
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Methode Beschrijving
    visitorMarketingCloudID Haalt de Experience Cloud-bezoeker-id op van de bezoeker-id-service.

    ADBMobile().visitorMarketingCloudID()
    visitorSyncIdentifiers Met de Experience Cloud-bezoeker-id kunt u aanvullende klant-id's instellen die aan elke bezoeker kunnen worden gekoppeld. De bezoeker-API accepteert meerdere klant-id's voor dezelfde bezoeker en een id voor het klanttype om het bereik van de verschillende klant-id's te scheiden. Deze methode komt overeen met setCustomerIDs . Bijvoorbeeld:

    identifiers={}
    identifiers["idType"]="idValue"
    ADBMobile().visitorSyncIdentifiers(identifiers)
    setAdvertisingIdentifier Wordt gebruikt om de Roku-id voor Advertising (RIDA) in te stellen op de SDK. Bijvoorbeeld:

    ADBMobile().setAdvertisingIdentifier(
      "<sample_roku_identifier_for_advertising>")


    krijgt identiteitskaart van Roku voor Advertising (RIDA) gebruikend Roku SDK getRIDA ()API.
    getAllIdentifiers Retourneert een lijst met alle id's die door de SDK zijn opgeslagen, inclusief Analytics, Visitor, Audience Manager en aangepaste id's.

    identifiers = ADBMobile().getAllIdentifiers()

    Extra Openbare APIs

    DebugLogging

    table 0-row-2 1-row-2 2-row-2
    Methode Beschrijving
    setDebugLogging Wordt gebruikt om foutopsporingslogbestanden voor de SDK in of uit te schakelen.

    ADBMobile().setDebugLogging(true)
    getDebugLogging Retourneert true als de logboekregistratie voor foutopsporing is ingeschakeld.

    isDebugLoggingEnabled = ADBMobile().getDebugLogging()

    PrivacyStatus

    table 0-row-2 1-row-2 2-row-2
    Constante Beschrijving
    PRIVACY_STATUS_OPT_IN Constante die moet worden doorgegeven tijdens het aanroepen van setPrivacyStatus voor aanmelden.

    optInString = ADBMobile().PRIVACY_STATUS_OPT_IN
    PRIVACY_STATUS_OPT_OUT Constante die moet worden doorgegeven terwijl setPrivacyStatus wordt aangeroepen om te weigeren.

    optOutString = ADBMobile().PRIVACY_STATUS_OPT_OUT
    table 0-row-2 1-row-2 2-row-2
    Methode Beschrijving
    setPrivacyStatus Stelt de privacystatus in op de SDK.

    ADBMobile().setPrivacyStatus(ADBMobile().PRIVACY_STATUS_OPT_IN)
    getPrivacyStatus Haalt de huidige privacystatus op die op de SDK is ingesteld.

    privacyStatus = ADBMobile().getPrivacyStatus()
    note important
    IMPORTANT
    Zorg ervoor dat u de processMessages - en processMediaMessages -functie om de 250 ms aanroept in de hoofdgebeurtenislus om ervoor te zorgen dat de SDK de pingelt correct verzendt.
    table 0-row-2 1-row-2 2-row-2
    Methode Beschrijving
    processMessages Verantwoordelijk om de gebeurtenissen van de Analytics tot SDK over te gaan om worden behandeld.

    ADBMobile().processMessages()
    processMediaMessages Verantwoordelijk om de Media-gebeurtenissen door te geven aan de SDK die moet worden afgehandeld.

    ADBMobile().processMediaMessages()
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb