광고 매개변수 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가 다시 추가합니다.
분류 이름을 변경하지 마십시오.
미디어 분류는 보고서 세트가 미디어 추적에 대해 활성화될 때
정의됩니다. Adobe는 수시로 새로운 속성을 추가하며, 이런 경우
고객이 보고서 세트를 다시 활성화하여 새 미디어 속성에
액세스해야 합니다. 업데이트 프로세스 중에 Adobe는 변수의 이름을 확인하여
분류를 사용할지 여부를 결정합니다. 누락된 항목이
있을 경우 Adobe가 다시 추가합니다.
광고 비디오 데이터 ad-video-data
광고 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.podPosition - 보고 XDM 필드 패스:
mediaReporting.advertisingDetails.podPosition
광고 길이
구현
네트워크 매개변수
보고
- 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.podIndex - 필수:
예 - 유형:
숫자 - 전송 시점:
- 최소. 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.
offset - 보고 XDM 필드 패스:
mediaReporting.advertisingPodDetails.
offset
광고 브레이크 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 키:
name - 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
표준 광고 메타데이터 standard-ad-metadata
광고주
구현
네트워크 매개변수
보고
- 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:<c/ode> 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
광고 지표 ad-metrics
광고 시작
구현
네트워크 매개변수
보고
- 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 - 설명:
광고를 시청하는 데 걸린 총 시간(즉, 재생되는 시간 (초))입니다. 값은 시간 형식(HH:MM:SS)으로 표시됩니다.
Analysis Workspace )을 참조하십시오. 데이터 피드, 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
관련 API section_Related_APIs
createAdObject APIs:
- Android - createAdObject
- iOS - createAdObject
- JavaScript - createAdObject
createAdBreakObject APIs:
- Android - createAdBreakObject
- iOS - createAdBreakObject
- JavaScript - createAdBreakObject
MediaHeartbeatConfig API:
- Android - MediaHeartbeatConfig
- iOS - ADBMediaHeartbeatConfig
- JavaScript - MediaHeartbeatConfig
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb