應用信息集成
這個實現指南涵蓋應用消息代碼注意事項和相應的代碼片段。當我們提供樣本集成代碼,您將需要添加邏輯處理和顯示觸發消息所需的UI。
因為您的代碼將是唯一的應用程序,您不需要處理所有情況列出如果不是有關你的用例。例如,如果你不使用延遲顯示應用程序的消息,你不會需要實現邏輯和邊界情況。
SDK要求
應用內隻會將消息發送到Roku設備運行的最小支持SDK版本:
應用程序消息設置
處理應用程序的消息,您可以添加一個觀察者BrazeTask.BrazeInAppMessage
:
1
m.BrazeTask。observeField (“BrazeInAppMessage”、“onInAppMessageReceived”)
然後在你的處理程序,你可以訪問應用內最高的消息,你的活動引發了:
1 2 3 4
in_app_message = m.BrazeTask子onInAppMessageReceived ()。BrazeInAppMessage……終止子
應用程序消息字段
以下列表的字段需要處理您的應用程序消息:
字段 | 描述 |
---|---|
按鈕 |
列表按鈕(可以是一個空的列表)。 |
click_action |
“URI” 或“沒有” 。使用此字段指示應用程序消息是否應該開放一個URI當點擊鏈接或關閉消息。當沒有按鈕,當用戶單擊“OK”這應該發生時顯示應用程序消息。 |
dismiss_type |
“AUTO_DISMISS” 或“刷” 。使用此字段指示您的應用程序消息是否會自動解散或者需要刷卡駁回。 |
display_delay |
多長時間(秒)等到顯示應用程序消息。 |
持續時間 |
多長時間(單位為毫秒)的信息應該顯示什麼時候dismiss_type 被設置為“AUTO_DISMISS” 。 |
臨時演員 |
鍵值對。 |
頭 |
標題文本。 |
id |
ID用於日誌的印象或點擊。 |
image_url |
應用程序消息圖像URL。 |
消息 |
消息正文文本。 |
uri |
基於URI的用戶將被發送到你click_action 。這個字段必須包含在click_action 是“URI” 。 |
造型領域
也有各種樣式的字段,你可以選擇使用指示板:
字段 | 描述 |
---|---|
bg_color |
背景顏色。 |
close_button_color |
關閉按鈕的顏色。 |
frame_color |
背景的顏色屏幕疊加。 |
header_text_color |
標題文本顏色。 |
message_text_color |
消息文本顏色。 |
text_align |
“開始”、“中心”或“結束”。你選中的文本對齊方式。 |
或者,您可以實現應用程序消息和風格在Roku應用程序使用一個標準的麵板:
按鈕字段
字段 | 描述 |
---|---|
click_action |
“URI” 或“沒有” 。使用此字段指示應用程序消息是否應該開放一個URI當點擊鏈接或關閉消息。 |
id |
按鈕本身的ID值。 |
文本 |
按鈕上的文字顯示。 |
uri |
基於URI的用戶將被發送到你click_action 。這個字段必須包含在click_action 是“URI” 。 |
處理交互
您需要確保某些功能來處理分析呼籲你的活動。
當顯示一個消息
顯示或消息時,日誌一個印象:
1
LogInAppMessageImpression (in_app_message。id、brazetask)
當用戶點擊一個信息
一旦用戶點擊消息,日誌點擊,然後處理in_app_message.click_action
:
1
LogInAppMessageClick (in_app_message。id、brazetask)
當用戶點擊一個按鈕
如果用戶點擊一個按鈕時,日誌按鈕單擊,然後處理inappmessage.buttons .click_action(選擇)
:
1
LogInAppMessageButtonClick (inappmessage。id, inappmessage.buttons(選擇)。id、brazetask)
處理後應用消息
處理一個應用消息後,應該明確的領域:
1
m.BrazeTask。釺InAppMessage = invalid