의견 보내기
부록: 광고 소재 유형별로 UI 필드를 API 필드에 매핑
bookmark_border bookmark
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
아래 표에는 광고 유형별로 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 필드 이름: 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 필드 이름: reviewStatus
서드 파티 디스플레이 광고 소재
광고 소재 유형: CREATIVE_TYPE_STANDARD
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수
API 필드 이름: displayName
상태
필수
API 필드 이름: entityStatus
측정기준
방문 페이지 URL
필수
API 필드 이름: exitEvents[].url
이탈 이벤트 유형: EXIT_EVENT_TYPE_DEFAULT
MRAID 필요
선택사항
API 필드 이름: requireMraid
HTML5 필요
선택사항
API 필드 이름: requireHtml5
서드 파티 태그
필수
API 필드 이름: thirdPartyTag
기여 분석팀에 공지 필요
선택사항
API 필드 이름: requirePingForAttribution
통합 코드
선택사항
API 필드 이름: integrationCode
참고
감사 상태
읽기 전용
API 필드 이름: reviewStatus
서드 파티 확장 가능 광고 소재
광고 소재 유형: CREATIVE_TYPE_EXPANDABLE
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수
API 필드 이름: displayName
상태
필수
API 필드 이름: entityStatus
측정기준
방문 페이지 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 필드 이름: reviewStatus
서드 파티 동영상 광고 소재
광고 소재 유형: CREATIVE_TYPE_VIDEO
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수
API 필드 이름: displayName
상태
필수
API 필드 이름: entityStatus
VAST 태그 URL
VPAID
HTML5 동영상
읽기 전용
API 필드 이름: html5Video
기여 분석팀에 공지 필요
선택사항
API 필드 이름: requirePingForAttribution
통합 코드
선택사항
API 필드 이름: integrationCode
참고
감사 상태
읽기 전용
API 필드 이름: reviewStatus
서드 파티 오디오 광고 소재
광고 소재 유형: CREATIVE_TYPE_AUDIO
호스팅 소스: HOSTING_SOURCE_THIRD_PARTY
이름
필수
API 필드 이름: displayName
상태
필수
API 필드 이름: entityStatus
VAST 태그 URL
기여 분석팀에 공지 필요
선택사항
API 필드 이름: requirePingForAttribution
통합 코드
선택사항
API 필드 이름: integrationCode
참고
감사 상태
읽기 전용
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 필드 이름: skipOffset
오프셋 진행
선택사항
API 필드 이름: progressOffset
범용 광고 ID
선택사항
API 필드 이름: universalAdId
OBA : 온라인 맞춤형 광고
컴패니언 광고 소재
선택사항
API 필드 이름: companionCreativeIds
게재 파일
읽기 전용
API 필드 이름: transcodes
제3자 URL
선택사항
API 필드 이름: thirdPartyUrls
통합 코드
선택사항
API 필드 이름: integrationCode
참고
감사 상태
읽기 전용
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 필드 이름: 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 필드 이름: 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 필드 이름: reviewStatus
의견 보내기
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스 에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스 에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책 을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-04-09(UTC)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-04-09(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."]]],[]]
