Documentatie Analytics Handleiding voor het streamen van media

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

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

Onderwerpen:

Gemaakt voor:

Gebruiker
Beheerder
Ontwikkelaar

Vereisten roku-prerequisites

Geldige configuratieparameters verkrijgen voor de invoegtoepassing voor het streamen van media-collectie

Deze parameters kunnen van een vertegenwoordiger van de Adobe worden verkregen nadat u opstelling uw Adobe het Stromen toe:voegen-op rekening van de Inzameling van Media.
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, gebruiken en gegevens van het publiek verzamelen via het beheer van het publiek en de betrokkenheid van video meten via videogebeurtenissen.

Implementatie van mobiele bibliotheek / SDK

Voeg uw gedownload Bibliotheek uitvoeren naar uw project.

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.

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

JSON die wordt gebruikt om Adobe Mobile te vormen heeft een exclusieve sleutel voor media analyses genoemd mediaHeartbeat. Dit is waar de configuratieparameters voor 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.

Bijvoorbeeld:

code language-none

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" } }

{
  "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
Indien `mediaHeartbeat` wordt verkeerd gevormd, gaat de media module (VHL) een foutenstaat in en zal ophouden verzendend volgende vraag.

Vorm identiteitskaart van de Bezoeker van het Experience Cloud.

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

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

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

Identiteitskaart van de organisatie van het Experience Cloud identificeert uniek elk cliëntbedrijf in Adobe Marketing Cloud en lijkt gelijkaardig aan de volgende waarde: 016D5C175213CCA80A490D05@AdobeOrg.

note important
IMPORTANT
Zorg ervoor dat u `@AdobeOrg`.

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

De Methoden van de Dienst van de Bezoeker van het Experience Cloud ID

note tip
TIP
De methodes van identiteitskaart van de Bezoeker van het Experience Cloud 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 bezoeker-id van het Experience Cloud op bij de bezoeker-id-service. `ADBMobile().visitorMarketingCloudID()`
`visitorSyncIdentifiers`	Met de Experience Cloud Bezoeker-id kunt u extra 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>")` De Roku-id voor Advertising (RIDA) ophalen 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 `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