광고 매개 변수

이 항목에서는 컨텍스트 데이터 값을 포함하여 Adobe에서 솔루션 변수를 통해 수집하는 비디오 광고 데이터의 목록을 제공합니다.

테이블 데이터 설명:

  • 구현: 구현 값 및 요구 사항에 대한 정보
    • 키 - 앱에서 수동으로 설정하거나 Adobe Media SDK에 의해 자동으로 설정된 변수.
    • 필수 - 기본 비디오 추적에 매개 변수가 필요한지 여부를 나타냅니다.
    • 유형 - 설정할 변수의 유형을 문자열 또는 숫자로 지정합니다.
    • 전송 시점 - 데이터가 전송되는 시점을 나타냅니다. 미디어 시작​은 미디어 시작 시 분석 호출이 전송되고, 광고 시작​은 광고 시작 시 분석 호출이 전송됩니다. 닫기 호출은 미디어 세션 종료 시 또는 광고, 챕터 종료 시 하트비트 서버에서 Analytics 서버로 컴파일된 분석 호출이 직접 전송됩니다. 닫기 호출은 네트워크 패킷 호출에 사용할 수 없습니다.
    • 최소. SDK 버전 - 매개 변수에 액세스하는 데 필요한 SDK 버전을 나타냅니다.
    • 샘플 값 - 일반적인 변수 사용의 예를 제공합니다.
  • 네트워크 매개 변수: Adobe Analytics 또는 하트비트 서버에 전달되는 값을 표시합니다. 이 열에는 Adobe Media SDK에서 생성한 네트워크 호출에 표시되는 매개 변수의 이름이 표시됩니다.
  • 보고: 비디오 데이터를 보고 분석하는 방법에 대한 정보입니다.
    • 사용 가능 - 데이터가 기본적으로(예) 보고 시 사용할 수 있는지 아니면 사용자 지정 설정(사용자 지정)을 필요로 하는지 여부를 지정합니다.
    • 예약된 변수 - 데이터가 예약된 변수에 이벤트, eVar, prop 또는 분류로 캡처되는지 여부를 나타냅니다.
    • 보고서 이름 - 변수에 대한 Adobe Analytics 보고서의 이름
    • 컨텍스트 데이터 - 보고 서버에 전달되고 처리 규칙에 사용되는 Adobe Analytics 컨텍스트 데이터의 이름
    • 데이터 피드 - 클릭스트림 또는 라이브 스트림 데이터 피드에 있는 변수의 열 이름
    • Audience Manager - Adobe Audience Manager에 있는 트레이트 이름
중요

보고/예약 변수 아래에 "분류"로 설명되어 있는 변수의
분류 이름을 변경하지 마십시오.
미디어 분류는 보고서 세트가 미디어 추적에 대해 활성화될 때
정의됩니다. Adobe는 수시로 새로운 속성을 추가하며, 이런 경우
고객이 보고서 세트를 다시 활성화하여 새 미디어 속성에
액세스해야 합니다. 업데이트 프로세스 중에 Adobe는 변수의 이름을 확인하여
분류를 사용할지 여부를 결정합니다. 누락된 항목이
있을 경우 Adobe가 다시 추가합니다.

광고 비디오 데이터

광고 ID

구현 네트워크 매개 변수 보고
  • SDK 키:
    adId
  • API 키:
    media.ad.id
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전:​모두
  • 샘플 값:
    "2125"
  • 설명:
    ​광고 ID입니다. (모든 정수 및/또는 문자 조합)
  • Adobe Analytics:
    (a.media.ad.
    name)
  • 하트비트:
    (s:asset:ad_id)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​방문 시
  • 보고서 이름:
    ​광고
  • 컨텍스트 데이터:
    (a.media.ad.
    name)
  • 데이터 피드:
    videoad
  • Audience Manager:
    (c_contextdata.
    a.media.ad.name)
  • XDM 필드 패스:
    advertising.adAssetReference.@ID
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.name
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.name

Pod의 광고 위치

구현 네트워크 매개 변수 보고
  • SDK 키:
    position
  • API 키:
    media.ad.podPosition
  • 필수:
    ​예
  • 유형:
    ​숫자
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전:​모두
  • 샘플 값:
    1
  • 설명:
    ​상위 광고 브레이크 내에 있는 광고의 위치(색인)입니다. 첫 번째 광고에는 색인 0, 두 번째 광고에 색인 1 등이 있습니다.
  • Adobe Analytics:
    (a.media.ad.
    podPosition)
  • 하트비트:
    (s:asset:pod_position)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    Pod의 광고 위치의
  • 컨텍스트 데이터:
    (a.media.ad.
    podPosition)
  • 데이터 피드:
    videoadinpod
  • Audience Manager:
    (c_contextdata).
    a.media.ad.podPosition)
  • XDM 필드 패스:
    advertising.adAssetViewDetails.index
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.index
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.index

광고 길이

구현 네트워크 매개 변수 보고
  • SDK 키:
    length
  • API 키:
    media.ad.length
  • 필수:
    ​예
  • 유형:
    ​숫자
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.1
  • 샘플 값:
    "15"
  • 설명:
    ​동영상 광고의 길이(초)입니다.
  • Adobe Analytics:
    (a.media.ad.
    length)
  • 하트비트:
    (l:asset:ad_length)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar 및 분류
  • 만료:
    ​히트 시
  • 보고서 이름:
    ​광고 길이 및 광고 길이(변수)
  • 컨텍스트 데이터:
    (a.media.ad.
    length)
  • 데이터 피드:
    videoadlength
  • Audience Manager:
    (c_contextdata).
    a.media.ad.length)
  • XDM 필드 패스:
    advertising.adAssetReference.
    xmpDM:duration
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.length
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.length

광고 플레이어 이름

구현 네트워크 매개 변수 보고
  • SDK 키:
    playerName
  • API 키:
    media.ad.playerName
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전:​모두
  • 샘플 값:
    "Freewheel"
  • 설명:
    ​광고 렌더링을 담당하는 플레이어의 이름입니다.
  • Adobe Analytics:
    (a.media.ad.
    playerName)
  • 하트비트:
    (s:sp:player_name)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    ​광고 플레이어 이름
  • 컨텍스트 데이터:
    (a.media.ad.
    playerName)
  • 데이터 피드:
    videoadplayername
  • Audience Manager:
    (c_contextdata).
    a.media.ad.playerName)
  • XDM 필드 패스:
    advertising.adAssetViewDetails.playerName
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.
    playerName
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.
    playerName

광고 브레이크 이름

구현 네트워크 매개 변수 보고
  • SDK 키:
    name
  • API 키:
    media.ad.podFriendlyName
  • 필수:
    SDK: 예, API: 아니요.
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전:​모두
  • 샘플 값:
    "프리롤"
  • 설명:
    ​친숙한 광고 브레이크 이름입니다.
  • Adobe Analytics:
    (a.media.ad.
    podFriendlyName)
  • 하트비트:
    (s:asset:pod_name)
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​분류
  • 보고서 이름:
    Pod 이름
  • 컨텍스트 데이터:
    (a.media.ad.
    podFriendlyName)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata).
    a.media.ad.podFriendlyName)
  • XDM 필드 경로:
    advertising.adAssetViewDetails.
    adBreak.dc:title
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingPodDetails.
    friendlyName
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingPodDetails.
    friendlyName

광고 브레이크 색인

구현 네트워크 매개 변수 보고
  • SDK 키:
    position
  • API 키:
    media.ad.podPosition
  • 필수:
    ​예
  • 유형:
    ​숫자
  • 전송 시점:
  • 최소. SDK 버전:​모두
  • 샘플 값:
    1
  • 설명:
    ​콘텐츠 내에 있는 광고 브레이크 색인(1부터 시작)입니다. 속성은 Media SDK에서 Pod ID를 생성하는 데​에만 사용됩니다.
  • Adobe Analytics:
  • 하트비트:
  • 사용 가능:
    ​아니요
  • 예약된 변수:
    ​해당 사항 없음
  • 보고서 이름:
    ​해당 사항 없음
  • 컨텍스트 데이터:
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
  • XDM 필드 패스:
    advertising.adAssetViewDetails.index
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingPodDetails.index

광고 브레이크 위치

구현 네트워크 매개 변수 보고
  • SDK 키:
    startTime
  • API 키:
    media.ad.podSecond
  • 필수:
    ​예
  • 유형:
    ​숫자
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전:​모두
  • 샘플 값:
    90
  • 설명:
    ​콘텐츠 내부의 광고 브레이크 오프셋(초)입니다.
  • Adobe Analytics:
    (a.media.ad.
    podSecond)
  • 하트비트:
    (l:asset:pod_offset)
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​분류
  • 보고서 이름:
    Pod 위치
  • 컨텍스트 데이터:
    (a.media.ad.
    podSecond)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata).
    a.media.ad.podSecond)
  • XDM 필드 패스:
    advertising.adAssetViewDetails.adBreak.
    offset
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingPodDetails.
    오프셋
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingPodDetails.
    오프셋

광고 브레이크 ID

구현 네트워크 매개 변수 보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전:​모두
  • 샘플 값:
    c4a577424c84067899b807c76722d495_1
  • Adobe Analytics:
    (a.media.ad.
    pod)
  • 하트비트:
    (s:asset:pod_id)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    ​광고 Pod
  • 컨텍스트 데이터:
    (a.media.ad.
    pod)
  • 데이터 피드:
    videoadpod
  • Audience Manager:
  • XDM 필드 패스:
    advertising.adAssetViewDetails.adBreak.@ID
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingPodDetails.
    ID

광고 이름

구현 네트워크 매개 변수 보고
  • SDK 키:
    이름
  • API 키:
    media.ad.name
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.1
  • 샘플 값:
    "Ford F-150"
  • 설명:
    ​친숙한 광고 이름입니다. 보고 시 "광고 이름"은 분류이고, "광고 이름(변수)"은 eVar입니다.
  • Adobe Analytics:
    (a.media.ad.
    friendlyName)
  • 하트비트:
    (s:asset:ad_name)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar 및 분류
  • 만료:
    ​히트 시
  • 보고서 이름:
    ​광고 이름 및 광고 이름(변수)
  • 컨텍스트 데이터:
    (a.media.ad.
    friendlyName)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata).
    a.media.ad.friendlyName)
  • XDM 필드 패스:
    advertising.adAssetReference.dc:title
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.friendlyName
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.friendlyName

표준 광고 메타데이터

광고주

구현 네트워크 매개 변수 보고
  • SDK 키:
    ADVERTISER
  • API 키:
    media.ad.advertiser
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.7
  • 샘플 값:
  • 설명:
    ​광고에서 다루고 있는 제품의 회사/브랜드입니다.
  • Adobe Analytics:
    (a.media.ad.
    advertiser)
  • 하트비트:
    (s:meta:
    a.media.ad.advertiser)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    광고주
  • 컨텍스트 데이터:
    (a.media.ad.
    advertiser)
  • 데이터 피드:
    videoadvertiser
  • Audience Manager:
    (c_contextdata).
    a.media.ad.advertiser)
  • XDM 필드 패스:
    advertising.adAssetReference.advertiser
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.advertiser
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.advertiser

캠페인 ID

구현 네트워크 매개 변수 보고
  • SDK 키:
    CAMPAIGN_ID
  • API 키:
    media.ad.campaignId
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.7
  • 샘플 값:
    ​정수 또는 이름(문자열).
  • 설명:
    ​광고 캠페인의 ID입니다.
  • Adobe Analytics:
    (a.media.ad.
    campaign)
  • 하트비트:
    (s:meta:
    a.media.ad.campaign)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    캠페인 ID
  • 컨텍스트 데이터:
    (a.media.ad.
    campaign)
  • 데이터 피드:
    videocampaign
  • Audience Manager:
    (c_contextdata).
    a.media.ad.campaign)
  • XDM 필드 패스:
    advertising.adAssetReference.campaign
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.
    campaignID
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.
    campaignID

광고 ID

구현 네트워크 매개 변수 보고
  • SDK 키:
    CREATIVE_ID
  • API 키:
    media.ad.creativeId
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.7
  • 샘플 값:
    ​정수 또는 이름(문자열).
  • 설명:
    ​광고 문안의 ID입니다.
  • Adobe Analytics:
    (a.media.ad.
    creative)
  • 하트비트:
    (s:meta:
    a.media.ad.creative)
  • 사용 가능:
    ​예
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    광고 ID
  • 컨텍스트 데이터:
    (a.media.ad.
    creative)
  • 데이터 피드:
    adclassificationcreative
  • Audience Manager:
    (c_contextdata).
    a.media.ad.creative)
  • XDM 필드 패스:
    advertising.adAssetReference.creativeID
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.creativeID
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.creativeID

사이트 ID

구현 네트워크 매개 변수 보고
  • SDK 키:
    SITE_ID
  • API 키:
    media.ad.siteId
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.7
  • 샘플 값:
  • 설명:
    ​광고 사이트의 ID입니다.
  • Adobe Analytics:
    (a.media.ad.
    없습니다)
  • 하트비트:
    (s:meta:
    a.media.ad.site)
  • 사용 가능:
    사용자 지정 처리 규칙 사용
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    사용자 지정
  • 컨텍스트 데이터:
    (a.media.ad.
    없습니다)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata).
    a.media.ad.site)
  • XDM 필드 패스:
    advertising.adAssetReference.siteID
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.siteID
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.siteID

광고 URL

구현 네트워크 매개 변수 보고
  • SDK 키:
    CREATIVE_URL
  • API 키:
    media.ad.creativeURL
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.7
  • 샘플 값:
  • Description:
    ​광고 문안의 URL입니다.
  • Adobe Analytics:
    (a.media.ad.
    creativeURL)
  • 하트비트:
    (s:meta:
    a.media.ad.creativeURL)
  • 사용 가능:
    사용자 지정 처리 규칙 사용
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    사용자 지정
  • 컨텍스트 데이터:
    (a.media.ad.
    creativeURL)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata).
    a.media.ad.creativeURL)
  • XDM 필드 패스:
    advertising.adAssetReference.creativeURL
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.
    creativeURL
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.
    creativeURL

게재위치 ID

구현 네트워크 매개 변수 보고
  • SDK 키:
    PLACEMENT_ID
  • API 키:
    media.ad.placementId
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.7
  • 샘플 값:
  • 설명:
    ​광고 배치 ID입니다.
  • Adobe Analytics:
    (a.media.ad.
    placement)
  • 하트비트:
    (s:meta:
    a.media.ad.placement)
  • 사용 가능:
    사용자 지정 처리 규칙 사용
  • 예약된 변수:
    eVar
  • 만료:
    ​히트 시
  • 보고서 이름:
    사용자 지정
  • 컨텍스트 데이터:
    (a.media.ad.
    placement)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata).
    a.media.ad.placement)
  • XDM 필드 패스:
    advertising.adAssetReference.placementID
  • 컬렉션 XDM 필드 경로:
    mediaCollection.advertisingDetails.
    placementID
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.
    placementID

광고 지표

광고 시작

구현 네트워크 매개 변수 보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작
  • 최소. SDK 버전:​모두
  • 샘플 값:
    TRUE
  • 설명:
    ​비디오 광고 시작 수입니다.
  • Adobe Analytics:
    (a.media.ad.
    view)
  • 하트비트:
    (s:event:type=start)
    (s:asset:type=ad)
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​이벤트
  • 보고서 이름:
    ​광고 시작
  • 데이터 피드:
    ​해당 사항 없음
  • 컨텍스트 데이터:
    (a.media.ad.
    view)
  • Audience Manager:
    (c_contextdata).
    a.media.ad.view)
  • XDM 필드 패스:
    advertising.starts.value > 0 => “TRUE”
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.isStarted

광고 완료

구현 네트워크 매개 변수 보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 닫기
  • 최소. SDK 버전:​모두
  • 샘플 값:
    TRUE
  • 설명:
    ​비디오 광고 완료 수입니다.
  • Adobe Analytics:
    (a.media.ad.
    complete)
  • 하트비트:
    (s:event:type=complete)
    (s:asset:type=ad)
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​이벤트
  • 보고서 이름:
    ​광고 완료
  • 데이터 피드:
    ​해당 사항 없음
  • 컨텍스트 데이터:
    (a.media.ad.
    complete)
  • Audience Manager:
    (c_contextdata).
    a.media.ad.complete)
  • XDM 필드 패스:
    advertising.completes.value > 0 => “TRUE”
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.
    isCompleted

광고 체류 시간

구현 네트워크 매개 변수 보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 닫기
  • 최소. SDK 버전:​모두
  • 샘플 값:
    15
  • 설명:
    ​광고를 시청하는 데 걸린 총 시간(즉, 재생되는 시간(초))입니다. Analysis Workspace 및 Reports & Analytics에서는 값이 시간 형식(HH:MM:SS)으로 표시됩니다. 데이터 피드, Data Warehouse 및 보고 API에서는 값이 초 단위로 표시됩니다.
    릴리스 날짜: 2018년 9월 13일
  • Adobe Analytics:
    (a.media.ad.
    timePlayed)
  • 하트비트:
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​이벤트
  • 보고서 이름:
    ​광고 체류 시간
  • 데이터 피드:
    ​해당 사항 없음
  • 컨텍스트 데이터:
    (a.media.ad.
    timePlayed)
  • Audience Manager:
    (c_contextdata).
    a.media.ad.timePlayed)
  • XDM 필드 패스:
    advertising.timePlayed.value
  • 보고 XDM 필드 경로:
    mediaReporting.advertisingDetails.
    timePlayed

createAdObject APIs:

createAdBreakObject APIs:

MediaHeartbeatConfig API:

이 페이지에서는