REST Resource: advertisers.creatives

리소스: Creative

단일 광고 소재입니다.

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의 탭 영역을 사용하세요.
  • 'click'이라는 자바스크립트 변수를 정의합니다.
  • 인에이블러 (인에이블러.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)의 자바스크립트 측정 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를 사용함을 나타냅니다.

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

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType과 결합:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

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

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

선택사항이며 서드 파티 태그 광고 소재 또는 서드 파티 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 (Digital Video Player-Ad Interface)가 필요함을 나타냅니다.

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

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

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType과 결합:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

출력 전용. 타사 VAST 태그 광고 소재에 HTML5 동영상 지원이 필요함을 나타냅니다.

출력 전용이며 서드 파티 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 (제3자 광고 서버)에서 호스팅하는 광고 소재입니다.

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)

광고 소재의 Exchange 검토 상태입니다.
publisherReviewStatuses[]

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를 다른 API 호출(예: creatives.create)에 전달하여 애셋을 광고 소재와 연결할 수 있습니다.

미디어 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는 25자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.

이 역할은 다음 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는 90자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.

이 역할은 다음 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는 30자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.

예를 들어 방문 페이지 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는 25자(영문 기준) 이하의 UTF-8로 인코딩되어야 합니다.

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

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

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

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

이 역할의 애셋은 읽기 전용입니다.
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 앱 스토어에 있는 앱의 평점입니다.

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

이 역할의 애셋은 읽기 전용입니다.
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 광고 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)

캠페인 관리자 360 추적 광고의 광고 소재 ID입니다.
cmAdId

string (int64 format)

캠페인 관리자 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

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