광고 매개변수 ad-parameters

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

테이블 데이터 설명:

  • 구현: 구현 값 및 요구 사항에 대한 정보

    • - 앱에서 수동으로 설정하거나 Adobe Media SDK에 의해 자동으로 설정된 변수.
    • 필수 - 기본 비디오 추적에 매개변수가 필요한지 여부를 나타냅니다.
    • 유형 - 설정할 변수의 유형을 문자열 또는 숫자로 지정합니다.
    • 전송 시점 - 데이터가 전송되는 시점을 나타냅니다. 미디어 시작 ​은 미디어 시작 시 분석 호출이 전송되고, 광고 시작 ​은 광고 시작 시 분석 호출이 전송됩니다. 닫기 호출은 미디어 세션 종료 시 또는 광고, 챕터 종료 시 하트비트 서버에서 Analytics 서버로 컴파일된 분석 호출이 직접 전송됩니다. 닫기 호출은 네트워크 패킷 호출에 사용할 수 없습니다.
    • 최소. SDK 버전 - 매개변수에 액세스하는 데 필요한 SDK 버전을 나타냅니다.
    • 샘플 값 - 일반적인 변수 사용의 예를 제공합니다.
  • 네트워크 매개변수: Adobe Analytics 또는 하트비트 서버에 전달되는 값을 표시합니다. 이 열에는 Adobe Media SDK에서 생성한 네트워크 호출에 표시되는 매개변수의 이름이 표시됩니다.

  • 보고: 비디오 데이터를 보고 분석하는 방법에 대한 정보입니다.

    • 사용 가능 - 데이터가 기본적으로() 보고 시 사용할 수 있는지 아니면 사용자 정의 설정(사용자 정의)을 필요로 하는지 여부를 지정합니다.
    • 예약된 변수 - 데이터가 예약된 변수에 이벤트, eVar, prop 또는 분류로 캡처되는지 여부를 나타냅니다.
    • 보고서 이름 - 변수에 대한 Adobe Analytics 보고서의 이름
    • 컨텍스트 데이터 - 보고 서버에 전달되고 처리 규칙에 사용되는 Adobe Analytics 컨텍스트 데이터의 이름
    • 데이터 피드 - 클릭스트림 또는 라이브 스트림 데이터 피드에 있는 변수의 열 이름
    • Audience Manager - Adobe Audience Manager에 있는 트레이트 이름
IMPORTANT
보고/예약 변수 아래에 "분류"로 설명되어 있는 변수의
분류 이름을 변경하지 마십시오.
미디어 분류는 보고서 세트가 미디어 추적에 대해 활성화될 때
정의됩니다. Adobe는 수시로 새로운 속성을 추가하며, 이런 경우
고객이 보고서 세트를 다시 활성화하여 새 미디어 속성에
액세스해야 합니다. 업데이트 프로세스 중에 Adobe는 변수의 이름을 확인하여
분류를 사용할지 여부를 결정합니다. 누락된 항목이
있을 경우 Adobe가 다시 추가합니다.

광고 비디오 데이터 ad-video-data

광고 ID

구현
네트워크 매개변수
보고
  • SDK 키:
    adId
  • API 키:
    media.ad.id
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: ​모두
  • 샘플 값:
    "2125"
  • 설명:
    ​광고 ID입니다. (모든 정수 및/또는 문자 조합)
  • Adobe Analytics:
    (a.media.ad.
    name)
  • 하트비트:
    (sad_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)
  • 하트비트:
    (spod_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)
  • 하트비트:
    (lad_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)
  • 하트비트:
    (splayer_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)
  • 하트비트:
    (spod_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)
  • 하트비트:
    (lpod_offset)
  • 사용 가능:
    ​예
  • 예약된 변수:
    ​분류
  • 보고서 이름:
    Pod 위치
  • 컨텍스트 데이터:
    (a.media.ad.
    podSecond)
  • 데이터 피드:
    ​해당 사항 없음
  • Audience Manager:
    (c_contextdata.
    a.media.ad.podSecond)
  • XDM 필드 패스:
    advertising.adAssetViewDetails.adBreak.
    offset
  • 컬렉션 XDM 필드 패스:
    mediaCollection.advertisingPodDetails.
    offset
  • 보고 XDM 필드 패스:
    mediaReporting.advertisingPodDetails.
    offset

광고 브레이크 ID

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

광고 이름

구현
네트워크 매개변수
보고
  • SDK 키:
    name
  • API 키:
    media.ad.name
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.1
  • 샘플 값:
    "Ford F-150"
  • 설명:
    ​친숙한 광고 이름입니다. 보고 시 "광고 이름"은 분류이고, "광고 이름(변수)"은 eVar입니다.
  • Adobe Analytics:
    (a.media.ad.
    friendlyName)
  • 하트비트:
    (sad_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

표준 광고 메타데이터 standard-ad-metadata

광고주

구현
네트워크 매개변수
보고
  • SDK 키:
    ADVERTISER
  • API 키:
    media.ad.advertiser
  • 필수:
    ​아니요
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작, 광고 종료
  • 최소. SDK 버전: 1.5.7
  • 샘플 값:
  • 설명:
    ​광고에서 다루고 있는 제품의 회사/브랜드입니다.
  • Adobe Analytics:
    (a.media.ad.
    advertiser)
  • 하트비트:
    (s
    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
    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
    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
    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
    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
    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

광고 지표 ad-metrics

광고 시작

구현
네트워크 매개변수
보고
  • SDK 키:
    ​자동으로 설정됨
  • API 키:
    ​해당 사항 없음
  • 필수:
    ​예
  • 유형:
    문자열
  • 전송 시점:
    ​광고 시작
  • 최소. SDK 버전: ​모두
  • 샘플 값:
    TRUE
  • 설명:
    ​비디오 광고 시작 수입니다.
  • Adobe Analytics:
    (a.media.ad.
    view)
  • 하트비트:
    (stype=start)
    (stype=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)
  • 하트비트:
    (stype=complete)
    (stype=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에서는 값이 시간 형식(HHSS)으로 표시됩니다. 데이터 피드, 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:

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb