REST Resource: advertisers.creatives

리소스: 광고 소재

단일 광고 소재

JSON 표현 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
필드
name

string

출력 전용입니다. 광고 소재의 리소스 이름입니다.
advertiserId

string (int64 format)

출력 전용입니다. 광고 소재가 속한 광고주의 고유 ID입니다.
creativeId

string (int64 format)

출력 전용입니다. 광고 소재의 고유 ID입니다. 시스템에서 할당합니다.
cmPlacementId

string (int64 format)

출력 전용입니다. 광고 소재와 연결된 Campaign Manager 360 게재위치의 고유 ID입니다. 이 필드는 Campaign Manager에서 동기화된 광고 소재에만 적용됩니다.
displayName

string

필수 항목입니다. 광고 소재의 표시 이름입니다.

최대 240바이트의 UTF-8로 인코딩되어야 합니다.
entityStatus

enum (EntityStatus)

필수 항목입니다. 광고 소재가 게재될 수 있는지 여부를 제어합니다.

허용되는 값은 다음과 같습니다.

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

출력 전용입니다. 사용자 또는 시스템 (예: 광고 소재 검토)에서 광고 소재를 마지막으로 업데이트한 타임스탬프입니다. 시스템에서 할당합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
createTime

string (Timestamp format)

출력 전용입니다. 광고 소재가 생성된 타임스탬프입니다. 시스템에서 할당합니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
creativeType

enum (CreativeType)

필수 항목입니다. 변경할 수 없습니다. 광고 소재 유형입니다.
hostingSource

enum (HostingSource)

필수 항목입니다. 광고 소재가 호스팅되는 위치를 나타냅니다.
dynamic

boolean

출력 전용입니다. 광고 소재가 동적인지 여부를 나타냅니다.
dimensions

object (Dimensions)

필수 항목입니다. 광고 소재의 기본 크기입니다. 모든 광고 소재 유형에 적용할 수 있습니다. creativeType이 다음 중 하나인 경우 widthPixels 및 heightPixels의 값은 기본적으로 0입니다.

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

추가 측정기준 creativeType이 다음 중 하나인 경우에 적용됩니다.

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

이 필드가 지정되면 widthPixels 및 heightPixels 모두 필수이며 0 이상이어야 합니다.
mediaDuration

string (Duration format)

출력 전용입니다. 광고 소재의 미디어 재생 시간입니다. creativeType이 다음 중 하나인 경우에 적용됩니다.

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

소수점 아래가 최대 9자리까지이고 's'로 끝나는 초 단위 기간입니다. 예를 들면 "3.5s"입니다.
creativeAttributes[]

enum (CreativeAttribute)

출력 전용입니다. 시스템에서 생성한 광고 소재의 속성 목록입니다.
reviewStatus

object (ReviewStatusInfo)

출력 전용입니다. 광고 소재 검토 프로세스의 현재 상태입니다.
assets[]

object (AssetAssociation)

필수 항목입니다. 이 광고 소재에 연결된 애셋입니다.
exitEvents[]

object (ExitEvent)

필수 항목입니다. 이 광고 소재의 종료 이벤트입니다. 이탈(클릭 태그라고도 함)은 사용자가 클릭하거나 탭하여 광고주의 방문 페이지를 열 수 있는 광고 소재의 영역입니다. 모든 광고 소재에는 하나 이상의 종료가 포함되어야 합니다. 다음과 같은 방법으로 광고 소재에 이탈을 추가할 수 있습니다.

  • Google Web Designer의 탭 영역을 사용합니다.
  • 'clickTag'라는 JavaScript 변수를 정의합니다.
  • 인에이블러 (Enabler.exit())를 사용하여 리치 미디어 형식의 종료를 추적합니다.
timerEvents[]

object (TimerEvent)

리치 미디어 광고 소재의 타이머 맞춤 이벤트 타이머는 사용자가 리치 미디어 광고 소재의 지정된 부분을 보고 해당 부분과 상호작용한 시간을 추적합니다. 광고 소재 하나에 여러 개의 타이머 이벤트가 있을 수 있으며, 각 타이머 이벤트의 시간은 독립적으로 기록됩니다. 이미지 애셋만 포함된 광고 소재의 경우 비워 두거나 설정하지 않습니다.
counterEvents[]

object (CounterEvent)

리치 미디어 광고 소재의 카운터 이벤트입니다. 카운터는 사용자가 지정된 방식(마우스 오버, 마우스아웃, 클릭, 탭, 데이터 로드, 키보드 입력 등)으로 리치 미디어 광고의 일부와 상호작용한 횟수를 추적합니다. 광고 소재에서 캡처할 수 있는 모든 이벤트는 카운터로 기록할 수 있습니다. 이미지 애셋만 포함된 광고 소재의 경우 비워 두거나 설정하지 않습니다.
appendedTag

string

광고 소재 태그에 추가될 제3자 HTML 추적 태그입니다.
integrationCode

string

이 광고 소재를 외부 시스템에 연결하는 데 사용되는 ID 정보입니다. 10,000자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.
notes

string

이 광고 소재에 대한 사용자 메모입니다. 20,000자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.
iasCampaignMonitoring

boolean

Integral Ad Science(IAS) 캠페인 모니터링이 사용 설정되어 있는지 여부를 나타냅니다. 광고 소재에 이 기능을 사용 설정하려면 Advertiser.creative_config.ias_client_id가 IAS 클라이언트 ID로 설정되어 있는지 확인하세요.
companionCreativeIds[]

string (int64 format)

동영상 광고 소재의 컴패니언 광고 소재 ID입니다.

게시자의 동영상 플레이어 주변에 게재할 기존 디스플레이 광고 소재 (이미지 또는 HTML5 애셋 포함)를 할당할 수 있습니다. 동영상이 재생되는 동안 동영상 플레이어 주변에 컴패니언이 표시되며 동영상이 완료된 후에도 계속 표시됩니다.

additional dimensions가 포함된 광고 소재는 컴패니언 광고 소재가 될 수 없습니다.

이 필드는 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

사용자가 동영상 광고 소재를 건너뛸 수 있는지 여부입니다.

이 필드는 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

동영상을 재생한 후에 건너뛰기 버튼이 표시됩니다.

skippable가 true인 경우 이 필드는 필수입니다.

이 필드는 다음 creativeType에만 지원됩니다.

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

조회수를 집계하기 전에 동영상을 재생해야 하는 시간입니다.

skippable가 true일 때 이 필드는 필수입니다.

이 필드는 다음 creativeType에만 지원됩니다.

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

선택사항입니다. 레지스트리에서 제공하는 광고 소재 식별자(선택사항)로, 모든 플랫폼에서 고유합니다.

범용 광고 ID는 VAST 4.0 표준의 일부입니다. 광고 소재가 생성된 후 수정할 수 있습니다.

이 필드는 다음 creativeType에만 지원됩니다.

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

동영상 광고 소재와의 상호작용을 추적하기 위한 서드 파티의 추적 URL

이 필드는 다음 creativeType에만 지원됩니다.

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

출력 전용입니다. 오디오/동영상 트랜스코딩

Display & Video 360은 기본 애셋을 서로 다른 파일 형식을 사용하거나 서로 다른 속성 (해상도, 오디오 비트 전송률, 동영상 비트 전송률)을 가진 여러 대체 버전으로 트랜스코딩하며, 각 버전은 특정 동영상 플레이어 또는 대역폭에 맞게 설계됩니다.

이러한 트랜스코딩을 통해 게시자 시스템은 동영상의 각 노출에 대해 더 많은 옵션을 선택할 수 있으며 시청자의 연결 상태와 화면 크기에 따라 적절한 파일이 게재되도록 할 수 있습니다.

이 필드는 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

분석 제공업체 또는 서드 파티 광고 기술 공급업체의 추적 URL입니다.

URL은 https로 시작해야 합니다 (SSL 규정 준수가 필요하지 않은 인벤토리 제외). URL에 매크로를 사용하는 경우 Display & Video 360에서 지원하는 매크로만 사용하세요.

표준 URL만 사용하고 IMG 또는 SCRIPT 태그는 사용하지 마세요.

이 필드는 다음 creativeType에서만 쓸 수 있습니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

지원되는 서드 파티 인증 제공업체 (ComScore, DoubleVerify, IAS, Moat)의 JavaScript 측정 URL입니다. HTML 스크립트 태그는 지원되지 않습니다.

이 필드는 다음 creativeType에서만 쓸 수 있습니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

광고 소재와 연결된 Campaign Manager 360 추적 광고입니다.

Campaign Manager 360과 서드 파티 광고 게재를 모두 사용하는 광고주가 만든 경우 다음 creativeType의 선택사항입니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

다른 케이스에 대해서만 출력합니다.
obaIcon

object (ObaIcon)

동영상 광고 소재의 OBA 아이콘을 지정합니다.

이 필드는 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

선택사항입니다. 광고 소재에 사용된 원래 서드 파티 태그입니다.

필수이며 서드 파티 태그 광고 소재에만 유효합니다.

서드 파티 태그 광고 소재는 다음과 같은 hostingSource가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

선택사항입니다. 광고 소재에 MRAID(모바일 리치 미디어 광고 인터페이스 정의 시스템)가 필요하다는 것을 나타냅니다.

광고 소재가 상호작용을 위해 모바일 동작(예: 스와이프 또는 탭)을 사용하는 경우 이 속성을 설정합니다.

선택사항이며 서드 파티 태그 광고 소재에만 유효합니다.

서드 파티 태그 광고 소재는 다음과 같은 hostingSource가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

선택사항입니다. 광고 소재가 제대로 렌더링되기 위해 HTML5를 사용해야 함을 나타냅니다.

선택사항이며 제3자 태그 광고 소재에만 유효합니다. 서드 파티 태그 광고 소재는 hostingSource를 포함하는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

선택사항입니다. 광고 소재가 기여 분석을 위해 반환 핑을 기다릴 것임을 나타냅니다.

서드 파티 광고 서버 매개변수 및 ${DC_DBM_TOKEN} 매크로와 함께 Campaign Manager 360 추적 광고를 사용하는 경우에만 유효합니다.

선택사항이며 제3자 태그 광고 소재 또는 제3자 VAST 태그 광고 소재에만 유효합니다.

서드 파티 태그 광고 소재는 다음과 같은 hostingSource가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

타사 VAST 태그 광고 소재는 hostingSource를 포함하는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

선택사항입니다. 광고 소재의 확장 방향을 지정합니다.

확장 가능한 서드 파티 광고 소재에만 필수사항이며 유효합니다.

서드 파티 확장 가능 광고 소재는 다음과 같은 호스팅 소스가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

선택사항입니다. 마우스 오버 시 광고 소재가 자동으로 확장됨을 나타냅니다.

선택사항이며 확장 가능한 서드 파티 광고 소재에만 유효합니다. 서드 파티 확장 가능 광고 소재는 다음과 같은 호스팅 소스가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

선택사항입니다. 서드 파티 VAST 태그 광고 소재의 VAST 태그 URL입니다.

서드 파티 VAST 태그 광고 소재에만 필수이며 유효합니다.

타사 VAST 태그 광고 소재는 hostingSource를 포함하는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

출력 전용입니다. 서드 파티 VAST 태그 광고 소재에 VPAID (디지털 동영상 플레이어 광고 인터페이스)가 필요함을 나타냅니다.

서드 파티 VAST 태그 광고 소재에만 출력되며 서드 파티 VAST 태그 광고 소재에만 유효합니다.

서드 파티 VAST 태그 광고 소재는 다음과 같은 hostingSource가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

출력 전용입니다. 서드 파티 VAST 태그 광고 소재에 HTML5 동영상 지원이 필요하다는 것을 나타냅니다.

서드 파티 VAST 태그 광고 소재에만 출력되며 서드 파티 VAST 태그 광고 소재에만 유효합니다.

서드 파티 VAST 태그 광고 소재는 다음과 같은 hostingSource가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

출력 전용입니다. 이 광고 소재가 연결된 광고 항목의 ID입니다.

광고 항목에 광고 소재를 연결하려면 대신 LineItem.creative_ids를 사용하세요.
mp3Audio

boolean

출력 전용입니다. 서드 파티 오디오 광고 소재가 MP3를 지원함을 나타냅니다.

출력 전용이며 서드 파티 오디오 광고 소재에만 유효합니다.

서드 파티 오디오 광고 소재는 다음 hostingSource가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

출력 전용입니다. 서드 파티 오디오 광고 소재가 OGG를 지원함을 나타냅니다.

출력 전용이며 서드 파티 오디오 광고 소재에만 유효합니다.

서드 파티 오디오 광고 소재는 다음 hostingSource가 있는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합:

  • CREATIVE_TYPE_AUDIO

HostingSource

광고 소재를 호스팅할 수 있는 소스입니다. 광고 소재를 만들고 호스팅하는 위치를 나타냅니다.

열거형
HOSTING_SOURCE_UNSPECIFIED 이 버전에서 호스팅 소스가 지정되지 않았거나 알 수 없습니다.
HOSTING_SOURCE_CM

Campaign Manager 360에서 동기화된 광고 소재입니다.

이 호스팅 유형에서는 만들기 및 업데이트 메서드가 지원되지 않습니다.
HOSTING_SOURCE_THIRD_PARTY

서드 파티 광고 서버(3PAS)에서 호스팅하는 광고 소재입니다.

creativeType가 다음 중 하나인 경우 이 호스팅 유형에 만들기 및 업데이트 방법이 지원됩니다.

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

DV360에서 만들어지고 Campaign Manager 360에서 호스팅되는 광고 소재입니다.

creativeType이 다음 중 하나인 경우 이 호스팅 유형에 생성 및 업데이트 메서드가 지원됩니다.

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
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": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
필드
approvalStatus

enum (ApprovalStatus)

광고 소재의 게재를 시작하는 데 필요한 기본 승인을 나타냅니다. creativeAndLandingPageReviewStatus 및 contentAndPolicyReviewStatus의 요약
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

광고 소재의 광고 소재 및 방문 페이지 검토 상태입니다.
contentAndPolicyReviewStatus

enum (ReviewStatus)

광고 소재의 콘텐츠 및 정책 검토 상태입니다.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

광고 소재의 검토 상태를 교환합니다.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

광고 소재의 게시자 검토 상태입니다.

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": enum (ReviewStatus)
}
필드
exchange

enum (Exchange)

광고 소재를 검토하는 거래소입니다.
status

enum (ReviewStatus)

교환 검토 상태입니다.

PublisherReviewStatus

광고 소재의 게시자 검토 상태입니다.

JSON 표현 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
필드
publisherName

string

광고 소재를 검토하는 게시자
status

enum (ReviewStatus)

게시자 검토 상태입니다.

AssetAssociation

광고 소재의 애셋 연결입니다.

JSON 표현 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
필드
asset

object (Asset)

관련 저작물입니다.
role

enum (AssetRole)

광고 소재에서 이 애셋의 역할입니다.

확장 소재

단일 저작물

JSON 표현 
{
  "mediaId": string,
  "content": string
}
필드
mediaId

string (int64 format)

업로드된 애셋의 미디어 ID입니다. 저작물의 고유 식별자입니다. 이 ID는 애셋을 광고 소재와 연결하기 위해 creatives.create와 같은 다른 API 호출에 전달할 수 있습니다.

미디어 ID 공간이 2023년 4월 5일에 업데이트되었습니다. 연결된 광고 소재 리소스에서 새 미디어 ID를 가져오거나 저작물을 다시 업로드하여 2023년 4월 5일 이전에 캐시된 미디어 ID를 업데이트합니다.
content

string

저작물 콘텐츠입니다. 업로드된 애셋의 경우 콘텐츠가 게재 경로입니다.

AssetRole

광고 소재에서 이 애셋의 역할입니다.

열거형
ASSET_ROLE_UNSPECIFIED 애셋 역할이 지정되지 않았거나 이 버전에서 알 수 없습니다.
ASSET_ROLE_MAIN 애셋은 광고 소재의 기본 애셋입니다.
ASSET_ROLE_BACKUP 애셋은 광고 소재의 백업 애셋입니다.
ASSET_ROLE_POLITE_LOAD 이 애셋은 광고 소재의 정중한 로드 애셋입니다.
ASSET_ROLE_HEADLINE

네이티브 광고 소재의 광고 제목입니다.

content는 UTF-8로 인코딩되어야 하며 길이는 25자(영문 기준) 이하여야 합니다.

이 역할은 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

네이티브 광고 소재의 긴 광고 제목

content는 50자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.

이 역할은 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

네이티브 광고 소재의 본문 텍스트입니다.

content는 UTF-8로 인코딩되어야 하며 길이는 90자(영문 기준) 이하여야 합니다.

이 역할은 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

네이티브 광고 소재의 긴 본문 텍스트입니다.

content는 150자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.

이 역할은 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

광고 소재에 표시할 방문 페이지 URL의 쉽고 간결한 버전입니다. 사용자는 이 URL을 통해 광고 소재를 클릭하면 어떤 페이지로 연결되는지 알 수 있습니다.

content는 UTF-8로 인코딩되어야 하며 길이는 30자(영문 기준) 이하여야 합니다.

예를 들어 방문 페이지 URL이 'http://www.example.com/page'인 경우 캡션 URL은 'example.com'일 수 있습니다. 프로토콜 (http://)은 선택사항이지만 URL은 공백이나 특수 문자를 포함할 수 없습니다.

이 역할은 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

네이티브 광고 소재의 클릭 유도 문구 버튼에 사용할 텍스트입니다.

content는 15자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.

이 역할은 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

광고주 또는 브랜드 이름을 식별하는 텍스트입니다.

content는 UTF-8로 인코딩되어야 하며 길이는 25자(영문 기준) 이하여야 합니다.

이 역할은 다음 creativeType에서만 지원됩니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Google Play 스토어 또는 iOS 앱 스토어에서 앱을 구매할 때의 가격입니다(예: 5.99달러).

이 값은 매장에 표시된 실제 값과 자동으로 동기화되지 않습니다. 광고 소재를 저장할 때 제공된 항목이 항상 표시됩니다.

content는 UTF-8로 인코딩되어야 하며 길이는 15자(영문 기준) 이하여야 합니다.

이 역할의 애셋은 읽기 전용입니다.
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 App Store의 앱 평점입니다.

이 값은 스토어의 실제 평점과 자동으로 동기화되지 않습니다. 광고 소재를 저장할 때 제공된 항목이 항상 표시됩니다.

이 역할의 애셋은 읽기 전용입니다.
ASSET_ROLE_ICON

광고 소재의 아이콘입니다.

이 역할은 다음 creativeType에서만 지원되고 필요합니다.

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

네이티브 동영상 광고 소재의 표지 이미지입니다.

이 역할은 다음 creativeType에서만 지원되고 필요합니다.

  • CREATIVE_TYPE_VIDEO

ExitEvent

광고 소재의 종료 이벤트입니다.

JSON 표현 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
필드
type

enum (ExitEventType)

필수 항목입니다. 종료 이벤트의 유형입니다.
url

string

필수 항목입니다. 이탈 이벤트의 클릭연결 URL입니다. type이 다음과 같은 경우 필수입니다.

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

종료 이벤트의 클릭 태그 이름입니다.

이름은 하나의 광고 소재 내에서 고유해야 합니다.

이미지 확장 소재가 포함된 광고 소재에 대해서만 이 입력란을 비워두거나 설정하지 마세요.
reportingName

string

보고서에서 이 이벤트를 식별하는 데 사용되는 이름입니다. 이미지 애셋만 포함된 광고 소재의 경우 비워 두거나 설정하지 않습니다.

ExitEventType

종료 이벤트의 유형입니다.

열거형
EXIT_EVENT_TYPE_UNSPECIFIED 이 버전에서 종료 이벤트 유형이 지정되지 않았거나 알 수 없습니다.
EXIT_EVENT_TYPE_DEFAULT 이탈 이벤트가 기본 이벤트입니다.
EXIT_EVENT_TYPE_BACKUP 이탈 이벤트는 백업 이탈 이벤트입니다. 광고 소재에 백업 이탈 이벤트가 여러 개 있을 수 있습니다.

TimerEvent

광고 소재의 타이머 이벤트입니다.

JSON 표현 
{
  "name": string,
  "reportingName": string
}
필드
name

string

필수 항목입니다. 타이머 이벤트의 이름입니다.
reportingName

string

필수 항목입니다. 보고서에서 이 타이머 이벤트를 식별하는 데 사용되는 이름입니다.

CounterEvent

광고 소재의 카운터 이벤트입니다.

JSON 표현 
{
  "name": string,
  "reportingName": string
}
필드
name

string

필수 항목입니다. 카운터 이벤트의 이름입니다.
reportingName

string

필수 항목입니다. 보고서에서 이 카운터 이벤트를 식별하는 데 사용되는 이름입니다.

AudioVideoOffset

오디오 또는 동영상이 재생된 길이입니다.

JSON 표현 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
필드
통합 필드 offset. 오프셋의 값입니다. offset은 다음 중 하나여야 합니다.
percentage

string (int64 format)

오디오 또는 동영상 길이의 백분율로 나타낸 오프셋입니다.
seconds

string (int64 format)

오디오 또는 동영상 시작부터의 오프셋(단위: 초)입니다.

UniversalAdId

모든 플랫폼에서 고유한 등록처에서 제공하는 광고 소재 식별자입니다. 이는 VAST 4.0 표준의 일부입니다.

JSON 표현 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
필드
id

string

광고 소재 고유 식별자입니다.
registry

enum (UniversalAdRegistry)

레지스트리는 고유한 광고 소재 식별자를 제공합니다.

UniversalAdRegistry

레지스트리는 범용 광고 ID에 고유한 광고 소재 식별자를 제공합니다.

열거형
UNIVERSAL_AD_REGISTRY_UNSPECIFIED 이 버전에서 범용 광고 레지스트리가 지정되지 않았거나 알 수 없습니다.
UNIVERSAL_AD_REGISTRY_OTHER 맞춤 제공업체를 사용하여 범용 광고 ID를 제공합니다.
UNIVERSAL_AD_REGISTRY_AD_ID Ad-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 (ThirdPartyUrlType),
  "url": string
}
필드
type

enum (ThirdPartyUrlType)

추적 URL에 따라 추적해야 하는 상호작용 유형
url

string

상호작용을 추적하는 데 사용되는 추적 URL입니다.

https:로 시작하는 선택적 경로 또는 쿼리 문자열이 포함된 URL을 제공합니다. 예: https://www.example.com/path

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 (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
필드
name

string

트랜스코딩된 파일의 이름입니다.
mimeType

string

트랜스코딩된 파일의 MIME 유형입니다.
transcoded

boolean

트랜스코딩이 성공했는지 여부를 나타냅니다.
dimensions

object (Dimensions)

트랜스코딩된 동영상의 크기입니다.
bitRateKbps

string (int64 format)

트랜스코딩된 동영상의 트랜스코딩 비트 전송률(kbit/초)입니다.
frameRate

number

트랜스코딩된 동영상의 프레임 속도입니다(단위: 초당 프레임 수).
audioBitRateKbps

string (int64 format)

트랜스코딩된 동영상의 오디오 스트림 비트 전송률 또는 트랜스코딩된 오디오의 비트 전송률(kbit/초)입니다.
audioSampleRateHz

string (int64 format)

트랜스코딩된 동영상의 오디오 스트림 샘플링 레이트 또는 트랜스코딩된 오디오의 샘플링 레이트(Hz)입니다.
fileSizeBytes

string (int64 format)

트랜스코딩된 파일의 크기(바이트)입니다.

CmTrackingAd

Campaign Manager 360 추적 광고

JSON 표현 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
필드
cmPlacementId

string (int64 format)

캠페인 관리자 360 추적 광고의 게재위치 ID입니다.
cmCreativeId

string (int64 format)

Campaign Manager 360 추적 광고의 광고 소재 ID입니다.
cmAdId

string (int64 format)

Campaign Manager 360 추적 광고의 광고 ID입니다.

ObaIcon

광고 소재의 OBA 아이콘

JSON 표현 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
필드
resourceUrl

string

OBA 아이콘 리소스의 URL입니다.
resourceMimeType

string

OBA 아이콘 리소스의 MIME 유형입니다.
position

enum (ObaIconPosition)

광고 소재에서 OBA 아이콘의 위치입니다.
dimensions

object (Dimensions)

OBA 아이콘의 크기입니다.
program

string

OBA 아이콘의 프로그램입니다. 예를 들면 'AdChoices'입니다.
landingPageUrl

string

필수 항목입니다. OBA 아이콘의 방문 페이지 URL입니다.

다음 도메인의 URL만 허용됩니다.
clickTrackingUrl

string

필수 항목입니다. OBA 아이콘의 클릭 추적 URL입니다.

다음 도메인의 URL만 허용됩니다.
viewTrackingUrl

string

필수 항목입니다. 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 모든 대각선 방향으로 확장할 수 있습니다.

메서드

create

 새 광고 소재를 만듭니다.

delete

 광고 소재를 삭제합니다.

get

 광고 소재를 가져옵니다.

list

 광고주의 광고 소재를 나열합니다.

patch

 기존 광고 소재를 업데이트합니다.