Adobe Mobile Services 提供的新使用者介面,將 Adobe Marketing Cloud 適用於行動應用程式的各項行動行銷功能整合在一起。Mobile 服務起初是提供 Adobe Analytics 和 Adobe Target 解決方案的應用程式分析和定位功能流暢整合。
如需詳細資訊,請參閱 Adobe Mobile Services 文件。
Experience Cloud 解決方案適用的 Roku SDK 2.x 可讓您測量在 BrightScript 中撰寫的 Roku 應用程式、透過對象管理利用和收集觀眾資料,以及透過視訊心率測量視訊參與。
將下載的 Roku 程式庫新增至專案。
AdobeMobileLibrary-2.*-Roku.zip
下載檔案包含下列軟體元件:
adbmobile.brs
:此程式庫檔案將會包含在您的 Roku 應用程式來源檔案夾中。
ADBMobileConfig.json
:此元件為根據您應用程式自訂的 SDK 設定檔案。
新增程式庫檔案和 JSON 設定檔案至您的專案來源。
用來設定 Adobe Mobile 的 JSON 有一個媒體心率專用的索引鍵,稱為 mediaHeartbeat
。其集結了多種媒體心率的設定參數。
套件會隨附 ADBMobileConfig
JSON 檔案範例。如需設定,請聯絡 Adobe 代表。
例如:
{
"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"
}
}
設定參數 | 說明 |
---|---|
server |
代表後端追蹤端點之 URL 的字串。 |
publisher |
代表內容發行者唯一識別碼的字串。 |
channel |
代表內容分送管道之名稱的字串。 |
ssl |
代表是否應使用 SSL 來追蹤呼叫的布林值。 |
ovp |
代表視訊播放器提供者之名稱的字串。 |
sdkversion |
代表應用程式/SDK 目前版本的字串。 |
playerName |
代表播放器名稱的字串。 |
如果 mediaHeartbeat
的設定不正確,媒體模組 (VHL) 會進入錯誤狀態並停止傳送追蹤呼叫。
設定 Experience Cloud 訪客 ID。
Experience Cloud 訪客 ID 服務提供跨 Experience Cloud 解決方案的通用訪客 ID。視訊心率和其他 Marketing Cloud 整合需要訪客 ID 服務。
確認您的 ADBMobileConfig
設定包含 marketingCloud
組織 ID。
"marketingCloud": {
"org": YOUR-MCORG-ID"
}
Experience Cloud 組織 ID 會唯一識別 Adobe Marketing Cloud 中的每一間客戶公司,並出現以下類似值:016D5C175213CCA80A490D05@AdobeOrg
。
一定要包含 @AdobeOrg
。
完成設定後,即會產生一個 Experience Cloud 訪客 ID,並包含在所有點撃中。其他訪客 ID (例如 custom
和 automatically-generated
ID) 會繼續在每次點撃時一併傳送。
Experience Cloud 訪客 ID 服務方法
Experience Cloud 訪客 ID 方法的前置詞為 visitor
。
方法 | 說明 |
---|---|
visitorMarketingCloudID |
從訪客 ID 服務中擷取 Experience Cloud 訪客 ID。 ADBMobile().visitorMarketingCloudID() |
visitorSyncIdentifiers |
透過 Experience Cloud 訪客 ID,您可以設定與每個訪客相關聯的額外客戶 ID。訪客 API 可接受同一名訪客具有多個客戶 ID,並透過客戶類型識別碼來區分不同客戶 ID 的範圍。此方法對應至 setCustomerIDs 。例如:identifiers={} identifiers["idType"]="idValue" ADBMobile().visitorSyncIdentifiers(identifiers) |
setAdvertisingIdentifier |
用來在 SDK 上設定適用於廣告的 Roku ID (RIDA)例如︰ADBMobile().setAdvertisingIdentifier( "<sample_roku_identifier_for_advertising>") 使用 Roku SDK getRIDA() API 取得適用於廣告的 Roku ID (RIDA)。 |
getAllIdentifiers |
傳回 SDK 儲存的所有識別碼清單,包括分析、訪客、Audience Manager 和客戶識別碼。identifiers = ADBMobile().getAllIdentifiers() |
其他公用 API
DebugLogging
方法 | 說明 |
---|---|
setDebugLogging |
用於啟用或停用 SDK 的偵錯記錄。ADBMobile().setDebugLogging(true) |
getDebugLogging |
如果啟用偵錯記錄,則傳回 True。isDebugLoggingEnabled = ADBMobile().getDebugLogging() |
PrivacyStatus
常數 | 說明 |
---|---|
PRIVACY_STATUS_OPT_IN |
呼叫 setPrivacyStatus 以選擇加入時要傳遞的常數。optInString = ADBMobile().PRIVACY_STATUS_OPT_IN |
PRIVACY_STATUS_OPT_OUT |
呼叫 setPrivacyStatus 以選擇退出時要傳遞的常數。optOutString = ADBMobile().PRIVACY_STATUS_OPT_OUT |
方法 | 說明 |
---|---|
setPrivacyStatus |
設定 SDK 上的隱私權狀態。 ADBMobile().setPrivacyStatus(ADBMobile().PRIVACY_STATUS_OPT_IN) |
getPrivacyStatus |
取得在 SDK 上設定的目前隱私權狀態。 privacyStatus = ADBMobile().getPrivacyStatus() |
確保您每 250 ms 呼叫主事件迴圈中的 processMessages
和 processMediaMessages
函數,以確保 SDK 傳出 Ping。
方法 | 說明 |
---|---|
processMessages |
負責傳遞分析事件至要處理的 SDK。 ADBMobile().processMessages() |
processMediaMessages |
負責傳遞媒體事件至要處理的 SDK。ADBMobile().processMediaMessages() |