부록: 광고 소재 유형별로 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
|
|
|
감사 상태
|
|
읽기 전용
|
|
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 필드 이름: reviewStatus
|
|
타사 디스플레이 광고 소재
| 광고 소재 유형: CREATIVE_TYPE_STANDARD |
| 호스팅 소스: HOSTING_SOURCE_THIRD_PARTY |
|
이름
|
|
필수 항목
|
|
API 필드 이름: displayName
|
|
|
상태
|
|
필수 항목
|
|
API 필드 이름: entityStatus
|
|
|
크기
|
|
|
방문 페이지 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
|
|
|
감사 상태
|
|
읽기 전용
|
|
API 필드 이름: reviewStatus
|
|
타사 확장형 광고
| 광고 소재 유형: CREATIVE_TYPE_EXPANDABLE |
| 호스팅 소스: HOSTING_SOURCE_THIRD_PARTY |
|
이름
|
|
필수 항목
|
|
API 필드 이름: displayName
|
|
|
상태
|
|
필수 항목
|
|
API 필드 이름: entityStatus
|
|
|
크기
|
|
|
방문 페이지 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
|
|
|
감사 상태
|
|
읽기 전용
|
|
API 필드 이름: reviewStatus
|
|
타사 동영상 광고 소재
| 광고 소재 유형: CREATIVE_TYPE_VIDEO |
| 호스팅 소스: HOSTING_SOURCE_THIRD_PARTY |
|
이름
|
|
필수 항목
|
|
API 필드 이름: displayName
|
|
|
상태
|
|
필수 항목
|
|
API 필드 이름: entityStatus
|
|
|
VAST 태그 URL
|
|
필수 항목
|
|
API 필드 이름: vastTagUrl
|
|
|
VPAID
|
|
|
HTML5 동영상
|
|
읽기 전용
|
|
API 필드 이름: html5Video
|
|
|
기여 분석팀에 공지 필요
|
|
Optional
|
|
API 필드 이름:requirePingForAttribution
|
|
|
통합 코드
|
|
Optional
|
|
API 필드 이름: integrationCode
|
|
|
Notes
|
|
|
감사 상태
|
|
읽기 전용
|
|
API 필드 이름: reviewStatus
|
|
서드 파티 오디오 광고 소재
| 광고 소재 유형: CREATIVE_TYPE_AUDIO |
| 호스팅 소스: HOSTING_SOURCE_THIRD_PARTY |
|
이름
|
|
필수 항목
|
|
API 필드 이름: displayName
|
|
|
상태
|
|
필수 항목
|
|
API 필드 이름: entityStatus
|
|
|
VAST 태그 URL
|
|
필수 항목
|
|
API 필드 이름: vastTagUrl
|
|
|
기여 분석팀에 공지 필요
|
|
Optional
|
|
API 필드 이름:requirePingForAttribution
|
|
|
통합 코드
|
|
Optional
|
|
API 필드 이름: integrationCode
|
|
|
Notes
|
|
|
감사 상태
|
|
읽기 전용
|
|
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
|
|
|
게재 파일
|
|
|
제3자 URL
|
|
Optional
|
|
API 필드 이름: thirdPartyUrls
|
|
|
통합 코드
|
|
Optional
|
|
API 필드 이름: integrationCode
|
|
|
Notes
|
|
|
감사 상태
|
|
읽기 전용
|
|
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
|
|
|
감사 상태
|
|
읽기 전용
|
|
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
|
|
|
감사 상태
|
|
읽기 전용
|
|
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
|
|
|
감사 상태
|
|
읽기 전용
|
|
API 필드 이름: reviewStatus
|
|
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2023-12-01(UTC)
[null,null,["최종 업데이트: 2023-12-01(UTC)"],[[["This document provides a comprehensive mapping of UI fields to their corresponding API fields for various creative types, including Standard Image, HTML5, Third-Party Display, Third-Party Expandable, Third-Party Video, Third-Party Audio, Video, Audio, Native Display, and Native Video."],["Each creative type has a specific set of required and optional fields, along with their API field names and any further specifications for asset roles or exit event types."],["Creative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names."],["Campaign Manager 360 tracking ad can optionally be included using the `cmTrackingAd` API field."],["This mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system."]]],[]]
