2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은
지원 중단 페이지를 참고하세요.
부록: 광고 소재 유형별로 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 필드 이름: 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-07-25(UTC)
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eEach 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.\u003c/p\u003e\n"],["\u003cp\u003eCreative asset specifications, such as required and optional assets, are outlined for Native Video creatives, including details about their roles and corresponding API field names.\u003c/p\u003e\n"],["\u003cp\u003eCampaign Manager 360 tracking ad can optionally be included using the \u003ccode\u003ecmTrackingAd\u003c/code\u003e API field.\u003c/p\u003e\n"],["\u003cp\u003eThis mapping enables developers to understand how UI inputs translate into API data for seamless creative management and integration within the system.\u003c/p\u003e\n"]]],[],null,[]]
