부록: 광고 소재 유형별로 UI 필드를 API 필드에 매핑

아래 표는 UI 필드를 광고 소재 유형별로 구분된 해당 API 필드에 매핑합니다. 일부 API 필드에는 제공된 리소스에 할당된 역할 또는 유형을 통해 추가 사양을 지정해야 합니다.

표준 이미지 광고 소재

광고 소재 유형: CREATIVE_TYPE_STANDARD
호스팅 소스: HOSTING_SOURCE_HOSTED
이름
필수 항목
API 필드 이름: displayName
광고 애셋
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_MAIN
방문 페이지 URL
필수 항목
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
상태
필수 항목
API 필드 이름: entityStatus
추가된 HTML 추적 태그
Optional
API 필드 이름:AddedTag
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

HTML5 광고 소재

광고 소재 유형: CREATIVE_TYPE_STANDARD
호스팅 소스: HOSTING_SOURCE_HOSTED
이름
필수 항목
API 필드 이름: displayName
광고 애셋
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_MAIN
상태
필수 항목
API 필드 이름: entityStatus
백업 이미지
Optional
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_BACKUP
백업 방문 페이지 URL
Optional
API 필드 이름: exitEvents[].url
종료 이벤트 유형: EXIT_EVENT_TYPE_BACKUP
백업 이탈 보고 라벨
Optional
API 필드 이름: exitEvents[].reportingName
종료 이벤트 유형: EXIT_EVENT_TYPE_BACKUP
이미지 폴라이트 로드
Optional
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_POLITE_LOAD
종료수
필수 항목
API 필드 이름: exitEvents[]
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
카운터
Optional
API 필드 이름:counterEvents[]
타이머
Optional
API 필드 이름: 타이머Events[]
추가된 HTML 추적 태그
Optional
API 필드 이름:AddedTag
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
Optional
API 필드 이름: reviewStatus

타사 디스플레이 광고 소재

광고 소재 유형: CREATIVE_TYPE_STANDARD
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수 항목
API 필드 이름: displayName
상태
필수 항목
API 필드 이름: entityStatus
크기
필수 항목
API 필드 이름: 측정기준
방문 페이지 URL
필수 항목
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
MRAID 필요
Optional
API 필드 이름:requireMraid
HTML5 필요
Optional
API 필드 이름: requiredhtml5
서드 파티 태그
필수 항목
API 필드 이름: thirdPartyTag
기여 분석팀에 공지 필요
Optional
API 필드 이름:requirePingForAttribution
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

타사 확장형 광고

광고 소재 유형: CREATIVE_TYPE_EXPANDABLE
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수 항목
API 필드 이름: displayName
상태
필수 항목
API 필드 이름: entityStatus
크기
필수 항목
API 필드 이름: 측정기준
방문 페이지 URL
필수 항목
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
MRAID 필요
Optional
API 필드 이름:requireMraid
HTML5 필요
Optional
API 필드 이름: requiredhtml5
확장 방향
필수 항목
API 필드 이름: expandDirection
마우스 오버 시 확장
Optional
API 필드 이름: expandOnHover
제3자
필수 항목
API 필드 이름: thirdPartyTag
기여 분석팀에 공지 필요
Optional
API 필드 이름:requirePingForAttribution
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

타사 동영상 광고 소재

광고 소재 유형: CREATIVE_TYPE_VIDEO
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수 항목
API 필드 이름: displayName
상태
필수 항목
API 필드 이름: entityStatus
VAST 태그 URL
필수 항목
API 필드 이름: vastTagUrl
VPAID
읽기 전용
API 필드 이름: vpaid
HTML5 동영상
읽기 전용
API 필드 이름: html5Video
기여 분석팀에 공지 필요
Optional
API 필드 이름:requirePingForAttribution
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

서드 파티 오디오 광고 소재

광고 소재 유형: CREATIVE_TYPE_AUDIO
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수 항목
API 필드 이름: displayName
상태
필수 항목
API 필드 이름: entityStatus
VAST 태그 URL
필수 항목
API 필드 이름: vastTagUrl
기여 분석팀에 공지 필요
Optional
API 필드 이름:requirePingForAttribution
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

동영상 광고문안

광고 소재 유형: CREATIVE_TYPE_VIDEO
호스팅 소스: HOSTING_SOURCE_HOSTED
이름
필수 항목
API 필드 이름: displayName
상태
필수 항목
API 필드 이름: entityStatus
소스 파일
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_MAIN
방문 페이지 URL
필수 항목
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
건너뛰기 버튼 포함
Optional
API 필드 이름: 건너뛸 수 있음
오프셋 건너뛰기
Optional
API 필드 이름: skipOffset
오프셋 진행
Optional
API 필드 이름: progressOffset
범용 광고 ID
Optional
API 필드 이름: UniversalAdId
OBA : 온라인 맞춤형 광고
Optional
API 필드 이름: obaIcon
컴패니언 광고 소재
Optional
API 입력란 이름:CompanionCreativeIds
게재 파일
읽기 전용
API 입력란 이름: 트랜스코드
제3자 URL
Optional
API 필드 이름: thirdPartyUrls
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

오디오 광고 소재

광고 소재 유형: CREATIVE_TYPE_AUDIO
호스팅 소스: HOSTING_SOURCE_HOSTED
이름
필수 항목
API 필드 이름: displayName
상태
필수 항목
API 필드 이름: entityStatus
소스 파일
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_MAIN
방문 페이지 URL
필수 항목
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
컴패니언 애셋 (업로드 또는 할당)
필수 항목
API 입력란 이름:CompanionCreativeIds
제공 파일 이름
읽기 전용
API 필드 이름:transforms[].name
제공 파일 형식
읽기 전용
API 필드 이름:transforms[].mimeType
게재 파일 오디오 비트 전송률
읽기 전용
API 필드 이름:transforms[].audioBitRateKbps
게재 파일 오디오 샘플링 레이트
읽기 전용
API 필드 이름:transforms[].audioSampleRateHz
제3자 URL
Optional
API 필드 이름: thirdPartyUrls
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

네이티브 디스플레이 광고 소재

광고 소재 유형: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_Spot
호스팅 소스: HOSTING_SOURCE_HOSTED
이름
필수 항목
API 필드 이름: displayName
status
필수 항목
API 필드 이름: entityStatus
로고
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_ICON
이미지 / 정사각형 이미지
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_MAIN
광고 제목
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_HEADLINE
긴 광고 제목
Optional
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_LONG_HEADLINE
본문 텍스트
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_BODY
긴 본문 텍스트
Optional
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_LONG_BODY
방문 페이지 URL
필수 항목
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
캡션 URL
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_CAPTION_URL
클릭 유도 문구
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_CALL_TO_ACTION
Campaign Manager 360 추적 광고
Optional
API 필드 이름: cmTrackingAd
노출 추적 URL 1
Optional
API 필드 이름: trackingUrls[]
노출 추적 URL 2
Optional
API 필드 이름: trackingUrls[]
자바스크립트 추적 URL
Optional
API 필드 이름: jsTrackerUrl
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus

네이티브 동영상 광고 소재

광고 소재 유형: CREATIVE_TYPE_NATIVE_VIDEO
호스팅 소스: HOSTING_SOURCE_HOSTED
이름
필수 항목
API 필드 이름: displayName
상태
필수 항목
API 필드 이름: entityStatus
로고
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_ICON
동영상
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_MAIN
표지 이미지
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_COVER_IMAGE
광고주 이름
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_ADVERTISER_NAME
광고 제목
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_HEADLINE
긴 광고 제목
Optional
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_LONG_HEADLINE
본문 텍스트
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_BODY
긴 본문 텍스트
Optional
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_LONG_BODY
방문 페이지 URL
필수 항목
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
캡션 URL
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_CAPTION_URL
클릭 유도 문구
필수 항목
API 필드 이름: 애셋
애셋 역할: ASSET_ROLE_CALL_TO_ACTION
노출 추적 URL 1
Optional
API 필드 이름: trackingUrls[]
노출 추적 URL 2
Optional
API 필드 이름: trackingUrls[]
자바스크립트 추적 URL
Optional
API 필드 이름: jsTrackerUrl
통합 코드
Optional
API 필드 이름: integrationCode
Notes
Optional
API 필드 이름: 참고사항
감사 상태
읽기 전용
API 필드 이름: reviewStatus