Mobiele SDK v2.x instellen voor Roku set-up-roku
Vereisten roku-prerequisites
-
verkrijg geldige configuratieparameters voor de Streaming Invoegtoepassing van de Inzameling van Media
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.
-
omvat volgende APIs in uw media speler
- API om aan spelergebeurtenissen in te tekenen - SDK van Media 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 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 gedownloadebibliotheek van Roku aan uw project toe.
-
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 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 analyse genoemd
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 de Adobe.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.
-
-
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.
Controleer of de
ADBMobileConfig
config uwmarketingCloud
-organisatie-id bevat.code language-none "marketingCloud": { "org": "YOUR-MCORG-ID" }
ID's van organisaties van Experiencen Cloud identificeren elk clientbedrijf in de Adobe Marketing Cloud op unieke wijze 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 het Experience Cloud geproduceerd en inbegrepen op alle treffers. Andere bezoeker-id's, zoals
custom
enautomatically-generated
, worden bij elke treffer verzonden.Methoden van de Dienst van identiteitskaart van de Bezoeker van het Experience Cloud
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>")
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 is ingesteld op de SDK. privacyStatus = ADBMobile().getPrivacyStatus()
note important IMPORTANT Zorg ervoor dat u de functies processMessages
enprocessMediaMessages
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 die moeten worden behandeld. ADBMobile().processMessages()
processMediaMessages
Verantwoordelijk om de gebeurtenissen van Media tot SDK over te gaan die moeten worden behandeld. ADBMobile().processMediaMessages()