설명서AnalyticsMedia Analytics 안내서

Roku용 Mobile SDK v2.x 설정 set-up-roku

Last update: Wed Jan 11 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • User
  • Admin
  • Developer

사전 요구 사항 roku-prerequisites

  • 미디어 분석에 대한 유효한 구성 매개 변수 얻기

    이러한 매개 변수는 미디어 분석 계정을 설정한 후에 Adobe 담당자로부터 얻을 수 있습니다.

  • 미디어 플레이어에서 다음 API 포함

    • 플레이어 이벤트에 가입할 API - Media SDK를 사용하려면 이벤트가 플레이어에서 발생할 때 단순 API 세트를 호출해야 합니다.
    • 플레이어 정보를 제공하는 API - 이 정보에는 미디어 이름 및 재생 헤드 위치와 같은 세부 정보가 포함됩니다.

Experience Cloud 솔루션용 Roku SDK 2.x를 사용하여 BrightScript로 작성된 Roku 애플리케이션을 측정하고, 대상자를 통해 대상 데이터를 사용 및 수집하고, 비디오 이벤트를 통해 비디오 참여를 측정할 수 있습니다.

모바일 라이브러리 / SDK 구현

  1. 다운로드한 Roku 라이브러리를 프로젝트에 추가합니다.

    1. 다음 소프트웨어 구성 요소로 AdobeMobileLibrary-2.*-Roku.zip 다운로드 파일은 구성됩니다.

      • adbmobile.brs: 이 라이브러리 파일은 Roku 앱 소스 폴더에 포함됩니다.

      • ADBMobileConfig.json: 앱에 맞게 사용자 지정된 SDK 구성 파일입니다.

    2. 라이브러리 파일 및 json 구성 파일을 프로젝트 소스에 추가합니다.

      Adobe Mobile을 구성하는 데 사용되는 JSON에는 mediaHeartbeat라는 미디어 분석에 대한 배타 키가 있습니다. 여기에 미디어 분석에 대한 구성 매개 변수가 속해 있습니다.

      note tip
      TIP
      샘플 ADBMobileConfig JSON 파일은 패키지와 함께 제공됩니다. 설정에 대해서는 Adobe 담당자에게 문의하십시오.

      예:

      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
      구성 매개 변수 설명
      server 백엔드에 대한 추적 엔드포인트의 URL을 나타내는 문자열입니다.
      publisher 콘텐츠 게시자 고유 식별자를 나타내는 문자열입니다.
      channel 콘텐츠 배포 채널의 이름을 나타내는 문자열입니다.
      ssl 추적 호출에 SSL을 사용해야 하는지 여부를 나타내는 부울입니다.
      ovp 비디오 플레이어 공급자의 이름을 나타내는 문자열입니다.
      sdkversion 앱/SDK의 현재 버전을 나타내는 문자열입니다.
      playerName 플레이어의 이름을 나타내는 문자열입니다.
      note important
      IMPORTANT
      mediaHeartbeat가 잘못 구성된 경우 미디어 모듈(VHL)이 오류 상태에 들어가고 추적 호출 전송을 중단합니다.

  2. Experience Cloud 방문자 ID를 구성합니다.

    Experience Cloud 방문자 ID 서비스는 Experience Cloud 솔루션에 관계없이 유니버설 방문자 ID를 제공합니다. 방문자 ID 서비스는 비디오 이벤트 및 다른 Marketing Cloud 통합에 필요합니다.

    ADBMobileConfig 구성에 marketingCloud 조직 ID가 포함되어 있는지 확인합니다.

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

    Experience Cloud 조직 ID는 Adobe Marketing Cloud에서 각 고객 회사를 고유하게 식별하며, 016D5C175213CCA80A490D05@AdobeOrg 값과 비슷하게 표시됩니다.

    note important
    IMPORTANT
    @AdobeOrg를 포함해야 합니다.

    구성이 완료되면 Experience Cloud 방문자 ID가 생성되고, 모든 히트 수에 포함됩니다. 각 히트 수와 함께 custom 및 automatically-generated 같은 다른 방문자 ID는 계속 전송됩니다.

    Experience Cloud 방문자 ID 서비스 메서드

    note tip
    TIP
    Experience Cloud 방문자 ID 메서드는 앞에 visitor가 붙습니다.
    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    메서드 설명
    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에서 RIDA(Roku ID for Advertising)를 설정하는 데 사용됩니다. 예:

    ADBMobile().setAdvertisingIdentifier(
      "<sample_roku_identifier_for_advertising>")


    Roku SDK getRIDA() API를 사용하여 RIDA(Roku ID for Advertising)를 가져옵니다.
    getAllIdentifiers Analytics, 방문자, Audience Manager 및 사용자 지정 식별자를 포함하여 SDK에 저장된 모든 식별자 목록을 반환합니다.

    identifiers = ADBMobile().getAllIdentifiers()

    추가 공개 API

    DebugLogging

    table 0-row-2 1-row-2 2-row-2
    메서드 설명
    setDebugLogging SDK에 대한 디버그 로깅을 활성화하거나 비활성화하는 데 사용됩니다.

    ADBMobile().setDebugLogging(true)
    getDebugLogging 디버그 로깅이 활성화된 경우 true를 반환합니다.

    isDebugLoggingEnabled = ADBMobile().getDebugLogging()

    PrivacyStatus

    table 0-row-2 1-row-2 2-row-2
    상수 설명
    PRIVACY_STATUS_OPT_IN 옵트인을 위해 setPrivacyStatus를 호출하는 동안 전달될 상수입니다.

    optInString = ADBMobile().PRIVACY_STATUS_OPT_IN
    PRIVACY_STATUS_OPT_OUT 옵트인을 위해 setPrivacyStatus를 호출하는 동안 전달될 상수입니다.

    optOutString = ADBMobile().PRIVACY_STATUS_OPT_OUT
    table 0-row-2 1-row-2 2-row-2
    메서드 설명
    setPrivacyStatus SDK의 개인 정보 상태를 설정합니다.

    ADBMobile().setPrivacyStatus(ADBMobile().PRIVACY_STATUS_OPT_IN)
    getPrivacyStatus SDK에 설정된 현재 개인 정보 상태를 가져옵니다.

    privacyStatus = ADBMobile().getPrivacyStatus()
    note important
    IMPORTANT
    SDK가 ping을 제대로 전송하도록 250ms마다 processMessages 및 processMediaMessages 함수를 호출해야 합니다.
    table 0-row-2 1-row-2 2-row-2
    메서드 설명
    processMessages 처리할 SDK에 Analytics 이벤트를 전달하는 일을 담당합니다.

    ADBMobile().processMessages()
    processMediaMessages 처리할 SDK에 미디어 이벤트를 전달하는 일을 담당합니다.

    ADBMobile().processMediaMessages()
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb