SearchAds360Row

쿼리에서 반환된 행입니다.

JSON 표현
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
필드
adGroup

object (AdGroup)

쿼리에서 참조된 광고 그룹입니다.

adGroupAd

object (AdGroupAd)

쿼리에서 참조된 광고입니다.

adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

쿼리에서 참조된 광고 그룹 광고 효과 라벨입니다.

adGroupAdLabel

object (AdGroupAdLabel)

쿼리에서 참조된 광고 그룹 광고 라벨입니다.

adGroupAsset

object (AdGroupAsset)

쿼리에서 참조된 광고 그룹 확장 소재입니다.

adGroupAssetSet

object (AdGroupAssetSet)

쿼리에서 참조된 광고 그룹 애셋 세트입니다.

adGroupAudienceView

object (AdGroupAudienceView)

쿼리에서 참조된 광고 그룹 잠재고객 보기입니다.

adGroupBidModifier

object (AdGroupBidModifier)

쿼리에서 참조된 입찰가 조정입니다.

adGroupCriterion

object (AdGroupCriterion)

쿼리에서 참조되는 기준입니다.

adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

쿼리에서 참조된 광고그룹 기준 유효 라벨입니다.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

쿼리에서 참조된 광고 그룹 기준 라벨입니다.

adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

쿼리에서 참조된 광고 그룹 유효 라벨입니다.

adGroupLabel

object (AdGroupLabel)

쿼리에서 참조된 광고 그룹 라벨입니다.

ageRangeView

object (AgeRangeView)

쿼리에서 참조된 연령대 뷰입니다.

asset

object (Asset)

쿼리에서 참조된 애셋입니다.

assetGroupAsset

object (AssetGroupAsset)

쿼리에서 참조된 애셋 그룹 애셋입니다.

assetGroupSignal

object (AssetGroupSignal)

쿼리에서 참조된 애셋 그룹 신호입니다.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

쿼리에서 참조된 애셋 그룹 등록정보 그룹 필터입니다.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

쿼리에서 참조된 애셋 그룹 상위 조합 보기입니다.

assetGroup

object (AssetGroup)

쿼리에서 참조된 애셋 그룹입니다.

assetSetAsset

object (AssetSetAsset)

쿼리에서 참조된 애셋 세트 애셋입니다.

assetSet

object (AssetSet)

쿼리에서 참조된 애셋 세트입니다.

biddingStrategy

object (BiddingStrategy)

쿼리에서 참조된 입찰 전략입니다.

campaignBudget

object (CampaignBudget)

쿼리에서 참조된 캠페인 예산입니다.

campaign

object (Campaign)

쿼리에서 참조된 캠페인입니다.

campaignAsset

object (CampaignAsset)

쿼리에서 참조된 캠페인 애셋입니다.

campaignAssetSet

object (CampaignAssetSet)

쿼리에서 참조된 캠페인 확장 소재 조합입니다.

campaignAudienceView

object (CampaignAudienceView)

쿼리에서 참조된 캠페인 잠재고객 뷰입니다.

campaignCriterion

object (CampaignCriterion)

쿼리에서 참조된 캠페인 기준입니다.

campaignEffectiveLabel

object (CampaignEffectiveLabel)

쿼리에서 참조된 캠페인 효과 라벨입니다.

campaignLabel

object (CampaignLabel)

쿼리에서 참조된 캠페인 라벨입니다.

cartDataSalesView

object (CartDataSalesView)

쿼리에서 참조된 장바구니 데이터 판매 뷰입니다.

audience

object (Audience)

쿼리에서 참조된 잠재고객입니다.

conversionAction

object (ConversionAction)

쿼리에서 참조된 전환 액션입니다.

conversionCustomVariable

object (ConversionCustomVariable)

쿼리에서 참조된 전환 맞춤 변수입니다.

customer

object (Customer)

쿼리에서 참조된 고객입니다.

customerAsset

object (CustomerAsset)

쿼리에서 참조된 고객 애셋입니다.

customerAssetSet

object (CustomerAssetSet)

쿼리에서 참조된 고객 애셋 세트입니다.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

쿼리에서 참조된 액세스 가능한 입찰 전략입니다.

customerClient

object (CustomerClient)

쿼리에서 참조된 CustomerClient입니다.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

쿼리에서 참조된 동적 검색 광고 검색어 보기입니다.

genderView

object (GenderView)

쿼리에서 참조된 성별 보기입니다.

geoTargetConstant

object (GeoTargetConstant)

쿼리에서 참조된 지역 타겟 상수입니다.

keywordView

object (KeywordView)

쿼리에서 참조된 키워드 뷰입니다.

label

object (Label)

쿼리에서 참조된 라벨입니다.

languageConstant

object (LanguageConstant)

쿼리에서 참조된 언어 상수입니다.

locationView

object (LocationView)

쿼리에서 참조된 위치 뷰입니다.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

쿼리에서 참조된 제품 입찰 카테고리입니다.

productGroupView

object (ProductGroupView)

쿼리에서 참조된 제품 그룹 뷰입니다.

shoppingPerformanceView

object (ShoppingPerformanceView)

쿼리에서 참조된 쇼핑 실적 보기입니다.

userList

object (UserList)

쿼리에서 참조된 사용자 목록입니다.

userLocationView

object (UserLocationView)

쿼리에서 참조된 사용자 위치 뷰입니다.

webpageView

object (WebpageView)

쿼리에서 참조된 웹페이지 뷰입니다.

visit

object (Visit)

쿼리에서 참조된 이벤트 수준 방문입니다.

conversion

object (Conversion)

쿼리에서 참조된 이벤트 수준 전환입니다.

metrics

object (Metrics)

측정항목

segments

object (Segments)

세그먼트

customColumns[]

object (Value)

맞춤 열

광고그룹

광고 그룹

JSON 표현
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
필드
resourceName

string

광고 그룹의 리소스 이름입니다. 광고 그룹 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

광고 그룹의 상태입니다.

type

enum (AdGroupType)

광고 그룹의 유형입니다.

adRotationMode

enum (AdGroupAdRotationMode)

광고 그룹의 광고 로테이션 모드입니다.

creationTime

string

이 adGroup이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

targetingSetting

object (TargetingSetting)

타겟팅 관련 기능의 설정입니다.

labels[]

string

이 광고 그룹에 연결된 라벨의 리소스 이름입니다.

effectiveLabels[]

string

이 광고그룹에 연결된 유효 라벨의 리소스 이름입니다. 효과적인 라벨은 이 광고 그룹에 상속되거나 직접 할당된 라벨입니다.

engineId

string

외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "adGroup.id"를 사용하세요.

startDate

string

이 광고 그룹에서 광고 게재를 시작하는 날짜입니다. 기본적으로 광고 그룹은 지금 또는 광고 그룹의 시작일 중에서 늦은 날짜에 시작합니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 시작될 때 광고 그룹이 시작됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다.

형식: YYYY-MM-DD(예: 2019-03-14)

endDate

string

광고 그룹의 광고 게재가 종료되는 날짜입니다. 기본적으로 광고 그룹은 광고 그룹의 종료일에 종료됩니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 끝날 때 광고 그룹이 종료됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다.

형식: YYYY-MM-DD(예: 2019-03-14)

languageCode

string

광고 그룹에서 광고 및 키워드의 언어입니다. 이 필드는 Microsoft Advertising 계정에만 사용할 수 있습니다. 자세한 내용: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

이 광고 그룹이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

id

string (int64 format)

광고 그룹의 ID입니다.

name

string

광고 그룹의 이름입니다.

이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다.

255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다.

null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다.

cpcBidMicros

string (int64 format)

최대 CPC(클릭당비용) 입찰가입니다.

engineStatus

enum (AdGroupEngineStatus)

광고그룹의 엔진 상태입니다.

AdGroupStatus

광고 그룹의 가능한 상태입니다.

열거형
UNSPECIFIED 상태가 지정되지 않았습니다.
UNKNOWN

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

응답 전용 값입니다.

ENABLED 광고 그룹이 사용 설정되었습니다.
PAUSED 광고 그룹이 일시중지되었습니다.
REMOVED 광고그룹이 삭제됩니다.

AdGroupType

가능한 광고 그룹 유형을 나열하는 enum입니다.

열거형
UNSPECIFIED 유형이 지정되지 않았습니다.
UNKNOWN

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

응답 전용 값입니다.

SEARCH_STANDARD 검색 캠페인의 기본 광고 그룹 유형입니다.
DISPLAY_STANDARD 디스플레이 캠페인의 기본 광고 그룹 유형입니다.
SHOPPING_PRODUCT_ADS 일반 제품 광고를 게재하는 쇼핑 캠페인의 광고 그룹 유형입니다.
SHOPPING_SHOWCASE_ADS 쇼핑 결과에 쇼케이스 광고 또는 판매자 광고만 게재할 수 있는 광고 그룹의 유형입니다.
HOTEL_ADS 호텔 캠페인의 기본 광고그룹 유형입니다.
SHOPPING_SMART_ADS 스마트 쇼핑 캠페인의 광고 그룹 유형입니다.
VIDEO_BUMPER 건너뛸 수 없는 짧은 인스트림 동영상 광고입니다.
VIDEO_TRUE_VIEW_IN_STREAM TrueView (건너뛸 수 있는) 인스트림 동영상 광고
VIDEO_TRUE_VIEW_IN_DISPLAY TrueView 디스플레이 동영상 광고
VIDEO_NON_SKIPPABLE_IN_STREAM 건너뛸 수 없는 인스트림 동영상 광고
VIDEO_OUTSTREAM 아웃스트림 동영상 광고
SEARCH_DYNAMIC_ADS 동적 검색 광고 광고 그룹의 광고 그룹 유형입니다.
SHOPPING_COMPARISON_LISTING_ADS 쇼핑 가격 비교 등록정보 캠페인의 광고 그룹 유형입니다.
PROMOTED_HOTEL_ADS 프로모션 호텔 광고그룹의 광고그룹 유형입니다.
VIDEO_RESPONSIVE 동영상 반응형 광고 그룹
VIDEO_EFFICIENT_REACH 동영상 효율적 잠재고객 도달 광고 그룹
SMART_CAMPAIGN_ADS 스마트 캠페인의 광고 그룹 유형입니다.
TRAVEL_ADS 여행 캠페인의 광고 그룹 유형입니다.

AdGroupAdRotationMode

광고 그룹에서 사용할 수 있는 광고 로테이션 모드입니다.

열거형
UNSPECIFIED 광고 로테이션 모드가 지정되지 않았습니다.
UNKNOWN

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

응답 전용 값입니다.

OPTIMIZE 클릭수 또는 전환수를 기준으로 광고 그룹 광고를 최적화합니다.
ROTATE_FOREVER 영원히 균등하게 회전합니다.

AdGroupEngineStatus

광고 그룹 엔진의 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_GROUP_ELIGIBLE

지원 중단되었습니다. 사용하지 마세요.

AD_GROUP_EXPIRED 광고 그룹의 종료일이 지났기 때문에 이 광고 그룹에 대한 광고가 게재되지 않습니다.
AD_GROUP_REMOVED 광고 그룹이 삭제되었습니다.
AD_GROUP_DRAFT 연결된 광고 그룹이 아직 초안 상태이므로 이 광고 그룹에 광고가 게재되지 않습니다.
AD_GROUP_PAUSED 광고 그룹이 일시중지되었습니다.
AD_GROUP_SERVING 광고그룹이 운영중이며 현재 광고를 게재하고 있습니다.
AD_GROUP_SUBMITTED 광고 그룹이 제출되었습니다 (Microsoft Bing Ads 기존 상태).
CAMPAIGN_PAUSED 캠페인이 일시중지되어 이 광고 그룹에 광고가 게재되지 않습니다.
ACCOUNT_PAUSED 계정이 일시중지되어 이 광고그룹에서 운영 중인 광고가 없습니다.

TargetingSetting

캠페인 및 광고그룹 수준의 타겟팅 관련 기능 설정 타겟팅 설정에 대한 자세한 내용은 다음 페이지를 참고하세요. https://support.google.com/google-ads/answer/7365594

JSON 표현
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
필드
targetRestrictions[]

object (TargetRestriction)

캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다.

TargetRestriction

타겟팅 측정기준별 타겟팅 설정 목록입니다.

JSON 표현
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
필드
targetingDimension

enum (TargetingDimension)

이 설정이 적용되는 타겟팅 측정기준입니다.

bidOnly

boolean

이 타겟팅 측정기준에 대해 선택한 기준에 대해서만 광고가 게재되도록 제한할지, 이 타겟팅 측정기준의 모든 값을 타겟팅하고 다른 타겟팅 측정기준의 타겟팅을 기반으로 광고를 표시할지 여부를 나타냅니다. 값이 true이면 이러한 기준이 입찰가 수정만 적용하고 타겟팅에는 영향을 미치지 않음을 의미합니다. 값이 false이면 이러한 기준이 타겟팅을 제한하고 입찰가 조정을 적용한다는 의미입니다.

TargetingDimension

가능한 타겟팅 측정기준을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
KEYWORD 키워드 기준(예: '화성 크루즈') KEYWORD는 맞춤 입찰 측정기준으로 사용할 수 있습니다. 키워드는 항상 타겟팅 측정기준이므로 TargetRestriction을 사용하여 타겟 'ALL' 측정기준으로 설정할 수 없습니다.
AUDIENCE 사용자 목록, 사용자 관심분야, 맞춤 관심분야, 맞춤 구매 의도 잠재고객을 포함한 잠재고객 기준
TOPIC 콘텐츠 카테고리를 타겟팅하기 위한 주제 기준입니다(예: 디스플레이 및 동영상 타겟팅에 사용되는 'category::동물>반려동물').
GENDER 성별 타겟팅 기준
AGE_RANGE 연령대 타겟팅 기준입니다.
PLACEMENT 게재위치 기준: 'www.flowers4sale.com'과 같은 웹사이트, 모바일 애플리케이션, 모바일 앱 카테고리, YouTube 동영상, YouTube 채널이 여기에 포함됩니다.
PARENTAL_STATUS 자녀 유무 타겟팅 기준입니다.
INCOME_RANGE 소득 범위 타겟팅 기준입니다.

AdGroupAd

광고 그룹 광고

JSON 표현
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
필드
resourceName

string

광고의 리소스 이름입니다. 광고 그룹 광고 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

광고의 상태입니다.

ad

object (Ad)

광고

creationTime

string

이 adGroupAd가 생성된 타임스탬프입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

labels[]

string

이 광고 그룹 광고에 연결된 라벨의 리소스 이름입니다.

effectiveLabels[]

string

이 광고에 연결된 유효 라벨의 리소스 이름입니다. 효과적인 라벨은 이 광고에 상속되거나 직접 할당된 라벨입니다.

engineId

string

외부 엔진 계정의 광고 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Search Ads 360 계정에만 사용됩니다. Search Ads 360 이외의 항목의 경우 대신 "adGroupAd.ad.id"를 사용하세요.

engineStatus

enum (AdGroupAdEngineStatus)

외부 엔진 계정에 있는 광고의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 활성, 적격, 검토 대기중 등입니다.

lastModifiedTime

string

이 광고 그룹 광고가 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

AdGroupAdStatus

AdGroupAd의 가능한 상태입니다.

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

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

응답 전용 값입니다.

ENABLED 광고 그룹 광고가 사용 설정됩니다.
PAUSED 광고 그룹 광고가 일시중지됩니다.
REMOVED 광고 그룹 광고가 삭제됩니다.

AdType

가능한 광고 유형입니다.

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

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

응답 전용 값입니다.

TEXT_AD 광고가 텍스트 광고입니다.
EXPANDED_TEXT_AD 광고가 확장 텍스트 광고입니다.
CALL_ONLY_AD 통화 전용 광고입니다.
EXPANDED_DYNAMIC_SEARCH_AD 광고가 확장 동적 검색 광고입니다.
HOTEL_AD 호텔 광고입니다.
SHOPPING_SMART_AD 광고가 스마트 쇼핑 광고입니다.
SHOPPING_PRODUCT_AD 이 광고는 일반 쇼핑 광고입니다.
VIDEO_AD 광고가 동영상 광고입니다.
GMAIL_AD 이 광고는 Gmail 광고입니다.
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_OUTSTREAM_AD 동영상 아웃스트림 광고
VIDEO_TRUEVIEW_DISCOVERY_AD 동영상 TrueView 디스플레이 광고
VIDEO_TRUEVIEW_IN_STREAM_AD 동영상 TrueView 인스트림 광고
VIDEO_RESPONSIVE_AD 동영상 반응형 광고
SMART_CAMPAIGN_AD 스마트 캠페인 광고
APP_PRE_REGISTRATION_AD 유니버설 앱 사전 등록 광고
DISCOVERY_MULTI_ASSET_AD 디스커버리 멀티 애셋 광고
TRAVEL_AD 여행 광고
DISCOVERY_VIDEO_RESPONSIVE_AD 디스커버리 동영상 반응형 광고입니다.
MULTIMEDIA_AD 멀티미디어 광고입니다.

SearchAds360TextAdInfo

Search Ads 360 텍스트 광고

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

string

광고의 제목입니다.

description1

string

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

description2

string

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

displayUrl

string

광고의 표시 URL입니다.

displayMobileUrl

string

광고의 표시된 모바일 URL입니다.

adTrackingId

string (int64 format)

광고의 추적 ID입니다.

SearchAds360ExpandedTextAdInfo

Search Ads 360 확장 텍스트 광고

JSON 표현
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
필드
headline

string

광고의 제목입니다.

headline2

string

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

headline3

string

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

description1

string

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

description2

string

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

path1

string

자동 생성된 표시 URL에 구분 기호와 함께 추가된 텍스트입니다.

path2

string

path1에 구분자가 추가된 텍스트입니다.

adTrackingId

string (int64 format)

광고의 추적 ID입니다.

SearchAds360ResponsiveSearchAdInfo

Search Ads 360의 반응형 검색 광고

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

object (AdTextAsset)

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

descriptions[]

object (AdTextAsset)

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

path1

string

자동 생성된 표시 URL에 구분 기호와 함께 추가된 텍스트입니다.

path2

string

path1에 구분자가 추가된 텍스트입니다.

adTrackingId

string (int64 format)

광고의 추적 ID입니다.

AdTextAsset

광고 내에 사용되는 텍스트 애셋입니다.

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

string

애셋 텍스트

SearchAds360ProductAdInfo

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

Search Ads 360 제품 광고

SearchAds360ExpandedDynamicSearchAdInfo

확장 동적 검색 광고

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

string

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

description2

string

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

adTrackingId

string (int64 format)

광고의 추적 ID입니다.

AdGroupAdEngineStatus

AdGroupAd 엔진 상태를 열거합니다.

열거형
UNSPECIFIED 지정된 값이 없습니다.
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_GROUP_AD_ELIGIBLE

지원 중단되었습니다. 사용하지 마세요.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: 광고 소재가 승인되지 않았습니다.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: 모바일 URL이 검토를 위해 처리 중
AD_GROUP_AD_PARTIALLY_INVALID Baidu: 광고 소재가 휴대기기에서는 유효하지 않지만 데스크톱에서는 유효합니다.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: 광고 소재를 활성화할 준비가 되었습니다.
AD_GROUP_AD_NOT_REVIEWED Baidu: 광고 소재가 검토되지 않았습니다.
AD_GROUP_AD_ON_HOLD

지원 중단되었습니다. 사용하지 마세요. Gemini에서 이전에 사용함

AD_GROUP_AD_PAUSED 광고 소재가 일시중지되었습니다.
AD_GROUP_AD_REMOVED 광고 소재가 삭제되었습니다.
AD_GROUP_AD_PENDING_REVIEW 광고 소재가 검토 대기 중입니다.
AD_GROUP_AD_UNDER_REVIEW 광고 소재를 검토 중입니다.
AD_GROUP_AD_APPROVED 광고 소재가 승인되었습니다.
AD_GROUP_AD_DISAPPROVED 광고 소재가 비승인되었습니다.
AD_GROUP_AD_SERVING 광고 소재가 게재되고 있습니다.
AD_GROUP_AD_ACCOUNT_PAUSED 계정이 일시중지되어 광고 소재가 일시중지되었습니다.
AD_GROUP_AD_CAMPAIGN_PAUSED 캠페인이 일시중지되어 광고 소재가 일시중지되었습니다.
AD_GROUP_AD_AD_GROUP_PAUSED 광고 그룹이 일시중지되어 광고 소재가 일시중지되었습니다.

AdGroupAdEffectiveLabel

광고 그룹 광고와 효과적인 라벨 간의 관계입니다. 유효 라벨은 이 광고그룹 광고에 상속되거나 직접 할당된 라벨입니다.

JSON 표현
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

광고 그룹 광고 효과 라벨의 리소스 이름입니다. 광고 그룹 광고 효과 라벨 리소스 이름은 customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id} 형식입니다.

adGroupAd

string

효과적인 라벨이 연결된 광고 그룹 광고입니다.

label

string

광고 그룹 광고에 할당된 유효 라벨입니다.

ownerCustomerId

string (int64 format)

효과적인 라벨을 소유한 고객의 ID입니다.

AdGroupAdLabel

광고 그룹 광고와 라벨 간의 관계입니다.

JSON 표현
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

광고 그룹 광고 라벨의 리소스 이름입니다. 광고 그룹 광고 라벨 리소스 이름의 형식은 다음과 같습니다. customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

라벨이 연결된 광고 그룹 광고입니다.

label

string

광고 그룹 광고에 할당된 라벨입니다.

ownerCustomerId

string (int64 format)

라벨을 소유한 고객의 ID입니다.

AdGroupAsset

광고 그룹과 확장 소재 간의 연결입니다.

JSON 표현
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
필드
resourceName

string

광고 그룹 확장 소재의 리소스 이름입니다. AdGroupAsset 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

필수 항목입니다. 애셋이 연결된 광고 그룹입니다.

asset

string

필수 항목입니다. 광고 그룹에 연결된 애셋입니다.

status

enum (AssetLinkStatus)

광고 그룹 확장 소재의 상태입니다.

AssetLinkStatus

저작물 링크의 상태를 설명하는 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 확장 소재 링크가 사용 설정되었습니다.
REMOVED 저작물 링크가 삭제되었습니다.
PAUSED 확장 소재 연결이 일시중지되었습니다.

AdGroupAssetSet

AdGroupAssetSet는 광고그룹과 애셋 집합 간의 연결입니다. AdGroupAssetSet를 생성하면 애셋 세트가 광고그룹과 연결됩니다.

JSON 표현
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
필드
resourceName

string

광고 그룹 애셋 세트의 리소스 이름입니다. 광고 그룹 확장 소재 세트 리소스 이름은 다음과 같은 형식입니다.

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

이 애셋 집합이 연결된 광고 그룹입니다.

assetSet

string

광고 그룹에 연결된 애셋 집합입니다.

status

enum (AssetSetLinkStatus)

광고 그룹 확장 소재 세트의 상태입니다. 읽기 전용입니다.

AssetSetLinkStatus

애셋 세트와 컨테이너 간 연결의 가능한 상태입니다.

열거형
UNSPECIFIED 상태가 지정되지 않았습니다.
UNKNOWN 이 버전에서는 수신된 값을 알 수 없습니다. 응답 전용 값입니다.
ENABLED 애셋 세트와 해당 컨테이너 간의 연결이 사용 설정되었습니다.
REMOVED 애셋 세트와 컨테이너 간의 연결이 삭제됩니다.

AdGroupAudienceView

광고 그룹 잠재고객 보기 디스플레이 네트워크 및 YouTube 네트워크 광고의 관심분야 및 리마케팅 목록, 검색 광고용 리마케팅 목록(RLSA)의 실적 데이터를 잠재고객 수준으로 집계한 데이터입니다.

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

string

광고 그룹 잠재고객 뷰의 리소스 이름입니다. 광고그룹 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

광고 그룹 입찰가 조정을 나타냅니다.

JSON 표현
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
필드
resourceName

string

광고그룹 입찰가 조정의 리소스 이름입니다. 광고 그룹 입찰가 조정 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 선호 콘텐츠의 경우 범위는 1.0~6.0입니다. 기기 유형을 선택 해제하려면 0을 사용합니다.

통합 필드 criterion. 이 광고 그룹 입찰가 조정의 기준입니다.

V5부터 생성 작업에 필요합니다. criterion는 다음 중 하나여야 합니다.

device

object (DeviceInfo)

기기 기준입니다.

DeviceInfo

기기 기준입니다.

JSON 표현
{
  "type": enum (Device)
}
필드
type

enum (Device)

기기 유형입니다.

기기

타겟팅할 수 있는 Google Ads 기기를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서 알 수 없는 값입니다.
MOBILE 풀브라우저가 있는 휴대기기
TABLET 풀브라우징 기능이 있는 태블릿
DESKTOP 컴퓨터
CONNECTED_TV 스마트 TV 및 게임 콘솔
OTHER 기타 기기 유형

AdGroupCriterion

광고그룹 기준 adGroup기준 보고서는 광고그룹에 명시적으로 추가된 기준만 반환합니다.

JSON 표현
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
필드
resourceName

string

광고그룹 기준의 리소스 이름입니다. 광고 그룹 기준 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}

creationTime

string

이 광고 그룹 기준이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

status

enum (AdGroupCriterionStatus)

기준의 상태입니다.

고객이 설정한 광고 그룹 기준 항목의 상태입니다. 참고: UI 보고서에는 기준 실행 가능 여부에 영향을 미치는 추가 정보가 포함될 수 있습니다. 일부 경우에는 API에서 삭제된 기준이 UI에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다.

qualityInfo

object (QualityInfo)

기준의 품질에 관한 정보입니다.

type

enum (CriterionType)

기준의 유형입니다.

labels[]

string

이 광고 그룹 기준에 연결된 라벨의 리소스 이름입니다.

effectiveLabels[]

string

이 광고 그룹 기준에 연결된 유효 라벨의 리소스 이름입니다. 효과적인 라벨은 이 광고 그룹 기준에 상속되거나 직접 할당된 라벨입니다.

positionEstimates

object (PositionEstimates)

다양한 게재순위에서의 기준 입찰가 견적입니다.

finalUrls[]

string

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

engineId

string

외부 엔진 계정의 광고그룹 기준 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "adGroupCriterion.criterion_id"를 사용하세요.

lastModifiedTime

string

이 광고 그룹 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

criterionId

string (int64 format)

기준의 ID입니다.

adGroup

string

기준이 속한 광고 그룹입니다.

negative

boolean

기준을 타겟팅(false)할지 또는 제외(true)할지 여부입니다.

이 필드는 변경할 수 없습니다. 기준을 포함에서 음수로 전환하려면 삭제한 다음 다시 추가하세요.

bidModifier

number

기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다.

cpcBidMicros

string (int64 format)

CPC(클릭당비용) 입찰가입니다.

effectiveCpcBidMicros

string (int64 format)

유효 CPC(클릭당비용) 입찰가입니다.

engineStatus

enum (AdGroupCriterionEngineStatus)

광고 그룹 기준의 엔진 상태입니다.

finalUrlSuffix

string

최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.

trackingUrlTemplate

string

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

통합 필드 criterion. 광고 그룹 기준입니다.

정확히 하나만 설정해야 합니다. criterion는 다음 중 하나여야 합니다.

keyword

object (KeywordInfo)

키워드

listingGroup

object (ListingGroupInfo)

등록정보 그룹

ageRange

object (AgeRangeInfo)

연령대입니다.

gender

object (GenderInfo)

성별

userList

object (UserListInfo)

사용자 목록

webpage

object (WebpageInfo)

웹페이지

location

object (LocationInfo)

위치를 탭합니다.

AdGroupCriterionStatus

AdGroupCriterion의 가능한 상태입니다.

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

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

응답 전용 값입니다.

ENABLED 광고그룹 기준이 사용 설정되어 있습니다.
PAUSED 광고그룹 기준이 일시중지됩니다.
REMOVED 광고그룹 기준이 삭제됩니다.

QualityInfo

광고 그룹 기준 품질 정보를 위한 컨테이너입니다.

JSON 표현
{
  "qualityScore": integer
}
필드
qualityScore

integer

품질평가점수입니다.

Google에서 값을 결정하기 위한 정보가 충분하지 않으면 이 필드가 채워지지 않을 수 있습니다.

CriterionType

가능한 기준 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
KEYWORD 키워드(예: '화성 크루즈')
PLACEMENT 게재위치(웹사이트)(예: 'www.flowers4sale.com')
MOBILE_APP_CATEGORY 타겟팅할 모바일 애플리케이션 카테고리입니다.
MOBILE_APPLICATION 타겟팅할 모바일 애플리케이션
DEVICE 타겟팅할 기기
LOCATION 타겟팅할 위치입니다.
LISTING_GROUP 타겟팅할 그룹 나열
AD_SCHEDULE 광고 일정
AGE_RANGE 연령대입니다.
GENDER 성별
INCOME_RANGE 소득 범위
PARENTAL_STATUS 자녀 유무
YOUTUBE_VIDEO YouTube 동영상
YOUTUBE_CHANNEL YouTube 채널
USER_LIST 사용자 목록
PROXIMITY 근접도
TOPIC 디스플레이 네트워크의 주제 타겟 (예: '애완동물 및 동물')
LISTING_SCOPE 타겟팅할 등록정보 범위입니다.
LANGUAGE 언어
IP_BLOCK IpBlock.
CONTENT_LABEL 카테고리 제외를 위한 콘텐츠 라벨입니다.
CARRIER 이동통신사로 이동합니다.
USER_INTEREST 사용자가 관심을 갖는 카테고리입니다.
WEBPAGE 동적 검색 광고의 웹페이지 기준
OPERATING_SYSTEM_VERSION 바로 운영체제 버전입니다.
APP_PAYMENT_MODEL 앱 결제 모델
MOBILE_DEVICE 휴대기기
CUSTOM_AFFINITY 맞춤 관심분야
CUSTOM_INTENT 맞춤 의도
LOCATION_GROUP 위치 그룹
CUSTOM_AUDIENCE 맞춤 잠재고객
COMBINED_AUDIENCE 통합된 잠재고객
KEYWORD_THEME 스마트 캠페인 키워드 테마
AUDIENCE 잠재고객
LOCAL_SERVICE_ID 지역 서비스 광고 서비스 ID.
BRAND 브랜드
BRAND_LIST 브랜드 목록
LIFE_EVENT 생애 주요 이벤트

PositionEstimates

다양한 위치의 검색어 입찰가에 대한 추정치입니다.

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

string (int64 format)

검색 결과 첫 페이지 상단에 광고를 게재하는 데 필요한 CPC 입찰가의 예상치입니다.

AdGroupCriterionEngineStatus

AdGroupCriterion 엔진 상태를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_GROUP_CRITERION_ELIGIBLE

지원 중단되었습니다. 사용하지 마세요.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: 입찰가 또는 품질이 너무 낮아서 표시할 수 없습니다.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: 검색량이 적어 Baidu에 의해 일시중지됨
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: 모바일 URL이 검토를 위해 처리 중
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: 한 기기의 방문 페이지는 유효하지만 다른 기기의 방문 페이지도 유효합니다.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: Baidu 계정 관리팀에서 키워드를 생성하고 일시중지했으며 이제 키워드를 활성화할 수 있습니다.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: Baidu에서 검토하는 중입니다. Gemini: 검토 중인 기준입니다.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: 검토 대상 기준
AD_GROUP_CRITERION_ON_HOLD

지원 중단되었습니다. 사용하지 마세요. Gemini에서 이전에 사용함

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : 검토 대기 중인 기준
AD_GROUP_CRITERION_PAUSED 기준이 일시중지되었습니다.
AD_GROUP_CRITERION_REMOVED 기준이 삭제되었습니다.
AD_GROUP_CRITERION_APPROVED 기준이 승인되었습니다.
AD_GROUP_CRITERION_DISAPPROVED 기준이 비승인되었습니다.
AD_GROUP_CRITERION_SERVING 기준이 활성 상태이며 게재되고 있습니다.
AD_GROUP_CRITERION_ACCOUNT_PAUSED 계정이 일시중지되어 기준이 일시중지되었습니다.

KeywordInfo

키워드 기준입니다.

JSON 표현
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
필드
matchType

enum (KeywordMatchType)

키워드의 일치 유형입니다.

text

string

키워드의 텍스트입니다(최대 80자 및 10개 단어).

KeywordMatchType

가능한 키워드 검색 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EXACT 일치검색
PHRASE 구문검색
BROAD 확장검색

ListingGroupInfo

등록정보 그룹 기준

JSON 표현
{
  "type": enum (ListingGroupType)
}
필드
type

enum (ListingGroupType)

목록 그룹의 유형입니다.

ListingGroupType

등록정보 그룹의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SUBDIVISION 일부 등록정보 측정기준을 기준으로 제품을 세분화합니다. 이러한 노드는 등록정보 항목을 타겟팅하는 데 사용되지 않으며 순전히 트리 구조를 정의하는 데 사용됩니다.
UNIT 입찰가를 정의하는 등록정보 그룹 단위입니다.

AgeRangeInfo

연령대 기준입니다.

JSON 표현
{
  "type": enum (AgeRangeType)
}
필드
type

enum (AgeRangeType)

연령대의 유형입니다.

AgeRangeType

인구통계 연령대 유형입니다 (예: 18~24세).

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AGE_RANGE_18_24 만 18~24세
AGE_RANGE_25_34 만 25~34세
AGE_RANGE_35_44 만 35~44세
AGE_RANGE_45_54 45~54세
AGE_RANGE_55_64 55~64세
AGE_RANGE_65_UP 65세 이상
AGE_RANGE_UNDETERMINED 연령대가 확인되지 않음

GenderInfo

성별 기준

JSON 표현
{
  "type": enum (GenderType)
}
필드
type

enum (GenderType)

성별 유형입니다.

GenderType

인구통계적 성별 유형입니다 (예: 여성).

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
MALE 남성입니다.
FEMALE 여성입니다.
UNDETERMINED 성별이 확인되지 않았습니다.

UserListInfo

사용자 목록 기준입니다. 광고주가 타겟팅하도록 정의한 사용자 목록을 나타냅니다.

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

string

사용자 목록 리소스 이름입니다.

WebpageInfo

광고주 웹사이트의 웹페이지를 타겟팅하기 위한 기준을 나타냅니다.

JSON 표현
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
필드
conditions[]

object (WebpageConditionInfo)

웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

coveragePercentage

number

웹사이트 기준 노출 범위 비율입니다. 광고 그룹 및 캠페인에서 웹사이트 대상, 제외 웹사이트 대상, 제외 키워드를 기반으로 계산된 웹사이트 노출 범위 비율입니다. 예를 들어 노출 범위가 1로 반환되었으면 노출 범위가 100%입니다. 이 필드는 읽기 전용입니다.

criterionName

string

이 매개변수로 정의된 기준의 이름입니다. 이름 값은 이 유형의 매개변수로 기준을 식별, 정렬, 필터링하는 데 사용됩니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

WebpageConditionInfo

광고주 웹사이트의 웹페이지를 타겟팅하기 위한 논리적 표현식입니다.

JSON 표현
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
필드
operand

enum (WebpageConditionOperand)

웹페이지 타겟팅 조건의 피연산자입니다.

operator

enum (WebpageConditionOperator)

웹페이지 타겟팅 조건의 연산자입니다.

argument

string

웹페이지 타겟팅 조건의 인수입니다.

WebpageConditionOperand

웹페이지 기준의 웹페이지 조건 피연산자입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
URL 웹페이지 URL 타겟팅 조건을 나타내는 피연산자입니다.
CATEGORY 웹페이지 카테고리 타겟팅 조건을 나타내는 피연산자입니다.
PAGE_TITLE 웹페이지 제목 타겟팅 조건을 나타내는 피연산자입니다.
PAGE_CONTENT 웹페이지 콘텐츠 타겟팅 조건을 나타내는 피연산자입니다.
CUSTOM_LABEL 웹페이지 맞춤 라벨 타겟팅 조건을 나타내는 피연산자입니다.

WebpageConditionOperator

웹페이지 기준의 웹페이지 조건 연산자입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EQUALS 인수 웹 조건이 비교된 웹 조건과 같습니다.
CONTAINS 인수 웹 조건은 비교된 웹 조건의 일부입니다.

LocationInfo

위치 기준입니다.

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

string

지역 대상 상수 리소스 이름입니다.

AdGroupCriterionEffectiveLabel

광고 그룹 기준과 효과적인 라벨 간의 관계입니다. 효과적인 라벨은 이 광고 그룹 기준에 상속되거나 직접 할당된 라벨입니다.

JSON 표현
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

광고 그룹 기준 효과 라벨의 리소스 이름입니다. 광고그룹 기준 유효 라벨 리소스 이름의 형식은 customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}입니다.

adGroupCriterion

string

효과적인 라벨이 연결된 광고 그룹 기준입니다.

label

string

광고 그룹 기준에 할당된 유효 라벨입니다.

ownerCustomerId

string (int64 format)

효과적인 라벨을 소유한 고객의 ID입니다.

AdGroupCriterionLabel

광고 그룹 기준과 라벨 간의 관계입니다.

JSON 표현
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

광고 그룹 기준 라벨의 리소스 이름입니다. 광고 그룹 기준 라벨 리소스 이름의 형식은 customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}입니다.

adGroupCriterion

string

라벨이 연결된 광고 그룹 기준입니다.

label

string

광고 그룹 기준에 할당된 라벨입니다.

ownerCustomerId

string (int64 format)

라벨을 소유한 고객의 ID입니다.

AdGroupEffectiveLabel

광고 그룹과 효과적인 라벨 간의 관계입니다. 효과적인 라벨은 이 광고 그룹에 상속되거나 직접 할당된 라벨입니다.

JSON 표현
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

광고그룹 유효 라벨의 리소스 이름입니다. 광고 그룹 효과적인 라벨 리소스 이름의 형식은 다음과 같습니다. customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}

adGroup

string

유효 라벨이 첨부된 광고그룹입니다.

label

string

광고 그룹에 할당된 유효 라벨입니다.

ownerCustomerId

string (int64 format)

효과적인 라벨을 소유한 고객의 ID입니다.

AdGroupLabel

광고 그룹과 라벨 간의 관계입니다.

JSON 표현
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

광고그룹 라벨의 리소스 이름입니다. 광고 그룹 라벨 리소스 이름의 형식은 customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}입니다.

adGroup

string

라벨이 연결된 광고 그룹입니다.

label

string

광고 그룹에 할당된 라벨입니다.

ownerCustomerId

string (int64 format)

라벨을 소유한 고객의 ID입니다.

AgeRangeView

연령대 뷰입니다.

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

string

연령대 뷰의 리소스 이름입니다. 연령대 보기 리소스 이름은 다음과 같은 형식입니다.

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

확장 소재

확장 소재는 광고의 일부로 여러 광고에서 공유할 수 있습니다. 이미지 (ImageAsset), 동영상 (YoutubeVideoAsset) 등이 될 수 있습니다. 애셋은 변경 불가능하며 삭제할 수 없습니다. 애셋의 게재를 중지하려면 애셋을 사용하는 항목에서 애셋을 삭제합니다.

JSON 표현
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
필드
resourceName

string

애셋의 리소스 이름입니다. 애셋 리소스 이름은 다음과 같은 형식입니다.

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

확장 소재 유형입니다.

finalUrls[]

string

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

status

enum (AssetStatus)

애셋의 상태입니다.

creationTime

string

이 애셋이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

lastModifiedTime

string

이 애셋이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

id

string (int64 format)

저작물의 ID입니다.

name

string

애셋의 이름입니다(선택사항).

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

저작물의 엔진 상태입니다.

통합 필드 asset_data. 저작물의 특정 유형입니다. asset_data은 다음 중 하나여야 합니다.
youtubeVideoAsset

object (YoutubeVideoAsset)

YouTube 동영상 애셋

imageAsset

object (ImageAsset)

이미지 확장 소재

textAsset

object (TextAsset)

텍스트 애셋입니다.

calloutAsset

object (UnifiedCalloutAsset)

통합 콜아웃 확장 소재

pageFeedAsset

object (UnifiedPageFeedAsset)

통합된 페이지 피드 애셋

mobileAppAsset

object (MobileAppAsset)

모바일 앱 확장 소재

callAsset

object (UnifiedCallAsset)

통합된 전화번호 확장 소재입니다.

callToActionAsset

object (CallToActionAsset)

클릭 유도 문구 애셋

locationAsset

object (UnifiedLocationAsset)

통합 위치 확장 소재입니다.

AssetType

가능한 확장 소재 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
YOUTUBE_VIDEO YouTube 동영상 애셋
MEDIA_BUNDLE 미디어 번들 애셋
IMAGE 이미지 확장 소재
TEXT 텍스트 애셋
LEAD_FORM 리드 양식 확장 소재
BOOK_ON_GOOGLE Google에서 예약 애셋
PROMOTION 프로모션 확장 소재
CALLOUT 콜아웃 확장 소재
STRUCTURED_SNIPPET 구조화된 스니펫 확장 소재
PAGE_FEED 페이지 피드 확장 소재
DYNAMIC_EDUCATION 동적 교육 확장 소재
MOBILE_APP 모바일 앱 확장 소재
HOTEL_CALLOUT 호텔 콜아웃 확장 소재
CALL 전화번호 확장 소재
PRICE 가격 확장 소재
CALL_TO_ACTION 클릭 유도 문구 애셋입니다.
DYNAMIC_REAL_ESTATE 동적 부동산 애셋입니다.
DYNAMIC_CUSTOM 동적 맞춤 애셋입니다.
DYNAMIC_HOTELS_AND_RENTALS 동적 호텔 및 공유숙박 애셋
DYNAMIC_FLIGHTS 동적 항공편 애셋
DYNAMIC_TRAVEL 동적 여행 애셋
DYNAMIC_LOCAL 동적 지역 확장 소재
DYNAMIC_JOBS 동적 직업 애셋
LOCATION 위치 확장 소재
HOTEL_PROPERTY 호텔 숙박 시설 확장 소재

AssetStatus

저작물의 가능한 상태입니다.

열거형
UNSPECIFIED 상태가 지정되지 않았습니다.
UNKNOWN 이 버전에서는 수신된 값을 알 수 없습니다. 응답 전용 값입니다.
ENABLED 확장 소재가 사용 설정되었습니다.
REMOVED 애셋이 삭제되었습니다.
ARCHIVED 저작물이 보관처리됩니다.
PENDING_SYSTEM_GENERATED 확장 소재는 사용자 검토를 위해 시스템에서 생성됩니다.

AssetEngineStatus

다음 ID = 11

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SERVING 저작물이 활성 상태입니다.
SERVING_LIMITED 저작물이 활성 제한 상태입니다.
DISAPPROVED 확장 소재가 비승인되었습니다 (사용할 수 없음).
DISABLED 저작물이 비활성 상태입니다 (대기 중).
REMOVED 애셋이 삭제되었습니다.

YoutubeVideoAsset

YouTube 확장 소재

JSON 표현
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
필드
youtubeVideoTitle

string

YouTube 동영상 제목

youtubeVideoId

string

YouTube 동영상 ID YouTube 동영상 URL에 사용되는 11자리 문자열 값입니다.

ImageAsset

이미지 확장 소재입니다.

JSON 표현
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
필드
mimeType

enum (MimeType)

이미지 확장 소재의 MIME 유형입니다.

fullSize

object (ImageDimension)

이 이미지의 메타데이터(원본 크기)입니다.

fileSize

string (int64 format)

이미지 애셋의 파일 크기(바이트)입니다.

MimeType

MIME 유형

열거형
UNSPECIFIED MIME 유형이 지정되지 않았습니다.
UNKNOWN

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

응답 전용 값입니다.

IMAGE_JPEG image/jpeg의 MIME 유형입니다.
IMAGE_GIF 이미지/gif의 MIME 유형입니다.
IMAGE_PNG image/png의 MIME 유형입니다.
FLASH application/x-shockwave-flash의 MIME 유형입니다.
TEXT_HTML MIME 유형은 text/html입니다.
PDF application/pdf의 MIME 유형입니다.
MSWORD application/msword의 MIME 유형입니다.
MSEXCEL MIME 유형이 application/vnd.ms-excel인 경우
RTF application/rtf의 MIME 유형입니다.
AUDIO_WAV audio/wav의 MIME 유형입니다.
AUDIO_MP3 audio/mp3의 MIME 유형입니다.
HTML5_AD_ZIP MIME 유형이 application/x-html5-ad-zip인 광고입니다.

ImageDimension

원본 또는 크기가 조절된 특정 크기의 이미지에 대한 메타데이터입니다.

JSON 표현
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
필드
heightPixels

string (int64 format)

이미지의 높이입니다.

widthPixels

string (int64 format)

이미지의 너비입니다.

url

string

이 높이와 너비로 이미지를 반환하는 URL입니다.

TextAsset

텍스트 애셋입니다.

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

string

텍스트 애셋의 텍스트 콘텐츠입니다.

UnifiedCalloutAsset

통합 콜아웃 확장 소재

JSON 표현
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
필드
calloutText

string

콜아웃 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함).

startDate

string

이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일입니다(yyyy-MM-dd 형식).

endDate

string

이 확장 소재가 유효하고 계속 게재되는 마지막 날짜(yyyy-MM-dd 형식)입니다.

adScheduleTargets[]

object (AdScheduleInfo)

저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개(총 42개)의 일정을 설정할 수 있습니다.

useSearcherTimeZone

boolean

검색 사용자의 시간대에 확장 소재를 표시할지 여부입니다. Microsoft Ads에 적용됩니다.

AdScheduleInfo

AdSchedule 기준을 나타냅니다.

AdSchedule은 요일 및 광고가 표시될 시간 간격으로 지정됩니다.

동일한 날짜에 AdSchedules를 6개 이하로 추가할 수 있습니다.

JSON 표현
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
필드
startMinute

enum (MinuteOfHour)

일정이 시작되는 시작 시간(분) 후의 시간입니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

endMinute

enum (MinuteOfHour)

일정이 종료되는 종료 시간 이후의 시간(분)입니다. 일정은 종료 시간(분)을 제외합니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

dayOfWeek

enum (DayOfWeek)

일정이 적용되는 요일입니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

startHour

integer

24시간 형식의 시작 시간입니다. 이 필드는 0~23 사이여야 합니다(양 끝값 포함).

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

endHour

integer

24시간 형식의 종료 시간입니다. 24는 하루의 종료를 나타냅니다. 이 필드는 0 이상, 24 이하여야 합니다.

이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다.

MinuteOfHour

15분 단위로 열거합니다. 예: 'FIFTEEN'

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서 알 수 없는 값입니다.
ZERO 0분(매시간)
FIFTEEN 15분
THIRTY 30분(매시간)
FORTY_FIVE 정시에서 45분 경과

DayOfWeek

요일을 열거합니다(예: 'Monday').

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서 알 수 없는 값입니다.
MONDAY 월요일입니다.
TUESDAY 화요일
WEDNESDAY 수요일.
THURSDAY 목요일.
FRIDAY 금요일입니다.
SATURDAY 따릅니다.
SUNDAY 일요일

UnifiedSitelinkAsset

통합된 사이트링크 확장 소재

JSON 표현
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
필드
description1

string

사이트링크 설명의 첫 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description2도 설정해야 합니다.

description2

string

사이트링크 설명의 두 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description1도 설정해야 합니다.

startDate

string

이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일입니다(yyyy-MM-dd 형식).

endDate

string

이 확장 소재가 유효하고 계속 게재되는 마지막 날짜(yyyy-MM-dd 형식)입니다.

adScheduleTargets[]

object (AdScheduleInfo)

저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개(총 42개)의 일정을 설정할 수 있습니다.

trackingId

string (int64 format)

사이트링크 확장 소재의 클릭을 추적하는 데 사용되는 ID입니다. Yahoo! 일본만 해당하는 입력란입니다.

useSearcherTimeZone

boolean

검색 사용자의 시간대에 사이트링크 확장 소재를 표시할지 여부입니다. Microsoft Advertising에 적용됩니다.

mobilePreferred

boolean

사이트링크 확장 소재가 휴대기기에 표시되도록 설정되어 있는지 여부입니다. Microsoft Advertising에 적용됩니다.

UnifiedPageFeedAsset

통합 페이지 피드 애셋입니다.

JSON 표현
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
필드
pageUrl

string

광고주가 타겟팅하려는 웹페이지입니다.

labels[]

string

페이지 URL을 그룹화하는 데 사용되는 라벨입니다.

MobileAppAsset

모바일 앱을 나타내는 확장 소재입니다.

JSON 표현
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
필드
appId

string

필수 항목입니다. 모바일 애플리케이션을 고유하게 식별하는 문자열입니다. Android의 경우 'com.android.ebay', iOS의 경우 '12345689'와 같이 플랫폼 네이티브 ID만 포함해야 합니다.

appStore

enum (MobileAppVendor)

필수 항목입니다. 이 특정 앱을 배포하는 애플리케이션 스토어입니다.

MobileAppVendor

모바일 앱 공급업체 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
APPLE_APP_STORE Apple App Store의 모바일 앱 공급업체입니다.
GOOGLE_APP_STORE Google 앱 스토어의 모바일 앱 공급업체입니다.

UnifiedCallAsset

통합된 전화번호 확장 소재입니다.

JSON 표현
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
필드
countryCode

string

전화번호의 두 자리 국가 코드입니다. 예: 'US', 'us'.

phoneNumber

string

광고주의 원시 전화번호입니다. 예: '1234567890', '(123)456-7890'

callConversionReportingState

enum (CallConversionReportingState)

이 CallAsset이 자체 통화 전환 설정을 사용해야 하는지, 계정 수준 설정을 따라야 하는지 또는 통화 전환을 사용 중지해야 하는지를 나타냅니다.

callConversionAction

string

통화 전환에 대한 기여도를 부여할 전환 액션입니다. 설정하지 않으면 기본 전환 액션이 사용됩니다. 이 필드는 callConversionReportingState가 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION으로 설정된 경우에만 적용됩니다.

adScheduleTargets[]

object (AdScheduleInfo)

저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개의 일정(총 42개)을 만들 수 있습니다.

callOnly

boolean

통화 시 웹사이트 링크 없이 전화번호만 표시할지 여부입니다. Microsoft Advertising에 적용됩니다.

callTrackingEnabled

boolean

통화 추적에서 통화를 사용 설정할지 여부입니다. Microsoft Ads에 적용됩니다.

useSearcherTimeZone

boolean

검색 사용자의 시간대에 통화 확장 프로그램을 표시할지 여부입니다. Microsoft Advertising에 적용됩니다.

startDate

string

이 확장 소재가 적용되고 게재를 시작할 수 있는 yyyy-MM-dd 형식의 시작일입니다.

endDate

string

이 확장 소재가 유효하고 게재 중인 마지막 날짜로 yyyy-MM-dd 형식입니다.

CallConversionReportingState

통화 전환 액션 상태의 가능한 데이터 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
DISABLED 통화 전환 액션이 사용 중지되었습니다.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION 통화 전환 액션은 계정 수준에서 설정된 통화 전환 유형을 사용합니다.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 통화 전환 액션은 리소스 (통화 전용 광고/전화번호 광고 확장) 수준에서 설정된 통화 전환 유형을 사용합니다.

CallToActionAsset

클릭 유도 문구 애셋

JSON 표현
{
  "callToAction": enum (CallToActionType)
}
필드
callToAction

enum (CallToActionType)

클릭 유도 문구

CallToActionType

가능한 클릭 유도 문구 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LEARN_MORE 클릭 유도 문구 유형은 '자세히 알아보기'입니다.
GET_QUOTE 클릭 유도 문구 유형은 견적 요청입니다.
APPLY_NOW 클릭 유도 문구 유형은 '지금 신청'입니다.
SIGN_UP 클릭 유도 문구 유형이 가입입니다.
CONTACT_US 클릭 유도 문구 유형은 '문의하기'입니다.
SUBSCRIBE 클릭 유도 문구 유형이 구독입니다.
DOWNLOAD 클릭 유도 문구 유형은 다운로드입니다.
BOOK_NOW 클릭 유도 문구 유형이 지금 예약입니다.
SHOP_NOW 클릭 유도 문구 유형은 '지금 쇼핑'입니다.
BUY_NOW 클릭 유도 문구 유형은 지금 구매입니다.
DONATE_NOW 클릭 유도 문구 유형은 '기부'입니다.
ORDER_NOW 클릭 유도 문구 유형이 지금 주문입니다.
PLAY_NOW 클릭 유도 문구 유형은 '지금 재생'입니다.
SEE_MORE 클릭 유도 문구 유형은 '더보기'입니다.
START_NOW 클릭 유도 문구 유형은 지금 시작입니다.
VISIT_SITE 클릭 유도 문구 유형은 사이트 방문입니다.
WATCH_NOW 클릭 유도 문구 유형은 지금 보기입니다.

UnifiedLocationAsset

통합 위치 확장 소재입니다.

JSON 표현
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
필드
placeId

string

장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 이 필드는 특정 고객 ID 및 애셋 유형에 고유합니다. 장소 ID에 대한 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요.

businessProfileLocations[]

object (BusinessProfileLocation)

고객의 비즈니스 위치 목록입니다. 위치 확장 소재가 비즈니스 프로필 계정에서 동기화되는 경우에만 반환됩니다. 동일한 계정 아래에 동일한 장소 ID를 가리키는 비즈니스 프로필 등록정보가 여러 개 있을 수 있습니다.

locationOwnershipType

enum (LocationOwnershipType)

위치 소유권 유형입니다. 유형이 BUSINESS_OWNER인 경우 위치 광고 확장으로 게재됩니다. 유형이 AFFILIATE인 경우 제휴사 위치로 게재됩니다.

BusinessProfileLocation

연결된 비즈니스 프로필 계정에서 동기화된 비즈니스 프로필 위치 데이터

JSON 표현
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
필드
labels[]

string

광고주가 비즈니스 프로필 계정의 위치에 지정한 라벨입니다. 비즈니스 프로필 계정에서 동기화됩니다.

storeCode

string

이 위치의 비즈니스 프로필 판매점 코드입니다. 비즈니스 프로필 계정에서 동기화됩니다.

listingId

string (int64 format)

이 비즈니스 프로필 위치의 등록정보 ID입니다. 연결된 비즈니스 프로필 계정에서 동기화됩니다.

LocationOwnershipType

가능한 위치 소유권 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BUSINESS_OWNER 위치의 비즈니스 소유자(기존 위치 광고 확장 - LE)입니다.
AFFILIATE 제휴사 위치(서드 파티 위치 광고 확장 - ALE)

AssetGroupAsset

AssetGroupAsset은 애셋과 애셋 그룹 간의 링크입니다. AssetGroupAsset을 추가하면 애셋이 애셋 그룹과 연결됩니다.

JSON 표현
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
필드
resourceName

string

애셋 그룹 애셋의 리소스 이름입니다. 애셋 그룹 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

이 애셋 그룹 확장 소재가 연결된 애셋 그룹입니다.

asset

string

애셋 그룹 애셋이 연결되는 애셋입니다.

fieldType

enum (AssetFieldType)

애셋 그룹 내 애셋의 게재위치에 관한 설명입니다. 예: HEADLINE, YOUTUBE_VIDEO 등

status

enum (AssetLinkStatus)

애셋과 애셋 그룹 간의 연결 상태입니다.

AssetFieldType

저작물의 가능한 게재위치를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
HEADLINE 광고 제목으로 사용하기 위해 애셋이 연결됩니다.
DESCRIPTION 애셋이 설명으로 사용되도록 연결됩니다.
MANDATORY_AD_TEXT 확장 소재가 필수 광고문안으로 사용되도록 연결되어 있습니다.
MARKETING_IMAGE 마케팅 이미지로 사용하기 위해 애셋이 연결됩니다.
MEDIA_BUNDLE 미디어 번들로 사용하기 위해 애셋이 연결되어 있습니다.
YOUTUBE_VIDEO 저작물이 YouTube 동영상으로 사용할 수 있도록 연결되어 있습니다.
BOOK_ON_GOOGLE 호텔 캠페인에 'Google에서 예약'이 사용 설정되어 있음을 나타내기 위해 애셋이 연결됩니다.
LEAD_FORM 리드 양식 광고 확장으로 사용하기 위해 확장 소재가 연결됩니다.
PROMOTION 확장 소재가 프로모션 광고 확장으로 사용하기 위해 연결되어 있습니다.
CALLOUT 콜아웃 광고 확장으로 사용하기 위해 애셋이 연결됩니다.
STRUCTURED_SNIPPET 확장 소재가 구조화된 스니펫 광고 확장으로 사용되도록 연결됩니다.
MOBILE_APP 모바일 앱 광고 확장으로 사용할 수 있도록 확장 소재가 연결되어 있습니다.
HOTEL_CALLOUT 호텔 콜아웃 광고 확장으로 사용하기 위해 확장 소재가 연결됩니다.
CALL 전화번호 광고 확장 소재로 사용하기 위해 저작물이 연결됩니다.
PRICE 확장 소재가 가격 광고 확장으로 사용되도록 연결됩니다.
LONG_HEADLINE 확장 소재가 긴 광고 제목으로 사용되도록 연결됩니다.
BUSINESS_NAME 비즈니스 이름으로 사용하기 위해 저작물이 연결됩니다.
SQUARE_MARKETING_IMAGE 정사각형 마케팅 이미지로 사용하기 위해 확장 소재가 연결되어 있습니다.
PORTRAIT_MARKETING_IMAGE 세로 방향 마케팅 이미지로 사용하기 위해 확장 소재가 연결됩니다.
VIDEO 저작물이 YouTube 이외의 로고로 사용하기 위해 연결되어 있습니다.
CALL_TO_ACTION_SELECTION 클릭 유도 문구를 선택하는 데 사용할 수 있도록 확장 소재가 연결되어 있습니다.
AD_IMAGE 광고 이미지를 선택하는 데 사용할 수 있도록 애셋이 연결됩니다.
HOTEL_PROPERTY 애셋이 여행 목표 달성을 위한 실적 최대화 캠페인에서 호텔 숙박 시설로 사용되도록 연결됩니다.

AssetGroupSignal

AssetGroupSignal은 애셋 그룹의 신호를 나타냅니다. 신호가 있으면 실적 최대화 캠페인에 전환 가능성이 높은 사용자가 누구인지 알려줍니다. 실적 최대화 캠페인에서는 검색, 디스플레이, 동영상 전체에서 전환 기회를 찾기 위해 신호를 사용하여 비슷한 수준 혹은 더 강한 의도를 가진 신규 사용자를 파악합니다.

JSON 표현
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
필드
resourceName

string

애셋 그룹 신호의 리소스 이름입니다. 애셋 그룹 신호 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

이 애셋 그룹 신호가 속한 애셋 그룹입니다.

통합 필드 signal. 애셋 그룹의 신호입니다. signal은 다음 중 하나여야 합니다.
audience

object (AudienceInfo)

실적 최대화 캠페인에서 사용할 잠재고객 신호입니다.

AudienceInfo

잠재고객 기준

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

string

잠재고객 리소스 이름입니다.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter는 애셋 그룹의 등록정보 그룹 필터 트리 노드를 나타냅니다.

JSON 표현
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
필드
resourceName

string

애셋 그룹 등록정보 그룹 필터의 리소스 이름입니다. 애셋 그룹 등록정보 그룹 필터 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

이 애셋 그룹 등록정보 그룹 필터가 속한 애셋 그룹입니다.

id

string (int64 format)

ListingGroupFilter의 ID입니다.

type

enum (ListingGroupFilterType)

등록정보 그룹 필터 노드의 유형입니다.

vertical

enum (ListingGroupFilterVertical)

현재 노드 트리가 나타내는 카테고리입니다. 동일한 트리의 모든 노드는 동일한 카테고리에 속해야 합니다.

caseValue

object (ListingGroupFilterDimension)

이 등록정보 그룹에서 상위 요소를 세분화하는 측정기준 값입니다. 루트 그룹에는 정의되지 않습니다.

parentListingGroupFilter

string

상위 등록정보 그룹 하위 그룹의 리소스 이름입니다. 루트 등록정보 그룹 필터 노드의 경우 null입니다.

path

object (ListingGroupFilterDimensionPath)

이 등록정보 그룹 필터를 정의하는 측정기준의 경로입니다.

ListingGroupFilterType

등록정보 그룹 필터의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SUBDIVISION 일부 등록정보 측정기준에 따라 제품을 세분화합니다.
UNIT_INCLUDED 포함된 등록정보 그룹 필터 리프 노드입니다.
UNIT_EXCLUDED 제외된 등록정보 그룹 필터 리프 노드입니다.

ListingGroupFilterVertical

등록정보 그룹 필터 카테고리의 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SHOPPING 쇼핑 카테고리를 나타냅니다. 이 카테고리는 소매업체용 실적 최대화 캠페인에서만 사용할 수 있습니다.

ListingGroupFilterDimension

애셋 그룹 등록정보 그룹 필터의 등록정보 측정기준입니다.

JSON 표현
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
필드
통합 필드 dimension. 아래 유형 중 하나의 측정기준은 항상 표시됩니다. dimension은 다음 중 하나여야 합니다.
productBiddingCategory

object (ProductBiddingCategory)

제품 입찰의 입찰 카테고리입니다.

productBrand

object (ProductBrand)

제품 혜택의 브랜드입니다.

productChannel

object (ProductChannel)

제품 혜택의 지역입니다.

productCondition

object (ProductCondition)

제품 혜택의 상태입니다.

productCustomAttribute

object (ProductCustomAttribute)

제품 혜택의 맞춤 속성입니다.

productItemId

object (ProductItemId)

제품의 상품 ID입니다.

productType

object (ProductType)

제품 제공 유형입니다.

ProductBiddingCategory

특정 수준의 입찰 카테고리의 요소입니다. 최상위 카테고리는 1단계, 하위 카테고리는 2단계로 표시됩니다. 현재 최대 5단계까지 지원됩니다. 사용자는 카테고리 수준을 나타내는 측정기준 유형을 지정해야 합니다. 동일한 하위 그룹의 모든 케이스는 측정기준 유형(카테고리 수준)이 동일해야 합니다.

JSON 표현
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
필드
level

enum (ListingGroupFilterBiddingCategoryLevel)

분류의 카테고리 수준을 나타냅니다.

id

string (int64 format)

제품 입찰 카테고리의 ID입니다.

이 ID는 이 도움말(https://support.google.com/merchants/answer/6324436)에 설명된 google_product_category ID와 같습니다.

ListingGroupFilterBiddingCategoryLevel

등록정보 그룹 필터 입찰 카테고리의 수준입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LEVEL1 1단계
LEVEL2 수준 2
LEVEL3 수준 3.
LEVEL4 4단계
LEVEL5 5단계

ProductBrand

제품의 브랜드입니다.

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

string

제품 브랜드의 문자열 값입니다.

ProductChannel

제품 혜택의 지역입니다.

JSON 표현
{
  "channel": enum (ListingGroupFilterProductChannel)
}
필드
channel

enum (ListingGroupFilterProductChannel)

지역 값입니다.

ListingGroupFilterProductChannel

제품 혜택의 지역을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ONLINE 상품이 온라인으로 판매됩니다.
LOCAL 상품이 오프라인 매장에서 판매됩니다.

ProductCondition

제품의 상태입니다.

JSON 표현
{
  "condition": enum (ListingGroupFilterProductCondition)
}
필드
condition

enum (ListingGroupFilterProductCondition)

조건의 값입니다.

ListingGroupFilterProductCondition

제품 혜택의 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NEW 제품 상태가 새 제품입니다.
REFURBISHED 제품 상태가 리퍼입니다.
USED 제품 상태가 '중고'입니다.

ProductCustomAttribute

제품 혜택의 맞춤 속성입니다.

JSON 표현
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
필드
index

enum (ListingGroupFilterCustomAttributeIndex)

맞춤 속성의 색인을 나타냅니다.

value

string

제품 맞춤 속성의 문자열 값입니다.

ListingGroupFilterCustomAttributeIndex

고객 속성의 색인입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
INDEX0 첫 번째 등록정보 그룹 필터 맞춤 속성입니다.
INDEX1 두 번째 등록정보 그룹 필터 맞춤 속성
INDEX2 세 번째 등록정보 그룹 필터 맞춤 속성입니다.
INDEX3 네 번째 등록정보 그룹 필터 맞춤 속성입니다.
INDEX4 다섯 번째 등록정보 그룹 필터 맞춤 속성

ProductItemId

제품 혜택의 상품 ID입니다.

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

string

ID 값입니다.

ProductType

제품 혜택 유형입니다.

JSON 표현
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
필드
level

enum (ListingGroupFilterProductTypeLevel)

유형의 수준입니다.

value

string

유형의 값입니다.

ListingGroupFilterProductTypeLevel

제품 오퍼 유형의 수준을 설명하는 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LEVEL1 1단계
LEVEL2 수준 2
LEVEL3 수준 3.
LEVEL4 4단계
LEVEL5 5단계

ListingGroupFilterDimensionPath

등록정보 그룹 필터를 정의하는 측정기준을 정의하는 경로입니다.

JSON 표현
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
필드
dimensions[]

object (ListingGroupFilterDimension)

등록정보 그룹 필터 계층 구조(루트 노드 제외)를 통과하여 이 등록정보 그룹 필터로 이어지는 측정기준의 전체 경로입니다.

AssetGroupTopCombinationView

광고 그룹 광고 애셋 조합의 사용에 대한 보기입니다.

JSON 표현
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
필드
resourceName

string

애셋 그룹 상단 조합 뷰의 리소스 이름입니다. AssetGroup Top Combination 뷰 리소스 이름의 형식은 `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"입니다.

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

함께 게재된 확장 소재의 주요 조합입니다.

AssetGroupAssetCombinationData

애셋 그룹 애셋 조합 데이터

JSON 표현
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
필드
assetCombinationServedAssets[]

object (AssetUsage)

게재된 애셋

AssetUsage

애셋의 사용 정보를 포함합니다.

JSON 표현
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
필드
asset

string

저작물의 리소스 이름입니다.

servedAssetFieldType

enum (ServedAssetFieldType)

애셋의 게재된 필드 유형입니다.

ServedAssetFieldType

가능한 애셋 필드 유형입니다.

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

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

응답 전용 값입니다.

HEADLINE_1 확장 소재가 광고 제목 1에 사용됩니다.
HEADLINE_2 확장 소재가 광고 제목 2에 사용됩니다.
HEADLINE_3 확장 소재가 광고 제목 3에 사용됩니다.
DESCRIPTION_1 저작물이 설명 1에 사용됩니다.
DESCRIPTION_2 저작물이 설명 2에 사용됩니다.
HEADLINE 확장 소재가 광고 제목에 사용되었습니다. 광고에 광고 제목이 하나만 있는 경우에만 사용하세요. 그 외의 경우 HEADLINE_1, HEADLINE_2 또는 HEADLINE_3 enum을 사용합니다.
HEADLINE_IN_PORTRAIT 세로 모드 이미지에서 광고 제목으로 사용된 확장 소재입니다.
LONG_HEADLINE 확장 광고 제목 (MultiAssetResponsiveAd에 사용됨)에 저작물이 사용되었습니다.
DESCRIPTION 저작물이 설명에 사용되었습니다. 광고에 설명이 하나만 있는 경우에만 사용합니다. 그 외의 경우 DESCRIPTION_1 또는 DESCRIPTION_@ enum을 사용합니다.
DESCRIPTION_IN_PORTRAIT 세로 이미지에서 설명으로 사용된 저작물입니다.
BUSINESS_NAME_IN_PORTRAIT 확장 소재가 세로 모드 이미지에서 업체 이름으로 사용되었습니다.
BUSINESS_NAME 저작물이 비즈니스 이름으로 사용되었습니다.
MARKETING_IMAGE 저작물이 마케팅 이미지로 사용되었습니다.
MARKETING_IMAGE_IN_PORTRAIT 확장 소재가 세로 모드 이미지에서 마케팅 이미지로 사용되었습니다.
SQUARE_MARKETING_IMAGE 확장 소재가 정사각형 마케팅 이미지로 사용되었습니다.
PORTRAIT_MARKETING_IMAGE 이 저작물은 세로 방향 마케팅 이미지로 사용되었습니다.
CALL_TO_ACTION 저작물이 클릭 유도 문구로 사용되었습니다.
YOU_TUBE_VIDEO 저작물이 YouTube 동영상으로 사용되었습니다.
CALL 이 확장 소재는 호출로 사용됩니다.
MOBILE_APP 이 확장 소재는 모바일 앱으로 사용됩니다.
CALLOUT 이 확장 소재는 콜아웃으로 사용됩니다.
STRUCTURED_SNIPPET 이 확장 소재는 구조화된 스니펫으로 사용됩니다.
PRICE 이 확장 소재는 가격으로 사용됩니다.
PROMOTION 이 확장 소재는 프로모션으로 사용됩니다.
AD_IMAGE 이 확장 소재는 이미지로 사용됩니다.
LEAD_FORM 확장 소재가 리드 양식으로 사용됩니다.

AssetGroup

애셋 그룹입니다. AssetGroupAsset은 애셋을 애셋 그룹에 연결하는 데 사용됩니다. AssetGroupSignal은 신호를 애셋 그룹에 연결하는 데 사용됩니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
필드
resourceName

string

애셋 그룹의 리소스 이름입니다. 애셋 그룹 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

애셋 그룹의 ID입니다.

campaign

string

이 애셋 그룹이 연결된 캠페인입니다. 애셋 그룹에 연결된 애셋입니다.

name

string

필수 항목입니다. 애셋 그룹의 이름입니다. 필수 항목입니다. 길이는 1~128자(영문 기준)여야 합니다. 캠페인 내에서 고유해야 합니다.

finalUrls[]

string

모든 교차 도메인 리디렉션 이후의 최종 URL 목록입니다. 실적 최대화 캠페인에서는 기본적으로 선택 해제하지 않는 한 URL을 확장할 수 있습니다.

finalMobileUrls[]

string

모든 교차 도메인 리디렉션 후 최종 모바일 URL의 목록입니다. 실적 최대화 캠페인에서는 기본적으로 URL을 선택 해제하지 않는 한 확장할 수 있습니다.

status

enum (AssetGroupStatus)

애셋 그룹의 상태입니다.

path1

string

광고에 표시되는 URL에 추가될 수 있는 텍스트의 첫 부분입니다.

path2

string

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

adStrength

enum (AdStrength)

이 애셋 그룹의 전반적인 광고 효력입니다.

AssetGroupStatus

애셋 그룹의 가능한 상태입니다.

열거형
UNSPECIFIED 상태가 지정되지 않았습니다.
UNKNOWN 이 버전에서는 수신된 값을 알 수 없습니다.
ENABLED 애셋 그룹이 사용 설정됩니다.
PAUSED 애셋 그룹이 일시중지되었습니다.
REMOVED 애셋 그룹이 삭제됩니다.

AdStrength

가능한 광고 효력을 나열하는 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
PENDING 광고 효력은 현재 대기 중입니다.
NO_ADS 광고를 생성할 수 없습니다.
POOR 강도가 약합니다.
AVERAGE 평균 강도입니다.
GOOD 좋은 힘입니다.
EXCELLENT 우수한 강도

AssetSetAsset

AssetSetAsset은 저작물과 저작물 세트 간의 연결입니다. AssetSetAsset을 추가하면 저작물이 저작물 세트와 연결됩니다.

JSON 표현
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
필드
resourceName

string

애셋 세트 저작물의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

이 애셋 집합이 연결된 애셋 집합입니다.

asset

string

이 애셋 집합이 연결된 애셋입니다.

status

enum (AssetSetAssetStatus)

저작물 세트 저작물의 상태입니다. 읽기 전용입니다.

AssetSetAssetStatus

애셋 세트 애셋의 가능한 상태입니다.

열거형
UNSPECIFIED 상태가 지정되지 않았습니다.
UNKNOWN 이 버전에서는 수신된 값을 알 수 없습니다. 응답 전용 값입니다.
ENABLED 애셋 집합 확장 소재가 사용 설정되어 있습니다.
REMOVED 애셋 집합 애셋이 삭제됩니다.

AssetSet

애셋 모음을 나타내는 애셋 세트입니다. AssetSetAsset을 사용하여 애셋을 애셋 집합에 연결합니다.

JSON 표현
{
  "id": string,
  "resourceName": string
}
필드
id

string (int64 format)

저작물 집합의 ID입니다.

resourceName

string

애셋 세트의 리소스 이름입니다. 애셋 세트 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

입찰 전략

JSON 표현
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
필드
resourceName

string

입찰 전략의 리소스 이름입니다. 입찰 전략 리소스 이름은 다음과 같은 형식입니다.

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

입찰 전략의 상태입니다.

이 필드는 읽기 전용입니다.

type

enum (BiddingStrategyType)

입찰 전략의 유형입니다. 입찰 스킴을 설정하여 입찰 전략을 만듭니다.

이 필드는 읽기 전용입니다.

currencyCode

string

입찰 전략에 사용되는 통화입니다 (ISO 4217 3자리 코드).

관리자 고객의 입찰 전략의 경우 이 통화는 생성 시 설정할 수 있으며 기본적으로 관리자 고객의 통화로 설정됩니다. 제공 고객의 경우 이 필드를 설정할 수 없습니다. 제공 중인 고객의 모든 전략은 암시적으로 제공 고객의 통화를 사용합니다. 모든 경우에 effectiveCurrencyCode 필드는 전략에서 사용한 통화를 반환합니다.

id

string (int64 format)

입찰 전략의 ID입니다.

name

string

입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다.

이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다.

effectiveCurrencyCode

string

입찰 전략에서 사용하는 통화(ISO 4217 3자리 코드)입니다.

관리자 고객의 입찰 전략의 경우 광고주가 전략을 만들 때 설정한 통화입니다. 고객에게 제품 또는 서비스를 제공하는 경우 고객의 numberCode입니다.

입찰 전략 측정항목은 이 통화로 보고됩니다.

이 필드는 읽기 전용입니다.

campaignCount

string (int64 format)

이 입찰 전략에 연결된 캠페인의 수입니다.

이 필드는 읽기 전용입니다.

nonRemovedCampaignCount

string (int64 format)

이 입찰 전략에 연결된 삭제되지 않은 캠페인 수입니다.

이 필드는 읽기 전용입니다.

통합 필드 scheme. 입찰 스키마입니다.

하나만 설정할 수 있습니다. scheme는 다음 중 하나여야 합니다.

enhancedCpc

object (EnhancedCpc)

전환으로 이어질 가능성이 큰 클릭의 입찰가를 높이고 전환으로 이어질 가능성이 작은 클릭의 입찰가를 낮추는 입찰 전략입니다.

maximizeConversionValue

object (MaximizeConversionValue)

예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다.

maximizeConversions

object (MaximizeConversions)

캠페인에서 예산이 지출될 때 최대한 많은 전환이 발생하도록 설정하는 자동 입찰 전략입니다.

targetCpa

object (TargetCpa)

타겟 CPA는 설정된 타겟 전환당비용(CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

targetImpressionShare

object (TargetImpressionShare)

선택한 비율에 맞춰 자동으로 최적화하는 입찰 전략입니다.

targetOutrankShare

object (TargetOutrankShare)

광고주가 특정 경쟁업체보다 높은 순위를 얻어야 하는 입찰 타겟 비율에 따라 입찰가를 설정하는 입찰 전략입니다. 이 필드는 지원 중단되었습니다. 이 필드로 새 입찰 전략을 만들거나 이 필드가 있는 입찰 전략을 캠페인에 연결하면 실패합니다. 이 스키마가 이미 채워진 전략을 변경할 수 있습니다.

targetRoas

object (TargetRoas)

특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 입찰 전략입니다.

targetSpend

object (TargetSpend)

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

BiddingStrategyStatus

BiddingStrategy의 가능한 상태입니다.

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

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

응답 전용 값입니다.

ENABLED 입찰 전략이 사용 설정되어 있습니다.
REMOVED 입찰 전략이 삭제됩니다.

BiddingStrategyType

가능한 입찰 전략 유형을 설명하는 enum입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
COMMISSION 수수료는 광고주가 전환 가치의 일정 부분을 지불하는 자동 입찰 전략입니다.
ENHANCED_CPC 향상된 CPC 입찰기능은 전환으로 이어질 가능성이 높은 클릭에 대해서는 입찰가를 높이고 전환으로 이어질 가능성이 낮은 클릭에 대해서는 입찰가를 낮추는 입찰 전략입니다.
INVALID 반환 값에만 사용됩니다. 캠페인에 입찰 전략이 없음을 나타냅니다. 이로 인해 캠페인에서 광고가 게재되지 않습니다. 예를 들어 캠페인이 관리자 입찰 전략에 연결되어 있고 이후 게재 중인 계정이 관리자 계정에서 연결 해제될 수 있습니다. 이 경우 캠페인은 현재 액세스할 수 없는 관리자 입찰 전략에서 자동으로 분리되고 잘못된 입찰 전략 유형으로 전환됩니다.
MANUAL_CPA 광고주가 지정한 작업별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다.
MANUAL_CPC 사용자가 클릭당 비용을 지불하는 수동 클릭 기반 입찰입니다.
MANUAL_CPM 사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.
MANUAL_CPV 설정 가능한 동영상 조회수당 금액을 지불하는 입찰 전략입니다.
MAXIMIZE_CONVERSIONS 일일 예산을 기준으로 전환수를 자동으로 최대화하는 입찰 전략입니다.
MAXIMIZE_CONVERSION_VALUE 예산을 지출하면서 수익을 극대화하도록 입찰가를 자동으로 설정하는 자동 입찰 전략입니다.
PAGE_ONE_PROMOTED 페이지 1에 표시되거나 google.com의 페이지 1에 표시되는 프로모션 슬롯의 노출을 타겟팅하도록 최대 CPC 입찰가를 설정하는 페이지 1 프로모션 입찰 스킴입니다. 이 enum 값은 지원 중단되었습니다.
PERCENT_CPC Percent CPC는 입찰가가 특정 상품 또는 서비스의 광고된 가격의 일부인 입찰 전략입니다.
TARGET_CPA 타겟 CPA는 설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.
TARGET_CPM 타겟 CPM은 설정된 타겟 1,000회 노출당비용 (CPM)으로 최대한 많은 노출이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.
TARGET_IMPRESSION_SHARE 첫 페이지 (또는 다른 타겟 위치)의 상단에 특정 비율의 검색 광고가 게재되도록 입찰가를 설정하는 자동 입찰 전략입니다.
TARGET_OUTRANK_SHARE 경쟁 광고보다 높은 순위를 얻은 노출 비율 타겟은 광고주가 특정 경쟁업체보다 높은 순위를 얻어야 하는 입찰의 타겟 비율을 기준으로 입찰가를 설정하는 자동 입찰 전략입니다. 이 열거형 값은 지원 중단되었습니다.
TARGET_ROAS 타겟 ROAS는 특정 타겟 평균 광고 투자수익 (ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 자동 입찰 전략입니다.
TARGET_SPEND 목표 지출액은 예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.

EnhancedCpc

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

전환 가능성이 큰 클릭의 입찰가를 높이고 전환 가능성이 작은 클릭의 입찰가를 낮추는 자동 입찰 전략입니다.

이 입찰 전략은 지원 중단되었으며 더 이상 만들 수 없습니다. 동등한 기능을 사용하려면 enhancedCpcEnabled가 true로 설정된 ManualCpc를 사용하세요.

MaximizeConversionValue

예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다.

JSON 표현
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
필드
cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다.

cpcBidFloorMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다.

targetRoas

number

타겟 광고 투자수익(ROAS) 옵션 타겟 광고 투자수익(ROAS)을 설정하면 입찰 전략에서 수익을 극대화하면서 타겟 광고 투자수익(ROAS)을 평균화합니다. 타겟 ROAS가 높으면 입찰 전략에서 전체 예산을 지출하지 못할 수 있습니다. 타겟 ROAS를 설정하지 않으면 입찰 전략은 예산에 대해 최대한 높은 ROAS를 달성하는 것을 목표로 합니다.

MaximizeConversions

캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되는 자동 입찰 전략입니다.

JSON 표현
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
필드
cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다.

cpcBidFloorMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다.

targetCpaMicros

string (int64 format)

타겟 전환당비용(CPA) 옵션 입찰 전략의 통화 단위로 지정된 전환 액션당 지출하고자 하는 평균 금액입니다. 타겟 CPA를 설정하면 입찰 전략에서 타겟 전환당비용 이하로 최대한 많은 전환을 얻습니다. 타겟 CPA를 설정하지 않으면 입찰 전략은 예산을 고려하여 가능한 한 낮은 CPA를 달성하는 것을 목표로 합니다.

TargetCpa

설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
필드
targetCpaMicros

string (int64 format)

평균 CPA 타겟입니다. 이 타겟은 계정의 통화를 기준으로 최소 청구 가능 단위보다 크거나 같아야 합니다.

cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다.

cpcBidFloorMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다.

TargetImpressionShare

첫 페이지 (또는 다른 타겟 위치)의 상단에 특정 비율의 검색 광고가 게재되도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
필드
location

enum (TargetImpressionShareLocation)

검색결과 페이지의 타겟 위치입니다.

locationFractionMicros

string (int64 format)

타겟팅된 위치에 표시할 광고의 선택된 비율(마이크로)입니다. 예를 들어 1%는 10,000입니다.

cpcBidCeilingMicros

string (int64 format)

자동 입찰 시스템으로 지정할 수 있는 가장 높은 CPC 입찰가입니다. 광고주가 입력하는 필수 필드이고 상한을 설정하며 로컬 마이크로 단위로 지정됩니다.

TargetImpressionShareLocation

가능한 목표를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ANYWHERE_ON_PAGE 웹페이지의 모든 위치
TOP_OF_PAGE 상단 광고 상자
ABSOLUTE_TOP_OF_PAGE 상단 광고 상자의 상단 슬롯

TargetOutrankShare

광고주가 특정 경쟁업체보다 순위가 높아야 하는 입찰의 타겟 비율을 기준으로 입찰가를 설정하는 자동 입찰 전략입니다. 이 전략은 지원 중단되었습니다.

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

string (Int64Value format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다.

TargetRoas

특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 자동 입찰 전략입니다.

JSON 표현
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
필드
targetRoas

number

필수 항목입니다. 지출 단위당 선택한 수익(전환 데이터 기준)입니다. 값은 0.01~1000.0 사이여야 합니다(0.01 및 1000.0 포함).

cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다.

cpcBidFloorMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다.

TargetSpend

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
필드
targetSpendMicros
(deprecated)

string (int64 format)

지원 중단됨: 클릭수를 최대화하기 위한 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. 자세한 내용은 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html을 참고하세요.

cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다.

CampaignBudget

캠페인 예산입니다.

JSON 표현
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
필드
resourceName

string

캠페인 예산의 리소스 이름입니다. 캠페인 예산 리소스 이름은 다음과 같은 형식입니다.

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

캠페인 예산의 소비율을 결정하는 게재 방법입니다.

만들기 작업에서 지정되지 않은 경우 기본적으로 STANDARD입니다.

period

enum (BudgetPeriod)

예산을 지출할 기간입니다. 지정하지 않으면 기본적으로 DAILY입니다.

amountMicros

string (int64 format)

예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 월별 지출은 이 금액의 30.4배로 제한됩니다.

BudgetDeliveryMethod

가능한 예산 지출 방법입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
STANDARD 예산 서버는 전체 기간에 걸쳐 게재를 균등하게 제한합니다.
ACCELERATED 예산 서버가 게재를 제한하지 않으며 광고가 최대한 빠르게 게재됩니다.

BudgetPeriod

가능한 예산 기간입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
DAILY 일일예산:
FIXED_DAILY 고정 일일 예산
CUSTOM_PERIOD 맞춤 예산을 total_amount와 함께 사용하여 전체 예산 한도를 지정할 수 있습니다.

캠페인

캠페인

JSON 표현
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
필드
resourceName

string

캠페인의 리소스 이름입니다. 캠페인 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

캠페인의 상태입니다.

새 캠페인을 추가하면 상태가 기본적으로 ENABLED로 설정됩니다.

servingStatus

enum (CampaignServingStatus)

캠페인의 광고 게재 상태입니다.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

캠페인 입찰 전략의 시스템 상태입니다.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

캠페인의 광고 게재 최적화 상태입니다.

advertisingChannelType

enum (AdvertisingChannelType)

캠페인 내 광고의 기본 게재 타겟입니다. 타겟팅 옵션은 networkSettings에서 미세 조정할 수 있습니다.

이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다.

캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

advertisingChannelType에 대한 선택적 미세 조정입니다. 상위 채널 유형의 유효한 하위 유형이어야 합니다.

캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다.

urlCustomParameters[]

object (CustomParameter)

trackingUrlTemplate, finalUrls 또는 mobile_final_urls에서 맞춤 매개변수 태그를 대체하는 데 사용되는 매핑 목록입니다.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

실시간 입찰 설정으로, Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있습니다.

networkSettings

object (NetworkSettings)

캠페인의 네트워크 설정입니다.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

동적 검색 광고(DSA)를 제어하기 위한 설정입니다.

shoppingSetting

object (ShoppingSetting)

쇼핑 캠페인을 관리하기 위한 설정입니다.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

광고 지역 타겟팅 설정입니다.

effectiveLabels[]

string

이 캠페인에 연결된 유효 라벨의 리소스 이름입니다. 유효 라벨은 이 캠페인에 상속되거나 직접 할당된 라벨입니다.

labels[]

string

이 캠페인에 연결된 라벨의 리소스 이름입니다.

biddingStrategyType

enum (BiddingStrategyType)

입찰 전략의 유형입니다.

입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 biddingStrategy 필드를 설정해서 포트폴리오 입찰 전략을 만드는 방식으로 입찰 전략을 만들 수 있습니다.

이 필드는 읽기 전용입니다.

accessibleBiddingStrategy

string

'biddingStrategy'로 식별된 연결된 포트폴리오 입찰 전략의 제한되지 않은 속성의 읽기 전용 뷰인 AccessibleBiddingStrategy의 리소스 이름입니다. 캠페인에서 포트폴리오 전략을 사용하지 않는 경우 비워 둡니다. 제한되지 않은 전략 속성은 전략이 공유된 모든 고객이 사용할 수 있으며 AccessibleBiddingStrategy 리소스에서 읽을 수 있습니다. 반면 제한된 속성은 전략의 소유자 고객 및 해당 고객의 관리자만 사용할 수 있습니다. 제한된 속성은 입찰전략 리소스에서만 읽을 수 있습니다.

frequencyCaps[]

object (FrequencyCapEntry)

각 사용자에게 이 캠페인의 광고가 게재되는 빈도를 제한하는 목록입니다.

selectiveOptimization

object (SelectiveOptimization)

이 캠페인의 선택적 최적화 설정으로, 캠페인 최적화의 기준이 되는 전환 액션 집합이 포함됩니다. 이 기능은 MULTI_CHANNEL을 AdvertisingChannelType으로, APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT을 AdvertisingChannelSubType로 사용하는 앱 캠페인에만 적용됩니다.

optimizationGoalSetting

object (OptimizationGoalSetting)

이 캠페인의 최적화 목표 설정으로, 최적화 목표 유형 집합이 포함됩니다.

trackingSetting

object (TrackingSetting)

추적 정보에 대한 캠페인 수준 설정

engineId

string

외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "campaign.id"를 사용하세요.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

이 캠페인에서 제외해야 하는 확장 소재 필드 유형입니다. 이러한 필드 유형의 애셋 링크는 이 캠페인이 상위 수준에서 상속되지 않습니다.

createTime

string

이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss' 형식입니다. v1에서는 createTime이 지원 중단됩니다. 대신 creationTime을 사용하세요.

creationTime

string

이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

lastModifiedTime

string

이 캠페인이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

id

string (int64 format)

캠페인의 ID입니다.

name

string

캠페인의 이름입니다.

이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다.

null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다.

trackingUrlTemplate

string

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

campaignBudget

string

캠페인 예산의 리소스 이름입니다.

startDate

string

YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인이 시작된 날입니다.

endDate

string

YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인 마지막 날입니다. 생성 시 기본값은 2037-12-30입니다. 즉, 캠페인이 무기한 실행됩니다. 기존 캠페인이 무한정 운영되도록 설정하려면 이 필드를 2037-12-30으로 설정하세요.

finalUrlSuffix

string

병렬 추적으로 게재되는 방문 페이지에 쿼리 매개변수를 추가하는 데 사용되는 접미사입니다.

urlExpansionOptOut

boolean

더 많은 타겟팅 URL로의 URL 확장을 선택 해제했음을 나타냅니다. 선택 해제된 경우(true) 애셋 그룹의 최종 URL 또는 광고주의 Google 판매자 센터 또는 비즈니스 데이터 피드에 지정된 URL만 타겟팅됩니다. 선택한 경우(false) 전체 도메인이 타겟팅됩니다. 이 필드는 실적 최대화 캠페인에 대해서만 설정할 수 있으며 기본값은 false입니다.

통합 필드 campaign_bidding_strategy. 캠페인의 입찰 전략입니다.

(BidStrategy 서비스를 통해 생성된 포트폴리오) 또는 캠페인에 삽입된 표준이어야 합니다. campaign_bidding_strategy는 다음 중 하나여야 합니다.

biddingStrategy

string

캠페인에서 사용하는 포트폴리오 입찰 전략의 리소스 이름입니다.

manualCpa

object (ManualCpa)

표준 수동 CPA 입찰 전략 광고주가 광고주 지정 액션별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다. 지역 서비스 캠페인에만 지원됩니다.

manualCpc

object (ManualCpc)

표준 수동 CPC 입찰 전략 사용자가 클릭당 비용을 지불하는 수동 클릭 기반 입찰입니다.

manualCpm

object (ManualCpm)

표준 수동 CPM 입찰 전략 사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.

maximizeConversions

object (MaximizeConversions)

예산을 지출하면서 전환수를 자동으로 최대화하는 표준 전환수 최대화 입찰 전략입니다.

maximizeConversionValue

object (MaximizeConversionValue)

예산을 지출하면서 수익을 극대화하도록 입찰가를 자동으로 설정하는 표준 전환 가치 극대화 입찰 전략입니다.

targetCpa

object (TargetCpa)

설정된 타겟 CPA로 전환수를 최대한 늘릴 수 있도록 입찰가를 자동으로 설정하는 표준 타겟 CPA 입찰 전략입니다.

targetImpressionShare

object (TargetImpressionShare)

타겟 노출 점유율 입찰 전략 선택한 노출 비율을 달성하도록 입찰가를 설정하는 자동 입찰 전략입니다.

targetRoas

object (TargetRoas)

특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 자동으로 극대화하는 표준 타겟 ROAS 입찰 전략입니다.

targetSpend

object (TargetSpend)

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 자동으로 설정하는 표준 타겟 지출 입찰 전략입니다.

percentCpc

object (PercentCpc)

입찰가가 특정 상품 또는 서비스의 광고된 가격의 일부인 표준 비율 CPC 입찰 전략입니다.

targetCpm

object (TargetCpm)

1,000회 노출당비용을 자동으로 최적화하는 입찰 전략입니다.

CampaignStatus

캠페인의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 캠페인이 운영 중이며 광고를 게재할 수 있습니다.
PAUSED 사용자가 캠페인을 일시중지했습니다.
REMOVED 캠페인이 삭제되었습니다.

CampaignServingStatus

캠페인의 가능한 게재 상태입니다.

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

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

응답 전용 값입니다.

SERVING 제공
NONE 없음
ENDED 종료되었습니다.
PENDING 대기 중입니다.
SUSPENDED 정지됨.

BiddingStrategySystemStatus

입찰전략의 가능한 시스템 상태입니다.

열거형
UNSPECIFIED 예기치 않은 오류가 발생했음을 나타냅니다(예: 입찰 전략 유형을 찾을 수 없거나 상태 정보를 찾을 수 없음).
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 입찰 전략이 활성 상태이며 애드워즈에서 해당 전략에 대해 아무런 문제도 찾지 못했습니다.
LEARNING_NEW 입찰 전략이 최근에 만들어졌거나 최근에 다시 활성화되었기 때문에 학습 중입니다.
LEARNING_SETTING_CHANGE 최근 설정 변경으로 인해 입찰 전략이 학습 중입니다.
LEARNING_BUDGET_CHANGE 최근 예산 변경으로 인해 입찰 전략이 학습 중입니다.
LEARNING_COMPOSITION_CHANGE 최근에 연결된 캠페인, 광고그룹 또는 키워드의 수가 변경되어 입찰 전략이 학습 중입니다.
LEARNING_CONVERSION_TYPE_CHANGE 입찰 전략은 전환 보고와 고객이 최근에 입찰 전략과 관련하여 수정한 전환 유형에 따라 달라집니다.
LEARNING_CONVERSION_SETTING_CHANGE 입찰 전략이 전환 보고에 따라 달라지며 고객이 최근에 전환 설정을 변경했습니다.
LIMITED_BY_CPC_BID_CEILING 입찰 전략은 입찰가 상한으로 제한됩니다.
LIMITED_BY_CPC_BID_FLOOR 입찰가 하한선으로 인해 입찰 전략이 제한됩니다.
LIMITED_BY_DATA 지난 몇 주 동안 전환 트래픽이 충분하지 않아 입찰 전략이 제한되었습니다.
LIMITED_BY_BUDGET 이 입찰 전략의 상당수 키워드가 예산 제약을 받고 있습니다.
LIMITED_BY_LOW_PRIORITY_SPEND 지출의 우선순위가 낮아져 입찰 전략이 목표 지출액에 도달할 수 없습니다.
LIMITED_BY_LOW_QUALITY 이 입찰 전략의 상당수 키워드의 품질평가점수가 낮습니다.
LIMITED_BY_INVENTORY 좁은 타겟팅으로 인해 입찰 전략에서 예산을 완전히 지출할 수 없습니다.
MISCONFIGURED_ZERO_ELIGIBILITY 전환 추적 (핑 없음) 또는 SSC용 리마케팅 목록이 누락되었습니다.
MISCONFIGURED_CONVERSION_TYPES 입찰 전략이 전환 보고에 종속되며 고객에게 이 전략에 대해 보고될 수 있는 전환 유형이 없습니다.
MISCONFIGURED_CONVERSION_SETTINGS 입찰 전략이 전환 보고에 종속되며 고객의 전환 설정이 잘못 구성되었습니다.
MISCONFIGURED_SHARED_BUDGET 입찰 전략에 포함된 캠페인과 예산을 공유하는 입찰 전략 외부의 캠페인이 있습니다.
MISCONFIGURED_STRATEGY_TYPE 캠페인의 전략 유형이 잘못되어 광고가 게재되지 않고 있습니다.
PAUSED 입찰 전략이 활성 상태가 아닙니다. 입찰 전략에 연결된 운영 중인 캠페인, 광고 그룹 또는 키워드가 없거나 또는 입찰 전략에 연결된 활성 예산이 없습니다.
UNAVAILABLE 이 입찰 전략은 현재 상태 보고를 지원하지 않습니다.
MULTIPLE_LEARNING 문제의 기간 동안 이 입찰 전략에 LEARNING_* 시스템 상태가 여러 번 발생했습니다.
MULTIPLE_LIMITED 문제의 기간 동안 이 입찰 전략에 대해 LIMITED_* 시스템 상태가 여러 번 발생했습니다.
MULTIPLE_MISCONFIGURED 해당 기간에 이 입찰 전략에 대한 MISCONFIGURED_* 시스템 상태가 여러 개 있었습니다.
MULTIPLE 문제의 기간 동안 이 입찰 전략에 여러 시스템 상태가 있었습니다.

AdServingOptimizationStatus

가능한 게재 상태를 설명하는 열거형입니다.

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

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

응답 전용 값입니다.

OPTIMIZE 광고 게재는 캠페인의 CTR을 기반으로 최적화됩니다.
CONVERSION_OPTIMIZE 광고 게재는 캠페인의 CTR * 전환수를 기준으로 최적화됩니다. 캠페인이 전환 최적화 도구 입찰 전략에 포함되어 있지 않으면 기본적으로 '최적화됨'으로 설정됩니다.
ROTATE 광고는 90일 동안 균등하게 로테이션된 후 클릭에 최적화됩니다.
ROTATE_INDEFINITELY 실적이 낮은 광고를 실적이 높은 광고와 함께 더 균등하게 게재하고 최적화하지 않습니다.
UNAVAILABLE 광고 게재 최적화 상태를 사용할 수 없습니다.

AdvertisingChannelType

다양한 광고 채널 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SEARCH 검색 네트워크를 선택합니다. 디스플레이 번들 및 Search+ 캠페인을 포함합니다.
DISPLAY Google 디스플레이 네트워크만 해당
SHOPPING 쇼핑 캠페인은 쇼핑 서비스 및 google.com 검색 결과에 게재됩니다.
HOTEL 호텔 광고 캠페인
VIDEO 동영상 캠페인
MULTI_CHANNEL 여러 채널에서 운영되는 앱 캠페인 및 참여 유도 앱 캠페인
LOCAL 지역 광고 캠페인
SMART 스마트 캠페인
PERFORMANCE_MAX 실적 최대화 캠페인
LOCAL_SERVICES 지역 서비스 캠페인
DISCOVERY 디스커버리 캠페인
TRAVEL 여행 캠페인
SOCIAL 소셜 캠페인

AdvertisingChannelSubType

다양한 채널 하위유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값으로만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SEARCH_MOBILE_APP 검색용 모바일 앱 캠페인
DISPLAY_MOBILE_APP 디스플레이용 모바일 앱 캠페인
SEARCH_EXPRESS 검색용 애드워즈 익스프레스 캠페인
DISPLAY_EXPRESS 디스플레이용 애드워즈 익스프레스 캠페인
SHOPPING_SMART_ADS 스마트 쇼핑 캠페인.
DISPLAY_GMAIL_AD Gmail 광고 캠페인.
DISPLAY_SMART_CAMPAIGN 스마트 디스플레이 캠페인: 이 하위 유형의 새 캠페인을 만들 수 없습니다.
VIDEO_OUTSTREAM 동영상 아웃스트림 캠페인
VIDEO_ACTION 동영상 액션 TrueView 캠페인
VIDEO_NON_SKIPPABLE 건너뛸 수 없는 동영상 광고가 포함된 동영상 캠페인
APP_CAMPAIGN 앱 캠페인을 사용하면 Google 검색, Play, YouTube, Google 디스플레이 네트워크 등 Google의 주요 서비스에서 Android 또는 iOS 앱을 손쉽게 홍보할 수 있습니다.
APP_CAMPAIGN_FOR_ENGAGEMENT Google 검색, YouTube, Google 디스플레이 네트워크 등 Google의 여러 주요 서비스에서 앱의 재참여를 유도하는 데 중점을 둔 참여 유도 앱 캠페인
LOCAL_CAMPAIGN 지역 광고에 특화된 캠페인입니다.
SHOPPING_COMPARISON_LISTING_ADS 쇼핑 비교 등록정보 캠페인
SMART_CAMPAIGN 표준 스마트 캠페인.
VIDEO_SEQUENCE 시퀀스 동영상 광고가 포함된 동영상 캠페인
APP_CAMPAIGN_FOR_PRE_REGISTRATION 모바일 앱 사전 등록 광고에 특화된 사전 등록용 앱 캠페인으로, Google Play, YouTube, 디스플레이 네트워크 전반에서 여러 광고 채널을 타겟팅합니다.
VIDEO_REACH_TARGET_FREQUENCY 타겟 게재빈도 입찰 전략을 사용한 동영상 도달범위 캠페인
TRAVEL_ACTIVITIES 여행 활동 캠페인
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook에서는 소셜 캠페인만 추적합니다.

CustomParameter

trackingUrlTemplate, finalUrls 또는 mobile_final_urls의 맞춤 매개변수 태그에서 사용할 수 있는 매핑입니다.

JSON 표현
{
  "key": string,
  "value": string
}
필드
key

string

매개변수 태그 이름과 일치하는 키입니다.

value

string

대체할 값입니다.

RealTimeBiddingSetting

실시간 입찰 설정: Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있는 기능입니다.

JSON 표현
{
  "optIn": boolean
}
필드
optIn

boolean

캠페인에서 실시간 입찰을 선택했는지 여부입니다.

NetworkSettings

캠페인의 네트워크 설정입니다.

JSON 표현
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
필드
targetSearchNetwork

boolean

광고가 Google 검색 네트워크의 파트너 사이트에 게재되는지 여부입니다(targetGoogleSearchtrue여야 함).

targetContentNetwork

boolean

광고가 Google 디스플레이 네트워크의 지정된 게재위치에 게재되는지 여부입니다. 게재위치는 게재위치 기준을 사용하여 지정됩니다.

targetPartnerSearchNetwork

boolean

광고가 Google 파트너 네트워크에 게재되는지 여부입니다. 이 기능은 일부 Google 파트너 계정에서만 사용할 수 있습니다.

DynamicSearchAdsSetting

동적 검색 광고(DSA)를 제어하기 위한 설정입니다.

JSON 표현
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
필드
domainName

string

필수 항목입니다. 이 설정이 나타내는 인터넷 도메인 이름입니다(예: 'google.com' 또는 'www.google.com').

languageCode

string

필수 항목입니다. 도메인의 언어를 지정하는 언어 코드입니다(예: 'en').

useSuppliedUrlsOnly

boolean

캠페인이 광고주 제공 URL만 사용하는지 여부입니다.

ShoppingSetting

쇼핑 캠페인의 설정입니다. 캠페인에서 광고할 수 있는 제품 범위와 이 캠페인이 다른 쇼핑 캠페인과 상호작용하는 방식을 정의합니다.

JSON 표현
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
필드
feedLabel

string

캠페인에 포함할 제품의 피드 라벨입니다. feedLabel 또는 salesCountry 중 하나만 설정할 수 있습니다. salesCountry 대신 사용되는 경우 feedLabel 필드에는 'XX'와 같은 형식의 국가 코드가 포함됩니다. 그 외의 경우 Google 판매자 센터의 피드 라벨에 사용되는 문자열이 될 수 있습니다.

useVehicleInventory

boolean

차량 등록정보 인벤토리를 타겟팅할지 여부입니다.

merchantId

string (int64 format)

판매자 센터 계정의 ID입니다. 만들기 작업에 필요한 필드입니다. 쇼핑 캠페인의 경우 이 필드를 변경할 수 없습니다.

salesCountry

string

캠페인에 포함할 제품의 판매 국가입니다.

campaignPriority

integer

캠페인의 우선순위입니다. 숫자가 더 높은 우선순위의 캠페인이 우선순위가 더 낮은 캠페인보다 우선 적용됩니다. 이 필드는 0 이상 2 이하의 값을 갖는 쇼핑 캠페인에 필수입니다. 이 필드는 스마트 쇼핑 캠페인에서 선택사항이지만 설정된 경우 3과 같아야 합니다.

enableLocal

boolean

오프라인 제품을 포함할지 여부입니다.

GeoTargetTypeSetting

광고 지역 타겟팅과 관련된 설정 모음을 나타냅니다.

JSON 표현
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
필드
positiveGeoTargetType

enum (PositiveGeoTargetType)

이 특정 캠페인에서 포지티브 지역 타겟팅에 사용되는 설정입니다.

negativeGeoTargetType

enum (NegativeGeoTargetType)

이 특정 캠페인의 제외 지역 타겟팅에 사용되는 설정입니다.

PositiveGeoTargetType

가능한 긍정적인 지역 타겟 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
PRESENCE_OR_INTEREST 사용자가 광고주의 타겟 지역에 있거나 타겟 지역에 관심을 보일 때 광고가 실행되도록 지정합니다.
SEARCH_INTEREST 사용자가 광고주의 타겟팅된 위치를 검색하면 광고가 트리거된다고 지정합니다. 이 기능은 검색 및 일반 쇼핑 캠페인에서만 사용할 수 있습니다.
PRESENCE 사용자가 광고주의 타겟 지역을 방문 중이거나 정기적으로 방문하는 경우 광고가 트리거된다고 지정합니다.

NegativeGeoTargetType

가능한 제외 지역 타겟 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
PRESENCE_OR_INTEREST 사용자가 광고주가 제외한 위치에 있거나 해당 위치에 관심을 보이는 경우 광고가 표시되지 않도록 지정합니다.
PRESENCE 광고주가 제외한 위치에 있는 사용자에게는 광고가 표시되지 않도록 지정합니다.

FrequencyCapEntry

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

특정 기간 동안 광고 (또는 광고 집합)가 사용자에게 표시될 수 있는 최대 횟수를 지정하는 규칙입니다.

SelectiveOptimization

이 캠페인의 선택적 최적화 설정으로, 캠페인 최적화의 기준이 되는 전환 액션 집합이 포함됩니다. 이 기능은 MULTI_CHANNEL을 AdvertisingChannelType으로, APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT을 AdvertisingChannelSubType로 사용하는 앱 캠페인에만 적용됩니다.

JSON 표현
{
  "conversionActions": [
    string
  ]
}
필드
conversionActions[]

string

이 캠페인을 최적화하기 위해 전환 액션용으로 선택한 리소스 이름 집합입니다.

OptimizationGoalSetting

이 캠페인의 최적화 목표 설정으로, 최적화 목표 유형 집합이 포함됩니다.

JSON 표현
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
필드
optimizationGoalTypes[]

enum (OptimizationGoalType)

최적화 목표 유형 목록입니다.

OptimizationGoalType

최적화 목표 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환값으로만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CALL_CLICKS 통화 클릭에 맞게 최적화합니다. 통화 클릭 전환은 광고를 본 후 사용자가 '통화'를 선택하여 매장에 연락한 횟수입니다.
DRIVING_DIRECTIONS 운전경로에 최적화 경로 검색 전환은 사용자가 광고를 본 후 '경로 검색'을 선택하여 매장으로 이동한 횟수입니다.
APP_PRE_REGISTRATION 사전 등록에 최적화합니다. 사전 등록 전환수는 앱 출시 시 알림을 받기 위한 사전 등록 가입 횟수입니다.

TrackingSetting

추적 정보에 대한 캠페인 수준 설정입니다.

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

string

동적 추적에 사용되는 URL입니다.

ManualCpa

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

광고주가 광고주 지정 액션별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다.

ManualCpc

사용자가 클릭당 비용을 지불하는 수동 클릭 기반 입찰입니다.

JSON 표현
{
  "enhancedCpcEnabled": boolean
}
필드
enhancedCpcEnabled

boolean

전환 최적화 도구 데이터를 기반으로 입찰가를 개선할지 여부입니다.

ManualCpm

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

사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.

PercentCpc

일부 상품 또는 서비스에 대해 광고된 가격의 일정 비율을 입찰가로 사용하는 입찰 전략입니다.

JSON 표현
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
필드
cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 광고주가 입력하는 선택사항 필드이며 로컬 마이크로 단위로 지정됩니다. 참고: 0 값은 bid_ceiling이 정의되지 않은 것과 동일한 방식으로 해석됩니다.

enhancedCpcEnabled

boolean

전환 가능성에 따라 각 입찰의 입찰가를 상향 또는 하향 조정합니다. 개별 입찰가는 cpcBidCeilingMicros를 초과할 수 있지만 캠페인의 평균 입찰가는 초과해서는 안 됩니다.

TargetCpm

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

타겟 CPM(1,000회 노출당비용)은 설정한 타겟 CPM을 기준으로 실적을 최적화하도록 입찰가를 설정하는 자동 입찰 전략입니다.

CampaignAsset

캠페인과 저작물 간의 연결입니다.

JSON 표현
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
필드
resourceName

string

캠페인 확장 소재의 리소스 이름입니다. CampaignAsset 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

캠페인 확장 소재의 상태입니다.

campaign

string

애셋이 연결된 캠페인입니다.

asset

string

캠페인에 연결된 애셋입니다.

CampaignAssetSet

CampaignAssetSet는 캠페인과 확장 소재 세트 간의 연결입니다. CampaignAssetSet을 추가하면 확장 소재 조합이 캠페인에 연결됩니다.

JSON 표현
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
필드
resourceName

string

캠페인 확장 소재 조합의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

이 애셋 집합이 연결된 캠페인입니다.

assetSet

string

캠페인에 연결된 애셋 세트입니다.

status

enum (AssetSetLinkStatus)

캠페인 확장 소재 조합 확장 소재의 상태입니다. 읽기 전용입니다.

CampaignAudienceView

캠페인 잠재고객 보기 디스플레이 네트워크 및 YouTube 네트워크 광고의 관심분야 및 리마케팅 목록, 검색 광고용 리마케팅 목록(RLSA)의 실적 데이터가 캠페인 및 잠재고객 기준별로 집계되어 포함됩니다. 이 뷰에는 캠페인 수준에서 연결된 잠재고객만 포함됩니다.

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

string

캠페인 잠재고객 뷰의 리소스 이름입니다. 캠페인 잠재고객 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

캠페인 기준

JSON 표현
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
필드
resourceName

string

캠페인 기준의 리소스 이름입니다. 캠페인 기준 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

기준의 표시 이름입니다.

이 필드는 변형에는 무시됩니다.

type

enum (CriterionType)

기준의 유형입니다.

status

enum (CampaignCriterionStatus)

기준의 상태입니다.

lastModifiedTime

string

이 캠페인 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

criterionId

string (int64 format)

기준의 ID입니다.

이 필드는 변경 중에 무시됩니다.

bidModifier

number

기준이 일치할 때의 입찰가에 대한 수정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. 기기 유형을 선택 해제하려면 0을 사용합니다.

negative

boolean

기준을 타겟팅(false)할지 또는 제외(true)할지 여부입니다.

통합 필드 criterion. 캠페인 기준입니다.

정확히 하나만 설정해야 합니다. criterion는 다음 중 하나여야 합니다.

keyword

object (KeywordInfo)

키워드

location

object (LocationInfo)

위치를 탭합니다.

device

object (DeviceInfo)

기기 등 데이터를 분류할 옵션을 선택합니다.

ageRange

object (AgeRangeInfo)

연령대입니다.

gender

object (GenderInfo)

성별

userList

object (UserListInfo)

사용자 목록

language

object (LanguageInfo)

언어

webpage

object (WebpageInfo)

웹페이지

locationGroup

object (LocationGroupInfo)

위치 그룹

CampaignCriterionStatus

CampaignCriterion의 가능한 상태입니다.

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

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

응답 전용 값입니다.

ENABLED 캠페인 기준이 사용 설정되었습니다.
PAUSED 캠페인 기준이 일시중지됩니다.
REMOVED 캠페인 기준이 삭제됩니다.

LanguageInfo

언어 기준입니다.

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

string

언어 상수 리소스 이름입니다.

LocationGroupInfo

피드를 통해 지정된 위치 목록 주변의 반경입니다.

JSON 표현
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
필드
geoTargetConstants[]

string

피드 내 지리적 지역의 범위를 제한하는 지역 타겟팅 상수입니다. 현재 지오타겟팅 상수는 하나만 허용됩니다.

radiusUnits

enum (LocationGroupRadiusUnits)

반경 단위입니다. 지역 타겟 상수에는 마일과 미터가 지원됩니다. 피드 항목 세트에는 밀리 마일과 미터가 지원됩니다. 이는 필수이며 CREATE 작업에서 설정해야 합니다.

feedItemSets[]

string

FeedItem이 타겟팅된 FeedItemSet입니다. ID가 여러 개 지정된 경우 하나 이상의 세트에 표시되는 모든 항목이 타겟팅됩니다. 이 필드는 geoTargetConstants와 함께 사용할 수 없습니다. 이 속성은 선택사항이며 CREATE 작업에서만 설정할 수 있습니다.

radius

string (int64 format)

타겟 위치 주변 반경을 지정하는 단위로 표시되는 거리입니다. 이는 필수이며 CREATE 작업에서 설정해야 합니다.

LocationGroupRadiusUnits

위치 그룹의 반경 거리 단위입니다 (예: MILES).

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
METERS 미터
MILES 마일
MILLI_MILES Milli Miles

CampaignEffectiveLabel

캠페인과 효과적인 라벨 간의 관계를 나타냅니다. 효과적인 라벨은 이 캠페인에 상속되거나 직접 할당된 라벨입니다.

JSON 표현
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

리소스의 이름입니다. CampaignEffectivelabel 리소스 이름은 customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id} 형식입니다.

campaign

string

효과 라벨이 연결된 캠페인입니다.

label

string

캠페인에 할당된 유효한 라벨입니다.

ownerCustomerId

string (int64 format)

유효 라벨을 소유한 고객의 ID입니다.

CampaignLabel

캠페인과 음반사 간의 관계를 나타냅니다.

JSON 표현
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
필드
resourceName

string

리소스의 이름입니다. 캠페인 라벨 리소스 이름은 customers/{customerId}/campaignLabels/{campaign_id}~{label_id} 형식입니다.

campaign

string

라벨이 연결된 캠페인입니다.

label

string

캠페인에 할당된 라벨입니다.

ownerCustomerId

string (int64 format)

라벨을 소유한 고객의 ID입니다.

CartDataSalesView

장바구니 데이터 판매 보기

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

string

장바구니 데이터 판매 뷰의 리소스 이름입니다. 장바구니 데이터 판매 뷰 리소스 이름의 형식은 customers/{customerId}/cartDataSalesView입니다.

잠재고객

잠재고객은 상세한 인구통계, 관심분야 등 여러 가지 세그먼트 속성을 교차하여 타겟팅 세그먼트를 표현하는 잠재고객을 생성할 수 있는 효과적인 타겟팅 옵션입니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
필드
resourceName

string

잠재고객의 리소스 이름입니다. 잠재고객 이름의 형식은 다음과 같습니다.

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

잠재고객의 ID입니다.

name

string

필수 항목입니다. 잠재고객의 이름입니다. 모든 잠재고객에서 고유해야 합니다. 길이는 1~255자(영문 기준)여야 합니다.

description

string

이 잠재고객에 대한 설명입니다.

ConversionAction

전환 액션

JSON 표현
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
필드
resourceName

string

전환 액션의 리소스 이름입니다. 전환 액션 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

ISO 8601 형식의 플러드라이트 활동 생성의 타임스탬프입니다.

status

enum (ConversionActionStatus)

전환 이벤트 발생에 대한 이 전환 액션의 상태입니다.

type

enum (ConversionActionType)

이 전환 액션의 유형입니다.

category

enum (ConversionActionCategory)

이 전환 액션에 대해 보고된 전환 카테고리입니다.

valueSettings

object (ValueSettings)

이 전환 액션과 연결된 전환 이벤트의 가치와 관련된 설정입니다.

attributionModelSettings

object (AttributionModelSettings)

이 전환 액션의 기여 분석 모델과 관련된 설정입니다.

floodlightSettings

object (FloodlightSettings)

플러드라이트 전환 유형의 플러드라이트 설정

id

string (int64 format)

전환 액션의 ID입니다.

name

string

전환 액션의 이름입니다.

이 필드는 필수 항목이며 새 전환 액션을 만들 때 비워 두지 않아야 합니다.

primaryForGoal

boolean

전환 액션의 primaryForGoal 비트가 false이면 고객 전환 목표 또는 캠페인 전환 목표에 관계없이 모든 캠페인에서 전환 액션을 입찰할 수 없습니다. 그러나 맞춤 전환 목표는 primaryForGoal을 따르지 않으므로 캠페인에 primaryForGoal = false 전환 액션으로 구성된 맞춤 전환 목표가 있는 경우 해당 전환 액션은 계속 입찰할 수 있습니다. 기본적으로 primaryForGoal은 설정되지 않은 경우 true입니다. V9에서 primaryForGoal 은 선택사항으로 선언되지 않았으므로 'update' 연산을 통해 생성된 후에 false로만 설정할 수 있습니다.

ownerCustomer

string

전환 액션 소유자 고객의 리소스 이름 또는 시스템 정의 전환 액션인 경우 null입니다.

includeInClientAccountConversionsMetric

boolean

이 전환 액션을 'clientAccountConversions' 측정항목에 포함해야 하는지 여부입니다.

includeInConversionsMetric

boolean

이 전환 액션을 '전환수' 측정항목에 포함해야 하는지 여부입니다.

clickThroughLookbackWindowDays

string (int64 format)

상호작용 (예: 클릭)과 전환 이벤트 간에 경과할 수 있는 최대 일수입니다.

appId

string

앱 전환 액션의 앱 ID입니다.

ConversionActionStatus

전환 액션의 가능한 상태

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 전환이 기록됩니다.
REMOVED 전환이 기록되지 않습니다.
HIDDEN 전환이 기록되지 않으며 전환 액션이 UI에 표시되지 않습니다.

ConversionActionType

가능한 전환 액션 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AD_CALL 사용자가 광고의 통화 확장 프로그램을 클릭할 때 발생하는 전환입니다.
CLICK_TO_CALL 휴대기기 사용자가 전화번호를 클릭할 때 발생하는 전환입니다.
GOOGLE_PLAY_DOWNLOAD 사용자가 Google Play 스토어에서 모바일 앱을 다운로드할 때 발생하는 전환입니다.
GOOGLE_PLAY_IN_APP_PURCHASE 사용자가 Android 결제를 통해 앱에서 구매할 때 발생하는 전환입니다.
UPLOAD_CALLS 광고주가 추적하고 업로드한 통화 전환입니다.
UPLOAD_CLICKS 광고주가 추적하고 기여 클릭으로 업로드된 전환입니다.
WEBPAGE 웹페이지에서 발생하는 전환
WEBSITE_CALL 사용자가 광고주 웹사이트에서 동적으로 생성된 전화번호로 전화를 걸 때 발생하는 전환입니다.
STORE_SALES_DIRECT_UPLOAD 퍼스트 파티 또는 서드 파티 판매자 데이터 업로드를 기반으로 한 오프라인 매장 판매 전환 허용 목록에 있는 고객만 오프라인 매장 판매 직접 업로드 유형을 사용할 수 있습니다.
STORE_SALES 퍼스트 파티 또는 서드 파티 판매자 데이터 업로드 또는 결제 네트워크의 카드를 사용한 매장 구매를 기반으로 한 오프라인 매장 판매 전환입니다. 허용 목록에 있는 고객만 오프라인 매장 판매 유형을 사용할 수 있습니다. 읽기 전용입니다.
FIREBASE_ANDROID_FIRST_OPEN Firebase를 통해 추적된 Android 앱 첫 실행 전환입니다.
FIREBASE_ANDROID_IN_APP_PURCHASE Firebase를 통해 추적된 Android 앱 인앱 구매 전환입니다.
FIREBASE_ANDROID_CUSTOM Firebase를 통해 추적된 Android 앱 맞춤 전환
FIREBASE_IOS_FIRST_OPEN Firebase를 통해 추적된 iOS 앱 첫 실행 전환
FIREBASE_IOS_IN_APP_PURCHASE Firebase를 통해 추적된 iOS 앱 인앱 구매 전환
FIREBASE_IOS_CUSTOM Firebase를 통해 추적된 iOS 앱 맞춤 전환
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN 타사 앱 애널리틱스를 통해 추적된 Android 앱 최초 실행 전환입니다.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE 서드 파티 앱 애널리틱스를 통해 추적된 Android 앱 인앱 구매 전환입니다.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 타사 앱 애널리틱스를 통해 추적된 Android 앱 맞춤 전환입니다.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN 서드 파티 앱 애널리틱스를 통해 추적된 iOS 앱 첫 실행 전환
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE 서드 파티 앱 애널리틱스를 통해 추적된 iOS 앱 인앱 구매 전환입니다.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM 서드 파티 앱 애널리틱스를 통해 추적된 iOS 앱 맞춤 전환입니다.
ANDROID_APP_PRE_REGISTRATION 사용자가 Google Play 스토어에서 모바일 앱을 사전 등록할 때 발생하는 전환입니다. 읽기 전용입니다.
ANDROID_INSTALLS_ALL_OTHER_APPS 앱별 유형으로 추적되지 않는 모든 Google Play 다운로드를 추적하는 전환입니다. 읽기 전용입니다.
FLOODLIGHT_ACTION 사용자가 광고주 광고 중 하나를 보거나 클릭한 후 특정 웹페이지를 방문한 횟수를 집계하는 플러드라이트 활동입니다. 읽기 전용입니다.
FLOODLIGHT_TRANSACTION 판매 횟수 또는 구매한 상품 수를 추적하는 플러드라이트 활동 각 판매의 총 가치를 확인할 수도 있습니다. 읽기 전용입니다.
GOOGLE_HOSTED 광고와 상호작용한 후 Google 제품 및 서비스에서 발생한 오프라인 액션을 추적하는 전환입니다. 읽기 전용입니다.
LEAD_FORM_SUBMIT 사용자가 리드 양식을 제출할 때 보고되는 전환입니다. 읽기 전용입니다.
SALESFORCE Salesforce에서 발생한 전환입니다. 읽기 전용입니다.
SEARCH_ADS_360 Search Ads 360 플러드라이트 데이터에서 가져온 전환입니다. 읽기 전용입니다.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL 스마트 캠페인 맞춤 기준을 사용하여 통화 추적을 설정하지 않은 스마트 캠페인 광고에서 발생한 통화 전환입니다. 읽기 전용입니다.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL 사용자가 Google 지도 내에서 전화 요소를 클릭합니다. 스마트 캠페인만 해당됩니다. 읽기 전용입니다.
SMART_CAMPAIGN_MAP_DIRECTIONS 사용자가 Google 지도 내에서 오프라인 매장까지의 경로를 요청합니다. 스마트 캠페인만 해당됩니다. 읽기 전용입니다.
SMART_CAMPAIGN_TRACKED_CALLS 스마트 캠페인 맞춤 기준을 사용하여 통화 추적 설정이 적용된 스마트 캠페인 광고에서 발생하는 통화 전환입니다. 읽기 전용입니다.
STORE_VISITS 사용자가 광고주의 소매점을 방문할 때 발생하는 전환입니다. 읽기 전용입니다.
WEBPAGE_CODELESS 개별적으로 코딩된 이벤트 스니펫을 사용하지 않는 웹사이트 이벤트 (예: 양식 제출 또는 페이지 로드)에서 생성된 전환입니다. 읽기 전용입니다.
UNIVERSAL_ANALYTICS_GOAL 연결된 유니버설 애널리틱스 목표에서 발생한 전환입니다.
UNIVERSAL_ANALYTICS_TRANSACTION 연결된 유니버설 애널리틱스 거래에서 발생한 전환입니다.
GOOGLE_ANALYTICS_4_CUSTOM 연결된 Google 애널리틱스 4 맞춤 이벤트 전환에서 발생한 전환입니다.
GOOGLE_ANALYTICS_4_PURCHASE 연결된 Google 애널리틱스 4 구매 전환에서 발생한 전환입니다.

ConversionActionCategory

ConversionAction과 연결된 전환의 카테고리입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
DEFAULT 기본 카테고리입니다.
PAGE_VIEW 페이지를 방문하는 사용자
PURCHASE 구매, 판매 또는 '주문 완료' 이벤트
SIGNUP 사용자 가입 작업입니다.
LEAD 리드 생성 작업
DOWNLOAD 소프트웨어 다운로드 작업 (앱의 경우)
ADD_TO_CART 광고주 사이트의 장바구니 또는 쇼핑백에 상품을 추가하는 행위입니다.
BEGIN_CHECKOUT 사용자가 광고주 사이트에서 결제 절차를 시작할 때
SUBSCRIBE_PAID 제품 또는 서비스의 유료 정기 결제 시작
PHONE_CALL_LEAD 광고주의 제품에 대한 관심을 나타내는 호출입니다.
IMPORTED_LEAD 외부 소스에서 Google Ads로 가져온 리드 전환입니다.
SUBMIT_LEAD_FORM 광고주 사이트에서 비즈니스 관심을 나타내는 양식을 제출합니다.
BOOK_APPOINTMENT 광고주 비즈니스와의 상담 예약입니다.
REQUEST_QUOTE 견적 또는 가격 추정치 요청
GET_DIRECTIONS 방문 의도를 가지고 광고주의 오프라인 매장을 검색하는 경우
OUTBOUND_CLICK 광고주의 파트너 사이트를 클릭한 경우입니다.
CONTACT 광고주에게 전화, SMS, 이메일, 채팅 또는 기타 유형으로 연락하는 행위입니다.
ENGAGEMENT 긴 사이트 시간 또는 Google 애널리틱스 (GA) 스마트 목표와 같은 웹사이트 참여 이벤트입니다. GA, Firebase, GA Gold 목표 가져오기에 사용하기 위한 것입니다.
STORE_VISIT 오프라인 매장 방문
STORE_SALE 오프라인 매장에서 발생한 판매입니다.
QUALIFIED_LEAD 외부 소스에서 Google Ads로 가져온 리드 전환으로, 광고주 (마케팅/영업팀)가 추가로 검증했습니다. 리드에서 판매에 이르는 여정에서 광고주는 리드를 받은 후 소비자에게 도달하여 리드에 따라 조치를 취합니다. 소비자가 관심을 보이며 제품을 구매할 가능성이 있는 경우 광고주는 이러한 리드를 '잠재고객'으로 표시합니다.
CONVERTED_LEAD 외부 소스에서 Google Ads로 가져온 리드 전환으로, 리드 생성 광고주가 정의한 선택한 단계를 추가로 완료했습니다.

ValueSettings

이 전환 액션과 연결된 전환 이벤트의 가치와 관련된 설정입니다.

JSON 표현
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
필드
defaultValue

number

이 전환 액션의 전환 이벤트가 잘못되거나, 허용되지 않거나, 누락된 값과 함께 전송되거나, 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 값입니다.

defaultCurrencyCode

string

이 전환 액션의 전환 이벤트가 잘못되거나 누락된 통화 코드와 함께 전송되거나 이 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 통화 코드입니다.

alwaysUseDefaultValue

boolean

이 전환 액션에 대한 전환 이벤트에 지정된 가치 및 통화 코드 대신 기본값 및 기본 통화 코드를 사용할지 여부를 지정합니다.

AttributionModelSettings

이 전환 액션의 기여 분석 모델과 관련된 설정입니다.

JSON 표현
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
필드
attributionModel

enum (AttributionModel)

이 전환 액션의 기여 분석 모델 유형입니다.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

전환 액션에 대한 데이터 기반 기여 분석 모델의 상태입니다.

AttributionModel

이전에 발생한 여러 상호작용에 특정 전환에 대한 기여도를 분배하는 방법을 설명하는 기여 분석 모델입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
EXTERNAL 외부 기여 분석을 사용합니다.
GOOGLE_ADS_LAST_CLICK 마지막 클릭에 전환 기여도를 모두 부여합니다.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google 검색 기여 분석을 사용하여 전환에 대한 모든 기여도를 첫 번째 클릭에 부여합니다.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google 검색 기여 분석을 사용하는 모든 클릭에 동등하게 전환 기여도를 부여합니다.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google 검색 기여 분석 (반감기는 1주일)을 사용하여 더 최근 클릭에 전환 기여도를 기하급수적으로 더 많이 부여합니다.
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED 첫 번째 클릭과 마지막 클릭에 전환 기여도 40%를 부여합니다. 나머지 20% 는 기타 모든 클릭에 균등하게 배분됩니다. Google 검색 기여 분석을 사용합니다.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN 머신러닝을 사용하여 Google 검색 기여 분석을 통해 클릭 간에 적절한 기여도 분포를 결정하는 유연한 모델입니다.

DataDrivenModelStatus

데이터 기반 모델 상태를 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
AVAILABLE 데이터 기반 모델을 사용할 수 있습니다.
STALE 데이터 기반 모델이 비활성 상태입니다. 7일 이상 업데이트되지 않았습니다. 아직 사용 중이지만 30일 동안 업데이트되지 않으면 만료됩니다.
EXPIRED 데이터 기반 모델이 만료되었습니다. 30일 이상 업데이트되지 않았으며 사용할 수 없습니다. 이는 대부분 최근 30일 동안 필요한 수의 이벤트가 발생하지 않았기 때문입니다.
NEVER_GENERATED 데이터 기반 모델이 생성된 적이 없습니다. 이는 대부분 30일 동안 필요한 수의 이벤트가 발생하지 않았기 때문입니다.

FloodlightSettings

플러드라이트 전환 액션과 관련된 설정입니다.

JSON 표현
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
필드
activityGroupTag

string

전환을 보고할 때 플러드라이트 활동 그룹을 식별하는 데 사용되는 문자열입니다.

activityTag

string

전환을 보고할 때 플러드라이트 활동을 식별하는 데 사용되는 문자열입니다.

activityId

string (int64 format)

DoubleClick Campaign Manager(DCM)의 플러드라이트 활동 ID입니다.

ConversionCustomVariable

전환 맞춤 변수 https://support.google.com/sa360/answer/13567857에서 '새 Search Ads 360의 맞춤 플러드라이트 측정항목 및 측정기준에 관한 정보'를 참고하세요.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
필드
resourceName

string

전환 맞춤 변수의 리소스 이름입니다. 전환 맞춤 변수 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

전환 맞춤 변수의 ID입니다.

name

string

필수 항목입니다. 전환 맞춤 변수의 이름입니다. 이름은 고유해야 합니다. 이름의 최대 길이는 100자(영문 기준)입니다. 앞뒤에 공백이 없어야 합니다.

tag

string

필수 항목입니다. 전환 맞춤 변수의 태그입니다. 태그는 고유해야 하며 'u' 문자와 100 이하의 숫자로 구성되어야 합니다. 예: 'u4'

status

enum (ConversionCustomVariableStatus)

전환 이벤트 발생에 대한 전환 맞춤 변수의 상태입니다.

ownerCustomer

string

전환 맞춤 변수를 소유한 고객의 리소스 이름입니다.

family

enum (ConversionCustomVariableFamily)

전환 맞춤 변수의 모음입니다.

cardinality

enum (ConversionCustomVariableCardinality)

전환 맞춤 변수의 카디널리티입니다.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Search Ads 360 플러드라이트 전환 맞춤 변수의 필드입니다.

customColumnIds[]

string (int64 format)

이 전환 맞춤 변수를 사용하는 맞춤 열의 ID입니다.

ConversionCustomVariableStatus

전환 맞춤 변수의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ACTIVATION_NEEDED

전환 맞춤 변수가 활성화 대기 중이며 ENABLED(사용 설정됨)로 설정될 때까지 통계가 누적되지 않습니다.

이 상태는 CREATE 및 UPDATE 요청에 사용할 수 없습니다.

ENABLED 전환 맞춤 변수가 사용 설정되고 통계가 누적됩니다.
PAUSED 전환 맞춤 변수가 일시중지되며 ENABLED로 다시 설정될 때까지 통계가 누적되지 않습니다.

ConversionCustomVariableFamily

전환 맞춤 변수의 계열입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
STANDARD 표준 전환 맞춤 변수입니다. 고객은 사용하기 전에 활성화해야 합니다.
FLOODLIGHT 맞춤 플러드라이트 변수에서 가져온 전환 맞춤 변수입니다.

ConversionCustomVariableCardinality

전환 맞춤 변수의 카디널리티입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BELOW_ALL_LIMITS 전환 맞춤 변수의 카디널리티가 모든 한도보다 낮습니다. 변수는 세분화에 사용할 수 있으며, 변수가 사용 설정된 경우에는 새 값에 대한 통계가 누적될 수 있습니다.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT 전환 맞춤 변수의 카디널리티가 세분화 한도를 초과하지만 통계 한도를 초과하지는 않습니다. 세분화가 사용 중지되지만 변수가 사용 설정된 경우 새 값에 대한 통계가 누적될 수 있습니다.
APPROACHES_STATS_LIMIT 전환 맞춤 변수가 세분화 한도를 초과했으며 통계 한도(90% 초과)에 근접하고 있습니다. 세분화가 사용 중지되지만 변수가 사용 설정된 경우 새 값에 대한 통계가 누적될 수 있습니다.
EXCEEDS_STATS_LIMIT 전환 맞춤 변수가 세분화 한도와 통계 한도를 모두 초과했습니다. 세분화가 사용 중지되며, 사용 설정된 변수의 통계는 기존 값이 변수의 카디널리티를 더 이상 늘리지 않는 경우에만 누적될 수 있습니다.

FloodlightConversionCustomVariableInfo

Search Ads 360 플러드라이트 전환 맞춤 변수에 대한 정보입니다.

JSON 표현
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
필드
floodlightVariableType

enum (FloodlightVariableType)

Search Ads 360에 정의된 플러드라이트 변수 유형입니다.

floodlightVariableDataType

enum (FloodlightVariableDataType)

Search Ads 360에 정의된 플러드라이트 변수 데이터 유형입니다.

FloodlightVariableType

Search Ads 360에 정의된 플러드라이트 변수의 유형입니다. 자세한 내용은 https://support.google.com/searchads/answer/4397154?hl=en 페이지를 참고하세요.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
DIMENSION 측정기준 플러드라이트 변수 유형입니다.
METRIC 측정항목 플러드라이트 변수 유형입니다.
UNSET 플러드라이트 변수 유형이 설정되지 않았습니다.

FloodlightVariableDataType

Search Ads 360에 정의된 플러드라이트 변수의 데이터 유형입니다. 자세한 내용은 https://support.google.com/searchads/answer/4397154?hl=en를 참고하세요.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NUMBER '숫자' 유형의 플러드라이트 변수를 나타냅니다. 이 변수는 DIMENSION 또는 METRIC 유형의 플러드라이트 변수에 할당할 수 있습니다.
STRING '문자열' 유형의 플러드라이트 변수를 나타냅니다. 이 변수는 DIMENSION 유형의 플러드라이트 변수에 할당될 수 있습니다.

고객

고객.

JSON 표현
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
필드
resourceName

string

고객의 리소스 이름입니다. 고객 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

고객의 전환 추적 설정입니다.

accountType

enum (AccountType)

엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등)

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

관리자 고객의 DoubleClick Campaign Manager (DCM) 설정입니다.

accountStatus

enum (AccountStatus)

계정 상태(예: 사용 설정됨, 일시중지됨, 삭제됨 등)

lastModifiedTime

string

이 고객이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다.

engineId

string

외부 엔진 계정의 계정 ID입니다.

status

enum (CustomerStatus)

고객의 상태입니다.

creationTime

string

이 고객이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

id

string (int64 format)

고객의 ID입니다.

descriptiveName

string

고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다.

currencyCode

string

계정에 사용되는 통화입니다. ISO 4217 표준의 통화 코드 중 일부가 지원됩니다.

timeZone

string

고객의 현지 시간대 ID입니다.

trackingUrlTemplate

string

매개변수로 추적 URL을 구성하기 위한 URL 템플릿입니다.

finalUrlSuffix

string

최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다.

autoTaggingEnabled

boolean

고객에 대해 자동 태그 추가가 사용 설정되어 있는지 여부입니다.

manager

boolean

고객이 관리자인지 여부

ConversionTrackingSetting

Search Ads 360 전환 추적과 관련된 고객 전체 설정 모음입니다.

JSON 표현
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
필드
acceptedCustomerDataTerms

boolean

고객이 고객 데이터 약관에 동의했는지 여부입니다. 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자 계정에서 상속됩니다. 이 필드는 읽기 전용입니다. 자세한 내용은 https://support.google.com/adspolicy/answer/7475709를 참고하세요.

conversionTrackingStatus

enum (ConversionTrackingStatus)

전환 추적 상태입니다. 고객이 전환 추적을 사용하고 있는지 여부와 이 고객의 전환 추적 소유자를 나타냅니다. 이 고객이 교차 계정 전환 추적을 사용하는 경우 반환되는 값은 요청의 login-customer-id에 따라 다릅니다.

enhancedConversionsForLeadsEnabled

boolean

고객이 리드 확보용 향상된 전환을 선택했는지 여부입니다. 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자 계정에서 상속됩니다. 이 필드는 읽기 전용입니다.

googleAdsConversionCustomer

string

전환이 생성되고 관리되는 고객의 리소스 이름입니다. 이 필드는 읽기 전용입니다.

conversionTrackingId

string (int64 format)

이 계정에 사용되는 전환 추적 ID입니다. 이 ID는 고객이 전환 추적을 사용하는지 여부를 나타내지 않습니다(conversionTrackingStatus가 이를 나타냅니다). 이 필드는 읽기 전용입니다.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

고객 관리자의 전환 추적 ID입니다. 고객이 전환 추적을 선택하면 설정되며 conversionTrackingId를 재정의합니다. 이 필드는 Google Ads UI를 통해서만 관리할 수 있습니다. 이 필드는 읽기 전용입니다.

crossAccountConversionTrackingId

string (int64 format)

고객 관리자의 전환 추적 ID입니다. 고객이 교차 계정 전환 추적을 선택하면 설정되며 conversionTrackingId를 재정의합니다.

ConversionTrackingStatus

고객의 전환 추적 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
NOT_CONVERSION_TRACKED 고객이 전환 추적을 사용하지 않습니다.
CONVERSION_TRACKING_MANAGED_BY_SELF 전환 액션은 이 고객이 만들고 관리합니다.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER 전환 액션은 요청의 login-customer-id에 지정된 관리자에 의해 생성되고 관리됩니다.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER 전환 액션은 요청의 login-customer-id에 지정된 고객 또는 관리자와 다른 관리자가 만들고 관리합니다.

AccountType

가능한 엔진 계정 유형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BAIDU Baidu 계정
ENGINE_TRACK 엔진 추적 계정
FACEBOOK Facebook 계정
FACEBOOK_GATEWAY 게이트웨이를 통해 관리되는 Facebook 계정
GOOGLE_ADS Google Ads 계정
MICROSOFT Microsoft Advertising 계정
SEARCH_ADS_360 Search Ads 360 관리자 계정
YAHOO_JAPAN Yahoo Japan 계정으로 이동합니다.

DoubleClickCampaignManagerSetting

관리자 고객의 DoubleClick Campaign Manager (DCM) 설정

JSON 표현
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
필드
advertiserId

string (int64 format)

이 고객과 연결된 Campaign Manager 광고주의 ID입니다.

networkId

string (int64 format)

이 고객과 연결된 Campaign Manager 네트워크의 ID입니다.

timeZone

string

이 고객과 연결된 Campaign Manager 네트워크의 시간대입니다(예: America/New_York). IANA 시간대 데이터베이스 형식입니다.

AccountStatus

가능한 계정 상태

열거형
UNSPECIFIED 기본값
UNKNOWN 알 수 없는 값입니다.
ENABLED 계정에서 광고를 게재할 수 있습니다.
PAUSED 사용자가 계정을 비활성화했습니다.
SUSPENDED 내부 프로세스에 의해 계정이 비활성화됩니다.
REMOVED 계정이 취소할 수 없게 비활성화됩니다.
DRAFT 계정이 아직 설정 중이며 아직 사용 설정되지 않았습니다.

CustomerStatus

고객의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 광고를 게재할 수 있는 활성 계정을 나타냅니다.
CANCELED 광고를 게재할 수 없는 취소된 계정을 나타냅니다. 관리자가 재활성화할 수 있습니다.
SUSPENDED 광고를 게재할 수 없는 정지된 계정을 나타냅니다. Google 지원팀에서만 활성화할 수 있습니다.
CLOSED 광고를 게재할 수 없는 폐쇄된 계정을 나타냅니다. 테스트 계정에도 'CLOSED'(폐쇄됨) 상태가 표시됩니다. 상태는 영구적이며 다시 열 수 없습니다.

CustomerAsset

고객과 애셋 간의 연결입니다.

JSON 표현
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
필드
resourceName

string

고객 애셋의 리소스 이름입니다. CustomerAsset 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

필수 항목입니다. 고객에 연결된 애셋입니다.

status

enum (AssetLinkStatus)

고객 애셋의 상태입니다.

CustomerAssetSet

CustomerAssetSet은 고객과 애셋 세트 간의 연결입니다. CustomerAssetSet을 추가하면 애셋 세트가 고객과 연결됩니다.

JSON 표현
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
필드
resourceName

string

고객 애셋 세트의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

고객에 연결된 애셋 집합입니다.

customer

string

이 애셋 세트가 연결된 고객입니다.

status

enum (AssetSetLinkStatus)

고객 애셋 세트 애셋의 상태입니다. 읽기 전용입니다.

AccessibleBiddingStrategy

고객이 소유하고 공유한 입찰 전략 보기를 나타냅니다.

BiddingStrategy와 달리 이 리소스에는 고객이 소유한 전략 외에도 고객의 관리자가 소유하고 고객과 공유하는 전략이 포함됩니다. 이 리소스는 측정항목을 제공하지 않으며 입찰 전략 속성의 제한된 하위 집합만 노출합니다.

JSON 표현
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
필드
resourceName

string

액세스 가능한 입찰 전략의 리소스 이름입니다. AccessibleBiddingStrategy 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

입찰 전략의 ID입니다.

name

string

입찰 전략의 이름입니다.

type

enum (BiddingStrategyType)

입찰 전략의 유형입니다.

ownerCustomerId

string (int64 format)

입찰 전략을 소유한 고객의 ID입니다.

ownerDescriptiveName

string

입찰 전략을 소유한 고객의 descriptiveName입니다.

통합 필드 scheme. 입찰 스키마입니다.

하나만 설정할 수 있습니다. scheme는 다음 중 하나여야 합니다.

maximizeConversionValue

object (MaximizeConversionValue)

예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다.

maximizeConversions

object (MaximizeConversions)

캠페인에서 예산이 지출될 때 최대한 많은 전환이 발생하도록 설정하는 자동 입찰 전략입니다.

targetCpa

object (TargetCpa)

타겟 CPA는 설정된 타겟 전환당비용(CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

targetImpressionShare

object (TargetImpressionShare)

선택한 노출 비율을 기준으로 자동으로 최적화하는 입찰 전략입니다.

targetRoas

object (TargetRoas)

특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 입찰 전략입니다.

targetSpend

object (TargetSpend)

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다.

MaximizeConversionValue

예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다.

JSON 표현
{
  "targetRoas": number
}
필드
targetRoas

number

타겟 광고 투자수익(ROAS) 옵션 이 옵션을 설정하면 입찰 전략이 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화합니다. 타겟 ROAS가 높으면 입찰 전략에서 전체 예산을 지출하지 못할 수 있습니다. 타겟 ROAS를 설정하지 않으면 입찰 전략은 예산에 대해 최대한 높은 ROAS를 달성하는 것을 목표로 합니다.

MaximizeConversions

캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되는 자동 입찰 전략입니다.

JSON 표현
{
  "targetCpa": string,
  "targetCpaMicros": string
}
필드
targetCpa

string (int64 format)

타겟 전환당비용 (CPA) 옵션입니다. 전환당 지출하고자 하는 평균 금액입니다.

targetCpaMicros

string (int64 format)

타겟 전환당비용 (CPA) 옵션 획득당 지출하고자 하는 평균 금액입니다.

TargetCpa

설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.

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

string (int64 format)

평균 CPA 타겟입니다. 이 타겟은 계정의 통화를 기준으로 최소 청구 가능 단위보다 크거나 같아야 합니다.

TargetImpressionShare

첫 페이지 (또는 다른 타겟 위치)의 상단에 특정 비율의 검색 광고가 게재되도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
필드
location

enum (TargetImpressionShareLocation)

검색결과 페이지의 타겟 위치입니다.

locationFractionMicros

string (int64 format)

타겟팅된 위치에 표시할 광고의 선택된 비율(마이크로)입니다. 예를 들어 1%는 10,000입니다.

cpcBidCeilingMicros

string (int64 format)

자동 입찰 시스템으로 지정할 수 있는 가장 높은 CPC 입찰가입니다. 광고주가 입력하는 필수 필드이고 상한을 설정하며 로컬 마이크로 단위로 지정됩니다.

TargetRoas

특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 자동 입찰 전략입니다.

JSON 표현
{
  "targetRoas": number
}
필드
targetRoas

number

지출 단위당 선택한 수익(전환 데이터 기준)입니다.

TargetSpend

예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.

JSON 표현
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
필드
targetSpendMicros
(deprecated)

string (int64 format)

클릭수를 최대화할 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. 자세한 내용은 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html을 참고하세요.

cpcBidCeilingMicros

string (int64 format)

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다.

ManagerLinkStatus

링크의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ACTIVE 현재 유효한 관계를 나타냅니다.
INACTIVE 종료된 관계를 나타냅니다.
PENDING 관리자가 관계를 요청했지만 아직 고객이 수락하지 않았음을 나타냅니다.
REFUSED 관리자가 관계를 요청했지만 고객이 거부했습니다.
CANCELED 관리자가 관계를 요청했으나 관리자가 취소했음을 나타냅니다.

CustomerClient

지정된 고객과 고객 고객 간의 링크입니다. CustomerClient는 관리자 고객에게만 존재합니다. 관리자 자신뿐만 아니라 모든 직접 및 간접 고객 고객이 포함됩니다.

JSON 표현
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
필드
resourceName

string

고객 클라이언트의 리소스 이름입니다. CustomerClient 리소스 이름의 형식은 customers/{customerId}/customerClients/{client_customer_id}입니다.

appliedLabels[]

string

요청하는 고객이 소유하고 있으며 고객 계정에 적용된 라벨의 리소스 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

고객 고객의 상태입니다. 읽기 전용입니다.

clientCustomer

string

특정 고객에 연결된 클라이언트-고객의 리소스 이름입니다. 읽기 전용입니다.

hidden

boolean

숨겨진 계정인지 여부를 지정합니다.

읽기 전용입니다.

level

string (int64 format)

지정된 고객과 고객 사이의 거리입니다. 자체 링크의 경우 수준 값은 0입니다. 읽기 전용입니다.

timeZone

string

클라이언트의 시간대의 Common Locale Data Repository(CLDR) 문자열 표현입니다(예: America/Los_Angeles). 읽기 전용입니다.

testAccount

boolean

고객이 테스트 계정인지 식별합니다. 읽기 전용입니다.

manager

boolean

클라이언트가 관리자인지 식별합니다. 읽기 전용입니다.

descriptiveName

string

클라이언트를 설명하는 이름입니다. 읽기 전용입니다.

currencyCode

string

고객의 통화 코드(예: 'USD', 'EUR')입니다. 읽기 전용입니다.

id

string (int64 format)

고객 클라이언트의 ID입니다. 읽기 전용입니다.

DynamicSearchAdsSearchTermView

동적 검색 광고 검색어 보기

JSON 표현
{
  "resourceName": string,
  "landingPage": string
}
필드
resourceName

string

동적 검색 광고 검색어 뷰의 리소스 이름입니다. 동적 검색 광고 검색어 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

동적으로 선택된 노출의 방문 페이지 URL입니다.

이 필드는 읽기 전용입니다.

GenderView

성별 보기 genderView 리소스는 추가된 기준이 아닌 유효한 게재 상태를 반영합니다. 성별 기준이 없는 광고 그룹은 기본적으로 모든 성별에 표시되므로 모든 성별이 통계와 함께 genderView에 표시됩니다.

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

string

성별 뷰의 리소스 이름입니다. 성별 보기 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

지역 타겟팅 상수입니다.

JSON 표현
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
필드
resourceName

string

지역 타겟 상수의 리소스 이름입니다. 지역 타겟 상수 리소스 이름의 형식은 다음과 같습니다.

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

지역 타겟팅 상수 상태입니다.

id

string (int64 format)

지역 타겟 상수의 ID입니다.

name

string

지역 타겟 상수의 영어 이름입니다.

countryCode

string

타겟과 연결된 ISO-3166-1 alpha-2 국가 코드입니다.

targetType

string

지역 타겟팅 상수 타겟 유형입니다.

canonicalName

string

타겟 이름과 상위 요소 및 국가 이름으로 구성된 정규화된 영어 이름입니다.

parentGeoTarget

string

상위 지역 타겟 상수의 리소스 이름입니다. 지역 타겟팅 상수 리소스 이름의 형식은 다음과 같습니다.

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

지역 대상 상수의 가능한 상태입니다.

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

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

응답 전용 값입니다.

ENABLED 지역 타겟 상수가 유효합니다.
REMOVAL_PLANNED 지역 대상 상수는 더 이상 사용되지 않으며 삭제될 예정입니다.

KeywordView

키워드 보기입니다.

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

string

키워드 뷰의 리소스 이름입니다. 키워드 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

라벨

라벨

JSON 표현
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
필드
resourceName

string

리소스의 이름입니다. 라벨 리소스 이름은 customers/{customerId}/labels/{label_id} 형식입니다.

status

enum (LabelStatus)

라벨의 상태입니다. 읽기 전용입니다.

textLabel

object (TextLabel)

색이 있는 배경에 텍스트를 표시하는 라벨 유형입니다.

id

string (int64 format)

라벨의 ID입니다. 읽기 전용입니다.

name

string

라벨 이름입니다.

이 필드는 필수이며 새 라벨을 만들 때 비워 둘 수 없습니다.

이 문자열의 길이는 1~80 사이여야 합니다(1 및 80 포함).

LabelStatus

라벨의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 라벨이 사용 설정되었습니다.
REMOVED 라벨이 삭제되었습니다.

TextLabel

컬러 배경에 텍스트를 표시하는 라벨 유형입니다.

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

string

라벨의 배경 색상(16진수 형식)입니다. 이 문자열은 정규 표현식 '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'와 일치해야 합니다. 참고: 관리자 계정에서는 배경색이 표시되지 않을 수 있습니다.

description

string

라벨에 관한 간단한 설명입니다. 길이는 200자(영문 기준) 이하여야 합니다.

LanguageConstant

언어

JSON 표현
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
필드
resourceName

string

언어 상수의 리소스 이름입니다. 언어 상수 리소스 이름의 형식은 다음과 같습니다.

languageConstants/{criterionId}

id

string (int64 format)

언어 상수의 ID입니다.

code

string

언어 코드(예: 'en_US', 'en_AU', 'es', 'fr' 등)입니다.

name

string

언어의 전체 이름(영어로 표시)입니다(예: '영어(미국)', '스페인어' 등).

targetable

boolean

언어의 타겟팅 가능 여부입니다.

LocationView

위치 보기는 위치 기준별로 캠페인 실적을 요약합니다.

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

string

위치 뷰의 리소스 이름입니다. 위치 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

제품 입찰 카테고리입니다.

JSON 표현
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
필드
resourceName

string

제품 입찰 카테고리의 리소스 이름입니다. 제품 입찰 카테고리 리소스 이름은 다음과 같은 형식입니다.

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

제품 입찰 카테고리의 수준입니다.

status

enum (ProductBiddingCategoryStatus)

제품 입찰 카테고리의 상태입니다.

id

string (int64 format)

제품 입찰 카테고리의 ID입니다.

이 ID는 이 도움말(https://support.google.com/merchants/answer/6324436)에 설명된 google_product_category ID와 같습니다.

countryCode

string

제품 입찰 카테고리의 2자리 대문자 국가 코드입니다.

productBiddingCategoryConstantParent

string

상위 제품 입찰 카테고리의 리소스 이름입니다.

languageCode

string

제품 입찰 카테고리의 언어 코드입니다.

localizedName

string

languageCode에 따라 현지화된 제품 입찰 카테고리의 값을 표시합니다.

ProductBiddingCategoryLevel

제품 입찰 카테고리의 수준을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
LEVEL1 1단계
LEVEL2 수준 2
LEVEL3 수준 3.
LEVEL4 4단계
LEVEL5 레벨 5.

ProductBiddingCategoryStatus

제품 입찰 카테고리의 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ACTIVE 카테고리가 활성 상태이며 입찰에 사용할 수 있습니다.
OBSOLETE 카테고리가 지원 중단되었습니다. 보고 목적으로만 사용됩니다.

ProductGroupView

제품 그룹 뷰

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

string

제품 그룹 뷰의 리소스 이름입니다. 제품 그룹 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

쇼핑 실적 뷰입니다. 여러 제품 측정기준 수준에서 집계된 쇼핑 캠페인 통계를 제공합니다. 브랜드, 카테고리, 맞춤 속성, 제품 상태, 제품 유형과 같은 판매자 센터의 제품 측정기준 값은 해당 이벤트가 기록된 날짜 및 시간의 각 측정기준 상태를 반영합니다.

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

string

쇼핑 실적 뷰의 리소스 이름입니다. 쇼핑 실적 보기 리소스 이름의 형식은 customers/{customerId}/shoppingPerformanceView입니다.

UserList

사용자 목록 고객이 타겟팅할 수 있는 사용자 목록입니다.

JSON 표현
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
필드
resourceName

string

사용자 목록의 리소스 이름입니다. 사용자 목록 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

이 목록의 유형입니다.

이 필드는 읽기 전용입니다.

id

string (int64 format)

사용자 목록의 ID입니다.

name

string

이 사용자 목록의 이름입니다. access_reason에 따라 사용자 목록 이름이 고유하지 않을 수 있습니다 (예: access_reason=SHARED인 경우).

UserListType

가능한 사용자 목록 유형을 포함하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
REMARKETING 전환 유형의 집합으로 표현되는 UserList입니다.
LOGICAL 다른 사용자 목록/관심분야의 조합으로 표현되는 UserList입니다.
EXTERNAL_REMARKETING Google Ad Manager 플랫폼에서 생성된 UserList입니다.
RULE_BASED 규칙과 연결된 UserList입니다.
SIMILAR 다른 UserList의 사용자와 유사한 사용자가 포함된 UserList입니다.
CRM_BASED 광고주가 이메일 또는 기타 형식으로 제공한 퍼스트 파티 CRM 데이터의 UserList입니다.

UserLocationView

사용자 위치 뷰입니다.

사용자 위치 뷰에는 국가 수준에서 집계된 모든 측정항목이 국가당 1행씩 포함됩니다. 타겟팅 여부에 따라 사용자의 실제 위치에서 측정항목을 보고합니다. 다른 세그먼트 필드를 사용하는 경우 국가당 행이 두 개 이상 표시될 수 있습니다.

JSON 표현
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
필드
resourceName

string

사용자 위치 뷰의 리소스 이름입니다. UserLocation 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}

countryCriterionId

string (int64 format)

국가의 기준 ID입니다.

targetingLocation

boolean

위치가 타겟팅되었는지 여부를 나타냅니다.

WebpageView

웹페이지 뷰

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

string

웹페이지 뷰의 리소스 이름입니다. 웹페이지 뷰 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

방문

방문

JSON 표현
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
필드
resourceName

string

방문의 리소스 이름입니다. 방문 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

방문 ID입니다.

criterionId

string (int64 format)

Search Ads 360 키워드 ID입니다. 값이 0이면 키워드가 기여 비구분 상태임을 나타냅니다.

merchantId

string (int64 format)

클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. 사용자가 Search Ads 360에서 인벤토리 계정을 링크할 때 Search Ads 360이 이 ID를 생성합니다.

adId

string (int64 format)

광고 ID 값이 0이면 광고가 기여 비구분 상태임을 나타냅니다.

clickId

string

방문 페이지에 클릭 ID URL 매개변수로 전달되는 각 방문에 대한 고유한 문자열입니다.

visitDateTime

string

방문 이벤트의 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다.

productId

string

클릭된 제품의 ID입니다.

productChannel

enum (ProductChannel)

클릭된 제품의 영업 채널: 온라인 또는 로컬.

productLanguageCode

string

제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다.

productStoreId

string

클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다.

productCountryCode

string

클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다.

assetId

string (int64 format)

방문 이벤트 중에 상호작용한 확장 소재의 ID입니다.

assetFieldType

enum (AssetFieldType)

방문 이벤트의 애셋 필드 유형입니다.

ProductChannel

제품 혜택의 지역을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ONLINE 상품이 온라인으로 판매됩니다.
LOCAL 오프라인 상점에서 판매되는 상품입니다.

전환

전환

JSON 표현
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
필드
resourceName

string

전환의 리소스 이름입니다. 전환 리소스 이름의 형식은 다음과 같습니다.

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

전환의 ID입니다.

criterionId

string (int64 format)

Search Ads 360 기준 ID입니다. 값이 0이면 기준이 비구분 상태임을 나타냅니다.

merchantId

string (int64 format)

클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. 사용자가 Search Ads 360에서 인벤토리 계정을 링크할 때 Search Ads 360이 이 ID를 생성합니다.

adId

string (int64 format)

광고 ID 값이 0이면 광고가 기여 비구분 상태임을 나타냅니다.

clickId

string

방문 페이지에 클릭 ID URL 매개변수로 전달되며, 전환의 기인 대상이 되는 방문에 대한 고유 문자열입니다.

visitId

string (int64 format)

전환에 기여한 Search Ads 360 방문 ID입니다.

advertiserConversionId

string

오프라인 전환의 경우 광고주가 제공하는 ID입니다. 광고주가 이러한 ID를 지정하지 않으면 Search Ads 360이 ID를 생성합니다. 온라인 전환의 경우 광고주의 플러드라이트 지침에 따라 ID 열 또는 floodlightOrderId 열과 동일합니다.

productId

string

클릭된 제품의 ID입니다.

productChannel

enum (ProductChannel)

클릭된 제품의 영업 채널: 온라인 또는 로컬.

productLanguageCode

string

제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다.

productStoreId

string

클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다.

productCountryCode

string

클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다.

attributionType

enum (AttributionType)

전환 기인 대상: 방문 또는 키워드+광고.

conversionDateTime

string

전환 이벤트의 타임스탬프입니다.

conversionLastModifiedDateTime

string

전환이 마지막으로 수정된 시간의 타임스탬프입니다.

conversionVisitDateTime

string

전환의 기인 대상이 되는 방문의 타임스탬프입니다.

conversionQuantity

string (int64 format)

전환으로 기록된 항목 수입니다. 수량 URL 매개변수에 따라 결정됩니다. 광고주가 매개변수를 동적으로 채워야 하며(예: 전환에서 판매된 항목 수) 그렇지 않은 경우 기본값은 1입니다.

conversionRevenueMicros

string (int64 format)

전환 이벤트에 대해 백만 분의 1 단위로 조정된 수익입니다. 항상 광고 게재 계정의 통화로 표시됩니다.

floodlightOriginalRevenue

string (int64 format)

플러드라이트 통화 안내 수정 전 플러드라이트 이벤트와 연관된 원래의 변경되지 않은 수익입니다(현재 보고서의 통화).

floodlightOrderId

string

광고주가 전환을 위해 제공한 플러드라이트 주문 ID입니다.

status

enum (ConversionStatus)

전환 상태(사용 설정됨 또는 삭제됨)입니다.

assetId

string (int64 format)

전환 이벤트 중에 상호작용이 발생한 확장 소재의 ID입니다.

assetFieldType

enum (AssetFieldType)

전환 이벤트의 애셋 필드 유형입니다.

AttributionType

SearchAds360의 전환 기여 분석 유형

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
VISIT 전환이 방문으로 발생합니다.
CRITERION_AD 전환 기여도가 기준 및 광고 쌍에 부여됩니다.

ConversionStatus

전환의 가능한 상태입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
ENABLED 전환이 사용 설정되었습니다.
REMOVED 전환이 삭제되었습니다.

측정항목

측정항목 데이터

JSON 표현
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
필드
allConversionsValueByConversionDate

number

모든 전환의 가치입니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열의 세부정보는 https://support.google.com/sa360/answer/9250611에서 확인할 수 있습니다.

allConversionsByConversionDate

number

총 전환수입니다. 여기에는 includeInConversionsMetric의 값과 관계없이 모든 전환이 포함됩니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요.

conversionCustomMetrics[]

object (Value)

전환 맞춤 측정항목

conversionsValueByConversionDate

number

전환 날짜별로 입찰 가능 전환 가치의 합계입니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다.

conversionsByConversionDate

number

입찰 가능한 전환 유형의 전환 날짜별 전환수 합계입니다. 기여 분석 모델링으로 인해 소수점 이하로 표시될 수 있습니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다.

historicalCreativeQualityScore

enum (QualityScoreBucket)

광고 소재의 이전 품질평가점수입니다.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

이전 방문 페이지 만족도의 품질

historicalSearchPredictedCtr

enum (QualityScoreBucket)

이전 검색의 예상 클릭률 (CTR)입니다.

interactionEventTypes[]

enum (InteractionEventType)

유료 및 무료 상호작용 유형입니다.

rawEventConversionMetrics[]

object (Value)

원시 이벤트 전환 측정항목입니다.

absoluteTopImpressionPercentage

number

검색 절대 상단 노출 점유율은 가장 눈에 잘 띄는 검색 위치에 표시되는 검색 광고 노출수의 비율입니다.

allConversionsFromInteractionsRate

number

조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다.

allConversionsValue

number

모든 전환의 가치입니다.

allConversions

number

총 전환수입니다. 여기에는 includeInConversionsMetric의 값과 관계없이 모든 전환이 포함됩니다.

allConversionsValuePerCost

number

모든 전환 가치를 광고 상호작용의 총 비용(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)으로 나눈 값입니다.

allConversionsFromClickToCall

number

광고를 클릭한 후에 매장에 전화하기 위해 '통화' 버튼을 클릭한 횟수입니다. 통화 연결 여부나 통화 시간은 포함되지 않습니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromDirections

number

광고를 클릭한 후에 매장으로 이동하기 위해 '경로 검색' 버튼을 클릭한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromInteractionsValuePerInteraction

number

상호작용에서 발생한 모든 전환의 가치를 총 상호작용 수로 나눈 값입니다.

allConversionsFromMenu

number

광고를 클릭한 후에 매장의 메뉴를 보기 위해 링크를 클릭한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromOrder

number

광고를 클릭한 후에 매장에서 주문한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromOtherEngagement

number

광고를 클릭한 후에 발생한 기타 전환(예: 매장에 대한 리뷰 게시, 매장 위치 저장) 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

allConversionsFromStoreVisit

number

광고를 클릭한 후에 매장을 방문한 예상 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

visits

number

Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다.

allConversionsFromStoreWebsite

number

광고를 클릭한 후에 매장의 URL로 연결된 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

averageCost

number

상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다.

averageCpc

number

모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

averageCpm

number

평균 CPM(1,000회 노출당비용)입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

clicks

string (int64 format)

클릭수입니다.

contentBudgetLostImpressionShare

number

광고가 디스플레이 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 콘텐츠 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

contentImpressionShare

number

디스플레이 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 콘텐츠 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

contentRankLostImpressionShare

number

디스플레이 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 콘텐츠 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

conversionsFromInteractionsRate

number

전환 발생 가능 상호작용당 입찰 가능 전환의 평균 수입니다 (상호작용에서 발생). 광고 상호작용이 입찰 가능 전환으로 이어지는 평균 빈도를 나타냅니다.

clientAccountConversionsValue

number

고객 계정 전환의 가치입니다. 여기에는 includeInClientAccountConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

conversionsValuePerCost

number

입찰 가능 전환 가치를 전환 발생 가능 상호작용의 총 비용으로 나눈 값입니다.

conversionsFromInteractionsValuePerInteraction

number

상호작용에서 발생한 전환의 가치를 광고 상호작용 수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

clientAccountConversions

number

고객 계정 전환수입니다. 여기에는 includeInClientAccountConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

costMicros

string (int64 format)

일정 기간에 발생한 클릭당비용(CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

costPerAllConversions

number

광고 상호작용 비용을 모든 전환으로 나눈 값입니다.

costPerConversion

number

입찰 가능한 전환당 평균 전환 가능 비용입니다.

costPerCurrentModelAttributedConversion

number

광고 상호작용 비용을 현재 모델 기여도 전환수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

crossDeviceConversions

number

고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 allConversions에 포함되어 있습니다.

crossDeviceConversionsByConversionDate

number

전환 날짜별 교차 기기 전환수입니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요.

crossDeviceConversionsValue

number

교차 기기 전환의 가치의 합계입니다.

crossDeviceConversionsValueByConversionDate

number

전환 날짜별 교차 기기 전환 가치의 합계입니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요.

ctr

number

광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.

conversions

number

전환이 발생한 횟수 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

conversionsValue

number

'전환수' 필드에 포함된 전환에 대한 전환 가치의 합계입니다. 이 측정항목은 전환 액션의 가치를 입력한 경우에만 유용합니다.

averageQualityScore

number

평균 품질평가점수입니다.

historicalQualityScore

string (int64 format)

이전 품질평가점수입니다.

impressions

string (int64 format)

Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.

interactionRate

number

사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다.

interactions

string (int64 format)

상호작용 횟수입니다. 상호작용이란 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회 등 광고 형식과 관련된 중요한 사용자 액션을 말합니다.

invalidClickRate

number

보고 기간 동안 총 클릭수(필터링된 클릭수 + 필터링되지 않은 클릭수)에서 필터링된 클릭이 차지하는 비율입니다.

invalidClicks

string (int64 format)

Google에서 불법으로 간주하여 비용을 청구하지 않는 클릭수

generalInvalidClickRate

number

전체 클릭수 (필터링된 클릭수 + 필터링되지 않은 클릭수)에서 일반 무효 클릭으로 인해 필터링된 클릭이 차지하는 비율입니다. 이러한 클릭이란 Google에서 반복적인 필터링 (예: 알려진 무효 데이터 센터 트래픽, 봇 및 스파이더 또는 기타 크롤러, 불규칙한 패턴 등)을 통해 감지된 클릭을 불법으로 간주하는 클릭을 말합니다. 무효 클릭은 비용을 발생시키지 않으며, 계정 통계에 영향을 주지 않습니다. 자세한 내용은 https://support.google.com/campaignmanager/answer/6076504의 도움말 페이지를 참고하세요.

generalInvalidClicks

string (int64 format)

일반 무효 클릭 수입니다. '일반 무효 클릭'은 일반적인 필터링 수단 (예: 알려진 무효 데이터 센터 트래픽, 봇 및 스파이더 또는 기타 크롤러, 비정상적인 패턴 등)을 통해 감지된 무효 클릭의 하위 집합입니다. 무효 클릭은 비용을 발생시키지 않으며, 계정 통계에 영향을 주지 않습니다. 자세한 내용은 https://support.google.com/campaignmanager/answer/6076504의 도움말 페이지를 참고하세요.

mobileFriendlyClicksPercentage

number

모바일 친화적인 페이지로 연결되는 모바일 클릭의 비율입니다.

searchAbsoluteTopImpressionShare

number

가장 눈에 잘 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 또는 검색 광고 노출수의 비율입니다. 자세한 내용은 https://support.google.com/sa360/answer/9566729를 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다.

searchBudgetLostAbsoluteTopImpressionShare

number

예산 부족으로 인해 검색 결과의 상단 광고 중 첫 번째 광고로 게재되지 않은 빈도를 추정하는 숫자입니다. 참고: 검색 예산 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchBudgetLostImpressionShare

number

광고가 검색 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 검색 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchBudgetLostTopImpressionShare

number

예산 부족으로 인해 광고가 상단 자연 검색 결과에 인접하여 게재되지 않은 빈도를 추정한 값입니다. 참고: 검색 예산 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchClickShare

number

검색 네트워크에서 발생한 클릭수를 발생 가능한 것으로 예상된 최대 클릭수로 나눈 값입니다. 참고: 검색 결과 클릭 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

searchExactMatchImpressionShare

number

발생한 노출수를 키워드 검색 유형에 관계없이 키워드와 정확히 일치하거나 키워드의 유사 검색어와 검색 네트워크에서 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 일치검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

searchImpressionShare

number

검색 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

searchRankLostAbsoluteTopImpressionShare

number

광고 순위가 낮아 검색 결과의 상단 광고 중 첫 번째 광고로 게재되지 않은 빈도를 추정하는 숫자입니다. 참고: 검색 순위 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchRankLostImpressionShare

number

검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchRankLostTopImpressionShare

number

광고 순위가 낮아 광고가 상단 자연 검색 결과에 인접하여 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

searchTopImpressionShare

number

상단 광고에서 발생한 노출수를 상단 광고에서 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 상단 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

상단 광고는 일반적으로 상단 자연 검색 결과 위에 게재되지만, 일부 검색어의 경우에는 상단 자연 검색 결과 아래에 게재될 수 있습니다.

topImpressionPercentage

number

상단 자연 검색 결과에 인접하여 게재되는 광고 노출수의 비율입니다.

valuePerAllConversions

number

모든 전환의 가치를 전체 전환수로 나눈 값입니다.

valuePerAllConversionsByConversionDate

number

모든 전환의 가치를 전체 전환수로 나눈 값입니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요.

valuePerConversion

number

입찰 가능 전환 가치를 입찰 가능 전환수로 나눈 값입니다. 입찰 가능한 각 전환의 평균 가치를 보여줍니다.

valuePerConversionsByConversionDate

number

전환일별 입찰 가능 전환 가치를 전환일별 입찰 가능 전환수로 나눈 값입니다. 입찰 가능한 각 전환의 평균 가치를 전환 날짜별로 보여줍니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다.

clientAccountViewThroughConversions

string (int64 format)

총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용(예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

고객 계정 크로스셀(cross-sell) 매출원가(COGS)는 다른 제품 광고로 인해 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 매출원가는 광고되지 않은 제품의 총 비용입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 크로스셀(cross-sell) 매출원가는 5,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

crossSellCostOfGoodsSoldMicros

string (int64 format)

크로스셀(cross-sell) 매출원가(COGS)는 다른 제품 광고로 인해 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 매출원가는 광고되지 않은 제품의 총 비용입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 크로스셀 매출원가(COGS)는 5,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

clientAccountCrossSellGrossProfitMicros

string (int64 format)

고객 계정 크로스셀(cross-sell)을 통한 총 이익은 다른 제품을 광고한 결과로 판매된 제품에서 발생한 이익에서 매출원가(COGS)를 제외한 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 구매에 포함된 제품은 판매된 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통한 총이익은 광고에 기여한 크로스셀(cross-sell)에서 얻은 수익에서 매출원가를 뺀 값입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 이 셔츠의 가격은 20,000원이며 매출원가는 5000원입니다. 이 주문의 크로스셀(cross-sell)을 통한 총이익은 15,000원 = 20,000원 - 5000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

crossSellGrossProfitMicros

string (int64 format)

크로스셀(cross-sell)을 통한 총이익은 다른 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가(COGS)를 제외한 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 구매에 포함된 제품은 판매된 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통한 총이익은 광고에 기여한 크로스셀(cross-sell)에서 얻은 수익에서 매출원가를 뺀 값입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 이 셔츠의 가격은 20,000원이며 매출원가는 5000원입니다. 이 주문의 크로스셀(cross-sell)을 통한 총이익은 15,000원 = 20,000원 - 5000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

clientAccountCrossSellRevenueMicros

string (int64 format)

고객 계정 크로스셀(cross-sell) 수익은 다른 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 수익은 광고로 인해 발생한 크로스셀(cross-sell)에서 창출된 총 가치입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 크로스셀(cross-sell) 수익은 20,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

crossSellRevenueMicros

string (int64 format)

크로스셀(cross-sell) 수익은 다른 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 수익은 광고로 인해 발생한 크로스셀(cross-sell)에서 창출된 총 가치입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 크로스셀(cross-sell) 수익은 20,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

clientAccountCrossSellUnitsSold

number

고객 계정 크로스셀(cross-sell)을 통해 판매된 제품수는 다른 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통해 판매된 제품수는 광고에 기여한 모든 주문의 크로스셀(cross-sell) 제품 총 개수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 크로스셀(cross-sell)을 통해 판매된 제품수는 2개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

crossSellUnitsSold

number

크로스셀(cross-sell)을 통해 판매된 제품수는 다른 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통해 판매된 제품수는 광고에 기여한 모든 주문의 크로스셀(cross-sell) 제품 총 개수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 크로스셀(cross-sell)을 통해 판매된 제품수는 2개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

고객 계정 리드 매출원가 (COGS)는 동일한 제품을 광고한 결과로 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 상호작용된 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이러한 제품의 비용은 리드 매출원가에 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 리드 매출원가는 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

leadCostOfGoodsSoldMicros

string (int64 format)

리드 매출원가(COGS)는 동일한 제품을 광고한 결과로 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이러한 제품의 비용은 리드 매출원가에 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 리드 매출원가는 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

clientAccountLeadGrossProfitMicros

string (int64 format)

고객 계정 리드 총이익은 동일한 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가 (COGS)를 제외한 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이 판매에서 얻은 수익에서 매출원가를 뺀 금액이 리드 총이익입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원이며 매출원가는 3,000원입니다. 이 주문의 리드 총이익은 7,000원 = 10,000원 - 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

leadGrossProfitMicros

string (int64 format)

리드 총이익은 동일한 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가(COGS)를 제외한 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이 판매에서 얻은 수익에서 매출원가를 뺀 금액이 리드 총이익입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원이며 매출원가는 3,000원입니다. 이 주문의 리드 총이익은 7,000원 = 10,000원 - 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

clientAccountLeadRevenueMicros

string (int64 format)

고객 계정 리드 수익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고 제품과 판매된 제품이 일치하면 해당 제품의 판매에서 발생한 총 가치가 리드 수익에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 리드 수익은 10,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

leadRevenueMicros

string (int64 format)

리드 수익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고 제품과 판매된 제품이 일치하면 해당 제품의 판매에서 발생한 총 가치가 리드 수익에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 리드 수익은 10,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

clientAccountLeadUnitsSold

number

고객 계정 판매된 리드 단위 수는 동일한 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 판매된 제품의 총 수가 판매된 리드 단위 아래에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 판매된 리드 단위는 1개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

leadUnitsSold

number

판매된 리드 단위 수는 동일한 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 판매된 제품의 총 수가 판매된 리드 단위 아래에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 판매된 리드 단위는 1개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

일반 데이터 컨테이너입니다.

JSON 표현
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
필드
통합 필드 value. 값 value은 다음 중 하나여야 합니다.
booleanValue

boolean

불리언

int64Value

string (int64 format)

int64입니다.

floatValue

number

부동 소수점 수

doubleValue

number

double

stringValue

string

문자열.

QualityScoreBucket

가능한 품질평가점수 버킷을 나열하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
BELOW_AVERAGE 광고 소재의 품질이 평균보다 낮습니다.
AVERAGE 광고 소재의 품질이 평균입니다.
ABOVE_AVERAGE 광고 소재의 품질이 평균보다 높습니다.

InteractionEventType

유료 및 무료 상호작용의 가능한 유형을 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
CLICK 사이트를 클릭합니다. 대부분의 경우 이 상호작용은 외부 위치(일반적으로 광고주의 방문 페이지)로 이동합니다. 클릭 이벤트의 기본 InteractionEventType이기도 합니다.
ENGAGEMENT 사용자가 광고와 상호작용하겠다는 의도를 표현한 것입니다.
VIDEO_VIEW 사용자가 동영상 광고를 조회했습니다.
NONE 광고 전환 이벤트의 기본 InteractionEventType입니다. 광고 전환 행에서 무료 상호작용(예: 광고 전환)을 '프로모션'하여 핵심 측정항목의 일부로 보고해야 한다고 표시하지 않는 경우에 사용됩니다. 이는 다른 (광고) 전환에 해당합니다.

세그먼트

필드만 세그먼트

JSON 표현
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
필드
adNetworkType

enum (AdNetworkType)

광고 네트워크 유형입니다.

conversionActionCategory

enum (ConversionActionCategory)

전환 액션 카테고리입니다.

conversionCustomDimensions[]

object (Value)

전환 맞춤 측정기준입니다.

dayOfWeek

enum (DayOfWeek)

요일입니다(예: MONDAY).

device

enum (Device)

측정항목이 적용되는 기기입니다.

keyword

object (Keyword)

키워드 기준

productChannel

enum (ProductChannel)

제품의 채널입니다.

productChannelExclusivity

enum (ProductChannelExclusivity)

제품의 단일 채널 판매 여부입니다.

productCondition

enum (ProductCondition)

제품 상태입니다.

productSoldCondition

enum (ProductCondition)

판매된 제품의 상태입니다.

rawEventConversionDimensions[]

object (Value)

원시 이벤트 전환 측정기준입니다.

conversionAction

string

전환 액션의 리소스 이름입니다.

conversionActionName

string

전환 액션 이름입니다.

date

string

측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17).

geoTargetCity

string

도시를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetCountry

string

국가를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetMetro

string

대중교통을 나타내는 지역 타겟 상수의 리소스 이름입니다.

geoTargetRegion

string

지역을 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

hour

integer

시간대(0~23 사이의 숫자, 양 끝값 포함)

month

string

월의 첫 번째 날짜로 표시되는 월입니다. 형식은 yyyy-MM-dd입니다.

productBiddingCategoryLevel1

string

제품의 입찰 카테고리(수준 1)입니다.

productBiddingCategoryLevel2

string

제품의 입찰 카테고리(수준 2)입니다.

productBiddingCategoryLevel3

string

제품의 입찰 카테고리(수준 3)입니다.

productBiddingCategoryLevel4

string

제품의 입찰 카테고리(수준 4)입니다.

productBiddingCategoryLevel5

string

제품의 입찰 카테고리(수준 5)입니다.

productBrand

string

제품의 브랜드입니다.

productCountry

string

제품의 판매 국가에 대한 지역 타겟 상수의 리소스 이름입니다.

productCustomAttribute0

string

제품의 커스텀 속성 0입니다.

productCustomAttribute1

string

제품의 커스텀 속성 1입니다.

productCustomAttribute2

string

제품의 커스텀 속성 2입니다.

productCustomAttribute3

string

제품의 커스텀 속성 3입니다.

productCustomAttribute4

string

제품의 커스텀 속성 4입니다.

productItemId

string

제품의 상품 ID입니다.

productLanguage

string

제품의 언어에 대한 언어 상수의 리소스 이름입니다.

productSoldBiddingCategoryLevel1

string

판매된 제품의 입찰 카테고리 (수준 1)입니다.

productSoldBiddingCategoryLevel2

string

판매된 제품의 입찰 카테고리 (수준 2)입니다.

productSoldBiddingCategoryLevel3

string

판매된 제품의 입찰 카테고리 (수준 3)입니다.

productSoldBiddingCategoryLevel4

string

판매된 제품의 입찰 카테고리 (수준 4)입니다.

productSoldBiddingCategoryLevel5

string

판매된 제품의 입찰 카테고리 (수준 5)입니다.

productSoldBrand

string

판매된 제품의 브랜드입니다.

productSoldCustomAttribute0

string

판매된 제품의 커스텀 속성 0입니다.

productSoldCustomAttribute1

string

판매된 제품의 커스텀 속성 1입니다.

productSoldCustomAttribute2

string

판매된 제품의 커스텀 속성 2입니다.

productSoldCustomAttribute3

string

판매된 제품의 맞춤 속성 3입니다.

productSoldCustomAttribute4

string

판매된 제품의 커스텀 속성 4입니다.

productSoldItemId

string

판매된 제품의 상품 ID입니다.

productSoldTitle

string

판매된 제품의 이름입니다.

productSoldTypeL1

string

판매된 제품 유형(수준 1)입니다.

productSoldTypeL2

string

판매된 제품 유형(수준 2)입니다.

productSoldTypeL3

string

판매된 제품 유형(수준 3)입니다.

productSoldTypeL4

string

판매된 제품 유형(수준 4)입니다.

productSoldTypeL5

string

판매된 제품 유형(수준 5)입니다.

productStoreId

string

제품의 스토어 ID입니다.

productTitle

string

제품의 이름입니다.

productTypeL1

string

제품 유형(수준 1)입니다.

productTypeL2

string

제품 유형(수준 2)입니다.

productTypeL3

string

제품 유형(수준 3)입니다.

productTypeL4

string

제품 유형(수준 4)입니다.

productTypeL5

string

제품 유형(수준 5)입니다.

quarter

string

분기의 첫 번째 날짜로 표시되는 분기입니다. 분기에 대한 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식입니다.

week

string

월요일부터 일요일까지로 정의되고 월요일 날짜로 표시되는 주입니다. yyyy-MM-dd 형식입니다.

year

integer

연도(yyyy 형식)입니다.

assetInteractionTarget

object (AssetInteractionTarget)

CustomerAsset, CampaignAsset, AdGroupAsset 측정항목에만 사용됩니다. 상호작용 측정항목이 확장 소재 자체에서 발생했는지 아니면 다른 확장 소재 또는 광고 단위에서 발생했는지 나타냅니다. 상호작용(예: 클릭)은 게재된 광고의 모든 부분(예: 광고 자체 및 사이트링크와 같은 기타 구성요소)에서 함께 게재될 때 집계됩니다. interactionOnThisAsset이 true이면 이 특정 확장 소재에서 상호작용이 발생한 것이고 interactionOnThisAsset이 false이면 이 특정 확장 소재가 아닌 이 확장 소재와 함께 게재된 광고의 다른 부분에서 상호작용이 발생한 것입니다.

AdNetworkType

Google Ads 네트워크 유형을 열거합니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 이 버전에서는 값을 알 수 없습니다.
SEARCH Google 검색
SEARCH_PARTNERS 검색 파트너
CONTENT (디스플레이 네트워크용)
YOUTUBE_WATCH YouTube 동영상
MIXED 교차 네트워크

키워드

키워드 기준 세그먼트입니다.

JSON 표현
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
필드
info

object (KeywordInfo)

키워드 정보

adGroupCriterion

string

AdGroupCriterion 리소스 이름입니다.

ProductChannelExclusivity

제품 혜택의 사용 가능 여부를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
SINGLE_CHANNEL ProductChannel에 표시된 대로 오프라인 매장 또는 온라인 중 하나의 채널을 통해서만 판매되는 상품입니다.
MULTI_CHANNEL 상품이 온라인 또는 오프라인 매장 제품과 일치하며, 이는 두 ShoppingProductChannels에서 모두 구매할 수 있음을 나타냅니다.

ProductCondition

제품 혜택의 상태를 설명하는 열거형입니다.

열거형
UNSPECIFIED 지정되지 않음
UNKNOWN 반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다.
OLD 제품 상태가 오래되었습니다.
NEW 제품 상태가 새 제품입니다.
REFURBISHED 제품 상태가 리퍼입니다.
USED 제품 상태가 사용됩니다.

AssetInteractionTarget

AssetInteractionTarget 세그먼트입니다.

JSON 표현
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
필드
asset

string

애셋 리소스 이름입니다.

interactionOnThisAsset

boolean

CustomerAsset, CampaignAsset, AdGroupAsset 측정항목에만 사용됩니다. 상호작용 측정항목이 확장 소재 자체에서 발생했는지 아니면 다른 확장 소재 또는 광고 단위에서 발생했는지 나타냅니다.