부록: 광고 소재 유형별로 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 추적 태그	선택사항 API 필드 이름: appendedTag
통합 코드	선택사항 API 필드 이름: integrationCode
참고	선택사항 API 필드 이름: 메모
감사 상태	읽기 전용 API 필드 이름: reviewStatus

HTML5 광고 소재

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

서드 파티 디스플레이 광고 소재

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

서드 파티 확장 가능 광고 소재

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

서드 파티 동영상 광고 소재

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

서드 파티 오디오 광고 소재

광고 소재 유형: CREATIVE_TYPE_AUDIO
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름	필수 API 필드 이름: displayName
상태	필수 API 필드 이름: entityStatus
VAST 태그 URL	필수 API 필드 이름: vastTagUrl
기여 분석팀에 공지 필요	선택사항 API 필드 이름: requirePingForAttribution
통합 코드	선택사항 API 필드 이름: integrationCode
참고	선택사항 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
건너뛰기 버튼 포함	선택사항 API 필드 이름: 건너뛸 수 있음
오프셋 건너뛰기	선택사항 API 필드 이름: skipOffset
오프셋 진행	선택사항 API 필드 이름: progressOffset
범용 광고 ID	선택사항 API 필드 이름: universalAdId
OBA : 온라인 맞춤형 광고	선택사항 API 필드 이름: obaIcon
컴패니언 광고 소재	선택사항 API 필드 이름: companionCreativeIds
게재 파일	읽기 전용 API 필드 이름: transcodes
제3자 URL	선택사항 API 필드 이름: thirdPartyUrls
통합 코드	선택사항 API 필드 이름: integrationCode
참고	선택사항 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 필드 이름: transcodes[].name
게재 파일 형식	읽기 전용 API 필드 이름: transcodes[].mimeType
파일 오디오 비트 전송률	읽기 전용 API 필드 이름: transcodes[].audioBitRateKbps
파일 오디오 샘플링 레이트 제공	읽기 전용 API 필드 이름: transcodes[].audioSampleRateHz
제3자 URL	선택사항 API 필드 이름: thirdPartyUrls
통합 코드	선택사항 API 필드 이름: integrationCode
참고	선택사항 API 필드 이름: 메모
감사 상태	읽기 전용 API 필드 이름: reviewStatus

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

광고 소재 유형: CREATIVE_TYPE_NATIVE, CREATIVE_TYPE_NATIVE_SITE_SQUARE
호스팅 소스: HOSTING_SOURCE_HOSTED
이름	필수 API 필드 이름: displayName
상태	필수 API 필드 이름: entityStatus
로고	필수 API 필드 이름: 애셋 애셋 역할: ASSET_ROLE_ICON
이미지 / 정사각형 이미지	필수 API 필드 이름: 애셋 애셋 역할: ASSET_ROLE_MAIN
광고 제목	필수 API 필드 이름: 애셋 애셋 역할: ASSET_ROLE_HEADLINE
긴 광고 제목	선택사항 API 필드 이름: 애셋 애셋 역할: ASSET_ROLE_LONG_HEADLINE
본문 텍스트	필수 API 필드 이름: 애셋 애셋 역할: ASSET_ROLE_BODY
긴 본문 텍스트	선택사항 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 추적 광고	선택사항 API 필드 이름: cmTrackingAd
노출 추적 URL 1	선택사항 API 필드 이름: trackingUrls[]
노출 추적 URL 2	선택사항 API 필드 이름: trackingUrls[]
JavaScript 추적 URL	선택사항 API 필드 이름: jsTrackerUrl
통합 코드	선택사항 API 필드 이름: integrationCode
참고	선택사항 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
긴 광고 제목	선택사항 API 필드 이름: 애셋 애셋 역할: ASSET_ROLE_LONG_HEADLINE
본문 텍스트	필수 API 필드 이름: 애셋 애셋 역할: ASSET_ROLE_BODY
긴 본문 텍스트	선택사항 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	선택사항 API 필드 이름: trackingUrls[]
노출 추적 URL 2	선택사항 API 필드 이름: trackingUrls[]
JavaScript 추적 URL	선택사항 API 필드 이름: jsTrackerUrl
통합 코드	선택사항 API 필드 이름: integrationCode
참고	선택사항 API 필드 이름: 메모
감사 상태	읽기 전용 API 필드 이름: reviewStatus