요청 매개 변수

분석 데이터

요청 키 필수 여부 시작 시기… 설명
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 매개 변수를 보낼 수 있습니다.

이 페이지에서는

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now