디스플레이 및 Video 360 API v2는
2024년 9월 3일에 지원 종료됩니다. 서비스가 중단되지 않도록 그 전에
v3로 마이그레이션하세요.
부록: 광고 소재 유형별로 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)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"필요한 정보가 없음"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"너무 복잡함/단계 수가 너무 많음"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"오래됨"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"번역 문제"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"샘플/코드 문제"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"기타"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"이해하기 쉬움"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"문제가 해결됨"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"기타"
}]
{
"lastModified": "최종 업데이트: 2023-12-01(UTC)",
"confidential": False
}