Ad

광고

JSON 표현 
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
필드
resourceName

string

변경할 수 없습니다. 광고의 리소스 이름입니다. 광고 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/ads/{ad_id}
finalUrls[]

string

광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다.
finalAppUrls[]

object (FinalAppUrl)

사용자가 특정 앱을 설치한 경우 모바일에서 사용될 최종 앱 URL 목록입니다.
finalMobileUrls[]

string

광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 모바일 URL 목록입니다.
urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls 또는 mobile_final_urls에서 맞춤 매개변수 태그를 대체하는 데 사용할 수 있는 매핑 목록입니다. 변형의 경우 URL 맞춤 매개변수 작업을 사용하세요.
type

enum (AdType)

출력 전용입니다. 광고의 유형입니다.
devicePreference

enum (Device)

광고의 기기 환경설정입니다. 휴대기기에 대한 환경설정만 지정할 수 있습니다. 이 환경설정을 설정하면 휴대기기에 표시될 때 이 광고가 다른 광고보다 우선 표시됩니다. 다른 광고를 사용할 수 없는 경우와 같이 다른 기기 유형에는 광고가 계속 표시될 수 있습니다. 지정하지 않으면 (기기 환경설정이 없음) 모든 기기가 타겟팅됩니다. 이 기능은 일부 광고 유형에서만 지원됩니다.
urlCollections[]

object (UrlCollection)

광고의 다른 필드에서 참조할 수 있는 고유 식별자로 태그된 광고의 추가 URL입니다.
systemManagedResourceSource

enum (SystemManagedResourceSource)

출력 전용입니다. 이 광고가 시스템에서 관리되는 경우 이 필드는 소스를 나타냅니다. 이 필드는 읽기 전용입니다.
id

string (int64 format)

출력 전용입니다. 광고의 ID입니다.
trackingUrlTemplate

string

추적 URL을 만들기 위한 URL 템플릿입니다.
finalUrlSuffix

string

최종 URL을 구성할 때 사용할 접미사입니다.
displayUrl

string

일부 광고 형식의 광고 설명에 표시되는 URL입니다.
addedByGoogleAds

boolean

출력 전용입니다. 사용자가 아닌 Google Ads에서 자동으로 광고를 추가했는지 여부를 나타냅니다. 예를 들어 기존 광고의 실적에 대한 정보를 기반으로 새 광고 제안으로 광고가 자동으로 생성되는 경우 이러한 상황이 발생할 수 있습니다.
name

string

변경할 수 없습니다. 광고의 이름입니다. 이 이름은 광고를 식별하는 데만 사용됩니다. 이름은 고유하지 않아도 되며 게재되는 광고에 영향을 주지 않습니다. 이름 필드는 현재 DisplayUploadAd, ImageAd, ShoppingComparisonListingAd, VideoAd에 대해서만 지원됩니다.
통합 필드 ad_data. 광고 유형과 관련된 세부정보입니다. 정확히 하나의 값을 설정해야 합니다. ad_data은 다음 중 하나여야 합니다.
textAd

object (TextAdInfo)

변경할 수 없습니다. 텍스트 광고와 관련된 세부정보입니다.
expandedTextAd

object (ExpandedTextAdInfo)

확장 텍스트 광고와 관련된 세부정보입니다.
callAd

object (CallAdInfo)

전화 유도 광고와 관련된 세부정보입니다.
expandedDynamicSearchAd

object (ExpandedDynamicSearchAdInfo)

변경할 수 없습니다. 확장 동적 검색 광고와 관련된 세부정보입니다. 이 유형의 광고는 캠페인 수준에서 연결된 dynamicSearchAdsSetting에서 제공하는 도메인 이름 관련 정보를 기반으로 게재 시 광고 제목, 최종 URL, 표시 URL이 자동으로 생성됩니다.
hotelAd

object (HotelAdInfo)

호텔 광고와 관련된 세부정보입니다.
shoppingSmartAd

object (ShoppingSmartAdInfo)

스마트 쇼핑 광고와 관련된 세부정보
shoppingProductAd

object (ShoppingProductAdInfo)

쇼핑 제품 광고와 관련된 세부정보입니다.
imageAd

object (ImageAdInfo)

변경할 수 없습니다. 이미지 광고와 관련된 세부정보입니다.
videoAd

object (VideoAdInfo)

동영상 광고와 관련된 세부정보입니다.
videoResponsiveAd

object (VideoResponsiveAdInfo)

동영상 반응형 광고와 관련된 세부정보입니다.
responsiveSearchAd

object (ResponsiveSearchAdInfo)

반응형 검색 광고와 관련된 세부정보입니다.
legacyResponsiveDisplayAd

object (LegacyResponsiveDisplayAdInfo)

기존 반응형 디스플레이 광고와 관련된 세부정보입니다.
appAd

object (AppAdInfo)

앱 광고와 관련된 세부정보입니다.
legacyAppInstallAd

object (LegacyAppInstallAdInfo)

변경할 수 없습니다. 기존 앱 설치 광고와 관련된 세부정보입니다.
responsiveDisplayAd

object (ResponsiveDisplayAdInfo)

반응형 디스플레이 광고와 관련된 세부정보입니다.
localAd

object (LocalAdInfo)

오프라인 광고와 관련된 세부정보입니다.
displayUploadAd

object (DisplayUploadAdInfo)

디스플레이 업로드 광고와 관련된 세부정보입니다.
appEngagementAd

object (AppEngagementAdInfo)

앱 재참여 광고와 관련된 세부정보입니다.
shoppingComparisonListingAd

object (ShoppingComparisonListingAdInfo)

쇼핑 가격 비교 광고와 관련된 세부정보입니다.
smartCampaignAd

object (SmartCampaignAdInfo)

스마트 캠페인 광고와 관련된 세부정보입니다.
appPreRegistrationAd

object (AppPreRegistrationAdInfo)

앱 사전 등록 유도 광고와 관련된 세부정보입니다.
demandGenMultiAssetAd

object (DemandGenMultiAssetAdInfo)

디맨드젠 멀티 애셋 광고와 관련된 세부정보입니다.
demandGenVideoResponsiveAd

object (DemandGenVideoResponsiveAdInfo)

디맨드젠 동영상 반응형 광고와 관련된 세부정보입니다.
demandGenProductAd

object (DemandGenProductAdInfo)

디맨드젠 제품 광고와 관련된 세부정보입니다.
travelAd

object (TravelAdInfo)

여행 광고와 관련된 세부정보입니다.

FinalAppUrl

지정된 운영체제의 앱에 딥 링크하는 URL입니다.

JSON 표현 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
필드
osType

enum (AppUrlOperatingSystemType)

이 URL에서 타겟팅하는 운영체제입니다. 필수입니다.
url

string

앱 딥 링크 URL입니다. 딥 링크는 표시하려는 콘텐츠에 해당하는 앱의 위치를 지정하며 {scheme}://{host_path} 형식이어야 합니다. 스키마는 열려는 앱을 식별합니다. 앱의 경우 앱 이름으로 시작하는 맞춤 스키마를 사용할 수 있습니다. 호스트와 경로는 콘텐츠가 있는 앱의 고유한 위치를 지정합니다. 예: 'exampleapp://productid_1234' 필수입니다.

AppUrlOperatingSystemType

운영체제

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
IOS Apple iOS 운영체제
ANDROID Android 운영체제

AdType

가능한 광고 유형입니다.

열거형
UNSPECIFIED 지정된 값이 없습니다.
UNKNOWN

이 버전에서는 수신된 값을 알 수 없습니다.

응답 전용 값입니다.
TEXT_AD 광고가 텍스트 광고입니다.
EXPANDED_TEXT_AD 광고가 확장 텍스트 광고입니다.
EXPANDED_DYNAMIC_SEARCH_AD 광고가 확장 동적 검색 광고입니다.
HOTEL_AD 호텔 광고입니다.
SHOPPING_SMART_AD 광고가 스마트 쇼핑 광고입니다.
SHOPPING_PRODUCT_AD 이 광고는 일반 쇼핑 광고입니다.
VIDEO_AD 동영상 광고입니다.
IMAGE_AD 이 광고는 이미지 광고입니다.
RESPONSIVE_SEARCH_AD 광고가 반응형 검색 광고입니다.
LEGACY_RESPONSIVE_DISPLAY_AD 기존의 반응형 디스플레이 광고입니다.
APP_AD 광고가 앱 광고입니다.
LEGACY_APP_INSTALL_AD 기존 앱 설치 광고입니다.
RESPONSIVE_DISPLAY_AD 광고가 반응형 디스플레이 광고입니다.
LOCAL_AD 광고가 지역 광고입니다.
HTML5_UPLOAD_AD 이 광고는 HTML5_UPLOAD_AD 제품 유형의 디스플레이 업로드 광고입니다.
DYNAMIC_HTML5_AD 이 광고는 DYNAMIC_HTML5_* 제품 유형 중 하나가 포함된 디스플레이 업로드 광고입니다.
APP_ENGAGEMENT_AD 앱 재참여 광고입니다.
SHOPPING_COMPARISON_LISTING_AD 이 광고는 쇼핑 비교 등록정보 광고입니다.
VIDEO_BUMPER_AD 범퍼 동영상 광고
VIDEO_NON_SKIPPABLE_IN_STREAM_AD 건너뛸 수 없는 인스트림 동영상 광고
VIDEO_TRUEVIEW_IN_STREAM_AD 동영상 TrueView 인스트림 광고
VIDEO_RESPONSIVE_AD 동영상 반응형 광고
SMART_CAMPAIGN_AD 스마트 캠페인 광고
CALL_AD 통화 광고
APP_PRE_REGISTRATION_AD 유니버설 앱 사전 등록 광고
IN_FEED_VIDEO_AD 인피드 동영상 광고
DEMAND_GEN_MULTI_ASSET_AD 디맨드젠 멀티 확장 소재 광고
TRAVEL_AD 여행 광고
DEMAND_GEN_VIDEO_RESPONSIVE_AD 디맨드젠 동영상 반응형 광고
DEMAND_GEN_PRODUCT_AD 디맨드젠 제품 광고

UrlCollection

고유 식별자로 태그가 지정된 URL 모음입니다.

JSON 표현 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
필드
finalUrls[]

string

가능한 최종 URL 목록입니다.
finalMobileUrls[]

string

가능한 최종 모바일 URL 목록입니다.
urlCollectionId

string

이 UrlCollection 인스턴스의 고유 식별자입니다.
trackingUrlTemplate

string

추적 URL을 만들기 위한 URL 템플릿입니다.

SystemManagedResourceSource

가능한 시스템 관리 엔티티 소스를 나열하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_VARIATIONS 생성된 유사 광고 실험 광고

TextAdInfo

텍스트 광고

JSON 표현 
{
  "headline": string,
  "description1": string,
  "description2": string
}
필드
headline

string

광고의 제목입니다.
description1

string

광고 설명의 첫 번째 줄입니다.
description2

string

광고 설명의 두 번째 줄입니다.

ExpandedTextAdInfo

확장 텍스트 광고

JSON 표현 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
필드
headlinePart1

string

광고 제목의 첫 번째 부분입니다.
headlinePart2

string

광고 제목의 두 번째 부분입니다.
headlinePart3

string

광고 제목의 세 번째 부분입니다.
description

string

광고 설명입니다.
description2

string

광고의 두 번째 설명입니다.
path1

string

광고의 표시 URL 옆에 표시될 수 있는 텍스트입니다.
path2

string

광고의 표시 URL과 함께 표시될 수 있는 추가 텍스트입니다.

CallAdInfo

전화 유도 광고

JSON 표현 
{
  "countryCode": string,
  "phoneNumber": string,
  "businessName": string,
  "headline1": string,
  "headline2": string,
  "description1": string,
  "description2": string,
  "callTracked": boolean,
  "disableCallConversion": boolean,
  "phoneNumberVerificationUrl": string,
  "conversionAction": string,
  "conversionReportingState": enum (CallConversionReportingState),
  "path1": string,
  "path2": string
}
필드
countryCode

string

광고의 국가 코드입니다.
phoneNumber

string

광고에 표시된 전화번호입니다.
businessName

string

광고의 비즈니스 이름입니다.
headline1

string

광고의 첫 번째 제목입니다.
headline2

string

광고의 두 번째 광고 제목입니다.
description1

string

광고 설명의 첫 번째 줄입니다.
description2

string

광고 설명의 두 번째 줄입니다.
callTracked

boolean

광고 소재에 통화 추적을 사용 설정할지 여부입니다. 통화 추적을 사용 설정하면 통화 전환도 사용 설정됩니다.
disableCallConversion

boolean

광고 소재의 통화 전환을 사용 중지할지 여부입니다. true로 설정하면 callTracked이 true이더라도 통화 전환이 사용 중지됩니다. callTracked이 false이면 이 필드는 무시됩니다.
phoneNumberVerificationUrl

string

전화번호 인증에 사용할 URL입니다.
conversionAction

string

통화 전환 기여도를 부여할 전환 액션입니다. 설정하지 않으면 기본 전환 액션이 사용됩니다. 이 필드는 callTracked가 true로 설정된 경우에만 적용됩니다. 그렇지 않으면 이 필드는 무시됩니다.
conversionReportingState

enum (CallConversionReportingState)

이 통화 광고의 통화 전환 동작입니다. 자체 통화 전환 설정을 사용하거나, 계정 수준 설정을 상속받거나, 사용 중지할 수 있습니다.
path1

string

광고의 URL에 추가할 수 있는 텍스트의 첫 번째 부분입니다. 선택사항입니다.
path2

string

광고의 URL에 추가할 수 있는 텍스트의 두 번째 부분입니다. 이 필드는 path1도 설정된 경우에만 설정할 수 있습니다. 선택사항입니다.

ExpandedDynamicSearchAdInfo

확장 동적 검색 광고

JSON 표현 
{
  "description": string,
  "description2": string
}
필드
description

string

광고 설명입니다.
description2

string

광고의 두 번째 설명입니다.

HotelAdInfo

이 유형에는 필드가 없습니다.

호텔 광고

ShoppingSmartAdInfo

이 유형에는 필드가 없습니다.

스마트 쇼핑 광고

ShoppingProductAdInfo

이 유형에는 필드가 없습니다.

일반 쇼핑 광고

ImageAdInfo

이미지 광고

JSON 표현 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
필드
mimeType

enum (MimeType)

이미지의 MIME 유형입니다.
pixelWidth

string (int64 format)

원본 크기 이미지의 너비(픽셀)입니다.
pixelHeight

string (int64 format)

전체 크기 이미지의 픽셀 단위 높이입니다.
imageUrl

string

전체 크기 이미지의 URL입니다.
previewPixelWidth

string (int64 format)

미리보기 크기 이미지의 픽셀 단위 너비입니다.
previewPixelHeight

string (int64 format)

미리보기 크기 이미지의 픽셀 단위 높이입니다.
previewImageUrl

string

미리보기 크기 이미지의 URL입니다.
name

string

이미지의 이름입니다. 이미지가 MediaFile에서 생성된 경우 MediaFile의 이름입니다. 이미지가 바이트를 사용하여 생성된 경우 이 필드는 비어 있습니다.
통합 필드 image. ImageAd를 만드는 데 사용할 이미지입니다. 이는 다음 두 가지 방법 중 하나로 지정할 수 있습니다. 1. 기존 MediaFile 리소스입니다. 2. 원시 이미지 데이터(바이트)입니다. image은 다음 중 하나여야 합니다.
imageAsset

object (AdImageAsset)

광고에 사용되는 이미지 애셋입니다.
data

string (bytes format)

원시 이미지 데이터(바이트)입니다.

base64 인코딩 문자열입니다.
adIdToCopyImageFrom

string (int64 format)

이미지를 복사할 광고 ID입니다.

AdImageAsset

광고 내에서 사용되는 이미지 확장 소재입니다.

JSON 표현 
{
  "asset": string
}
필드
asset

string

이 이미지의 확장 소재 리소스 이름입니다.

VideoAdInfo

동영상 광고

JSON 표현 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
필드
video

object (AdVideoAsset)

광고에 사용된 YouTube 동영상 애셋
통합 필드 format. 다양한 동영상 형식의 형식별 스키마입니다. format은 다음 중 하나여야 합니다.
inStream

object (VideoTrueViewInStreamAdInfo)

동영상 TrueView 인스트림 광고 형식
bumper

object (VideoBumperInStreamAdInfo)

동영상 범퍼 인스트림 광고 형식
outStream

object (VideoOutstreamAdInfo)

동영상 아웃스트림 광고 형식
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

건너뛸 수 없는 인스트림 동영상 광고 형식
inFeed

object (InFeedVideoAdInfo)

인피드 동영상 광고 형식

AdVideoAsset

광고 내에서 사용되는 동영상 애셋입니다.

JSON 표현 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
필드
asset

string

이 동영상의 저작물 리소스 이름입니다.
adVideoAssetInfo

object (AdVideoAssetInfo)

이 AdVideoAsset의 정보 필드를 포함합니다.

AdVideoAssetInfo

AdVideoAssets의 정보 필드를 포함합니다.

JSON 표현 
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
필드
adVideoAssetInventoryPreferences

object (AdVideoAssetInventoryPreferences)

이 AdVideoAsset의 인벤토리 환경설정 목록입니다. 이 필드는 DiscoveryVideoResponsiveAd에만 설정할 수 있습니다. 인벤토리 확장 소재 환경설정이 설정된 동영상 확장 소재는 게재 시간 동안 동일한 광고의 다른 동영상보다 우선 게재됩니다. 예를 들어 특정 인벤토리에 게재되는 광고를 생각해 보세요. 서버는 먼저 요건을 충족하는 동영상을 해당 인벤토리의 일치하는 환경설정과 일치시키려고 시도합니다. 선호사항이 없는 동영상은 일치하는 선호사항이 있고 지정된 광고 자리에 게재될 수 있는 동영상을 찾을 수 있는 경우에만 선택됩니다.

AdVideoAssetInventoryPreferences

YouTube 동영상 애셋 인벤토리 환경설정

JSON 표현 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
필드
inFeedPreference

boolean

이 값이 true이면 피드에 게재할 동영상을 선택할 때 이 인벤토리 환경설정이 있는 YouTube 동영상 애셋이 우선적으로 선택됩니다.
inStreamPreference

boolean

true인 경우 인스트림 광고를 게재할 동영상을 선택할 때 이 인벤토리 환경설정이 있는 YouTube 동영상 애셋이 우선적으로 선택됩니다.
shortsPreference

boolean

이 값이 true이면 YouTube Shorts에 게재할 동영상을 선택할 때 이 인벤토리 환경설정이 있는 YouTube 동영상 애셋이 우선적으로 선택됩니다.

VideoTrueViewInStreamAdInfo

동영상 TrueView 인스트림 광고 형식의 표현입니다. 동영상 재생 중에 표시되는 광고로, 보통 동영상 시작 부분에 표시되며 동영상 시작 몇 초 후에 건너뛰기 버튼이 표시됩니다.

JSON 표현 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
필드
actionButtonLabel

string

사용자를 동영상 광고의 최종 URL로 연결하는 클릭 유도 문구 (CTA) 버튼의 라벨입니다. 액션 TrueView 캠페인에는 필수사항이며 그 외의 경우에는 선택사항입니다.
actionHeadline

string

맥락을 제공하고 버튼 클릭을 유도하기 위해 CTA (클릭 유도 문구) 버튼과 함께 표시되는 추가 텍스트입니다.
companionBanner

object (AdImageAsset)

광고와 함께 사용되는 컴패니언 배너의 이미지 애셋입니다.

VideoBumperInStreamAdInfo

동영상 범퍼 인스트림 광고 형식 (건너뛸 수 없는 매우 짧은 인스트림 동영상 광고)을 나타냅니다.

JSON 표현 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
필드
companionBanner

object (AdImageAsset)

광고와 함께 사용되는 컴패니언 배너의 이미지 애셋입니다.
actionButtonLabel

string

사용자를 동영상 광고의 최종 URL로 연결하는 '클릭 유도 문구' 버튼의 라벨입니다.
actionHeadline

string

맥락을 제공하고 버튼 클릭을 유도하기 위해 CTA (클릭 유도 문구) 버튼과 함께 표시되는 추가 텍스트입니다.

VideoOutstreamAdInfo

동영상 아웃스트림 광고 형식의 표현입니다 (소리 없이 자동 재생과 함께 피드 옆에 표시되는 광고).

JSON 표현 
{
  "headline": string,
  "description": string
}
필드
headline

string

광고의 제목입니다.
description

string

내용 입력란

VideoNonSkippableInStreamAdInfo

건너뛸 수 없는 인스트림 동영상 광고 형식 (건너뛸 수 없는 15초 인스트림 동영상 광고)을 나타냅니다.

JSON 표현 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
필드
companionBanner

object (AdImageAsset)

광고와 함께 사용되는 컴패니언 배너의 이미지 애셋입니다.
actionButtonLabel

string

사용자를 동영상 광고의 최종 URL로 연결하는 '클릭 유도 문구' 버튼의 라벨입니다.
actionHeadline

string

'클릭 유도 문구' 버튼과 함께 표시되어 맥락을 제공하고 버튼 클릭을 유도하는 추가 텍스트입니다.

InFeedVideoAdInfo

인피드 동영상 광고 형식의 표현입니다.

JSON 표현 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
필드
headline

string

광고의 제목입니다.
description1

string

광고의 첫 번째 텍스트 줄입니다.
description2

string

광고의 두 번째 텍스트 줄입니다.
thumbnail

enum (VideoThumbnail)

사용할 동영상 썸네일 이미지입니다.

VideoThumbnail

가능한 동영상 썸네일 유형을 나열하는 enum입니다.

열거형
UNSPECIFIED 유형이 지정되지 않았습니다.
UNKNOWN 이 버전에서는 수신된 값을 알 수 없습니다. 응답 전용 값입니다.
DEFAULT_THUMBNAIL 기본 썸네일입니다. 자동 생성되거나 사용자가 업로드할 수 있습니다.
THUMBNAIL_1 동영상에서 생성된 썸네일 1
THUMBNAIL_2 동영상에서 생성된 썸네일 2
THUMBNAIL_3 동영상에서 생성된 썸네일 3

VideoResponsiveAdInfo

동영상 반응형 광고

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
필드
headlines[]

object (AdTextAsset)

짧은 광고 제목에 사용된 텍스트 애셋 목록입니다. 현재 짧은 광고 제목은 단일 값만 지원됩니다.
longHeadlines[]

object (AdTextAsset)

긴 광고 제목에 사용된 텍스트 확장 소재 목록입니다. 현재 긴 광고 제목의 값은 하나만 지원됩니다.
descriptions[]

object (AdTextAsset)

설명에 사용된 텍스트 애셋 목록입니다. 현재 설명의 값은 하나만 지원됩니다.
callToActions[]

object (AdTextAsset)

버튼에 사용되는 텍스트 애셋 목록입니다(예: '클릭 유도 문구' 버튼). 현재 버튼의 단일 값만 지원됩니다.
videos[]

object (AdVideoAsset)

광고에 사용된 YouTube 동영상 확장 소재 목록입니다. 현재 YouTube 동영상 저작물의 단일 값만 지원됩니다.
companionBanners[]

object (AdImageAsset)

컴패니언 배너에 사용된 이미지 확장 소재 목록입니다. 현재는 컴패니언 배너 확장 소재의 단일 값만 지원됩니다.
breadcrumb1

string

표시 URL과 함께 광고에 표시되는 텍스트의 첫 번째 부분입니다.
breadcrumb2

string

표시된 URL과 함께 광고에 표시되는 텍스트의 두 번째 부분입니다.

ResponsiveSearchAdInfo

반응형 검색 광고

반응형 검색 광고를 사용하면 더 많은 텍스트와 관련성이 높은 메시지를 고객에게 보여주도록 조정되는 광고를 만들 수 있습니다. 반응형 검색 광고를 만들 때 여러 광고 제목과 설명을 입력하면, 시간이 지남에 따라 Google Ads에서 자동으로 여러 조합을 테스트하여 어떤 조합이 가장 실적이 좋은지 학습합니다. 반응형 검색 광고는 잠재고객의 검색어와 최대한 일치하도록 광고의 콘텐츠를 조정하여 캠페인의 실적을 향상시킬 수 있습니다.

자세한 내용은 https://support.google.com/google-ads/answer/7684791을 참고하세요.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
필드
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재되면 광고 제목이 이 목록에서 선택됩니다.
descriptions[]

object (AdTextAsset)

설명 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
path1

string

광고의 URL에 추가할 수 있는 텍스트의 첫 번째 부분입니다.
path2

string

광고의 URL에 추가할 수 있는 텍스트의 두 번째 부분입니다. 이 필드는 path1도 설정된 경우에만 설정할 수 있습니다.

LegacyResponsiveDisplayAdInfo

기존 반응형 디스플레이 광고 이 유형의 광고는 Google Ads UI에서 '반응형 광고'로 라벨이 지정됩니다.

JSON 표현 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
필드
formatSetting

enum (DisplayAdFormatSetting)

광고가 게재될 형식을 지정합니다. 기본값은 ALL_FORMATS입니다.
shortHeadline

string

광고 제목의 짧은 버전입니다.
longHeadline

string

광고 제목의 긴 버전입니다.
description

string

광고 설명입니다.
businessName

string

광고의 비즈니스 이름입니다.
allowFlexibleColor

boolean

유연한 색상을 허용하는 광고주의 동의 이 값이 true이면 필요한 경우 광고가 다른 색상으로 게재될 수 있습니다. false인 경우 광고가 지정된 색상 또는 중성 색상으로 게재됩니다. 기본값은 true입니다. mainColor 및 accentColor가 설정되지 않은 경우 true여야 합니다.
accentColor

string

광고의 강조 색상입니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 하나도 필요합니다.
mainColor

string

광고의 기본 색상입니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 하나도 필요합니다.
callToActionText

string

광고의 클릭 유도 문구 텍스트입니다.
logoImage

string

광고에 사용된 로고 이미지의 MediaFile 리소스 이름입니다.
squareLogoImage

string

광고에 사용된 정사각형 로고 이미지의 MediaFile 리소스 이름입니다.
marketingImage

string

광고에 사용된 마케팅 이미지의 MediaFile 리소스 이름입니다.
squareMarketingImage

string

광고에 사용된 정사각형 마케팅 이미지의 MediaFile 리소스 이름입니다.
pricePrefix

string

가격 앞에 표시되는 접두사입니다. 예를 들면 '최저'입니다.
promoText

string

반응형 광고의 동적 형식에 사용되는 프로모션 문구입니다. 예: '무료 2일 배송'

DisplayAdFormatSetting

디스플레이 광고 형식 설정을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
ALL_FORMATS 텍스트, 이미지, 네이티브 형식
NON_NATIVE 텍스트 및 이미지 형식
NATIVE 네이티브 형식: 예를 들어 형식 렌더링은 Google이 아닌 게시자가 제어합니다.

AppAdInfo

앱 광고

JSON 표현 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
필드
mandatoryAdText

object (AdTextAsset)

필수 광고문안
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재되면 광고 제목이 이 목록에서 선택됩니다.
descriptions[]

object (AdTextAsset)

설명 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
images[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 이미지 확장 소재의 목록입니다.
youtubeVideos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 YouTube 동영상 확장 소재 목록입니다.
html5MediaBundles[]

object (AdMediaBundleAsset)

광고에 사용할 수 있는 미디어 번들 확장 소재 목록입니다.

AdMediaBundleAsset

광고 내에서 사용되는 미디어 번들 애셋입니다.

JSON 표현 
{
  "asset": string
}
필드
asset

string

이 미디어 번들의 애셋 리소스 이름입니다.

AdAppDeepLinkAsset

광고 내에서 사용되는 앱 딥 링크입니다.

JSON 표현 
{
  "asset": string
}
필드
asset

string

이 앱 딥 링크 애셋의 애셋 리소스 이름입니다.

LegacyAppInstallAdInfo

일부 고객만 사용할 수 있는 기존 앱 설치 광고입니다.

JSON 표현 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
필드
appStore

enum (LegacyAppInstallAdAppStore)

모바일 앱을 사용할 수 있는 앱 스토어입니다.
appId

string

모바일 앱의 ID입니다.
headline

string

광고의 제목입니다.
description1

string

광고의 첫 번째 설명 줄입니다.
description2

string

광고의 두 번째 설명 입력란입니다.

LegacyAppInstallAdAppStore

기존 앱 설치 광고의 앱 스토어 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
APPLE_APP_STORE Apple iTunes
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows 스토어
WINDOWS_PHONE_STORE Windows Phone 스토어
CN_APP_STORE 앱이 중국 앱 스토어에 호스팅됩니다.

ResponsiveDisplayAdInfo

반응형 디스플레이 광고

JSON 표현 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
필드
marketingImages[]

object (AdImageAsset)

광고에 사용할 마케팅 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 600x314이고 가로세로 비율은 1.91:1 (±1%)이어야 합니다. marketingImage가 하나 이상 필요합니다. squareMarketingImages와 함께 사용하면 최대 15개까지 사용할 수 있습니다.
squareMarketingImages[]

object (AdImageAsset)

광고에 사용할 정사각형 마케팅 이미지 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 300x300이고 가로세로 비율은 1:1 (±1%)이어야 합니다. 정사각형 marketingImage이 하나 이상 필요합니다. marketingImages와 함께 사용하면 최대 15개까지 사용할 수 있습니다.
logoImages[]

object (AdImageAsset)

광고에 사용할 로고 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 512x128이고 가로세로 비율은 4:1 (±1%)이어야 합니다. squareLogoImages와 결합하면 최대 5개까지 사용할 수 있습니다.
squareLogoImages[]

object (AdImageAsset)

광고에 사용할 정사각형 로고 이미지 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (±1%)이어야 합니다. logoImages와 결합하면 최대 5개까지 사용할 수 있습니다.
headlines[]

object (AdTextAsset)

광고의 짧은 형식 광고 제목입니다. 최대 길이는 30자(영문 기준)입니다. 광고 제목은 1개 이상 5개 이하로 지정할 수 있습니다.
longHeadline

object (AdTextAsset)

긴 형식의 광고 제목으로 필수 항목입니다. 최대 길이는 90자(영문 기준)입니다.
descriptions[]

object (AdTextAsset)

광고에 대한 설명 텍스트입니다. 최대 길이는 90자(영문 기준)입니다. 광고 제목은 1개 이상 5개 이하로 지정할 수 있습니다.
youtubeVideos[]

object (AdVideoAsset)

광고에 사용할 YouTube 동영상(선택사항). 최대 5개의 동영상을 지정할 수 있습니다.
formatSetting

enum (DisplayAdFormatSetting)

광고가 게재될 형식을 지정합니다. 기본값은 ALL_FORMATS입니다.
controlSpec

object (ResponsiveDisplayAdControlSpec)

다양한 광고 소재 컨트롤의 사양입니다.
businessName

string

광고주/브랜드 이름입니다. 최대 디스플레이 너비는 25입니다.
mainColor

string

광고의 기본 색상입니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 하나도 필요합니다.
accentColor

string

광고의 강조 색상입니다(예: 흰색의 경우 #ffffff). mainColor와 accentColor 중 하나가 설정되면 다른 하나도 필요합니다.
allowFlexibleColor

boolean

유연한 색상을 허용하는 광고주의 동의 이 값이 true이면 필요한 경우 광고가 다른 색상으로 게재될 수 있습니다. false인 경우 광고가 지정된 색상 또는 중성 색상으로 게재됩니다. 기본값은 true입니다. mainColor 및 accentColor가 설정되지 않은 경우 true여야 합니다.
callToActionText

string

광고의 클릭 유도 문구 텍스트입니다. 최대 표시 너비는 30입니다.
pricePrefix

string

가격 앞에 표시되는 접두사입니다. 예를 들면 '최저'입니다.
promoText

string

반응형 광고의 동적 형식에 사용되는 프로모션 문구입니다. 예: '무료 2일 배송'

ResponsiveDisplayAdControlSpec

반응형 디스플레이 광고의 다양한 광고 소재 관리 기능에 대한 사양

JSON 표현 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
필드
enableAssetEnhancements

boolean

광고주가 확장 소재 기능을 선택했는지 여부입니다.
enableAutogenVideo

boolean

광고주가 자동 생성 동영상 기능을 선택했는지 여부입니다.

LocalAdInfo

지역 광고

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
필드
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재되면 광고 제목이 이 목록에서 선택됩니다. 광고 제목은 1개 이상 5개 이하로 지정해야 합니다.
descriptions[]

object (AdTextAsset)

설명 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다. 설명은 1개 이상 5개 이하로 지정해야 합니다.
callToActions[]

object (AdTextAsset)

클릭 유도 문구의 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 클릭 유도 문구가 선택됩니다. 클릭 유도 문구는 1개 이상 5개 이하로 지정해야 합니다.
marketingImages[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 마케팅 이미지 확장 소재 목록입니다. 이미지는 314x600픽셀 또는 320x320픽셀이어야 합니다. 이미지 애셋을 1개 이상 20개 이하로 지정해야 합니다.
logoImages[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 로고 이미지 확장 소재의 목록입니다. 이미지는 128x128픽셀이고 120KB 이하여야 합니다. 이미지 확장 소재는 1개 이상 5개 이하로 지정해야 합니다.
videos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 YouTube 동영상 확장 소재 목록입니다. 동영상 애셋은 1개 이상 20개 이하로 지정해야 합니다.
path1

string

광고의 URL에 추가할 수 있는 선택적 텍스트의 첫 번째 부분입니다.
path2

string

광고의 URL에 추가할 수 있는 선택적 텍스트의 두 번째 부분입니다. 이 필드는 path1도 설정된 경우에만 설정할 수 있습니다.

DisplayUploadAdInfo

일반적인 디스플레이 광고 유형입니다. 정확한 광고 형식은 광고에 포함해야 하는 데이터의 유형을 결정하는 displayUploadProductType 필드에 의해 제어됩니다.

JSON 표현 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
필드
displayUploadProductType

enum (DisplayUploadProductType)

이 광고의 제품 유형입니다. 자세한 내용은 enum에 관한 주석을 참고하세요.
통합 필드 media_asset. 광고를 구성하는 확장 소재 데이터입니다. media_asset은 다음 중 하나여야 합니다.
mediaBundle

object (AdMediaBundleAsset)

광고에 사용할 미디어 번들 애셋입니다. HTML5_UPLOAD_AD의 미디어 번들에 대한 자세한 내용은 https://support.google.com/google-ads/answer/1722096을 참고하세요. 동적 제품 유형의 일부인 미디어 번들은 Google Web Designer를 통해 만들어야 하는 특수 형식을 사용합니다. 자세한 내용은 https://support.google.com/webdesigner/answer/7543898을 참고하세요.

DisplayUploadProductType

디스플레이 업로드 제품 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
HTML5_UPLOAD_AD HTML5 업로드 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다.
DYNAMIC_HTML5_EDUCATION_AD 동적 HTML5 교육 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 교육 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_FLIGHT_AD 동적 HTML5 항공편 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 항공편 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_HOTEL_RENTAL_AD 동적 HTML5 호텔 및 공유숙박 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 호텔 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_JOB_AD 동적 HTML5 채용정보 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 구인 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_LOCAL_AD 동적 HTML5 로컬 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 지역 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_REAL_ESTATE_AD 동적 HTML5 부동산 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 부동산 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_CUSTOM_AD 동적 HTML5 맞춤 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 맞춤 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_TRAVEL_AD 동적 HTML5 여행 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 여행 캠페인에서만 사용할 수 있습니다.
DYNAMIC_HTML5_HOTEL_AD 동적 HTML5 호텔 광고 이 제품 유형을 사용하려면 DisplayUploadAdInfo의 upload_media_bundle 필드를 설정해야 합니다. 호텔 캠페인에서만 사용할 수 있습니다.

AppEngagementAdInfo

앱 재참여 광고를 이용하면 체크인, 구매, 항공권 예약 등과 같이 앱에서 유도하려는 특정 액션을 광고문안에 작성할 수 있습니다. 이를 통해 사용자를 앱의 특정 부분으로 보내 사용자가 원하는 항목을 더 쉽고 빠르게 찾을 수 있도록 할 수 있습니다.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
필드
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재되면 광고 제목이 이 목록에서 선택됩니다.
descriptions[]

object (AdTextAsset)

설명 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
images[]

object (AdImageAsset)

광고와 함께 표시될 수 있는 이미지 확장 소재의 목록입니다.
videos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 동영상 애셋 목록입니다.

ShoppingComparisonListingAdInfo

쇼핑 비교 등록정보 광고

JSON 표현 
{
  "headline": string
}
필드
headline

string

광고의 제목입니다. 필수 입력란입니다. 허용되는 길이는 25~45자(영문 기준)입니다.

AppPreRegistrationAdInfo

앱 사전 등록 광고는 Google Play의 앱 또는 게임 등록정보에 연결되며 Google Play, YouTube (인스트림만), 디스플레이 네트워크의 다른 앱 및 모바일 웹사이트에 게재될 수 있습니다. 앱 또는 게임에 대한 사용자의 관심을 사로잡아 출시 전에 앱 또는 게임의 초기 설치 사용자 기반을 만드는 데 도움이 됩니다.

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
필드
headlines[]

object (AdTextAsset)

광고 제목의 텍스트 애셋 목록입니다. 광고가 게재되면 광고 제목이 이 목록에서 선택됩니다.
descriptions[]

object (AdTextAsset)

설명 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다.
images[]

object (AdImageAsset)

광고와 함께 이미지가 표시될 수 있는 이미지 확장 소재 ID 목록입니다.
youtubeVideos[]

object (AdVideoAsset)

광고와 함께 표시될 수 있는 동영상의 YouTube 동영상 저작물 ID 목록입니다.

DemandGenMultiAssetAdInfo

디맨드젠 멀티 확장 소재 광고

JSON 표현 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
필드
marketingImages[]

object (AdImageAsset)

광고에 사용할 마케팅 이미지 애셋 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 600x314이고 가로세로 비율은 1.91:1 (±1%)이어야 합니다. squareMarketingImages가 없는 경우 필수입니다. squareMarketingImages, portraitMarketingImages, tallPortraitMarketingImages와 함께 사용하면 최대 20개까지 사용할 수 있습니다.
squareMarketingImages[]

object (AdImageAsset)

광고에 사용할 정사각형 마케팅 이미지 확장 소재입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 300x300이고 가로세로 비율은 1:1 (±1%)이어야 합니다. marketingImages가 없는 경우 필수입니다. marketingImages, portraitMarketingImages, tallPortraitMarketingImages와 함께 사용하면 최대 20개까지 사용할 수 있습니다.
portraitMarketingImages[]

object (AdImageAsset)

광고에 사용할 세로 방향 마케팅 이미지 확장 소재입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 480x600이고 가로세로 비율은 4:5 (±1%)여야 합니다. marketingImages, squareMarketingImages, tallPortraitMarketingImages와 함께 사용하면 최대 20개까지 사용할 수 있습니다.
tallPortraitMarketingImages[]

object (AdImageAsset)

광고에 사용할 세로로 긴 마케팅 이미지 확장 소재입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 600x1067이고 가로세로 비율은 9:16 (±1%)이어야 합니다. marketingImages, squareMarketingImages, portraitMarketingImages와 함께 사용하면 최대 20개까지 사용할 수 있습니다.
logoImages[]

object (AdImageAsset)

광고에 사용할 로고 이미지 애셋입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (±1%)이어야 합니다. 로고 이미지는 1개 이상 5개 이하로 지정할 수 있습니다.
headlines[]

object (AdTextAsset)

광고의 광고 제목 텍스트 애셋입니다. 최대 표시 너비는 30입니다. 광고 제목은 1개 이상 5개 이하로 지정할 수 있습니다.
descriptions[]

object (AdTextAsset)

광고의 설명 텍스트입니다. 최대 디스플레이 너비는 90입니다. 설명은 1~5개까지 지정할 수 있습니다.
businessName

string

광고주/브랜드 이름입니다. 최대 디스플레이 너비는 25입니다. 필수입니다.
callToActionText

string

클릭 유도 문구 텍스트
leadFormOnly

boolean

이 광고를 리드 양식과 함께 게재해야 하는지 여부를 나타내는 불리언 옵션입니다.

DemandGenCarouselAdInfo

디맨드젠 캐러셀 광고

JSON 표현 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
필드
businessName

string

필수입니다. 광고주/브랜드 이름입니다.
logoImage

object (AdImageAsset)

필수입니다. 광고에 사용할 로고 이미지입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (±1%)이어야 합니다.
headline

object (AdTextAsset)

필수입니다. 광고의 제목입니다.
description

object (AdTextAsset)

필수입니다. 광고의 설명 텍스트입니다.
callToActionText

string

클릭 유도 문구 텍스트
carouselCards[]

object (AdDemandGenCarouselCardAsset)

필수입니다. 광고와 함께 표시되는 캐러셀 카드입니다. 최소 2개, 최대 10개

AdDemandGenCarouselCardAsset

광고 내에서 사용되는 디맨드젠 캐러셀 카드 애셋입니다.

JSON 표현 
{
  "asset": string
}
필드
asset

string

이 디스커버리 캐러셀 카드의 애셋 리소스 이름입니다.

DemandGenVideoResponsiveAdInfo

디맨드젠 동영상 반응형 광고

JSON 표현 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
필드
headlines[]

object (AdTextAsset)

짧은 광고 제목에 사용된 텍스트 애셋 목록입니다.
longHeadlines[]

object (AdTextAsset)

긴 광고 제목에 사용된 텍스트 확장 소재 목록입니다.
descriptions[]

object (AdTextAsset)

설명에 사용된 텍스트 애셋 목록입니다.
videos[]

object (AdVideoAsset)

광고에 사용된 YouTube 동영상 확장 소재 목록입니다.
logoImages[]

object (AdImageAsset)

광고에 사용할 로고 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (±1%)이어야 합니다.
breadcrumb1

string

표시 URL과 함께 광고에 표시되는 텍스트의 첫 번째 부분입니다.
breadcrumb2

string

표시된 URL과 함께 광고에 표시되는 텍스트의 두 번째 부분입니다.
businessName

object (AdTextAsset)

필수입니다. 광고주/브랜드 이름입니다.
callToActions[]

object (AdCallToActionAsset)

'클릭 유도 문구' 버튼에 사용되는 CallToActionAsset 유형의 확장 소재입니다.

AdCallToActionAsset

광고 내에서 사용되는 클릭 유도 문구 확장 소재입니다.

JSON 표현 
{
  "asset": string
}
필드
asset

string

이 클릭 유도 문구 애셋의 애셋 리소스 이름입니다.

DemandGenProductAdInfo

디맨드젠 제품 광고

JSON 표현 
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
필드
breadcrumb1

string

표시 URL과 함께 광고에 표시되는 텍스트의 첫 번째 부분입니다.
breadcrumb2

string

표시된 URL과 함께 광고에 표시되는 텍스트의 두 번째 부분입니다.
businessName

object (AdTextAsset)

필수입니다. 광고주/브랜드 이름입니다.
headline

object (AdTextAsset)

필수입니다. 짧은 광고 제목에 사용되는 텍스트 애셋입니다.
description

object (AdTextAsset)

필수입니다. 설명에 사용되는 텍스트 애셋입니다.
logoImage

object (AdImageAsset)

필수입니다. 광고에 사용할 로고 이미지입니다. 유효한 이미지 유형은 GIF, JPEG, PNG입니다. 최소 크기는 128x128이고 가로세로 비율은 1:1 (±1%)이어야 합니다.
callToAction

object (AdCallToActionAsset)

'클릭 유도 문구' 버튼에 사용되는 CallToActionAsset 유형의 확장 소재입니다.

TravelAdInfo

이 유형에는 필드가 없습니다.

여행 광고