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가 다음 중 하나일 때 widthPixelsheightPixels의 기본값은 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

이 필드가 지정된 경우 widthPixelsheightPixels 모두 필수이며 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의 탭 영역을 사용하세요.
  • 'GCLID'라는 자바스크립트 변수를 정의합니다.
  • 인에이블러 (인에이블러.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

분석 제공업체 또는 제3자 광고 기술 공급업체를 위한 추적 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

선택사항입니다. 광고 소재에 사용된 원래의 제3자 태그입니다.

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

서드 파티 태그 광고 소재는 hostingSource를 포함하는 광고 소재입니다.

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합됨:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

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

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

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

서드 파티 태그 광고 소재는 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 (디지털 동영상 플레이어 광고 인터페이스)가 필요함을 나타냅니다.

출력 전용이며 제3자 VAST 태그 광고 소재에만 유효합니다.

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

  • HOSTING_SOURCE_THIRD_PARTY

다음 creativeType와 결합됨:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

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

출력 전용이며 제3자 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)

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

creativeAndLandingPageReviewStatus

enum (ReviewStatus)

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

contentAndPolicyReviewStatus

enum (ReviewStatus)

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

exchangeReviewStatuses[]

object (ExchangeReviewStatus)

광고 소재의 검토 상태를 교환합니다.

publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

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

ApprovalStatus

가능한 승인 상태 유형입니다. creativeAndLandingPageReviewStatuscontentAndPolicyReviewStatus의 요약입니다.

열거형
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

광고 소재의 교환 검토 상태

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)으로 전달되어 애셋을 광고 소재와 연결할 수 있습니다.

2023년 4월 5일에 업데이트된 미디어 ID 공간 연결된 광고 소재 리소스에서 새 미디어 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 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 광고 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 이 버전에서 제3자 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

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