광고 매개변수 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) - 데이터 피드:
videoadname - 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) - 데이터 피드:
videoadadvertiser - 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) - 데이터 피드:
videoadcampaign - 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)
``
- 사용 가능:
예 - 예약된 변수:
이벤트 - 보고서 이름:
광고 시작 - 데이터 피드:
videoadstart - 컨텍스트 데이터:
(a.media.ad.
view) - Audience Manager:
(c_contextdata.
a.media.ad.view) - XDM 필드 패스:(더 이상 사용되지 않음)
advertising.impressions.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
).
- 사용 가능:
예 - 예약된 변수:
이벤트 - 보고서 이름:
광고 완료 - 데이터 피드:
videoadcomplete - 컨텍스트 데이터:
(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) - 하트비트:
- 사용 가능:
예 - 예약된 변수:
이벤트 - 보고서 이름:
광고 체류 시간 - 데이터 피드:
videoadtime - 컨텍스트 데이터:
(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