의견 보내기
부록: 광고 소재 유형별로 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)
의견을 전달하고 싶나요?
[[["이해하기 쉬움","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"]],["최종 업데이트: 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."]]],[]]
