DocumentatieAnalyticsGids voor Media Analytics

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

Last update: Fri Nov 11 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Gemaakt voor:

  • User
  • Admin
  • Developer

Vereisten roku-prerequisites

  • Geldige configuratieparameters verkrijgen voor Media Analytics

    Deze parameters kunt u verkrijgen van een Adobe-medewerker nadat u uw account voor mediacontrole hebt ingesteld.

  • De volgende API's opnemen in uw mediaspeler

    • Een API die zich moet abonneren op spelergebeurtenissen - De SDK van Media vereist dat u een set eenvoudige API's oproept wanneer gebeurtenissen in de speler plaatsvinden.
    • Een API die spelerinformatie biedt - Deze informatie bevat details zoals de medianaam en de positie van de afspeelkop.

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

Implementatie van mobiele bibliotheek / SDK

  1. Voeg uw gedownload Bibliotheek uitvoeren naar uw project.

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

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

      • ADBMobileConfig.json: Dit SDK-configuratiebestand is 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 mediaveralytics die mediaHeartbeat. Dit is waar de configuratieparameters voor de media analyses behoren.

      note tip
      TIP
      Een monster ADBMobileConfig Het JSON-bestand wordt bij het pakket geleverd. Neem voor de instellingen contact op met de 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 Tekenreeks die de unieke id van de uitgever van de inhoud vertegenwoordigt.
      channel Tekenreeks die de naam van het distributiekanaal van de inhoud vertegenwoordigt.
      ssl Booleaanse waarde 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
      Indien mediaHeartbeat wordt verkeerd gevormd, gaat de media module (VHL) een foutenstaat in en zal ophouden verzendend volgende vraag.

  2. Experience Cloud-bezoeker-id configureren.

    De dienst van identiteitskaart van de Bezoeker van Experience Cloud verstrekt universele Bezoeker identiteitskaart over de oplossingen van Experience Cloud. De service voor bezoekers-id is vereist voor videogebeurtenissen en andere Marketing Cloud-integratie.

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

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

    De organisatie-id's van Experience Cloud identificeren uniek elk clientbedrijf in de Adobe Marketing Cloud en lijken ongeveer op de volgende waarde te lijken: 016D5C175213CCA80A490D05@AdobeOrg.

    note important
    IMPORTANT
    Zorg ervoor dat u @AdobeOrg.

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

    Service-methoden voor Experience Cloud-bezoeker-id

    note tip
    TIP
    De methoden voor de Experience Cloud-bezoeker-id worden vooraf bepaald met 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 advertentie (RIDA) in te stellen op de SDK. Bijvoorbeeld:

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


    Haal de Roku-id voor adverteren (RIDA) op met de 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()

    Aanvullende openbare API's

    DebugLogging

    table 0-row-2 1-row-2 2-row-2
    Methode Beschrijving
    setDebugLogging Gebruikt om te toelaten of onbruikbaar te maken zuivert registreren voor SDK.

    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 Hiermee stelt u de privacystatus van de SDK in.

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

    privacyStatus = ADBMobile().getPrivacyStatus()
    note important
    IMPORTANT
    Zorg ervoor dat u roept processMessages en processMediaMessages functie in de hoofdgebeurtenislijn om de 250 ms om ervoor te zorgen dat SDK pingelt behoorlijk 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 die moeten worden behandeld.

    ADBMobile().processMessages()
    processMediaMessages Verantwoordelijk om de gebeurtenissen van Media tot SDK over te gaan die moeten worden behandeld.

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