Roku Basic Integration

필수 라이브러리 파일 포함

  1. BranchSdkLibrary.brs
  2. BranchSdkTask.xml
  3. BranchSdkTask.brs

input 폴더에서 다음과 같은 필수 Branch SDK 파일을 찾을 수 있습니다.

├── components
│   └── tasks
│       ├── BranchSdkTask.brs
│       └── BranchSdkTask.xml
└── source
    └── libs
        └── BranchSdkLibrary.brs
  1. 애플리케이션의 source 폴더에 libs 라는 새 폴더를 만듭니다.
  2. Branch 저장소의 BranchSdkLibrary.brs 파일을 프로젝트의 새 libs 폴더로 복사합니다.
  3. components 폴더에 tasks 라는 새 폴더를 만듭니다.
    신청
  4. BranchSdkTask.xmlBranchSdkTask.brs 파일을 프로젝트의 새 파일에 복사합니다.
    tasks 폴더

Configure Branch

  1. SceneGraph 애플리케이션의 진입점 역할을하는 프로젝트의 Main.brs 파일을 엽니다.
  2. Inside the sub Main(), or below where screen is declared, add the following line: ConfigureBranchSdk(screen) (example here)
  3. 다음으로 아래에 새 하위를 정의하겠습니다. Main()
sub ConfigureBranchSdk(screen as dynamic)
    options = {}
    ' For future use for advance features in Branch SDK'
    options.branchKey = "key_live_TODO_YOUR_BRANCH_KEY_HERE"
    options.logLevel = BranchSdkConstants().LOG_LEVEL.DEBUG
    options.environment = BranchSdkConstants().ENVIRONMENT.PRODUCTION

    ' Set Branch SDK configuration parameter as required
    screen.getGlobalNode().addFields({branchSdkConfig: options})
end sub

Then be sure to replace key_live_TODO_YOUR_BRANCH_KEY_HERE with your Branch Key from the Branch Dashboard.

You can see an example of this code here.

Initialize Branch

  1. Scene 을 확장하는 파일을 엽니다. MainScene.xml 파일이라고 가정 해 보겠습니다.
  2. 새 스크립트 파일 경로 추가 BranchSdkLibrary.brs
<script type="text/brightscript" uri="pkg:/source/libs/BranchSdkLibrary.brs"/>

You can see an example of this code here.

  1. MainScene.brs 파일을 열고 Branch SDK 라이브러리의 인스턴스를 만듭니다.
m.branchSdkObj = CreateBranchSdkForSceneGraphApp()

You can see an example of this code here.

  1. 이제 다음과 같이 InitSession 인 첫 번째 API 호출을 수행하십시오.
m.branchSdkObj.initSession(m.global.launchArgs, "OnInitSessionCallbackFunc")

You can see an example of this code here. An example of the callback function can be found here

그게 다입니다! 이제 Roku 세션 수 트래킹이 작동해야 하며 Branch 대시보드에서 Roku 설치 및 오픈이 트래킹되는 것을 볼 수 있습니다!

딥링킹 및 어트리뷰션

링크가 Roku 앱이 응답하도록 트리거할 수있는 두 가지 기본 방법이 있습니다. 다음은 테스트를 위해 수정하고 사용할 수 있는 이러한 링크의 형식을 나타내는 컬입니다.

  1. /launch/{channel}
curl -d '' 'http://ROKU_LOCAL_IP:8060/launch/dev?contentId=1234&mediaType=movie'
  1. /input
curl -d '' 'http://ROKU_LOCAL_IP:8060/input?contentId=1234&mediaType=movie'

여기서 ROKU_LOCAL_IP 는 Roku의 로컬 IP 주소입니다.

두 경우 모두 데이터 (contentId, mediaType 및 기타 쿼리 파라미터)를 Branch로 전송하세요.

m.branchSdkObj.handleInput(data, "OnHandleInputEventCallbackFunc")

Then you can receive deep link data back from Branch's servers, similar to any other Branch SDK. You can see an example of this code here.

📘

Important note

For proper deep linking, please make sure that you are using a correct deeplink format, e.g.: contentId=1234&mediaType=movie

Branch 팀원과 딥링크 및 어트리뷰션에 대한 사용 사례를 논의하십시오.


이 페이지가 도움이 되었습니까?