- 리소스: 광고 소재
- HostingSource
- CreativeAttribute
- ReviewStatusInfo
- ApprovalStatus
- ReviewStatus
- ExchangeReviewStatus
- PublisherReviewStatus
- AssetAssociation
- 애셋
- AssetRole
- ExitEvent
- ExitEventType
- TimerEvent
- CounterEvent
- AudioVideoOffset
- UniversalAdId
- UniversalAdRegistry
- ThirdPartyUrl
- ThirdPartyUrlType
- 트랜스코드
- CmTrackingAd
- ObaIcon
- ObaIconPosition
- ExpandingDirection
- 메서드
리소스: 광고 소재
단일 광고 소재입니다.
JSON 표현 |
---|
{ "name": string, "advertiserId": string, "creativeId": string, "cmPlacementId": string, "displayName": string, "entityStatus": enum ( |
입력란 | |
---|---|
name |
출력 전용입니다. 광고 소재의 리소스 이름입니다. |
advertiserId |
출력 전용입니다. 광고 소재가 속한 광고주의 고유 ID입니다. |
creativeId |
출력 전용입니다. 광고 소재의 고유 ID입니다. 시스템에서 할당합니다. |
cmPlacementId |
출력 전용입니다. 광고 소재와 연결된 Campaign Manager 360 게재위치의 고유 ID입니다. 이 입력란은 Campaign Manager에서 동기화된 광고 소재에만 적용됩니다. |
displayName |
필수 항목입니다. 광고 소재의 표시 이름입니다. UTF-8 형식으로 인코딩되어야 하며 최대 크기는 240바이트여야 합니다. |
entityStatus |
필수 항목입니다. 광고 소재의 게재 가능 여부를 제어합니다. 허용되는 값은 다음과 같습니다.
|
updateTime |
출력 전용입니다. 사용자 또는 시스템에 의해 광고 소재가 마지막으로 업데이트된 타임스탬프입니다 (예: 광고 소재 검토). 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
createTime |
출력 전용입니다. 광고 소재가 생성된 시점의 타임스탬프입니다. 시스템에서 할당합니다. RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 |
creativeType |
필수 항목입니다. 변경할 수 없습니다. 광고 소재의 유형입니다. |
hostingSource |
필수 항목입니다. 광고 소재가 호스팅되는 위치를 나타냅니다. |
dynamic |
출력 전용입니다. 광고 소재가 동적인지 여부를 나타냅니다. |
dimensions |
필수 항목입니다. 광고 소재의 기본 크기입니다. 모든 광고 소재 유형에 적용할 수 있습니다.
|
additionalDimensions[] |
추가 측정기준
이 필드가 지정된 경우 |
mediaDuration |
출력 전용입니다. 광고 소재의 미디어 재생 시간입니다.
소수점 아래가 최대 9자리까지이고 ' |
creativeAttributes[] |
출력 전용입니다. 시스템에 의해 생성된 광고 소재의 속성 목록입니다. |
reviewStatus |
출력 전용입니다. 광고 소재 검토 과정의 현재 상태입니다. |
assets[] |
필수 항목입니다. 이 광고 소재에 연결된 애셋입니다. |
exitEvents[] |
필수 항목입니다. 이 광고 소재의 이탈 이벤트입니다. 이탈 (클릭 태그라고도 함)은 광고 소재에서 사용자가 클릭하거나 탭하여 광고주의 방문 페이지를 열 수 있는 모든 영역입니다. 모든 광고 소재에는 하나 이상의 이탈이 있어야 합니다. 다음 중 한 가지 방법으로 광고 소재에 이탈을 추가할 수 있습니다.
|
timerEvents[] |
리치 미디어 광고 소재에 대한 맞춤 이벤트 타이머입니다. 타이머는 사용자가 리치 미디어 소재의 지정된 부분을 보고 해당 부분과 상호작용하는 시간을 추적합니다. 광고 소재 하나에 여러 개의 타이머 이벤트가 있을 수 있으며 각 타이머 이벤트의 시간은 독립적으로 기록됩니다. 이미지 확장 소재만 포함된 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
counterEvents[] |
리치 미디어 광고 소재의 카운터 이벤트입니다. 카운터는 사용자가 지정된 방식 (마우스오버, 마우스아웃, 클릭, 탭, 데이터 로드, 키보드 입력 등)으로 리치 미디어 소재의 일부와 상호작용한 횟수를 추적합니다. 광고 소재에서 캡처할 수 있는 모든 이벤트는 카운터로 기록될 수 있습니다. 이미지 확장 소재만 포함된 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
appendedTag |
광고 소재 태그에 추가할 제3자 HTML 추적 태그입니다. |
integrationCode |
이 광고 소재를 외부 시스템에 연결하는 데 사용되는 ID 정보입니다. 10,000자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다. |
notes |
이 광고 소재에 대한 사용자 메모입니다. 20,000자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다. |
iasCampaignMonitoring |
Integral Ad Science (IAS) 캠페인 모니터링이 사용 설정되었는지 여부를 나타냅니다. 광고 소재에 이 기능을 사용 설정하려면 |
companionCreativeIds[] |
동영상 광고 소재의 컴패니언 광고 소재 ID입니다. 기존 디스플레이 광고 소재 (이미지 또는 HTML5 애셋 포함)를 할당하여 게시자의 동영상 플레이어 주변에 게재할 수 있습니다. 컴패니언은 동영상이 재생되는 동안 동영상 플레이어 주위에 표시되고, 동영상이 끝난 후에도 남아 있습니다.
이 필드는 다음
|
skippable |
사용자가 동영상 광고 소재를 건너뛸 수 있는지 여부입니다. 이 필드는 다음
|
skipOffset |
동영상을 재생한 후 건너뛰기 버튼이 표시되기 전까지의 시간입니다.
이 필드는 다음
|
progressOffset |
조회수를 계산하기 전에 동영상을 재생한 시간입니다.
이 필드는 다음
|
universalAdId |
선택사항입니다. 레지스트리에서 제공하는 광고 소재 식별자(선택사항)로, 모든 플랫폼에서 고유합니다. 범용 광고 ID는 VAST 4.0 표준의 일부입니다. 광고 소재를 만든 후에 수정할 수 있습니다. 이 필드는 다음
|
thirdPartyUrls[] |
동영상 광고 소재와의 상호작용을 추적하기 위해 제3자의 추적 URL 이 필드는 다음
|
transcodes[] |
출력 전용입니다. 오디오/동영상 트랜스코드 Display & Video 360은 특정 동영상 플레이어 또는 대역폭에 맞게 설계된 다양한 파일 형식을 사용하거나 속성 (해상도, 오디오 비트 전송률 및 동영상 비트 전송률)이 다른 여러 대체 버전으로 기본 애셋을 트랜스코딩합니다. 이러한 트랜스코드는 게시자 시스템에서 동영상의 각 노출에 대해 선택할 수 있는 옵션을 더 많이 제공하고 시청자의 연결 및 화면 크기에 따라 적절한 파일이 게재되도록 합니다. 이 필드는 다음
|
trackerUrls[] |
분석 제공업체 또는 제3자 광고 기술 공급업체용 추적 URL URL은 https로 시작해야 합니다 (SSL 준수를 요구하지 않는 인벤토리 제외). URL에서 매크로를 사용하는 경우 Display & Video 360에서 지원하는 매크로만 사용하세요. 표준 URL만 사용하고 IMG 또는 script 태그는 사용할 수 없습니다. 이 필드는 다음
|
jsTrackerUrl |
지원되는 서드 파티 인증 제공업체 (ComScore, DoubleVerify, IAS, Moat)의 자바스크립트 측정 URL입니다. HTML 스크립트 태그는 지원되지 않습니다. 이 필드는 다음
|
cmTrackingAd |
광고 소재와 연결된 Campaign Manager 360 추적 광고입니다. Campaign Manager 360과 서드 파티 광고 게재를 모두 사용하는 광고주가 만드는 경우 다음
다른 경우에만 출력합니다. |
obaIcon |
동영상 광고 소재의 OBA 아이콘을 지정합니다. 이 필드는 다음
|
thirdPartyTag |
선택사항입니다. 광고 소재에 사용된 원래의 서드 파티 태그입니다. 필수이며 제3자 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
|
requireMraid |
선택사항입니다. 광고 소재에 MRAID (모바일 리치 미디어 광고 인터페이스 정의 시스템)가 필요함을 나타냅니다. 광고 소재가 상호작용 기능을 위해 모바일 동작(예: 스와이프 또는 탭)을 사용하는 경우 이 속성을 설정합니다. 선택 사항이며 제3자 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
|
requireHtml5 |
선택사항입니다. 광고 소재가 HTML5에 의존하여 제대로 렌더링됨을 나타냅니다. 선택 사항이며 제3자 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
|
requirePingForAttribution |
선택사항입니다. 광고 소재가 기여 분석을 위해 반환 핑을 기다릴 것임을 나타냅니다. 외부 광고 서버 매개변수 및 ${DC_DBM_TOKEN} 매크로와 함께 Campaign Manager 360 추적 광고를 사용하는 경우에만 유효합니다. 선택사항이며 서드 파티 태그 광고 소재 또는 서드 파티 VAST 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 다음
다음
서드 파티 VAST 태그 광고 소재는 다음
다음
|
expandingDirection |
선택사항입니다. 광고 소재의 확장 방향을 지정합니다. 필수이며 제3자 확장형 광고 소재에만 유효합니다. 타사 확장형 광고 소재는 호스팅 소스가 다음과 같은 광고 소재입니다.
다음
|
expandOnHover |
선택사항입니다. 광고 소재가 마우스 오버 시 자동으로 확장됨을 나타냅니다. 선택사항이며 제3자 확장형 광고 소재에만 유효합니다. 타사 확장형 광고 소재는 호스팅 소스가 다음과 같은 광고 소재입니다.
다음
|
vastTagUrl |
선택사항입니다. 서드 파티 VAST 태그 광고 소재의 VAST 태그 URL입니다. 필수이며 타사 VAST 태그 광고 소재에만 유효합니다. 서드 파티 VAST 태그 광고 소재는 다음
다음
|
vpaid |
출력 전용입니다. 타사 VAST 태그 광고 소재에 VPAID (디지털 동영상 플레이어 광고 인터페이스)가 필요함을 나타냅니다. 출력 전용이며 서드 파티 VAST 태그 광고 소재에만 유효합니다. 서드 파티 VAST 태그 광고 소재는 다음
다음
|
html5Video |
출력 전용입니다. 타사 VAST 태그 광고 소재에 HTML5 동영상 지원이 필요함을 나타냅니다. 출력 전용이며 서드 파티 VAST 태그 광고 소재에만 유효합니다. 서드 파티 VAST 태그 광고 소재는 다음
다음
|
lineItemIds[] |
출력 전용입니다. 이 광고 소재와 연결된 광고 항목의 ID입니다. 광고 소재를 광고 항목에 연결하려면 대신 |
mp3Audio |
출력 전용입니다. 타사 오디오 광고 소재가 MP3를 지원함을 나타냅니다. 출력 전용이며 서드 파티 오디오 광고 소재에만 유효합니다. 서드 파티 오디오 광고 소재는 다음
다음
|
oggAudio |
출력 전용입니다. 서드 파티 오디오 광고 소재가 OGG를 지원함을 나타냅니다. 출력 전용이며 서드 파티 오디오 광고 소재에만 유효합니다. 서드 파티 오디오 광고 소재는 다음
다음
|
HostingSource
광고 소재에 대한 가능한 호스팅 소스입니다. 광고 소재가 생성되고 호스팅되는 위치를 나타냅니다.
열거형 | |
---|---|
HOSTING_SOURCE_UNSPECIFIED |
이 버전에서 호스팅 소스가 지정되지 않았거나 알 수 없습니다. |
HOSTING_SOURCE_CM |
Campaign Manager 360에서 동기화된 광고 소재 이 호스팅 유형에는 생성 및 업데이트 메서드가 지원되지 않습니다. |
HOSTING_SOURCE_THIRD_PARTY |
3PAS (외부 광고 서버)에서 호스팅하는 광고 소재입니다.
|
HOSTING_SOURCE_HOSTED |
DV360에서 생성되고 Campaign Manager 360에서 호스팅하는 광고 소재입니다.
|
HOSTING_SOURCE_RICH_MEDIA |
Studio에서 제작되고 Campaign Manager 360에서 호스팅하는 리치 미디어 광고 소재입니다. 이 호스팅 유형에는 생성 및 업데이트 메서드가 지원되지 않습니다. |
CreativeAttribute
광고 소재의 가능한 속성입니다.
열거형 | |
---|---|
CREATIVE_ATTRIBUTE_UNSPECIFIED |
이 버전에서 광고 소재 속성이 지정되지 않았거나 알 수 없습니다. |
CREATIVE_ATTRIBUTE_VAST |
광고 소재가 VAST 광고 소재입니다. |
CREATIVE_ATTRIBUTE_VPAID_LINEAR |
광고 소재는 선형 VPAID 광고 소재입니다. |
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR |
광고 소재는 비선형 VPAID 광고 소재입니다. |
ReviewStatusInfo
광고 소재의 상태를 검토합니다.
JSON 표현 |
---|
{ "approvalStatus": enum ( |
입력란 | |
---|---|
approvalStatus |
광고 소재가 게재되는 데 필요한 기본 승인을 나타냅니다. |
creativeAndLandingPageReviewStatus |
광고 소재의 광고 소재 및 방문 페이지 검토 상태입니다. |
contentAndPolicyReviewStatus |
광고 소재의 콘텐츠 및 정책 검토 상태입니다. |
exchangeReviewStatuses[] |
광고 소재의 검토 상태를 교환합니다. |
publisherReviewStatuses[] |
광고 소재의 게시자 검토 상태입니다. 경고: 이 필드는 2024년 6월 26일에 지원 중단됩니다. 이 날짜 이후에는 이 필드가 비어 있게 됩니다. 자세한 내용은 기능 지원 중단 공지를 참고하세요. |
ApprovalStatus
승인 상태의 유형입니다. creativeAndLandingPageReviewStatus
및 contentAndPolicyReviewStatus
의 요약입니다.
열거형 | |
---|---|
APPROVAL_STATUS_UNSPECIFIED |
이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다. |
APPROVAL_STATUS_PENDING_NOT_SERVABLE |
광고 소재가 아직 검토 중이며 게재할 수 없습니다. |
APPROVAL_STATUS_PENDING_SERVABLE |
광고 소재가 광고 소재 및 방문 페이지 검토를 통과했으며 게재할 수 있지만, 추가 콘텐츠 및 정책 검토를 대기 중입니다. |
APPROVAL_STATUS_APPROVED_SERVABLE |
광고 소재 및 방문 페이지 검토와 콘텐츠 및 정책 검토가 모두 승인됩니다. 게재할 수 있는 광고 소재입니다. |
APPROVAL_STATUS_REJECTED_NOT_SERVABLE |
광고 소재에 문제가 있습니다. 이 문제를 해결해야 광고를 게재할 수 있습니다. |
ReviewStatus
가능한 검토 상태의 유형입니다.
열거형 | |
---|---|
REVIEW_STATUS_UNSPECIFIED |
이 버전에서 유형 값이 지정되지 않았거나 알 수 없습니다. |
REVIEW_STATUS_APPROVED |
광고 소재가 승인되었습니다. |
REVIEW_STATUS_REJECTED |
광고 소재가 거부되었습니다. |
REVIEW_STATUS_PENDING |
광고 소재가 검토 대기 중입니다. |
ExchangeReviewStatus
광고 소재의 Exchange 검토 상태입니다.
JSON 표현 |
---|
{ "exchange": enum ( |
입력란 | |
---|---|
exchange |
광고 소재를 검토하는 광고 거래소 |
status |
거래소 검토 상태입니다. |
PublisherReviewStatus
광고 소재의 게시자 검토 상태입니다.
JSON 표현 |
---|
{
"publisherName": string,
"status": enum ( |
입력란 | |
---|---|
publisherName |
광고 소재를 검토하는 게시자입니다. |
status |
게시자 검토 상태입니다. |
AssetAssociation
광고 소재의 애셋 연결입니다.
JSON 표현 |
---|
{ "asset": { object ( |
입력란 | |
---|---|
asset |
연결된 저작물입니다. |
role |
광고 소재에 대한 이 애셋의 역할입니다. |
애셋
단일 저작물입니다.
JSON 표현 |
---|
{ "mediaId": string, "content": string } |
입력란 | |
---|---|
mediaId |
업로드된 저작물의 미디어 ID입니다. 저작물의 고유 식별자입니다. 이 ID는 다른 API 호출(예: 미디어 ID 공간이 2023년 4월 5일에 업데이트되었습니다. 연결된 광고 소재 리소스에서 새 미디어 ID를 검색하거나 애셋을 다시 업로드하여 2023년 4월 5일 이전에 캐시된 미디어 ID를 업데이트하세요. |
content |
저작물 콘텐츠입니다. 업로드된 확장 소재의 경우 콘텐츠는 게재 경로입니다. |
AssetRole
광고 소재에 대한 이 애셋의 역할입니다.
열거형 | |
---|---|
ASSET_ROLE_UNSPECIFIED |
이 버전에서 애셋 역할이 지정되지 않았거나 알 수 없습니다. |
ASSET_ROLE_MAIN |
애셋은 광고 소재의 기본 애셋입니다. |
ASSET_ROLE_BACKUP |
애셋은 광고 소재의 백업 애셋입니다. |
ASSET_ROLE_POLITE_LOAD |
애셋은 광고 소재의 폴라이트 로드 애셋입니다. |
ASSET_ROLE_HEADLINE |
네이티브 광고 소재의 제목입니다.
이 역할은 다음
|
ASSET_ROLE_LONG_HEADLINE |
네이티브 광고 소재의 긴 광고 제목입니다.
이 역할은 다음
|
ASSET_ROLE_BODY |
네이티브 광고 소재의 본문 텍스트입니다.
이 역할은 다음
|
ASSET_ROLE_LONG_BODY |
네이티브 광고 소재의 긴 본문 텍스트
이 역할은 다음
|
ASSET_ROLE_CAPTION_URL |
광고 소재에 표시할 방문 페이지 URL의 쉽고 간결한 버전입니다. 사용자는 이 URL을 통해 광고 소재를 클릭하면 어디로 연결될지 짐작할 수 있습니다.
예를 들어 방문 페이지 URL이 'http://www.example.com/page'인 경우 자막 URL은 'example.com'이 될 수 있습니다. 프로토콜 (http://)은 선택사항이지만 URL에 공백이나 특수문자를 포함할 수 없습니다. 이 역할은 다음
|
ASSET_ROLE_CALL_TO_ACTION |
네이티브 광고 소재의 클릭 유도 문구 버튼에 사용할 텍스트입니다.
이 역할은 다음
|
ASSET_ROLE_ADVERTISER_NAME |
광고주 또는 브랜드 이름을 식별하는 텍스트입니다.
이 역할은 다음
|
ASSET_ROLE_PRICE |
Google Play 스토어 또는 iOS 앱 스토어에서의 앱 구매 가격 (예: 5.99달러)입니다. 이 값은 스토어에 표시된 실제 값과 자동으로 동기화되지 않습니다. 이 ID는 광고 소재를 저장할 때 항상 제공됩니다.
이 역할의 애셋은 읽기 전용입니다. |
ASSET_ROLE_ANDROID_APP_ID |
Google Play 스토어에 있는 Android 앱의 ID입니다. 이 ID는 앱의 Google Play 스토어 URL 'id' 뒤에 표시됩니다. 예를 들어 https://play.google.com/store/apps/details?id=com.company.appname에서 식별자는 com.company.appname입니다. 이 역할의 애셋은 읽기 전용입니다. |
ASSET_ROLE_IOS_APP_ID |
Apple App Store의 iOS 앱 ID입니다. 이 ID 번호는 Apple App Store URL에서 'id' 바로 뒤에 붙은 숫자 문자열로 찾을 수 있습니다. 예를 들어 https://apps.apple.com/us/app/gmail-email-by-google/id422689480에서 ID는 422689480입니다. 이 역할의 애셋은 읽기 전용입니다. |
ASSET_ROLE_RATING |
Google Play 스토어 또는 iOS 앱 스토어에 있는 앱의 평점입니다. 이 값은 스토어의 실제 평점과 자동으로 동기화되지 않습니다. 이 ID는 광고 소재를 저장할 때 항상 제공됩니다. 이 역할의 애셋은 읽기 전용입니다. |
ASSET_ROLE_ICON |
광고 소재의 아이콘입니다. 이 역할은 다음
|
ASSET_ROLE_COVER_IMAGE |
네이티브 동영상 광고 소재의 표지 이미지입니다. 이 역할은 다음
|
ExitEvent
광고 소재의 이탈 이벤트입니다.
JSON 표현 |
---|
{
"type": enum ( |
입력란 | |
---|---|
type |
필수 항목입니다. 이탈 이벤트의 유형입니다. |
url |
필수 항목입니다. 이탈 이벤트의 클릭연결 URL입니다.
|
name |
이탈 이벤트의 클릭 태그 이름입니다. 이름은 하나의 광고 소재 내에서 고유해야 합니다. 이미지 확장 소재만 포함된 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
reportingName |
보고서에서 이 이벤트를 식별하는 데 사용되는 이름입니다. 이미지 확장 소재만 포함된 광고 소재의 경우 이 입력란을 비워두거나 설정하지 않습니다. |
ExitEventType
이탈 이벤트의 유형입니다.
열거형 | |
---|---|
EXIT_EVENT_TYPE_UNSPECIFIED |
이 버전에서 이탈 이벤트 유형이 지정되지 않았거나 알 수 없습니다. |
EXIT_EVENT_TYPE_DEFAULT |
이탈 이벤트가 기본 이벤트입니다. |
EXIT_EVENT_TYPE_BACKUP |
이탈 이벤트는 백업 이탈 이벤트입니다. 광고 소재에 여러 백업 이탈 이벤트가 있을 수 있습니다. |
TimerEvent
광고 소재의 타이머 이벤트입니다.
JSON 표현 |
---|
{ "name": string, "reportingName": string } |
입력란 | |
---|---|
name |
필수 항목입니다. 타이머 이벤트의 이름입니다. |
reportingName |
필수 항목입니다. 보고서에서 이 타이머 이벤트를 식별하는 데 사용되는 이름입니다. |
CounterEvent
광고 소재의 카운터 이벤트입니다.
JSON 표현 |
---|
{ "name": string, "reportingName": string } |
입력란 | |
---|---|
name |
필수 항목입니다. 카운터 이벤트의 이름입니다. |
reportingName |
필수 항목입니다. 보고서에서 이 카운터 이벤트를 식별하는 데 사용되는 이름입니다. |
AudioVideoOffset
오디오 또는 동영상이 재생된 길이입니다.
JSON 표현 |
---|
{ // Union field |
입력란 | |
---|---|
통합 필드 offset . 오프셋의 값입니다. offset 는 다음 중 하나여야 합니다. |
|
percentage |
오디오 또는 동영상 재생 시간의 오프셋입니다(단위: 백분율). |
seconds |
오디오 또는 동영상 시작 부분으로부터의 오프셋(초)입니다. |
UniversalAdId
레지스트리에서 제공하는 광고 소재 식별자로, 모든 플랫폼에서 고유합니다. 이는 VAST 4.0 표준의 일부입니다.
JSON 표현 |
---|
{
"id": string,
"registry": enum ( |
입력란 | |
---|---|
id |
고유한 광고 소재 식별자입니다. |
registry |
등록처는 고유한 광고 소재 식별자를 제공합니다. |
UniversalAdRegistry
등록처는 범용 광고 ID에 고유한 광고 소재 식별자를 제공합니다.
열거형 | |
---|---|
UNIVERSAL_AD_REGISTRY_UNSPECIFIED |
이 버전에서 범용 광고 레지스트리가 지정되지 않았거나 알 수 없습니다. |
UNIVERSAL_AD_REGISTRY_OTHER |
맞춤 제공업체를 사용하여 범용 광고 ID를 제공하세요. |
UNIVERSAL_AD_REGISTRY_AD_ID |
광고 ID를 사용하여 범용 광고 ID를 제공하세요. |
UNIVERSAL_AD_REGISTRY_CLEARCAST |
clearcast.co.uk에서 범용 광고 ID를 제공하세요. |
UNIVERSAL_AD_REGISTRY_DV360 |
Display & Video 360을 사용하여 범용 광고 ID를 제공합니다. |
UNIVERSAL_AD_REGISTRY_CM |
Campaign Manager 360을 사용하여 유니버설 광고 ID를 제공합니다. |
ThirdPartyUrl
오디오 또는 동영상 광고 소재와의 상호작용을 추적하기 위해 타사의 추적 URL
JSON 표현 |
---|
{
"type": enum ( |
입력란 | |
---|---|
type |
상호작용 유형은 추적 URL로 추적해야 합니다. |
url |
상호작용을 추적하는 데 사용되는 추적 URL입니다.
|
ThirdPartyUrlType
상호작용 유형은 서드 파티 추적 URL로 추적해야 합니다.
열거형 | |
---|---|
THIRD_PARTY_URL_TYPE_UNSPECIFIED |
이 버전에서 서드 파티 URL 유형이 지정되지 않았거나 알 수 없습니다. |
THIRD_PARTY_URL_TYPE_IMPRESSION |
오디오 또는 동영상 버퍼링이 완료된 후에 광고 소재의 노출수를 계산하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_CLICK_TRACKING |
오디오 또는 동영상에 대한 사용자 클릭을 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START |
사용자가 오디오 또는 동영상을 시작하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE |
오디오 또는 동영상이 전체 길이의 25% 까지 재생된 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT |
오디오 또는 동영상이 전체 길이의 50% 까지 재생된 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE |
오디오 또는 동영상이 전체 길이의 75% 까지 재생된 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE |
오디오 또는 동영상이 끝까지 재생되는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE |
사용자가 오디오 또는 동영상을 음소거하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE |
사용자가 오디오 또는 동영상을 일시중지하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND |
사용자가 오디오 또는 동영상을 다시 재생한 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN |
사용자가 플레이어를 전체 화면 크기로 확장하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP |
사용자가 오디오 또는 동영상을 정지하는 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM |
사용자가 맞춤 클릭(예: 동영상 핫스팟 클릭)을 수행한 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP |
오디오 또는 동영상을 건너뛴 횟수를 추적하는 데 사용됩니다. |
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS |
progressOffset 에 의해 결정된 오프셋까지 오디오 또는 동영상이 재생되는 횟수를 추적하는 데 사용됩니다. |
트랜스코드
트랜스코딩된 오디오 또는 동영상 파일에 대한 정보를 나타냅니다.
JSON 표현 |
---|
{
"name": string,
"mimeType": string,
"transcoded": boolean,
"dimensions": {
object ( |
입력란 | |
---|---|
name |
트랜스코딩된 파일의 이름입니다. |
mimeType |
트랜스코딩된 파일의 MIME 유형입니다. |
transcoded |
트랜스코딩이 성공했는지 여부를 나타냅니다. |
dimensions |
트랜스코딩된 동영상의 크기입니다. |
bitRateKbps |
트랜스코딩된 동영상의 트랜스코딩 비트 전송률(kbit/초)입니다. |
frameRate |
트랜스코딩된 동영상의 프레임 속도(초당 프레임 수)입니다. |
audioBitRateKbps |
트랜스코딩된 동영상의 오디오 스트림 비트 전송률 또는 트랜스코딩된 오디오의 비트 전송률(kbit/초)입니다. |
audioSampleRateHz |
트랜스코딩된 동영상의 오디오 스트림에 대한 샘플링 레이트 또는 트랜스코딩된 오디오의 샘플링 레이트(Hz)입니다. |
fileSizeBytes |
트랜스코딩된 파일의 크기(바이트)입니다. |
CmTrackingAd
Campaign Manager 360 추적 광고입니다.
JSON 표현 |
---|
{ "cmPlacementId": string, "cmCreativeId": string, "cmAdId": string } |
입력란 | |
---|---|
cmPlacementId |
캠페인 관리자 360 추적 광고의 게재위치 ID입니다. |
cmCreativeId |
캠페인 관리자 360 추적 광고의 광고 소재 ID입니다. |
cmAdId |
캠페인 관리자 360 추적 광고의 광고 ID입니다. |
ObaIcon
광고 소재의 OBA 아이콘
JSON 표현 |
---|
{ "resourceUrl": string, "resourceMimeType": string, "position": enum ( |
입력란 | |
---|---|
resourceUrl |
OBA 아이콘 리소스의 URL입니다. |
resourceMimeType |
OBA 아이콘 리소스의 MIME 유형입니다. |
position |
광고 소재에서 OBA 아이콘의 위치입니다. |
dimensions |
OBA 아이콘의 크기입니다. |
program |
OBA 아이콘의 프로그램입니다. (예: 'AdChoices') |
landingPageUrl |
필수 항목입니다. OBA 아이콘의 방문 페이지 URL입니다. 다음 도메인의 URL만 허용됩니다. |
clickTrackingUrl |
필수 항목입니다. OBA 아이콘의 클릭 추적 URL입니다. 다음 도메인의 URL만 허용됩니다. |
viewTrackingUrl |
필수 항목입니다. OBA 아이콘의 보기 추적 URL입니다. 다음 도메인의 URL만 허용됩니다. |
ObaIconPosition
광고 소재에서 OBA 아이콘의 위치입니다.
열거형 | |
---|---|
OBA_ICON_POSITION_UNSPECIFIED |
OBA 아이콘 위치가 지정되지 않았습니다. |
OBA_ICON_POSITION_UPPER_RIGHT |
광고 소재의 오른쪽 상단 |
OBA_ICON_POSITION_UPPER_LEFT |
광고 소재의 왼쪽 상단 |
OBA_ICON_POSITION_LOWER_RIGHT |
광고 소재의 오른쪽 하단에 위치 |
OBA_ICON_POSITION_LOWER_LEFT |
광고 소재의 왼쪽 하단에 위치 |
ExpandingDirection
타사 확장 광고 소재의 확장 방향입니다.
열거형 | |
---|---|
EXPANDING_DIRECTION_UNSPECIFIED |
확장 방향이 지정되지 않았습니다. |
EXPANDING_DIRECTION_NONE |
어떤 방향으로도 확장되지 않습니다. |
EXPANDING_DIRECTION_UP |
확장됩니다. |
EXPANDING_DIRECTION_DOWN |
아래로 펼칩니다. |
EXPANDING_DIRECTION_LEFT |
왼쪽으로 펼칩니다. |
EXPANDING_DIRECTION_RIGHT |
오른쪽으로 확장됩니다. |
EXPANDING_DIRECTION_UP_AND_LEFT |
위쪽과 왼쪽으로 확장됩니다. |
EXPANDING_DIRECTION_UP_AND_RIGHT |
위쪽 및 오른쪽으로 확장됩니다. |
EXPANDING_DIRECTION_DOWN_AND_LEFT |
아래로 그리고 왼쪽으로 확장됩니다. |
EXPANDING_DIRECTION_DOWN_AND_RIGHT |
오른쪽 아래로 확장됩니다. |
EXPANDING_DIRECTION_UP_OR_DOWN |
위 또는 아래로 확장됩니다. |
EXPANDING_DIRECTION_LEFT_OR_RIGHT |
왼쪽 또는 오른쪽으로 확장됩니다. |
EXPANDING_DIRECTION_ANY_DIAGONAL |
모든 대각선 방향으로 확장할 수 있습니다. |
메서드 |
|
---|---|
|
새 광고 소재를 만듭니다. |
|
광고 소재를 삭제합니다. |
|
광고 소재를 가져옵니다. |
|
광고주의 광고 소재를 나열합니다. |
|
기존 광고 소재를 업데이트합니다. |