요청 매개 변수

분석 데이터

요청 키 필수 여부 시작 시기… 설명
analytics.trackingServer Y sessionStart Adobe Analytics 서버의 URL
analytics.reportSuite Y sessionStart Analytics 보고 데이터를 식별하는 ID
analytics.enableSSL N sessionStart SSL을 사용할 True 또는 False
analytics.visitorId N sessionStart Adobe 방문자 ID는 여러 Adobe 애플리케이션에서 사용할 수 있는 사용자 지정 ID입니다. 하트비트 visitorId는 Analytics VID.와 같습니다.

방문자 데이터

요청 키 필수 여부 시작 시기… 설명
visitor.marketingCloudOrgId Y sessionStart Experience Cloud 조직 ID, Adobe Experience Cloud 관련 시스템 내에서 조직 식별
visitor.marketingCloudUserId N sessionStart ECID(Experience Cloud 사용자 ID)입니다. 대부분의 시나리오에서 사용자를 식별하는 데 사용해야 하는 ID입니다. 하트비트 marketingCloudUserId는 Adobe Analytics의 MID와 같습니다. 이 매개 변수는 기술적으로 필요하지 않지만, Experience Cloud 앱 제품군에 액세스하는 데 필요합니다.
visitor.aamLocationHint N sessionStart Adobe Audience Manager Edge 데이터 제공
appInstallationId N sessionStart appInstallationId가 앱 및 장치를 고유하게 식별함

컨텐츠 데이터

요청 키 필수 여부 시작 시기… 설명
media.id Y sessionStart 컨텐츠에 대한 고유 식별자
media.name N sessionStart 사용자가 읽을 수 있는 컨텐츠 이름
media.length Y sessionStart 컨텐츠 길이(초)
media.contentType Y sessionStart 스트림 형식(임의의 문자열일 수 있으며, "Live", "VOD" 또는 "Linear" 값이 권장됨)
media.playerName Y sessionStart 컨텐츠 렌더링을 담당하는 플레이어의 이름
media.channel Y sessionStart 컨텐츠 배포 채널. 모바일 애플리케이션 이름이나 웹 사이트 이름, 속성 이름일 수 있습니다.
media.resume N sessionStart 사용자가 이전 세션을 다시 시작하는지 여부를 나타냅니다(새 세션 시작과 반대됨).
media.sdkVersion N sessionStart 플레이어에서 사용하는 SDK 버전

컨텐츠 표준 메타데이터

요청 키 필수 여부 시작 시기… 설명
media.streamFormat N sessionStart 스트림 포맷(예:"HD"
media.show N sessionStart 프로그램 또는 시리즈 이름
media.season N sessionStart 프로그램 또는 시리즈가 속한 시즌 번호
media.episode N sessionStart 에피소드의 번호
media.assetId N sessionStart TV 시리즈 에피소드 식별자, 동영상 자산 식별자 또는 라이브 이벤트 식별자와 같은 비디오 자산 컨텐츠에 대한 고유 식별자입니다. 일반적으로 이러한 ID는 EIDR, TMS/Gracenote 또는 Rovi와 같은 메타데이터 기관에서 나옵니다. 이러한 식별자는 다른 소유권 또는 사내 시스템에서도 사용할 수 있습니다.
media.genre N sessionStart 컨텐츠 생성자에서 정의한 컨텐츠의 유형
media.firstAirDate N sessionStart 컨텐츠가 TV에 처음 방송된 날짜
media.firstDigitalDate N sessionStart 컨텐츠가 디지털 플랫폼에서 처음으로 방송된 날짜
media.rating N sessionStart TV 유해 컨텐츠 가이드라인으로 정의된 등급
media.originator N sessionStart 컨텐츠 작성자
media.network N sessionStart 네트워크/채널 이름
media.showType N sessionStart 0과 3 사이의 정수로 표시되는 컨텐츠의 유형입니다.
  • 0 - 전체 에피소드
  • 1 - 미리 보기
  • 2 - 클립
  • 3 - 기타
media.adLoad N sessionStart 로드된 광고 유형
media.pass.mvpd N sessionStart Adobe 인증에서 제공한 MVPD
media.pass.auth N sessionStart Adobe 인증을 통해 사용자가 인증되었음을 나타냄(설정된 경우에만 true일 수 있음)
media.dayPart N sessionStart 컨텐츠가 브로드캐스트된 시간
media.feed N sessionStart 피드 유형(예: "West-HD")

광고 데이터

요청 키 필수 여부 시작 시기… 설명
media.ad.podFriendlyName N adBreakStart 친숙한 광고 브레이크 이름
media.ad.podIndex Y adBreakStart 비디오에 있는 광고 pod 인덱스
media.ad.podSecond Y adBreakStart pod가 시작된 시간(초)
media.ad.podPosition Y adStart 광고 브레이크 내에 있는 광고 인덱스(1부터 시작)
media.ad.name N adStart 친숙한 광고 이름
media.ad.id Y adStart 광고 이름
media.ad.length Y adStart 비디오 광고 길이(초)
media.ad.playerName Y adStart 광고를 렌더링하는 플레이어의 이름

광고 표준 메타데이터

요청 키 필수 여부 시작 시기… 설명
media.ad.advertiser N adStart 광고에서 다루고 있는 제품의 회사 또는 브랜드입니다
media.ad.campaignId N adStart 광고 캠페인의 ID
media.ad.creativeId N adStart 광고 문안 ID
media.ad.siteId N adStart 광고 사이트의 ID
media.ad.creativeURL N adStart 광고 문안 URL
media.ad.placementId N adStart 광고 배치 ID

챕터 데이터

요청 키 필수 여부 시작 시기… 설명
media.chapter.index Y chapterStart 컨텐츠에서 챕터의 위치 식별
media.chapter.offset Y chapterStart 재생에서 챕터가 시작되는 시간(초)
media.chapter.length Y chapterStart 챕터의 길이(초)
media.chapter.friendlyName N chapterStart 친숙한 챕터 이름

품질 데이터

요청 키 필수 여부 시작 시기… 설명
media.qoe.bitrate N 임의 스트림의 비트율
media.qoe.droppedFrames N 임의 스트림의 드롭된 프레임 수
media.qoe.framesPerSecond N 임의 초당 프레임 수
media.qoe.timeToStart N 임의 사용자가 재생을 누르는 때와 컨텐츠가 로드되어 재생을 시작할 때 사이에 경과된 시간(밀리초)입니다.

CCPA(California Consumer Privacy Act) 매개 변수

요청 키 필수 여부 시작 시기… 설명
analytics.optOutServerSideForwarding N sessionStart 최종 사용자가 Adobe Analytics와 다른 Experience Cloud 솔루션(예: Audience Manager) 간에 데이터를 공유하지 않기로 선택한 경우 참으로 설정합니다.
analytics.optOutShare N sessionStart 최종 사용자가 데이터를 (예: 다른 Adobe Analytics 클라이언트로) 페더레이션하지 않기로 선택한 경우 참으로 설정합니다.

추가 세부 정보

visitor.marketingCloudUserId

params 내부에 Experience Cloud 사용자 ID(MID 또는 MCID라고도 함)를 포함하면 visitor.marketingCloudUserId 키를 사용하여 sessionStart 호출 시 Experience Cloud 사용자 ID를 전달합니다. 이 기능은 다른 Experience Cloud 제품과 이미 통합하고 MCID를 가져온 경우에 유용합니다.

노트

MA(Media Analytics)는 Experience Cloud 앱 제품군(Adobe Analytics, Audience Manager, Target 등)에 통합되어 있습니다. 이러한 앱에 액세스하려면 Experience Cloud ID가 필요합니다. ECID는 대부분의 시나리오에서 사용자를 식별하는 데 사용해야 하는 것입니다.

appInstallationId

  • appInstallationId 값을 전달하지 않은 경우 - MA 백 엔드가 더 이상 MCID를 생성하지 않고, Adobe Analytics를 대신 이용하여 이 작업을 수행합니다. Media Collection API에서 MCID를 생성하여 모든 요청 시 보낼 수 있도록 가능한 경우 MCID를 보내거나 appInstallationId(필수 marketingCloudOrgId와 함께 사용)를 보내는 것이 좋습니다.

  • appInstallationId 값을 전달​하는 경우 - appInstallationId 및 (필수) marketingCloudOrgId 매개 변수 값을 전달하는 경우 MA 백 엔드에서 MCID를 생성​할 수 있습니다. appInstallationId를 직접 전달하는 경우 클라이언트 측에서 해당 값을 유지해야 합니다. 이는 장치의 앱에 고유해야 하며, 앱이 다시 설치되지 않는 한 유지되어야 합니다.

노트

appInstallationId는 앱 및 장치​를 고유하게 식별합니다. 각 장치의 각 앱에 대해 고유해야 합니다. 즉, 다른 장치에서 동일한 앱의 동일한 버전을 사용하는 두 명의 사용자가 각각 다른(고유) appInstallationId를 보내야 합니다.

visitor.marketingCloudOrgId

이 매개 변수는 제공하지 않은 경우 MCID 생성에 필요하며, 게시자 ID(Media Analytics에서 페더레이션 규칙 일치를 수행할 때 기반으로 함)에 대한 값으로도 사용됩니다.

Analytics 기존 사용 ID(aid) 및 선언된 사용자 ID(customerIDs)

  • analytics.aid:

    이 키 값은 Analytics 기존 사용자 ID를 나타내는 문자열이어야 합니다.

  • visitor.customerIDs:

    이 키의 값은 다음 형식의 개체여야 합니다.

    "<<insert your ID name here>>": {  
      "id": " <<insert your id here>>",  
       "authState": <<insert one of 0, 1, 2>>
    }
    

visitor.customerIDs 값은 제공된 형식의 개체를 임의의 수만큼 가질 수 있습니다.

visitor.aamLocationHint

이 매개 변수는 Adobe Analytics에서 고객 데이터를 Audience Manager에게 보낼 때 AAM(Adobe Audience Manager) Edge가 적중됨을 나타냅니다. 이 매개 변수를 전달하지 않으면 Adobe는 이 매개 변수를 1로 하드코딩합니다. 이는 최종 사용자가 지리적으로 먼 곳(예: 미국-동부, 미국-서부, 유럽, 아시아)에서 장치를 사용하는 경향이 있는 경우에 특히 중요합니다. 다른 경우에는 사용자 데이터가 여러 AAM Edges에 분산됩니다.

media.resume

세션이 닫히고 나중에 재개되었다고 판단되면(예: 사용자가 비디오를 나갔지만 결국 다시 플레이어에서 비디오가 중단된 플레이헤드부터 비디오를 재개한 경우) 호출 시 params 버킷 내에 선택적 부울 media.resumesessionStart 매개 변수를 보낼 수 있습니다.

이 페이지에서는