- JSON 표현
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- 광고
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdEffectiveLabel
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- 기기
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionEffectiveLabel
- AdGroupCriterionLabel
- AdGroupEffectiveLabel
- AdGroupLabel
- AgeRangeView
- 애셋
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- 캠페인
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignEffectiveLabel
- CampaignLabel
- CartDataSalesView
- 시청자층
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- 고객
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- 라벨
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- UserLocationView
- WebpageView
- 방문
- ProductChannel
- 전환
- AttributionType
- ConversionStatus
- 측정항목
- Value
- QualityScoreBucket
- InteractionEventType
- 세그먼트
- AdNetworkType
- 키워드
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
쿼리에서 반환된 행입니다.
JSON 표현 |
---|
{ "adGroup": { object ( |
필드 | |
---|---|
ad |
쿼리에서 참조된 광고 그룹입니다. |
ad |
쿼리에서 참조된 광고입니다. |
ad |
쿼리에서 참조된 광고 그룹 광고 효과 라벨입니다. |
ad |
쿼리에서 참조된 광고 그룹 광고 라벨입니다. |
ad |
쿼리에서 참조된 광고 그룹 확장 소재입니다. |
ad |
쿼리에서 참조된 광고 그룹 애셋 세트입니다. |
ad |
쿼리에서 참조된 광고 그룹 잠재고객 보기입니다. |
ad |
쿼리에서 참조된 입찰가 조정입니다. |
ad |
쿼리에서 참조되는 기준입니다. |
ad |
쿼리에서 참조된 광고그룹 기준 유효 라벨입니다. |
ad |
쿼리에서 참조된 광고 그룹 기준 라벨입니다. |
ad |
쿼리에서 참조된 광고 그룹 유효 라벨입니다. |
ad |
쿼리에서 참조된 광고 그룹 라벨입니다. |
age |
쿼리에서 참조된 연령대 뷰입니다. |
asset |
쿼리에서 참조된 애셋입니다. |
asset |
쿼리에서 참조된 애셋 그룹 애셋입니다. |
asset |
쿼리에서 참조된 애셋 그룹 신호입니다. |
asset |
쿼리에서 참조된 애셋 그룹 등록정보 그룹 필터입니다. |
asset |
쿼리에서 참조된 애셋 그룹 상위 조합 보기입니다. |
asset |
쿼리에서 참조된 애셋 그룹입니다. |
asset |
쿼리에서 참조된 애셋 세트 애셋입니다. |
asset |
쿼리에서 참조된 애셋 세트입니다. |
bidding |
쿼리에서 참조된 입찰 전략입니다. |
campaign |
쿼리에서 참조된 캠페인 예산입니다. |
campaign |
쿼리에서 참조된 캠페인입니다. |
campaign |
쿼리에서 참조된 캠페인 애셋입니다. |
campaign |
쿼리에서 참조된 캠페인 확장 소재 조합입니다. |
campaign |
쿼리에서 참조된 캠페인 잠재고객 뷰입니다. |
campaign |
쿼리에서 참조된 캠페인 기준입니다. |
campaign |
쿼리에서 참조된 캠페인 효과 라벨입니다. |
campaign |
쿼리에서 참조된 캠페인 라벨입니다. |
cart |
쿼리에서 참조된 장바구니 데이터 판매 뷰입니다. |
audience |
쿼리에서 참조된 잠재고객입니다. |
conversion |
쿼리에서 참조된 전환 액션입니다. |
conversion |
쿼리에서 참조된 전환 맞춤 변수입니다. |
customer |
쿼리에서 참조된 고객입니다. |
customer |
쿼리에서 참조된 고객 애셋입니다. |
customer |
쿼리에서 참조된 고객 애셋 세트입니다. |
accessible |
쿼리에서 참조된 액세스 가능한 입찰 전략입니다. |
customer |
쿼리에서 참조된 CustomerManagerLink입니다. |
customer |
쿼리에서 참조된 CustomerClient입니다. |
dynamic |
쿼리에서 참조된 동적 검색 광고 검색어 보기입니다. |
gender |
쿼리에서 참조된 성별 보기입니다. |
geo |
쿼리에서 참조된 지역 타겟 상수입니다. |
keyword |
쿼리에서 참조된 키워드 뷰입니다. |
label |
쿼리에서 참조된 라벨입니다. |
language |
쿼리에서 참조된 언어 상수입니다. |
location |
쿼리에서 참조된 위치 뷰입니다. |
product |
쿼리에서 참조된 제품 입찰 카테고리입니다. |
product |
쿼리에서 참조된 제품 그룹 뷰입니다. |
shopping |
쿼리에서 참조된 쇼핑 실적 보기입니다. |
user |
쿼리에서 참조된 사용자 목록입니다. |
user |
쿼리에서 참조된 사용자 위치 뷰입니다. |
webpage |
쿼리에서 참조된 웹페이지 뷰입니다. |
visit |
쿼리에서 참조된 이벤트 수준 방문입니다. |
conversion |
쿼리에서 참조된 이벤트 수준 전환입니다. |
metrics |
측정항목 |
segments |
세그먼트 |
custom |
맞춤 열 |
광고그룹
광고 그룹
JSON 표현 |
---|
{ "resourceName": string, "status": enum ( |
필드 | |
---|---|
resource |
광고 그룹의 리소스 이름입니다. 광고 그룹 리소스 이름의 형식은 다음과 같습니다.
|
status |
광고 그룹의 상태입니다. |
type |
광고 그룹의 유형입니다. |
ad |
광고 그룹의 광고 로테이션 모드입니다. |
creation |
이 adGroup이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
targeting |
타겟팅 관련 기능의 설정입니다. |
labels[] |
이 광고 그룹에 연결된 라벨의 리소스 이름입니다. |
effective |
이 광고그룹에 연결된 유효 라벨의 리소스 이름입니다. 효과적인 라벨은 이 광고 그룹에 상속되거나 직접 할당된 라벨입니다. |
engine |
외부 엔진 계정의 광고 그룹 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "adGroup.id"를 사용하세요. |
start |
이 광고 그룹에서 광고 게재를 시작하는 날짜입니다. 기본적으로 광고 그룹은 지금 또는 광고 그룹의 시작일 중에서 늦은 날짜에 시작합니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 시작될 때 광고 그룹이 시작됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다. 형식: YYYY-MM-DD(예: 2019-03-14) |
end |
광고 그룹의 광고 게재가 종료되는 날짜입니다. 기본적으로 광고 그룹은 광고 그룹의 종료일에 종료됩니다. 이 필드를 설정하면 고객의 시간대로 지정된 날짜가 끝날 때 광고 그룹이 종료됩니다. 이 필드는 Microsoft Advertising 및 Facebook 게이트웨이 계정에만 사용할 수 있습니다. 형식: YYYY-MM-DD(예: 2019-03-14) |
language |
광고 그룹에서 광고 및 키워드의 언어입니다. 이 필드는 Microsoft Advertising 계정에만 사용할 수 있습니다. 자세한 내용: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last |
이 광고 그룹이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
id |
광고 그룹의 ID입니다. |
name |
광고 그룹의 이름입니다. 이 필드는 필수이며 새 광고 그룹을 만들 때 비어 있지 않아야 합니다. 255자 미만의 UTF-8 전체 너비 문자를 포함해야 합니다. null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다. |
cpc |
최대 CPC(클릭당비용) 입찰가입니다. |
engine |
광고그룹의 엔진 상태입니다. |
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 ( |
필드 | |
---|---|
target |
캠페인 또는 광고 그룹의 범위를 제한하기 위한 타겟팅별 측정기준 설정입니다. |
TargetRestriction
타겟팅 측정기준별 타겟팅 설정 목록입니다.
JSON 표현 |
---|
{
"targetingDimension": enum ( |
필드 | |
---|---|
targeting |
이 설정이 적용되는 타겟팅 측정기준입니다. |
bid |
이 타겟팅 측정기준에 대해 선택한 기준에 대해서만 광고가 게재되도록 제한할지, 이 타겟팅 측정기준의 모든 값을 타겟팅하고 다른 타겟팅 측정기준의 타겟팅을 기반으로 광고를 표시할지 여부를 나타냅니다. 값이 |
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 ( |
필드 | |
---|---|
resource |
광고의 리소스 이름입니다. 광고 그룹 광고 리소스 이름의 형식은 다음과 같습니다.
|
status |
광고의 상태입니다. |
ad |
광고 |
creation |
이 adGroupAd가 생성된 타임스탬프입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
labels[] |
이 광고 그룹 광고에 연결된 라벨의 리소스 이름입니다. |
effective |
이 광고에 연결된 유효 라벨의 리소스 이름입니다. 효과적인 라벨은 이 광고에 상속되거나 직접 할당된 라벨입니다. |
engine |
외부 엔진 계정의 광고 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Search Ads 360 계정에만 사용됩니다. Search Ads 360 이외의 항목의 경우 대신 "adGroupAd.ad.id"를 사용하세요. |
engine |
외부 엔진 계정에 있는 광고의 추가 상태입니다. 외부 계정 유형에 따라 가능한 상태는 활성, 적격, 검토 대기중 등입니다. |
last |
이 광고 그룹 광고가 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
AdGroupAdStatus
AdGroupAd의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정된 값이 없습니다. |
UNKNOWN |
수신된 값을 이 버전에서 알 수 없습니다. 응답 전용 값입니다. |
ENABLED |
광고 그룹 광고가 사용 설정됩니다. |
PAUSED |
광고 그룹 광고가 일시중지됩니다. |
REMOVED |
광고 그룹 광고가 삭제됩니다. |
광고
광고
JSON 표현 |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
필드 | |
---|---|
resource |
광고의 리소스 이름입니다. 광고 리소스 이름의 형식은 다음과 같습니다.
|
final |
광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. |
type |
광고의 유형입니다. |
id |
광고의 ID입니다. |
display |
일부 광고 형식의 광고 설명에 표시되는 URL입니다. |
name |
광고의 이름입니다. 이 이름은 광고를 식별하는 데만 사용됩니다. 이름은 고유하지 않아도 되며 게재되는 광고에 영향을 주지 않습니다. 이름 필드는 현재 DisplayUploadAd, ImageAd, ShoppingComparisonListingAd, VideoAd에 대해서만 지원됩니다. |
통합 필드 ad_data . 광고 유형과 관련된 세부정보입니다. 값을 정확히 하나만 설정해야 합니다. ad_data 은 다음 중 하나여야 합니다. |
|
text |
텍스트 광고와 관련된 세부정보입니다. |
expanded |
확장 텍스트 광고와 관련된 세부정보입니다. |
responsive |
반응형 검색 광고와 관련된 세부정보입니다. |
product |
제품 광고와 관련된 세부정보입니다. |
expanded |
확장 동적 검색 광고와 관련된 세부정보입니다. |
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 |
디스커버리 멀티 애셋 광고 |
DISCOVERY_CAROUSEL_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 |
광고의 제목입니다. |
description1 |
광고 설명의 첫 번째 줄입니다. |
description2 |
광고 설명의 두 번째 줄입니다. |
display |
광고의 표시 URL입니다. |
display |
광고의 표시된 모바일 URL입니다. |
ad |
광고의 추적 ID입니다. |
SearchAds360ExpandedTextAdInfo
Search Ads 360 확장 텍스트 광고
JSON 표현 |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
필드 | |
---|---|
headline |
광고의 제목입니다. |
headline2 |
광고의 두 번째 제목입니다. |
headline3 |
광고의 세 번째 제목입니다. |
description1 |
광고 설명의 첫 번째 줄입니다. |
description2 |
광고 설명의 두 번째 줄입니다. |
path1 |
자동 생성된 표시 URL에 구분 기호와 함께 추가된 텍스트입니다. |
path2 |
path1에 구분자가 추가된 텍스트입니다. |
ad |
광고의 추적 ID입니다. |
SearchAds360ResponsiveSearchAdInfo
Search Ads 360의 반응형 검색 광고
JSON 표현 |
---|
{ "headlines": [ { object ( |
필드 | |
---|---|
headlines[] |
광고 제목의 텍스트 애셋 목록입니다. 광고가 게재되면 광고 제목이 이 목록에서 선택됩니다. |
descriptions[] |
설명용 텍스트 애셋 목록입니다. 광고가 게재되면 이 목록에서 설명이 선택됩니다. |
path1 |
자동 생성된 표시 URL에 구분 기호와 함께 추가된 텍스트입니다. |
path2 |
path1에 구분자가 추가된 텍스트입니다. |
ad |
광고의 추적 ID입니다. |
AdTextAsset
광고 내에 사용되는 텍스트 애셋입니다.
JSON 표현 |
---|
{ "text": string } |
필드 | |
---|---|
text |
애셋 텍스트 |
SearchAds360ProductAdInfo
이 유형에는 필드가 없습니다.
Search Ads 360 제품 광고
SearchAds360ExpandedDynamicSearchAdInfo
확장 동적 검색 광고
JSON 표현 |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
필드 | |
---|---|
description1 |
광고 설명의 첫 번째 줄입니다. |
description2 |
광고 설명의 두 번째 줄입니다. |
ad |
광고의 추적 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 } |
필드 | |
---|---|
resource |
광고 그룹 광고 효과 라벨의 리소스 이름입니다. 광고 그룹 광고 효과 라벨 리소스 이름은 |
ad |
효과적인 라벨이 연결된 광고 그룹 광고입니다. |
label |
광고 그룹 광고에 할당된 유효 라벨입니다. |
owner |
효과적인 라벨을 소유한 고객의 ID입니다. |
AdGroupAdLabel
광고 그룹 광고와 라벨 간의 관계입니다.
JSON 표현 |
---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
필드 | |
---|---|
resource |
광고 그룹 광고 라벨의 리소스 이름입니다. 광고 그룹 광고 라벨 리소스 이름의 형식은 다음과 같습니다. |
ad |
라벨이 연결된 광고 그룹 광고입니다. |
label |
광고 그룹 광고에 할당된 라벨입니다. |
owner |
라벨을 소유한 고객의 ID입니다. |
AdGroupAsset
광고 그룹과 확장 소재 간의 연결입니다.
JSON 표현 |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
필드 | |
---|---|
resource |
광고 그룹 확장 소재의 리소스 이름입니다. AdGroupAsset 리소스 이름의 형식은 다음과 같습니다.
|
ad |
필수 항목입니다. 애셋이 연결된 광고 그룹입니다. |
asset |
필수 항목입니다. 광고 그룹에 연결된 애셋입니다. |
status |
광고 그룹 확장 소재의 상태입니다. |
AssetLinkStatus
저작물 링크의 상태를 설명하는 enum입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
ENABLED |
확장 소재 링크가 사용 설정되었습니다. |
REMOVED |
저작물 링크가 삭제되었습니다. |
PAUSED |
확장 소재 연결이 일시중지되었습니다. |
AdGroupAssetSet
AdGroupAssetSet는 광고그룹과 애셋 집합 간의 연결입니다. AdGroupAssetSet를 생성하면 애셋 세트가 광고그룹과 연결됩니다.
JSON 표현 |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
필드 | |
---|---|
resource |
광고 그룹 애셋 세트의 리소스 이름입니다. 광고 그룹 확장 소재 세트 리소스 이름은 다음과 같은 형식입니다.
|
ad |
이 애셋 집합이 연결된 광고 그룹입니다. |
asset |
광고 그룹에 연결된 애셋 집합입니다. |
status |
광고 그룹 확장 소재 세트의 상태입니다. 읽기 전용입니다. |
AssetSetLinkStatus
애셋 세트와 컨테이너 간 연결의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
상태가 지정되지 않았습니다. |
UNKNOWN |
이 버전에서는 수신된 값을 알 수 없습니다. 응답 전용 값입니다. |
ENABLED |
애셋 세트와 해당 컨테이너 간의 연결이 사용 설정되었습니다. |
REMOVED |
애셋 세트와 컨테이너 간의 연결이 삭제됩니다. |
AdGroupAudienceView
광고 그룹 잠재고객 보기 디스플레이 네트워크 및 YouTube 네트워크 광고의 관심분야 및 리마케팅 목록, 검색 광고용 리마케팅 목록(RLSA)의 실적 데이터를 잠재고객 수준으로 집계한 데이터입니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
광고 그룹 잠재고객 뷰의 리소스 이름입니다. 광고그룹 잠재고객 보기 리소스 이름의 형식은 다음과 같습니다.
|
AdGroupBidModifier
광고 그룹 입찰가 조정을 나타냅니다.
JSON 표현 |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
필드 | |
---|---|
resource |
광고그룹 입찰가 조정의 리소스 이름입니다. 광고 그룹 입찰가 조정 리소스 이름의 형식은 다음과 같습니다.
|
bid |
기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 선호 콘텐츠의 경우 범위는 1.0~6.0입니다. 기기 유형을 선택 해제하려면 0을 사용합니다. |
통합 필드 V5부터 생성 작업에 필요합니다. |
|
device |
기기 기준입니다. |
DeviceInfo
기기 기준입니다.
JSON 표현 |
---|
{
"type": enum ( |
필드 | |
---|---|
type |
기기 유형입니다. |
기기
타겟팅할 수 있는 Google Ads 기기를 열거합니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
이 버전에서 알 수 없는 값입니다. |
MOBILE |
풀브라우저가 있는 휴대기기 |
TABLET |
풀브라우징 기능이 있는 태블릿 |
DESKTOP |
컴퓨터 |
CONNECTED_TV |
스마트 TV 및 게임 콘솔 |
OTHER |
기타 기기 유형 |
AdGroupCriterion
광고그룹 기준 adGroup기준 보고서는 광고그룹에 명시적으로 추가된 기준만 반환합니다.
JSON 표현 |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
필드 | |
---|---|
resource |
광고그룹 기준의 리소스 이름입니다. 광고 그룹 기준 리소스 이름의 형식은 다음과 같습니다.
|
creation |
이 광고 그룹 기준이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
status |
기준의 상태입니다. 고객이 설정한 광고 그룹 기준 항목의 상태입니다. 참고: UI 보고서에는 기준 실행 가능 여부에 영향을 미치는 추가 정보가 포함될 수 있습니다. 일부 경우에는 API에서 삭제된 기준이 UI에 계속 사용 설정된 것으로 표시될 수 있습니다. 예를 들어 기본적으로 캠페인은 제외되지 않는 한 모든 연령의 사용자에게 표시됩니다. 광고 게재가 가능하기 때문에 UI에 연령 범위가 "사용 설정됨"으로 표시되지만 긍정적 기준이 추가되지 않았기 때문에 AdGroupCriterion.status에 "삭제됨"으로 표시됩니다. |
quality |
기준의 품질에 관한 정보입니다. |
type |
기준의 유형입니다. |
labels[] |
이 광고 그룹 기준에 연결된 라벨의 리소스 이름입니다. |
effective |
이 광고 그룹 기준에 연결된 유효 라벨의 리소스 이름입니다. 효과적인 라벨은 이 광고 그룹 기준에 상속되거나 직접 할당된 라벨입니다. |
position |
다양한 게재순위에서의 기준 입찰가 견적입니다. |
final |
광고의 모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. |
engine |
외부 엔진 계정의 광고그룹 기준 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "adGroupCriterion.criterion_id"를 사용하세요. |
last |
이 광고 그룹 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
criterion |
기준의 ID입니다. |
ad |
기준이 속한 광고 그룹입니다. |
negative |
기준을 타겟팅( 이 필드는 변경할 수 없습니다. 기준을 포함에서 음수로 전환하려면 삭제한 다음 다시 추가하세요. |
bid |
기준이 일치할 때의 입찰가의 한정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. |
cpc |
CPC(클릭당비용) 입찰가입니다. |
effective |
유효 CPC(클릭당비용) 입찰가입니다. |
engine |
광고 그룹 기준의 엔진 상태입니다. |
final |
최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다. |
tracking |
추적 URL을 만들기 위한 URL 템플릿입니다. |
통합 필드 정확히 하나만 설정해야 합니다. |
|
keyword |
키워드 |
listing |
등록정보 그룹 |
age |
연령대입니다. |
gender |
성별 |
user |
사용자 목록 |
webpage |
웹페이지 |
location |
위치를 탭합니다. |
AdGroupCriterionStatus
AdGroupCriterion의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정된 값이 없습니다. |
UNKNOWN |
수신된 값을 이 버전에서 알 수 없습니다. 응답 전용 값입니다. |
ENABLED |
광고그룹 기준이 사용 설정되어 있습니다. |
PAUSED |
광고그룹 기준이 일시중지됩니다. |
REMOVED |
광고그룹 기준이 삭제됩니다. |
QualityInfo
광고 그룹 기준 품질 정보를 위한 컨테이너입니다.
JSON 표현 |
---|
{ "qualityScore": integer } |
필드 | |
---|---|
quality |
품질평가점수입니다. 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 } |
필드 | |
---|---|
top |
검색 결과 첫 페이지 상단에 광고를 게재하는 데 필요한 CPC 입찰가의 예상치입니다. |
AdGroupCriterionEngineStatus
AdGroupCriterion 엔진 상태를 열거합니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
AD_GROUP_CRITERION_ELIGIBLE |
지원 중단되었습니다. 사용하지 마세요. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: 입찰가 또는 품질이 너무 낮아서 표시할 수 없습니다. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: 모바일에서는 입찰가 또는 품질이 너무 낮지만 데스크톱에는 표시할 수 있습니다. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: 입찰가 또는 품질이 데스크톱에 대해서는 너무 낮지만, 모바일에 대해서는 표시할 수 있음 |
AD_GROUP_CRITERION_INVALID_SEARCH |
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 ( |
필드 | |
---|---|
match |
키워드의 일치 유형입니다. |
text |
키워드의 텍스트입니다(최대 80자 및 10개 단어). |
KeywordMatchType
가능한 키워드 검색 유형
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
EXACT |
일치검색 |
PHRASE |
구문검색 |
BROAD |
확장검색 |
ListingGroupInfo
등록정보 그룹 기준
JSON 표현 |
---|
{
"type": enum ( |
필드 | |
---|---|
type |
목록 그룹의 유형입니다. |
ListingGroupType
등록정보 그룹의 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
SUBDIVISION |
일부 등록정보 측정기준을 기준으로 제품을 세분화합니다. 이러한 노드는 등록정보 항목을 타겟팅하는 데 사용되지 않으며 순전히 트리 구조를 정의하는 데 사용됩니다. |
UNIT |
입찰가를 정의하는 등록정보 그룹 단위입니다. |
AgeRangeInfo
연령대 기준입니다.
JSON 표현 |
---|
{
"type": enum ( |
필드 | |
---|---|
type |
연령대의 유형입니다. |
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 ( |
필드 | |
---|---|
type |
성별 유형입니다. |
GenderType
인구통계적 성별 유형입니다 (예: 여성).
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
MALE |
남성입니다. |
FEMALE |
여성입니다. |
UNDETERMINED |
성별이 확인되지 않았습니다. |
UserListInfo
사용자 목록 기준입니다. 광고주가 타겟팅하도록 정의한 사용자 목록을 나타냅니다.
JSON 표현 |
---|
{ "userList": string } |
필드 | |
---|---|
user |
사용자 목록 리소스 이름입니다. |
WebpageInfo
광고주 웹사이트의 웹페이지를 타겟팅하기 위한 기준을 나타냅니다.
JSON 표현 |
---|
{
"conditions": [
{
object ( |
필드 | |
---|---|
conditions[] |
웹페이지 타겟팅을 위한 조건 또는 논리 표현식입니다. 웹페이지 타겟팅 조건 목록은 타겟팅 평가 시 함께 AND로 연결됩니다. 빈 조건 목록은 캠페인 웹사이트의 모든 페이지가 타겟팅되었음을 나타냅니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
coverage |
웹사이트 기준 노출 범위 비율입니다. 광고 그룹 및 캠페인에서 웹사이트 대상, 제외 웹사이트 대상, 제외 키워드를 기반으로 계산된 웹사이트 노출 범위 비율입니다. 예를 들어 노출 범위가 1로 반환되었으면 노출 범위가 100%입니다. 이 필드는 읽기 전용입니다. |
criterion |
이 매개변수로 정의된 기준의 이름입니다. 이름 값은 이 유형의 매개변수로 기준을 식별, 정렬, 필터링하는 데 사용됩니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
WebpageConditionInfo
광고주 웹사이트의 웹페이지를 타겟팅하기 위한 논리적 표현식입니다.
JSON 표현 |
---|
{ "operand": enum ( |
필드 | |
---|---|
operand |
웹페이지 타겟팅 조건의 피연산자입니다. |
operator |
웹페이지 타겟팅 조건의 연산자입니다. |
argument |
웹페이지 타겟팅 조건의 인수입니다. |
WebpageConditionOperand
웹페이지 기준의 웹페이지 조건 피연산자입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
URL |
웹페이지 URL 타겟팅 조건을 나타내는 피연산자입니다. |
CATEGORY |
웹페이지 카테고리 타겟팅 조건을 나타내는 피연산자입니다. |
PAGE_TITLE |
웹페이지 제목 타겟팅 조건을 나타내는 피연산자입니다. |
PAGE_CONTENT |
웹페이지 콘텐츠 타겟팅 조건을 나타내는 피연산자입니다. |
CUSTOM_LABEL |
웹페이지 맞춤 라벨 타겟팅 조건을 나타내는 피연산자입니다. |
WebpageConditionOperator
웹페이지 기준의 웹페이지 조건 연산자입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
EQUALS |
인수 웹 조건이 비교된 웹 조건과 같습니다. |
CONTAINS |
인수 웹 조건은 비교된 웹 조건의 일부입니다. |
LocationInfo
위치 기준입니다.
JSON 표현 |
---|
{ "geoTargetConstant": string } |
필드 | |
---|---|
geo |
지역 대상 상수 리소스 이름입니다. |
AdGroupCriterionEffectiveLabel
광고 그룹 기준과 효과적인 라벨 간의 관계입니다. 효과적인 라벨은 이 광고 그룹 기준에 상속되거나 직접 할당된 라벨입니다.
JSON 표현 |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
필드 | |
---|---|
resource |
광고 그룹 기준 효과 라벨의 리소스 이름입니다. 광고그룹 기준 유효 라벨 리소스 이름의 형식은 |
ad |
효과적인 라벨이 연결된 광고 그룹 기준입니다. |
label |
광고 그룹 기준에 할당된 유효 라벨입니다. |
owner |
효과적인 라벨을 소유한 고객의 ID입니다. |
AdGroupCriterionLabel
광고 그룹 기준과 라벨 간의 관계입니다.
JSON 표현 |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
필드 | |
---|---|
resource |
광고 그룹 기준 라벨의 리소스 이름입니다. 광고 그룹 기준 라벨 리소스 이름의 형식은 |
ad |
라벨이 연결된 광고 그룹 기준입니다. |
label |
광고 그룹 기준에 할당된 라벨입니다. |
owner |
라벨을 소유한 고객의 ID입니다. |
AdGroupEffectiveLabel
광고 그룹과 효과적인 라벨 간의 관계입니다. 효과적인 라벨은 이 광고 그룹에 상속되거나 직접 할당된 라벨입니다.
JSON 표현 |
---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
필드 | |
---|---|
resource |
광고그룹 유효 라벨의 리소스 이름입니다. 광고 그룹 효과적인 라벨 리소스 이름의 형식은 다음과 같습니다. |
ad |
유효 라벨이 첨부된 광고그룹입니다. |
label |
광고 그룹에 할당된 유효 라벨입니다. |
owner |
효과적인 라벨을 소유한 고객의 ID입니다. |
AdGroupLabel
광고 그룹과 라벨 간의 관계입니다.
JSON 표현 |
---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
필드 | |
---|---|
resource |
광고그룹 라벨의 리소스 이름입니다. 광고 그룹 라벨 리소스 이름의 형식은 |
ad |
라벨이 연결된 광고 그룹입니다. |
label |
광고 그룹에 할당된 라벨입니다. |
owner |
라벨을 소유한 고객의 ID입니다. |
AgeRangeView
연령대 뷰입니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
연령대 뷰의 리소스 이름입니다. 연령대 보기 리소스 이름은 다음과 같은 형식입니다.
|
확장 소재
확장 소재는 광고의 일부로 여러 광고에서 공유할 수 있습니다. 이미지 (ImageAsset), 동영상 (YoutubeVideoAsset) 등이 될 수 있습니다. 애셋은 변경 불가능하며 삭제할 수 없습니다. 애셋의 게재를 중지하려면 애셋을 사용하는 항목에서 애셋을 삭제합니다.
JSON 표현 |
---|
{ "resourceName": string, "type": enum ( |
필드 | |
---|---|
resource |
애셋의 리소스 이름입니다. 애셋 리소스 이름은 다음과 같은 형식입니다.
|
type |
확장 소재 유형입니다. |
final |
모든 교차 도메인 리디렉션 이후에 가능한 최종 URL 목록입니다. |
status |
애셋의 상태입니다. |
creation |
이 애셋이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
last |
이 애셋이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
id |
저작물의 ID입니다. |
name |
애셋의 이름입니다(선택사항). |
tracking |
추적 URL을 만들기 위한 URL 템플릿입니다. |
engine |
저작물의 엔진 상태입니다. |
통합 필드 asset_data . 저작물의 특정 유형입니다. asset_data 은 다음 중 하나여야 합니다. |
|
youtube |
YouTube 동영상 애셋 |
image |
이미지 확장 소재 |
text |
텍스트 애셋입니다. |
callout |
통합 콜아웃 확장 소재 |
sitelink |
통합된 사이트링크 확장 소재 |
page |
통합된 페이지 피드 애셋 |
mobile |
모바일 앱 확장 소재 |
call |
통합된 전화번호 확장 소재입니다. |
call |
클릭 유도 문구 애셋 |
location |
통합 위치 확장 소재입니다. |
AssetType
가능한 확장 소재 유형을 설명하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
YOUTUBE_VIDEO |
YouTube 동영상 애셋 |
MEDIA_BUNDLE |
미디어 번들 애셋 |
IMAGE |
이미지 확장 소재 |
TEXT |
텍스트 애셋 |
LEAD_FORM |
리드 양식 확장 소재 |
BOOK_ON_GOOGLE |
Google에서 예약 애셋 |
PROMOTION |
프로모션 확장 소재 |
CALLOUT |
콜아웃 확장 소재 |
STRUCTURED_SNIPPET |
구조화된 스니펫 확장 소재 |
SITELINK |
사이트링크 확장 소재 |
PAGE_FEED |
페이지 피드 확장 소재 |
DYNAMIC_EDUCATION |
동적 교육 확장 소재 |
MOBILE_APP |
모바일 앱 확장 소재 |
HOTEL_CALLOUT |
호텔 콜아웃 확장 소재 |
CALL |
전화번호 확장 소재 |
PRICE |
가격 확장 소재 |
CALL_TO_ACTION |
클릭 유도 문구 애셋입니다. |
DYNAMIC_REAL_ESTATE |
동적 부동산 애셋입니다. |
DYNAMIC_CUSTOM |
동적 맞춤 애셋입니다. |
DYNAMIC_HOTELS_AND_RENTALS |
동적 호텔 및 공유숙박 애셋 |
DYNAMIC_FLIGHTS |
동적 항공편 애셋 |
DISCOVERY_CAROUSEL_CARD |
디스커버리 캐러셀 카드 애셋 |
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 } |
필드 | |
---|---|
youtube |
YouTube 동영상 제목 |
youtube |
YouTube 동영상 ID YouTube 동영상 URL에 사용되는 11자리 문자열 값입니다. |
ImageAsset
이미지 확장 소재입니다.
JSON 표현 |
---|
{ "mimeType": enum ( |
필드 | |
---|---|
mime |
이미지 확장 소재의 MIME 유형입니다. |
full |
이 이미지의 메타데이터(원본 크기)입니다. |
file |
이미지 애셋의 파일 크기(바이트)입니다. |
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 } |
필드 | |
---|---|
height |
이미지의 높이입니다. |
width |
이미지의 너비입니다. |
url |
이 높이와 너비로 이미지를 반환하는 URL입니다. |
TextAsset
텍스트 애셋입니다.
JSON 표현 |
---|
{ "text": string } |
필드 | |
---|---|
text |
텍스트 애셋의 텍스트 콘텐츠입니다. |
UnifiedCalloutAsset
통합 콜아웃 확장 소재
JSON 표현 |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
필드 | |
---|---|
callout |
콜아웃 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함). |
start |
이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일입니다(yyyy-MM-dd 형식). |
end |
이 확장 소재가 유효하고 계속 게재되는 마지막 날짜(yyyy-MM-dd 형식)입니다. |
ad |
저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개(총 42개)의 일정을 설정할 수 있습니다. |
use |
검색 사용자의 시간대에 확장 소재를 표시할지 여부입니다. Microsoft Ads에 적용됩니다. |
AdScheduleInfo
AdSchedule 기준을 나타냅니다.
AdSchedule은 요일 및 광고가 표시될 시간 간격으로 지정됩니다.
동일한 날짜에 AdSchedules를 6개 이하로 추가할 수 있습니다.
JSON 표현 |
---|
{ "startMinute": enum ( |
필드 | |
---|---|
start |
일정이 시작되는 시작 시간(분) 후의 시간입니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
end |
일정이 종료되는 종료 시간 이후의 시간(분)입니다. 일정은 종료 시간(분)을 제외합니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
day |
일정이 적용되는 요일입니다. 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
start |
24시간 형식의 시작 시간입니다. 이 필드는 0~23 사이여야 합니다(양 끝값 포함). 이 필드는 CREATE 작업에 필요하고 UPDATE 작업에서는 금지됩니다. |
end |
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 ( |
필드 | |
---|---|
link |
사이트링크의 URL 표시 텍스트입니다. 이 문자열의 길이는 1~25 사이여야 합니다(1 및 25 포함). |
description1 |
사이트링크 설명의 첫 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description2도 설정해야 합니다. |
description2 |
사이트링크 설명의 두 번째 줄입니다. 설정된 경우 길이가 1~35 사이여야 하고(1 및 35 포함) description1도 설정해야 합니다. |
start |
이 확장 소재가 유효하고 게재를 시작할 수 있는 시작일입니다(yyyy-MM-dd 형식). |
end |
이 확장 소재가 유효하고 계속 게재되는 마지막 날짜(yyyy-MM-dd 형식)입니다. |
ad |
저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개(총 42개)의 일정을 설정할 수 있습니다. |
tracking |
사이트링크 확장 소재의 클릭을 추적하는 데 사용되는 ID입니다. Yahoo! 일본만 해당하는 입력란입니다. |
use |
검색 사용자의 시간대에 사이트링크 확장 소재를 표시할지 여부입니다. Microsoft Advertising에 적용됩니다. |
mobile |
사이트링크 확장 소재가 휴대기기에 표시되도록 설정되어 있는지 여부입니다. Microsoft Advertising에 적용됩니다. |
UnifiedPageFeedAsset
통합 페이지 피드 애셋입니다.
JSON 표현 |
---|
{ "pageUrl": string, "labels": [ string ] } |
필드 | |
---|---|
page |
광고주가 타겟팅하려는 웹페이지입니다. |
labels[] |
페이지 URL을 그룹화하는 데 사용되는 라벨입니다. |
MobileAppAsset
모바일 앱을 나타내는 확장 소재입니다.
JSON 표현 |
---|
{
"appId": string,
"appStore": enum ( |
필드 | |
---|---|
app |
필수 항목입니다. 모바일 애플리케이션을 고유하게 식별하는 문자열입니다. Android의 경우 'com.android.ebay', iOS의 경우 '12345689'와 같이 플랫폼 네이티브 ID만 포함해야 합니다. |
app |
필수 항목입니다. 이 특정 앱을 배포하는 애플리케이션 스토어입니다. |
MobileAppVendor
모바일 앱 공급업체 유형
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
APPLE_APP_STORE |
Apple App Store의 모바일 앱 공급업체입니다. |
GOOGLE_APP_STORE |
Google 앱 스토어의 모바일 앱 공급업체입니다. |
UnifiedCallAsset
통합된 전화번호 확장 소재입니다.
JSON 표현 |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
필드 | |
---|---|
country |
전화번호의 두 자리 국가 코드입니다. 예: 'US', 'us'. |
phone |
광고주의 원시 전화번호입니다. 예: '1234567890', '(123)456-7890' |
call |
이 CallAsset이 자체 통화 전환 설정을 사용해야 하는지, 계정 수준 설정을 따라야 하는지 또는 통화 전환을 사용 중지해야 하는지를 나타냅니다. |
call |
통화 전환에 대한 기여도를 부여할 전환 액션입니다. 설정하지 않으면 기본 전환 액션이 사용됩니다. 이 필드는 callConversionReportingState가 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION으로 설정된 경우에만 적용됩니다. |
ad |
저작물이 게재될 수 있는 모든 시간 간격을 지정하는 겹치지 않는 일정의 목록입니다. 하루에 최대 6개의 일정(총 42개)을 만들 수 있습니다. |
call |
통화 시 웹사이트 링크 없이 전화번호만 표시할지 여부입니다. Microsoft Advertising에 적용됩니다. |
call |
통화 추적에서 통화를 사용 설정할지 여부입니다. Microsoft Ads에 적용됩니다. |
use |
검색 사용자의 시간대에 통화 확장 프로그램을 표시할지 여부입니다. Microsoft Advertising에 적용됩니다. |
start |
이 확장 소재가 적용되고 게재를 시작할 수 있는 yyyy-MM-dd 형식의 시작일입니다. |
end |
이 확장 소재가 유효하고 게재 중인 마지막 날짜로 yyyy-MM-dd 형식입니다. |
CallConversionReportingState
통화 전환 액션 상태의 가능한 데이터 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
DISABLED |
통화 전환 액션이 사용 중지되었습니다. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
통화 전환 액션은 계정 수준에서 설정된 통화 전환 유형을 사용합니다. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
통화 전환 액션은 리소스 (통화 전용 광고/전화번호 광고 확장) 수준에서 설정된 통화 전환 유형을 사용합니다. |
CallToActionAsset
클릭 유도 문구 애셋
JSON 표현 |
---|
{
"callToAction": enum ( |
필드 | |
---|---|
call |
클릭 유도 문구 |
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 ( |
필드 | |
---|---|
place |
장소 ID는 Google 지역 정보 데이터베이스 및 Google 지도에 있는 장소를 고유하게 나타냅니다. 이 필드는 특정 고객 ID 및 애셋 유형에 고유합니다. 장소 ID에 대한 자세한 내용은 https://developers.google.com/places/web-service/place-id를 참고하세요. |
business |
고객의 비즈니스 위치 목록입니다. 위치 확장 소재가 비즈니스 프로필 계정에서 동기화되는 경우에만 반환됩니다. 동일한 계정 아래에 동일한 장소 ID를 가리키는 비즈니스 프로필 등록정보가 여러 개 있을 수 있습니다. |
location |
위치 소유권 유형입니다. 유형이 BUSINESS_OWNER인 경우 위치 광고 확장으로 게재됩니다. 유형이 AFFILIATE인 경우 제휴사 위치로 게재됩니다. |
BusinessProfileLocation
연결된 비즈니스 프로필 계정에서 동기화된 비즈니스 프로필 위치 데이터
JSON 표현 |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
필드 | |
---|---|
labels[] |
광고주가 비즈니스 프로필 계정의 위치에 지정한 라벨입니다. 비즈니스 프로필 계정에서 동기화됩니다. |
store |
이 위치의 비즈니스 프로필 판매점 코드입니다. 비즈니스 프로필 계정에서 동기화됩니다. |
listing |
이 비즈니스 프로필 위치의 등록정보 ID입니다. 연결된 비즈니스 프로필 계정에서 동기화됩니다. |
LocationOwnershipType
가능한 위치 소유권 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
BUSINESS_OWNER |
위치의 비즈니스 소유자(기존 위치 광고 확장 - LE)입니다. |
AFFILIATE |
제휴사 위치(서드 파티 위치 광고 확장 - ALE) |
AssetGroupAsset
AssetGroupAsset은 애셋과 애셋 그룹 간의 링크입니다. AssetGroupAsset을 추가하면 애셋이 애셋 그룹과 연결됩니다.
JSON 표현 |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
필드 | |
---|---|
resource |
애셋 그룹 애셋의 리소스 이름입니다. 애셋 그룹 애셋 리소스 이름의 형식은 다음과 같습니다.
|
asset |
이 애셋 그룹 확장 소재가 연결된 애셋 그룹입니다. |
asset |
애셋 그룹 애셋이 연결되는 애셋입니다. |
field |
애셋 그룹 내 애셋의 게재위치에 관한 설명입니다. 예: HEADLINE, YOUTUBE_VIDEO 등 |
status |
애셋과 애셋 그룹 간의 연결 상태입니다. |
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 |
확장 소재가 구조화된 스니펫 광고 확장으로 사용되도록 연결됩니다. |
SITELINK |
확장 소재가 사이트링크로 사용하기 위해 연결되어 있습니다. |
MOBILE_APP |
모바일 앱 광고 확장으로 사용할 수 있도록 확장 소재가 연결되어 있습니다. |
HOTEL_CALLOUT |
호텔 콜아웃 광고 확장으로 사용하기 위해 확장 소재가 연결됩니다. |
CALL |
전화번호 광고 확장 소재로 사용하기 위해 저작물이 연결됩니다. |
PRICE |
확장 소재가 가격 광고 확장으로 사용되도록 연결됩니다. |
LONG_HEADLINE |
확장 소재가 긴 광고 제목으로 사용되도록 연결됩니다. |
BUSINESS_NAME |
비즈니스 이름으로 사용하기 위해 저작물이 연결됩니다. |
SQUARE_MARKETING_IMAGE |
정사각형 마케팅 이미지로 사용하기 위해 확장 소재가 연결되어 있습니다. |
PORTRAIT_MARKETING_IMAGE |
세로 방향 마케팅 이미지로 사용하기 위해 확장 소재가 연결됩니다. |
LOGO |
로고로 사용하기 위해 저작물이 연결되어 있습니다. |
LANDSCAPE_LOGO |
확장 소재가 가로 모드 로고로 사용하도록 연결되어 있습니다. |
VIDEO |
저작물이 YouTube 이외의 로고로 사용하기 위해 연결되어 있습니다. |
CALL_TO_ACTION_SELECTION |
클릭 유도 문구를 선택하는 데 사용할 수 있도록 확장 소재가 연결되어 있습니다. |
AD_IMAGE |
광고 이미지를 선택하는 데 사용할 수 있도록 애셋이 연결됩니다. |
BUSINESS_LOGO |
비즈니스 로고로 사용하기 위해 애셋이 연결되어 있습니다. |
HOTEL_PROPERTY |
애셋이 여행 목표 달성을 위한 실적 최대화 캠페인에서 호텔 숙박 시설로 사용되도록 연결됩니다. |
DISCOVERY_CAROUSEL_CARD |
디스커버리 캐러셀 카드로 사용하기 위해 애셋이 연결됩니다. |
AssetGroupSignal
AssetGroupSignal은 애셋 그룹의 신호를 나타냅니다. 신호가 있으면 실적 최대화 캠페인에 전환 가능성이 높은 사용자가 누구인지 알려줍니다. 실적 최대화 캠페인에서는 검색, 디스플레이, 동영상 전체에서 전환 기회를 찾기 위해 신호를 사용하여 비슷한 수준 혹은 더 강한 의도를 가진 신규 사용자를 파악합니다.
JSON 표현 |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
필드 | |
---|---|
resource |
애셋 그룹 신호의 리소스 이름입니다. 애셋 그룹 신호 리소스 이름의 형식은 다음과 같습니다.
|
asset |
이 애셋 그룹 신호가 속한 애셋 그룹입니다. |
통합 필드 signal . 애셋 그룹의 신호입니다. signal 은 다음 중 하나여야 합니다. |
|
audience |
실적 최대화 캠페인에서 사용할 잠재고객 신호입니다. |
AudienceInfo
잠재고객 기준
JSON 표현 |
---|
{ "audience": string } |
필드 | |
---|---|
audience |
잠재고객 리소스 이름입니다. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter는 애셋 그룹의 등록정보 그룹 필터 트리 노드를 나타냅니다.
JSON 표현 |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
필드 | |
---|---|
resource |
애셋 그룹 등록정보 그룹 필터의 리소스 이름입니다. 애셋 그룹 등록정보 그룹 필터 리소스 이름의 형식은 다음과 같습니다.
|
asset |
이 애셋 그룹 등록정보 그룹 필터가 속한 애셋 그룹입니다. |
id |
ListingGroupFilter의 ID입니다. |
type |
등록정보 그룹 필터 노드의 유형입니다. |
vertical |
현재 노드 트리가 나타내는 카테고리입니다. 동일한 트리의 모든 노드는 동일한 카테고리에 속해야 합니다. |
case |
이 등록정보 그룹에서 상위 요소를 세분화하는 측정기준 값입니다. 루트 그룹에는 정의되지 않습니다. |
parent |
상위 등록정보 그룹 하위 그룹의 리소스 이름입니다. 루트 등록정보 그룹 필터 노드의 경우 null입니다. |
path |
이 등록정보 그룹 필터를 정의하는 측정기준의 경로입니다. |
ListingGroupFilterType
등록정보 그룹 필터의 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
SUBDIVISION |
일부 등록정보 측정기준에 따라 제품을 세분화합니다. |
UNIT_INCLUDED |
포함된 등록정보 그룹 필터 리프 노드입니다. |
UNIT_EXCLUDED |
제외된 등록정보 그룹 필터 리프 노드입니다. |
ListingGroupFilterVertical
등록정보 그룹 필터 카테고리의 유형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
SHOPPING |
쇼핑 카테고리를 나타냅니다. 이 카테고리는 소매업체용 실적 최대화 캠페인에서만 사용할 수 있습니다. |
ListingGroupFilterDimension
애셋 그룹 등록정보 그룹 필터의 등록정보 측정기준입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 dimension . 아래 유형 중 하나의 측정기준은 항상 표시됩니다. dimension 은 다음 중 하나여야 합니다. |
|
product |
제품 입찰의 입찰 카테고리입니다. |
product |
제품 혜택의 브랜드입니다. |
product |
제품 혜택의 지역입니다. |
product |
제품 혜택의 상태입니다. |
product |
제품 혜택의 맞춤 속성입니다. |
product |
제품의 상품 ID입니다. |
product |
제품 제공 유형입니다. |
ProductBiddingCategory
특정 수준의 입찰 카테고리의 요소입니다. 최상위 카테고리는 1단계, 하위 카테고리는 2단계로 표시됩니다. 현재 최대 5단계까지 지원됩니다. 사용자는 카테고리 수준을 나타내는 측정기준 유형을 지정해야 합니다. 동일한 하위 그룹의 모든 케이스는 측정기준 유형(카테고리 수준)이 동일해야 합니다.
JSON 표현 |
---|
{
"level": enum ( |
필드 | |
---|---|
level |
분류의 카테고리 수준을 나타냅니다. |
id |
제품 입찰 카테고리의 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 |
제품 브랜드의 문자열 값입니다. |
ProductChannel
제품 혜택의 지역입니다.
JSON 표현 |
---|
{
"channel": enum ( |
필드 | |
---|---|
channel |
지역 값입니다. |
ListingGroupFilterProductChannel
제품 혜택의 지역을 설명하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
ONLINE |
상품이 온라인으로 판매됩니다. |
LOCAL |
상품이 오프라인 매장에서 판매됩니다. |
ProductCondition
제품의 상태입니다.
JSON 표현 |
---|
{
"condition": enum ( |
필드 | |
---|---|
condition |
조건의 값입니다. |
ListingGroupFilterProductCondition
제품 혜택의 상태를 설명하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
NEW |
제품 상태가 새 제품입니다. |
REFURBISHED |
제품 상태가 리퍼입니다. |
USED |
제품 상태가 '중고'입니다. |
ProductCustomAttribute
제품 혜택의 맞춤 속성입니다.
JSON 표현 |
---|
{
"index": enum ( |
필드 | |
---|---|
index |
맞춤 속성의 색인을 나타냅니다. |
value |
제품 맞춤 속성의 문자열 값입니다. |
ListingGroupFilterCustomAttributeIndex
고객 속성의 색인입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
INDEX0 |
첫 번째 등록정보 그룹 필터 맞춤 속성입니다. |
INDEX1 |
두 번째 등록정보 그룹 필터 맞춤 속성 |
INDEX2 |
세 번째 등록정보 그룹 필터 맞춤 속성입니다. |
INDEX3 |
네 번째 등록정보 그룹 필터 맞춤 속성입니다. |
INDEX4 |
다섯 번째 등록정보 그룹 필터 맞춤 속성 |
ProductItemId
제품 혜택의 상품 ID입니다.
JSON 표현 |
---|
{ "value": string } |
필드 | |
---|---|
value |
ID 값입니다. |
ProductType
제품 혜택 유형입니다.
JSON 표현 |
---|
{
"level": enum ( |
필드 | |
---|---|
level |
유형의 수준입니다. |
value |
유형의 값입니다. |
ListingGroupFilterProductTypeLevel
제품 오퍼 유형의 수준을 설명하는 enum입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
LEVEL1 |
1단계 |
LEVEL2 |
수준 2 |
LEVEL3 |
수준 3. |
LEVEL4 |
4단계 |
LEVEL5 |
5단계 |
ListingGroupFilterDimensionPath
등록정보 그룹 필터를 정의하는 측정기준을 정의하는 경로입니다.
JSON 표현 |
---|
{
"dimensions": [
{
object ( |
필드 | |
---|---|
dimensions[] |
등록정보 그룹 필터 계층 구조(루트 노드 제외)를 통과하여 이 등록정보 그룹 필터로 이어지는 측정기준의 전체 경로입니다. |
AssetGroupTopCombinationView
광고 그룹 광고 애셋 조합의 사용에 대한 보기입니다.
JSON 표현 |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
필드 | |
---|---|
resource |
애셋 그룹 상단 조합 뷰의 리소스 이름입니다. AssetGroup Top Combination 뷰 리소스 이름의 형식은 `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"입니다. |
asset |
함께 게재된 확장 소재의 주요 조합입니다. |
AssetGroupAssetCombinationData
애셋 그룹 애셋 조합 데이터
JSON 표현 |
---|
{
"assetCombinationServedAssets": [
{
object ( |
필드 | |
---|---|
asset |
게재된 애셋 |
AssetUsage
애셋의 사용 정보를 포함합니다.
JSON 표현 |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
필드 | |
---|---|
asset |
저작물의 리소스 이름입니다. |
served |
애셋의 게재된 필드 유형입니다. |
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 |
이 저작물은 세로 방향 마케팅 이미지로 사용되었습니다. |
LOGO |
애셋이 로고로 사용되었습니다. |
LANDSCAPE_LOGO |
애셋이 가로 모드 로고로 사용되었습니다. |
CALL_TO_ACTION |
저작물이 클릭 유도 문구로 사용되었습니다. |
YOU_TUBE_VIDEO |
저작물이 YouTube 동영상으로 사용되었습니다. |
SITELINK |
이 확장 소재는 사이트링크로 사용됩니다. |
CALL |
이 확장 소재는 호출로 사용됩니다. |
MOBILE_APP |
이 확장 소재는 모바일 앱으로 사용됩니다. |
CALLOUT |
이 확장 소재는 콜아웃으로 사용됩니다. |
STRUCTURED_SNIPPET |
이 확장 소재는 구조화된 스니펫으로 사용됩니다. |
PRICE |
이 확장 소재는 가격으로 사용됩니다. |
PROMOTION |
이 확장 소재는 프로모션으로 사용됩니다. |
AD_IMAGE |
이 확장 소재는 이미지로 사용됩니다. |
LEAD_FORM |
확장 소재가 리드 양식으로 사용됩니다. |
BUSINESS_LOGO |
확장 소재가 비즈니스 로고로 사용됩니다. |
AssetGroup
애셋 그룹입니다. AssetGroupAsset은 애셋을 애셋 그룹에 연결하는 데 사용됩니다. AssetGroupSignal은 신호를 애셋 그룹에 연결하는 데 사용됩니다.
JSON 표현 |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
필드 | |
---|---|
resource |
애셋 그룹의 리소스 이름입니다. 애셋 그룹 리소스 이름의 형식은 다음과 같습니다.
|
id |
애셋 그룹의 ID입니다. |
campaign |
이 애셋 그룹이 연결된 캠페인입니다. 애셋 그룹에 연결된 애셋입니다. |
name |
필수 항목입니다. 애셋 그룹의 이름입니다. 필수 항목입니다. 길이는 1~128자(영문 기준)여야 합니다. 캠페인 내에서 고유해야 합니다. |
final |
모든 교차 도메인 리디렉션 이후의 최종 URL 목록입니다. 실적 최대화 캠페인에서는 기본적으로 선택 해제하지 않는 한 URL을 확장할 수 있습니다. |
final |
모든 교차 도메인 리디렉션 후 최종 모바일 URL의 목록입니다. 실적 최대화 캠페인에서는 기본적으로 URL을 선택 해제하지 않는 한 확장할 수 있습니다. |
status |
애셋 그룹의 상태입니다. |
path1 |
광고에 표시되는 URL에 추가될 수 있는 텍스트의 첫 부분입니다. |
path2 |
광고에 표시되는 URL에 추가되어 표시될 수 있는 텍스트의 두 번째 부분입니다. 이 필드는 path1이 설정된 경우에만 설정할 수 있습니다. |
ad |
이 애셋 그룹의 전반적인 광고 효력입니다. |
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 ( |
필드 | |
---|---|
resource |
애셋 세트 저작물의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.
|
asset |
이 애셋 집합이 연결된 애셋 집합입니다. |
asset |
이 애셋 집합이 연결된 애셋입니다. |
status |
저작물 세트 저작물의 상태입니다. 읽기 전용입니다. |
AssetSetAssetStatus
애셋 세트 애셋의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
상태가 지정되지 않았습니다. |
UNKNOWN |
이 버전에서는 수신된 값을 알 수 없습니다. 응답 전용 값입니다. |
ENABLED |
애셋 집합 확장 소재가 사용 설정되어 있습니다. |
REMOVED |
애셋 집합 애셋이 삭제됩니다. |
AssetSet
애셋 모음을 나타내는 애셋 세트입니다. AssetSetAsset을 사용하여 애셋을 애셋 집합에 연결합니다.
JSON 표현 |
---|
{ "id": string, "resourceName": string } |
필드 | |
---|---|
id |
저작물 집합의 ID입니다. |
resource |
애셋 세트의 리소스 이름입니다. 애셋 세트 리소스 이름의 형식은 다음과 같습니다.
|
BiddingStrategy
입찰 전략
JSON 표현 |
---|
{ "resourceName": string, "status": enum ( |
필드 | |
---|---|
resource |
입찰 전략의 리소스 이름입니다. 입찰 전략 리소스 이름은 다음과 같은 형식입니다.
|
status |
입찰 전략의 상태입니다. 이 필드는 읽기 전용입니다. |
type |
입찰 전략의 유형입니다. 입찰 스킴을 설정하여 입찰 전략을 만듭니다. 이 필드는 읽기 전용입니다. |
currency |
입찰 전략에 사용되는 통화입니다 (ISO 4217 3자리 코드). 관리자 고객의 입찰 전략의 경우 이 통화는 생성 시 설정할 수 있으며 기본적으로 관리자 고객의 통화로 설정됩니다. 제공 고객의 경우 이 필드를 설정할 수 없습니다. 제공 중인 고객의 모든 전략은 암시적으로 제공 고객의 통화를 사용합니다. 모든 경우에 effectiveCurrencyCode 필드는 전략에서 사용한 통화를 반환합니다. |
id |
입찰 전략의 ID입니다. |
name |
입찰 전략의 이름입니다. 한 계정 내의 모든 입찰 전략은 이름이 고유해야 합니다. 이 문자열의 길이는 UTF-8 바이트 단위(공백 삭제)로 1~255 사이(1 및 255 포함)여야 합니다. |
effective |
입찰 전략에서 사용하는 통화(ISO 4217 3자리 코드)입니다. 관리자 고객의 입찰 전략의 경우 광고주가 전략을 만들 때 설정한 통화입니다. 고객에게 제품 또는 서비스를 제공하는 경우 고객의 numberCode입니다. 입찰 전략 측정항목은 이 통화로 보고됩니다. 이 필드는 읽기 전용입니다. |
campaign |
이 입찰 전략에 연결된 캠페인의 수입니다. 이 필드는 읽기 전용입니다. |
non |
이 입찰 전략에 연결된 삭제되지 않은 캠페인 수입니다. 이 필드는 읽기 전용입니다. |
통합 필드 하나만 설정할 수 있습니다. |
|
enhanced |
전환으로 이어질 가능성이 큰 클릭의 입찰가를 높이고 전환으로 이어질 가능성이 작은 클릭의 입찰가를 낮추는 입찰 전략입니다. |
maximize |
예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다. |
maximize |
캠페인에서 예산이 지출될 때 최대한 많은 전환이 발생하도록 설정하는 자동 입찰 전략입니다. |
target |
타겟 CPA는 설정된 타겟 전환당비용(CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다. |
target |
선택한 비율에 맞춰 자동으로 최적화하는 입찰 전략입니다. |
target |
광고주가 특정 경쟁업체보다 높은 순위를 얻어야 하는 입찰 타겟 비율에 따라 입찰가를 설정하는 입찰 전략입니다. 이 필드는 지원 중단되었습니다. 이 필드로 새 입찰 전략을 만들거나 이 필드가 있는 입찰 전략을 캠페인에 연결하면 실패합니다. 이 스키마가 이미 채워진 전략을 변경할 수 있습니다. |
target |
특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 입찰 전략입니다. |
target |
예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다. |
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 } |
필드 | |
---|---|
cpc |
입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다. |
cpc |
입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다. |
target |
타겟 광고 투자수익(ROAS) 옵션 타겟 광고 투자수익(ROAS)을 설정하면 입찰 전략에서 수익을 극대화하면서 타겟 광고 투자수익(ROAS)을 평균화합니다. 타겟 ROAS가 높으면 입찰 전략에서 전체 예산을 지출하지 못할 수 있습니다. 타겟 ROAS를 설정하지 않으면 입찰 전략은 예산에 대해 최대한 높은 ROAS를 달성하는 것을 목표로 합니다. |
MaximizeConversions
캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
필드 | |
---|---|
cpc |
입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다. |
cpc |
입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에 대해서만 변경 가능합니다. |
target |
타겟 전환당비용(CPA) 옵션 입찰 전략의 통화 단위로 지정된 전환 액션당 지출하고자 하는 평균 금액입니다. 타겟 CPA를 설정하면 입찰 전략에서 타겟 전환당비용 이하로 최대한 많은 전환을 얻습니다. 타겟 CPA를 설정하지 않으면 입찰 전략은 예산을 고려하여 가능한 한 낮은 CPA를 달성하는 것을 목표로 합니다. |
TargetCpa
설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
필드 | |
---|---|
target |
평균 CPA 타겟입니다. 이 타겟은 계정의 통화를 기준으로 최소 청구 가능 단위보다 크거나 같아야 합니다. |
cpc |
입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다. |
cpc |
입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다. |
TargetRoas
특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
필드 | |
---|---|
target |
필수 항목입니다. 지출 단위당 선택한 수익(전환 데이터 기준)입니다. 값은 0.01~1000.0 사이여야 합니다(0.01 및 1000.0 포함). |
cpc |
입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다. |
cpc |
입찰 전략으로 설정할 수 있는 최소 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. 포트폴리오 입찰 전략에만 설정해야 합니다. |
TargetSpend
예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
필드 | |
---|---|
targetSpendMicros |
지원 중단됨: 클릭수를 최대화하기 위한 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. 자세한 내용은 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html을 참고하세요. |
cpc |
입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. |
CampaignBudget
캠페인 예산입니다.
JSON 표현 |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
필드 | |
---|---|
resource |
캠페인 예산의 리소스 이름입니다. 캠페인 예산 리소스 이름은 다음과 같은 형식입니다.
|
delivery |
캠페인 예산의 소비율을 결정하는 게재 방법입니다. 만들기 작업에서 지정되지 않은 경우 기본적으로 STANDARD입니다. |
period |
예산을 지출할 기간입니다. 지정하지 않으면 기본적으로 DAILY입니다. |
amount |
예산 금액(계정의 현지 통화)입니다. 금액은 마이크로 단위로 지정되며, 100만은 통화 단위 1에 해당합니다. 월별 지출은 이 금액의 30.4배로 제한됩니다. |
BudgetDeliveryMethod
가능한 예산 지출 방법입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
STANDARD |
예산 서버는 전체 기간에 걸쳐 게재를 균등하게 제한합니다. |
ACCELERATED |
예산 서버가 게재를 제한하지 않으며 광고가 최대한 빠르게 게재됩니다. |
BudgetPeriod
가능한 예산 기간입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
DAILY |
일일예산: |
FIXED_DAILY |
고정 일일 예산 |
CUSTOM_PERIOD |
맞춤 예산을 total_amount와 함께 사용하여 전체 예산 한도를 지정할 수 있습니다. |
캠페인
캠페인
JSON 표현 |
---|
{ "resourceName": string, "status": enum ( |
필드 | |
---|---|
resource |
캠페인의 리소스 이름입니다. 캠페인 리소스 이름의 형식은 다음과 같습니다.
|
status |
캠페인의 상태입니다. 새 캠페인을 추가하면 상태가 기본적으로 ENABLED로 설정됩니다. |
serving |
캠페인의 광고 게재 상태입니다. |
bidding |
캠페인 입찰 전략의 시스템 상태입니다. |
ad |
캠페인의 광고 게재 최적화 상태입니다. |
advertising |
캠페인 내 광고의 기본 게재 타겟입니다. 타겟팅 옵션은 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. 캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다. |
advertising |
캠페인을 만들 때만 설정할 수 있습니다. 캠페인을 만든 후에는 필드를 변경할 수 없습니다. |
url |
|
real |
실시간 입찰 설정으로, Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있습니다. |
network |
캠페인의 네트워크 설정입니다. |
dynamic |
동적 검색 광고(DSA)를 제어하기 위한 설정입니다. |
shopping |
쇼핑 캠페인을 관리하기 위한 설정입니다. |
geo |
광고 지역 타겟팅 설정입니다. |
effective |
이 캠페인에 연결된 유효 라벨의 리소스 이름입니다. 유효 라벨은 이 캠페인에 상속되거나 직접 할당된 라벨입니다. |
labels[] |
이 캠페인에 연결된 라벨의 리소스 이름입니다. |
bidding |
입찰 전략의 유형입니다. 입찰 스킴을 설정해서 표준 입찰 전략을 만들거나 이 필드는 읽기 전용입니다. |
accessible |
'biddingStrategy'로 식별된 연결된 포트폴리오 입찰 전략의 제한되지 않은 속성의 읽기 전용 뷰인 AccessibleBiddingStrategy의 리소스 이름입니다. 캠페인에서 포트폴리오 전략을 사용하지 않는 경우 비워 둡니다. 제한되지 않은 전략 속성은 전략이 공유된 모든 고객이 사용할 수 있으며 AccessibleBiddingStrategy 리소스에서 읽을 수 있습니다. 반면 제한된 속성은 전략의 소유자 고객 및 해당 고객의 관리자만 사용할 수 있습니다. 제한된 속성은 입찰전략 리소스에서만 읽을 수 있습니다. |
frequency |
각 사용자에게 이 캠페인의 광고가 게재되는 빈도를 제한하는 목록입니다. |
selective |
이 캠페인의 선택적 최적화 설정으로, 캠페인 최적화의 기준이 되는 전환 액션 집합이 포함됩니다. 이 기능은 MULTI_CHANNEL을 AdvertisingChannelType으로, APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT을 AdvertisingChannelSubType로 사용하는 앱 캠페인에만 적용됩니다. |
optimization |
이 캠페인의 최적화 목표 설정으로, 최적화 목표 유형 집합이 포함됩니다. |
tracking |
추적 정보에 대한 캠페인 수준 설정 |
engine |
외부 엔진 계정의 캠페인 ID입니다. 이 필드는 Yahoo Japan, Microsoft, Baidu 등의 Google Ads 이외의 계정에만 사용됩니다. Google Ads 항목의 경우 "campaign.id"를 사용하세요. |
excluded |
이 캠페인에서 제외해야 하는 확장 소재 필드 유형입니다. 이러한 필드 유형의 애셋 링크는 이 캠페인이 상위 수준에서 상속되지 않습니다. |
create |
이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss' 형식입니다. v1에서는 createTime이 지원 중단됩니다. 대신 creationTime을 사용하세요. |
creation |
이 캠페인이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
last |
이 캠페인이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
id |
캠페인의 ID입니다. |
name |
캠페인의 이름입니다. 이 필드는 필수 항목이며 새 캠페인을 만들 때 비워두지 않아야 합니다. null(코드 포인트 0x0), NL 라인 피드(코드 포인트 0xA), 캐리지 리턴(코드 포인트 0xD) 문자는 포함하지 않아야 합니다. |
tracking |
추적 URL을 만들기 위한 URL 템플릿입니다. |
campaign |
캠페인 예산의 리소스 이름입니다. |
start |
YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인이 시작된 날입니다. |
end |
YYYY-MM-DD 형식의 게재 고객의 시간대로 캠페인 마지막 날입니다. 생성 시 기본값은 2037-12-30입니다. 즉, 캠페인이 무기한 실행됩니다. 기존 캠페인이 무한정 운영되도록 설정하려면 이 필드를 2037-12-30으로 설정하세요. |
final |
병렬 추적으로 게재되는 방문 페이지에 쿼리 매개변수를 추가하는 데 사용되는 접미사입니다. |
url |
더 많은 타겟팅 URL로의 URL 확장을 선택 해제했음을 나타냅니다. 선택 해제된 경우(true) 애셋 그룹의 최종 URL 또는 광고주의 Google 판매자 센터 또는 비즈니스 데이터 피드에 지정된 URL만 타겟팅됩니다. 선택한 경우(false) 전체 도메인이 타겟팅됩니다. 이 필드는 실적 최대화 캠페인에 대해서만 설정할 수 있으며 기본값은 false입니다. |
통합 필드 (BidStrategy 서비스를 통해 생성된 포트폴리오) 또는 캠페인에 삽입된 표준이어야 합니다. |
|
bidding |
캠페인에서 사용하는 포트폴리오 입찰 전략의 리소스 이름입니다. |
manual |
표준 수동 CPA 입찰 전략 광고주가 광고주 지정 액션별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다. 지역 서비스 캠페인에만 지원됩니다. |
manual |
표준 수동 CPC 입찰 전략 사용자가 클릭당 비용을 지불하는 수동 클릭 기반 입찰입니다. |
manual |
표준 수동 CPM 입찰 전략 사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다. |
maximize |
예산을 지출하면서 전환수를 자동으로 최대화하는 표준 전환수 최대화 입찰 전략입니다. |
maximize |
예산을 지출하면서 수익을 극대화하도록 입찰가를 자동으로 설정하는 표준 전환 가치 극대화 입찰 전략입니다. |
target |
설정된 타겟 CPA로 전환수를 최대한 늘릴 수 있도록 입찰가를 자동으로 설정하는 표준 타겟 CPA 입찰 전략입니다. |
target |
타겟 노출 점유율 입찰 전략 선택한 노출 비율을 달성하도록 입찰가를 설정하는 자동 입찰 전략입니다. |
target |
특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 자동으로 극대화하는 표준 타겟 ROAS 입찰 전략입니다. |
target |
예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 자동으로 설정하는 표준 타겟 지출 입찰 전략입니다. |
percent |
입찰가가 특정 상품 또는 서비스의 광고된 가격의 일부인 표준 비율 CPC 입찰 전략입니다. |
target |
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 |
매개변수 태그 이름과 일치하는 키입니다. |
value |
대체할 값입니다. |
RealTimeBiddingSetting
실시간 입찰 설정: Ad Exchange 네트워크를 타겟팅하는 캠페인에서만 사용할 수 있는 기능입니다.
JSON 표현 |
---|
{ "optIn": boolean } |
필드 | |
---|---|
opt |
캠페인에서 실시간 입찰을 선택했는지 여부입니다. |
NetworkSettings
캠페인의 네트워크 설정입니다.
JSON 표현 |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
필드 | |
---|---|
target |
광고를 google.com 검색 결과에 게재할지 여부입니다. |
target |
광고가 Google 검색 네트워크의 파트너 사이트에 게재되는지 여부입니다( |
target |
광고가 Google 디스플레이 네트워크의 지정된 게재위치에 게재되는지 여부입니다. 게재위치는 게재위치 기준을 사용하여 지정됩니다. |
target |
광고가 Google 파트너 네트워크에 게재되는지 여부입니다. 이 기능은 일부 Google 파트너 계정에서만 사용할 수 있습니다. |
DynamicSearchAdsSetting
동적 검색 광고(DSA)를 제어하기 위한 설정입니다.
JSON 표현 |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
필드 | |
---|---|
domain |
필수 항목입니다. 이 설정이 나타내는 인터넷 도메인 이름입니다(예: 'google.com' 또는 'www.google.com'). |
language |
필수 항목입니다. 도메인의 언어를 지정하는 언어 코드입니다(예: 'en'). |
use |
캠페인이 광고주 제공 URL만 사용하는지 여부입니다. |
ShoppingSetting
쇼핑 캠페인의 설정입니다. 캠페인에서 광고할 수 있는 제품 범위와 이 캠페인이 다른 쇼핑 캠페인과 상호작용하는 방식을 정의합니다.
JSON 표현 |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
필드 | |
---|---|
feed |
캠페인에 포함할 제품의 피드 라벨입니다. feedLabel 또는 salesCountry 중 하나만 설정할 수 있습니다. salesCountry 대신 사용되는 경우 feedLabel 필드에는 'XX'와 같은 형식의 국가 코드가 포함됩니다. 그 외의 경우 Google 판매자 센터의 피드 라벨에 사용되는 문자열이 될 수 있습니다. |
use |
차량 등록정보 인벤토리를 타겟팅할지 여부입니다. |
merchant |
판매자 센터 계정의 ID입니다. 만들기 작업에 필요한 필드입니다. 쇼핑 캠페인의 경우 이 필드를 변경할 수 없습니다. |
sales |
캠페인에 포함할 제품의 판매 국가입니다. |
campaign |
캠페인의 우선순위입니다. 숫자가 더 높은 우선순위의 캠페인이 우선순위가 더 낮은 캠페인보다 우선 적용됩니다. 이 필드는 0 이상 2 이하의 값을 갖는 쇼핑 캠페인에 필수입니다. 이 필드는 스마트 쇼핑 캠페인에서 선택사항이지만 설정된 경우 3과 같아야 합니다. |
enable |
오프라인 제품을 포함할지 여부입니다. |
GeoTargetTypeSetting
광고 지역 타겟팅과 관련된 설정 모음을 나타냅니다.
JSON 표현 |
---|
{ "positiveGeoTargetType": enum ( |
필드 | |
---|---|
positive |
이 특정 캠페인에서 포지티브 지역 타겟팅에 사용되는 설정입니다. |
negative |
이 특정 캠페인의 제외 지역 타겟팅에 사용되는 설정입니다. |
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 ] } |
필드 | |
---|---|
conversion |
이 캠페인을 최적화하기 위해 전환 액션용으로 선택한 리소스 이름 집합입니다. |
OptimizationGoalSetting
이 캠페인의 최적화 목표 설정으로, 최적화 목표 유형 집합이 포함됩니다.
JSON 표현 |
---|
{
"optimizationGoalTypes": [
enum ( |
필드 | |
---|---|
optimization |
최적화 목표 유형 목록입니다. |
OptimizationGoalType
최적화 목표 유형
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환값으로만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
CALL_CLICKS |
통화 클릭에 맞게 최적화합니다. 통화 클릭 전환은 광고를 본 후 사용자가 '통화'를 선택하여 매장에 연락한 횟수입니다. |
DRIVING_DIRECTIONS |
운전경로에 최적화 경로 검색 전환은 사용자가 광고를 본 후 '경로 검색'을 선택하여 매장으로 이동한 횟수입니다. |
APP_PRE_REGISTRATION |
사전 등록에 최적화합니다. 사전 등록 전환수는 앱 출시 시 알림을 받기 위한 사전 등록 가입 횟수입니다. |
TrackingSetting
추적 정보에 대한 캠페인 수준 설정입니다.
JSON 표현 |
---|
{ "trackingUrl": string } |
필드 | |
---|---|
tracking |
동적 추적에 사용되는 URL입니다. |
ManualCpa
이 유형에는 필드가 없습니다.
광고주가 광고주 지정 액션별로 입찰가를 설정할 수 있는 수동 입찰 전략입니다.
ManualCpc
사용자가 클릭당 비용을 지불하는 수동 클릭 기반 입찰입니다.
JSON 표현 |
---|
{ "enhancedCpcEnabled": boolean } |
필드 | |
---|---|
enhanced |
전환 최적화 도구 데이터를 기반으로 입찰가를 개선할지 여부입니다. |
ManualCpm
이 유형에는 필드가 없습니다.
사용자가 1,000회 노출당 비용을 지불하는 수동 노출 기반 입찰입니다.
PercentCpc
일부 상품 또는 서비스에 대해 광고된 가격의 일정 비율을 입찰가로 사용하는 입찰 전략입니다.
JSON 표현 |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
필드 | |
---|---|
cpc |
입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 광고주가 입력하는 선택사항 필드이며 로컬 마이크로 단위로 지정됩니다. 참고: 0 값은 bid_ceiling이 정의되지 않은 것과 동일한 방식으로 해석됩니다. |
enhanced |
전환 가능성에 따라 각 입찰의 입찰가를 상향 또는 하향 조정합니다. 개별 입찰가는 cpcBidCeilingMicros를 초과할 수 있지만 캠페인의 평균 입찰가는 초과해서는 안 됩니다. |
TargetCpm
이 유형에는 필드가 없습니다.
타겟 CPM(1,000회 노출당비용)은 설정한 타겟 CPM을 기준으로 실적을 최적화하도록 입찰가를 설정하는 자동 입찰 전략입니다.
CampaignAsset
캠페인과 저작물 간의 연결입니다.
JSON 표현 |
---|
{
"resourceName": string,
"status": enum ( |
필드 | |
---|---|
resource |
캠페인 확장 소재의 리소스 이름입니다. CampaignAsset 리소스 이름의 형식은 다음과 같습니다.
|
status |
캠페인 확장 소재의 상태입니다. |
campaign |
애셋이 연결된 캠페인입니다. |
asset |
캠페인에 연결된 애셋입니다. |
CampaignAssetSet
CampaignAssetSet는 캠페인과 확장 소재 세트 간의 연결입니다. CampaignAssetSet을 추가하면 확장 소재 조합이 캠페인에 연결됩니다.
JSON 표현 |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
필드 | |
---|---|
resource |
캠페인 확장 소재 조합의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.
|
campaign |
이 애셋 집합이 연결된 캠페인입니다. |
asset |
캠페인에 연결된 애셋 세트입니다. |
status |
캠페인 확장 소재 조합 확장 소재의 상태입니다. 읽기 전용입니다. |
CampaignAudienceView
캠페인 잠재고객 보기 디스플레이 네트워크 및 YouTube 네트워크 광고의 관심분야 및 리마케팅 목록, 검색 광고용 리마케팅 목록(RLSA)의 실적 데이터가 캠페인 및 잠재고객 기준별로 집계되어 포함됩니다. 이 뷰에는 캠페인 수준에서 연결된 잠재고객만 포함됩니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
캠페인 잠재고객 뷰의 리소스 이름입니다. 캠페인 잠재고객 뷰 리소스 이름의 형식은 다음과 같습니다.
|
CampaignCriterion
캠페인 기준
JSON 표현 |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
필드 | |
---|---|
resource |
캠페인 기준의 리소스 이름입니다. 캠페인 기준 리소스 이름의 형식은 다음과 같습니다.
|
display |
기준의 표시 이름입니다. 이 필드는 변형에는 무시됩니다. |
type |
기준의 유형입니다. |
status |
기준의 상태입니다. |
last |
이 캠페인 기준이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
criterion |
기준의 ID입니다. 이 필드는 변경 중에 무시됩니다. |
bid |
기준이 일치할 때의 입찰가에 대한 수정자입니다. 한정자는 0.1~10.0 사이여야 합니다. 대부분의 타겟팅 가능한 기준 유형은 한정자를 지원합니다. 기기 유형을 선택 해제하려면 0을 사용합니다. |
negative |
기준을 타겟팅( |
통합 필드 정확히 하나만 설정해야 합니다. |
|
keyword |
키워드 |
location |
위치를 탭합니다. |
device |
기기 등 데이터를 분류할 옵션을 선택합니다. |
age |
연령대입니다. |
gender |
성별 |
user |
사용자 목록 |
language |
언어 |
webpage |
웹페이지 |
location |
위치 그룹 |
CampaignCriterionStatus
CampaignCriterion의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정된 값이 없습니다. |
UNKNOWN |
수신된 값을 이 버전에서 알 수 없습니다. 응답 전용 값입니다. |
ENABLED |
캠페인 기준이 사용 설정되었습니다. |
PAUSED |
캠페인 기준이 일시중지됩니다. |
REMOVED |
캠페인 기준이 삭제됩니다. |
LanguageInfo
언어 기준입니다.
JSON 표현 |
---|
{ "languageConstant": string } |
필드 | |
---|---|
language |
언어 상수 리소스 이름입니다. |
LocationGroupInfo
피드를 통해 지정된 위치 목록 주변의 반경입니다.
JSON 표현 |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
필드 | |
---|---|
geo |
피드 내 지리적 지역의 범위를 제한하는 지역 타겟팅 상수입니다. 현재 지오타겟팅 상수는 하나만 허용됩니다. |
radius |
반경 단위입니다. 지역 타겟 상수에는 마일과 미터가 지원됩니다. 피드 항목 세트에는 밀리 마일과 미터가 지원됩니다. 이는 필수이며 CREATE 작업에서 설정해야 합니다. |
feed |
FeedItem이 타겟팅된 FeedItemSet입니다. ID가 여러 개 지정된 경우 하나 이상의 세트에 표시되는 모든 항목이 타겟팅됩니다. 이 필드는 geoTargetConstants와 함께 사용할 수 없습니다. 이 속성은 선택사항이며 CREATE 작업에서만 설정할 수 있습니다. |
radius |
타겟 위치 주변 반경을 지정하는 단위로 표시되는 거리입니다. 이는 필수이며 CREATE 작업에서 설정해야 합니다. |
LocationGroupRadiusUnits
위치 그룹의 반경 거리 단위입니다 (예: MILES).
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
METERS |
미터 |
MILES |
마일 |
MILLI_MILES |
Milli Miles |
CampaignEffectiveLabel
캠페인과 효과적인 라벨 간의 관계를 나타냅니다. 효과적인 라벨은 이 캠페인에 상속되거나 직접 할당된 라벨입니다.
JSON 표현 |
---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
필드 | |
---|---|
resource |
리소스의 이름입니다. CampaignEffectivelabel 리소스 이름은 |
campaign |
효과 라벨이 연결된 캠페인입니다. |
label |
캠페인에 할당된 유효한 라벨입니다. |
owner |
유효 라벨을 소유한 고객의 ID입니다. |
CampaignLabel
캠페인과 음반사 간의 관계를 나타냅니다.
JSON 표현 |
---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
필드 | |
---|---|
resource |
리소스의 이름입니다. 캠페인 라벨 리소스 이름은 |
campaign |
라벨이 연결된 캠페인입니다. |
label |
캠페인에 할당된 라벨입니다. |
owner |
라벨을 소유한 고객의 ID입니다. |
CartDataSalesView
장바구니 데이터 판매 보기
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
장바구니 데이터 판매 뷰의 리소스 이름입니다. 장바구니 데이터 판매 뷰 리소스 이름의 형식은 |
잠재고객
잠재고객은 상세한 인구통계, 관심분야 등 여러 가지 세그먼트 속성을 교차하여 타겟팅 세그먼트를 표현하는 잠재고객을 생성할 수 있는 효과적인 타겟팅 옵션입니다.
JSON 표현 |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
필드 | |
---|---|
resource |
잠재고객의 리소스 이름입니다. 잠재고객 이름의 형식은 다음과 같습니다.
|
id |
잠재고객의 ID입니다. |
name |
필수 항목입니다. 잠재고객의 이름입니다. 모든 잠재고객에서 고유해야 합니다. 길이는 1~255자(영문 기준)여야 합니다. |
description |
이 잠재고객에 대한 설명입니다. |
ConversionAction
전환 액션
JSON 표현 |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
필드 | |
---|---|
resource |
전환 액션의 리소스 이름입니다. 전환 액션 리소스 이름의 형식은 다음과 같습니다.
|
creation |
ISO 8601 형식의 플러드라이트 활동 생성의 타임스탬프입니다. |
status |
전환 이벤트 발생에 대한 이 전환 액션의 상태입니다. |
type |
이 전환 액션의 유형입니다. |
category |
이 전환 액션에 대해 보고된 전환 카테고리입니다. |
value |
이 전환 액션과 연결된 전환 이벤트의 가치와 관련된 설정입니다. |
attribution |
이 전환 액션의 기여 분석 모델과 관련된 설정입니다. |
floodlight |
플러드라이트 전환 유형의 플러드라이트 설정 |
id |
전환 액션의 ID입니다. |
name |
전환 액션의 이름입니다. 이 필드는 필수 항목이며 새 전환 액션을 만들 때 비워 두지 않아야 합니다. |
primary |
전환 액션의 primaryForGoal 비트가 false이면 고객 전환 목표 또는 캠페인 전환 목표에 관계없이 모든 캠페인에서 전환 액션을 입찰할 수 없습니다. 그러나 맞춤 전환 목표는 primaryForGoal을 따르지 않으므로 캠페인에 primaryForGoal = false 전환 액션으로 구성된 맞춤 전환 목표가 있는 경우 해당 전환 액션은 계속 입찰할 수 있습니다. 기본적으로 primaryForGoal은 설정되지 않은 경우 true입니다. V9에서 primaryForGoal 은 선택사항으로 선언되지 않았으므로 'update' 연산을 통해 생성된 후에 false로만 설정할 수 있습니다. |
owner |
전환 액션 소유자 고객의 리소스 이름 또는 시스템 정의 전환 액션인 경우 null입니다. |
include |
이 전환 액션을 'clientAccountConversions' 측정항목에 포함해야 하는지 여부입니다. |
include |
이 전환 액션을 '전환수' 측정항목에 포함해야 하는지 여부입니다. |
click |
상호작용 (예: 클릭)과 전환 이벤트 간에 경과할 수 있는 최대 일수입니다. |
app |
앱 전환 액션의 앱 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 } |
필드 | |
---|---|
default |
이 전환 액션의 전환 이벤트가 잘못되거나, 허용되지 않거나, 누락된 값과 함께 전송되거나, 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 값입니다. |
default |
이 전환 액션의 전환 이벤트가 잘못되거나 누락된 통화 코드와 함께 전송되거나 이 전환 액션이 항상 기본값을 사용하도록 구성된 경우 사용할 통화 코드입니다. |
always |
이 전환 액션에 대한 전환 이벤트에 지정된 가치 및 통화 코드 대신 기본값 및 기본 통화 코드를 사용할지 여부를 지정합니다. |
AttributionModelSettings
이 전환 액션의 기여 분석 모델과 관련된 설정입니다.
JSON 표현 |
---|
{ "attributionModel": enum ( |
필드 | |
---|---|
attribution |
이 전환 액션의 기여 분석 모델 유형입니다. |
data |
전환 액션에 대한 데이터 기반 기여 분석 모델의 상태입니다. |
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 } |
필드 | |
---|---|
activity |
전환을 보고할 때 플러드라이트 활동 그룹을 식별하는 데 사용되는 문자열입니다. |
activity |
전환을 보고할 때 플러드라이트 활동을 식별하는 데 사용되는 문자열입니다. |
activity |
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 ( |
필드 | |
---|---|
resource |
전환 맞춤 변수의 리소스 이름입니다. 전환 맞춤 변수 리소스 이름의 형식은 다음과 같습니다.
|
id |
전환 맞춤 변수의 ID입니다. |
name |
필수 항목입니다. 전환 맞춤 변수의 이름입니다. 이름은 고유해야 합니다. 이름의 최대 길이는 100자(영문 기준)입니다. 앞뒤에 공백이 없어야 합니다. |
tag |
필수 항목입니다. 전환 맞춤 변수의 태그입니다. 태그는 고유해야 하며 'u' 문자와 100 이하의 숫자로 구성되어야 합니다. 예: 'u4' |
status |
전환 이벤트 발생에 대한 전환 맞춤 변수의 상태입니다. |
owner |
전환 맞춤 변수를 소유한 고객의 리소스 이름입니다. |
family |
전환 맞춤 변수의 모음입니다. |
cardinality |
전환 맞춤 변수의 카디널리티입니다. |
floodlight |
Search Ads 360 플러드라이트 전환 맞춤 변수의 필드입니다. |
custom |
이 전환 맞춤 변수를 사용하는 맞춤 열의 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 ( |
필드 | |
---|---|
floodlight |
Search Ads 360에 정의된 플러드라이트 변수 유형입니다. |
floodlight |
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 ( |
필드 | |
---|---|
resource |
고객의 리소스 이름입니다. 고객 리소스 이름의 형식은 다음과 같습니다.
|
conversion |
고객의 전환 추적 설정입니다. |
account |
엔진 계정 유형(예: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track 등) |
double |
관리자 고객의 DoubleClick Campaign Manager (DCM) 설정입니다. |
account |
계정 상태(예: 사용 설정됨, 일시중지됨, 삭제됨 등) |
last |
이 고객이 마지막으로 수정된 날짜/시간입니다. 날짜/시간은 고객의 시간대로 표시되며 'yyyy-MM-dd HH:mm:ss.ssssss' 형식입니다. |
engine |
외부 엔진 계정의 계정 ID입니다. |
status |
고객의 상태입니다. |
creation |
이 고객이 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
id |
고객의 ID입니다. |
descriptive |
고객에 대해 선택적이고 고유하지 않은 설명이 포함된 이름입니다. |
currency |
계정에 사용되는 통화입니다. ISO 4217 표준의 통화 코드 중 일부가 지원됩니다. |
time |
고객의 현지 시간대 ID입니다. |
tracking |
매개변수로 추적 URL을 구성하기 위한 URL 템플릿입니다. |
final |
최종 URL에 매개변수를 추가하기 위한 URL 템플릿입니다. |
auto |
고객에 대해 자동 태그 추가가 사용 설정되어 있는지 여부입니다. |
manager |
고객이 관리자인지 여부 |
ConversionTrackingSetting
Search Ads 360 전환 추적과 관련된 고객 전체 설정 모음입니다.
JSON 표현 |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
필드 | |
---|---|
accepted |
고객이 고객 데이터 약관에 동의했는지 여부입니다. 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자 계정에서 상속됩니다. 이 필드는 읽기 전용입니다. 자세한 내용은 https://support.google.com/adspolicy/answer/7475709를 참고하세요. |
conversion |
전환 추적 상태입니다. 고객이 전환 추적을 사용하고 있는지 여부와 이 고객의 전환 추적 소유자를 나타냅니다. 이 고객이 교차 계정 전환 추적을 사용하는 경우 반환되는 값은 요청의 |
enhanced |
고객이 리드 확보용 향상된 전환을 선택했는지 여부입니다. 교차 계정 전환 추적을 사용하는 경우 이 값은 관리자 계정에서 상속됩니다. 이 필드는 읽기 전용입니다. |
google |
전환이 생성되고 관리되는 고객의 리소스 이름입니다. 이 필드는 읽기 전용입니다. |
conversion |
이 계정에 사용되는 전환 추적 ID입니다. 이 ID는 고객이 전환 추적을 사용하는지 여부를 나타내지 않습니다(conversionTrackingStatus가 이를 나타냅니다). 이 필드는 읽기 전용입니다. |
google |
고객 관리자의 전환 추적 ID입니다. 고객이 전환 추적을 선택하면 설정되며 conversionTrackingId를 재정의합니다. 이 필드는 Google Ads UI를 통해서만 관리할 수 있습니다. 이 필드는 읽기 전용입니다. |
cross |
고객 관리자의 전환 추적 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 } |
필드 | |
---|---|
advertiser |
이 고객과 연결된 Campaign Manager 광고주의 ID입니다. |
network |
이 고객과 연결된 Campaign Manager 네트워크의 ID입니다. |
time |
이 고객과 연결된 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 ( |
필드 | |
---|---|
resource |
고객 애셋의 리소스 이름입니다. CustomerAsset 리소스 이름의 형식은 다음과 같습니다.
|
asset |
필수 항목입니다. 고객에 연결된 애셋입니다. |
status |
고객 애셋의 상태입니다. |
CustomerAssetSet
CustomerAssetSet은 고객과 애셋 세트 간의 연결입니다. CustomerAssetSet을 추가하면 애셋 세트가 고객과 연결됩니다.
JSON 표현 |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
필드 | |
---|---|
resource |
고객 애셋 세트의 리소스 이름입니다. 애셋 세트 애셋 리소스 이름의 형식은 다음과 같습니다.
|
asset |
고객에 연결된 애셋 집합입니다. |
customer |
이 애셋 세트가 연결된 고객입니다. |
status |
고객 애셋 세트 애셋의 상태입니다. 읽기 전용입니다. |
AccessibleBiddingStrategy
고객이 소유하고 공유한 입찰 전략 보기를 나타냅니다.
BiddingStrategy와 달리 이 리소스에는 고객이 소유한 전략 외에도 고객의 관리자가 소유하고 고객과 공유하는 전략이 포함됩니다. 이 리소스는 측정항목을 제공하지 않으며 입찰 전략 속성의 제한된 하위 집합만 노출합니다.
JSON 표현 |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
필드 | |
---|---|
resource |
액세스 가능한 입찰 전략의 리소스 이름입니다. AccessibleBiddingStrategy 리소스 이름의 형식은 다음과 같습니다.
|
id |
입찰 전략의 ID입니다. |
name |
입찰 전략의 이름입니다. |
type |
입찰 전략의 유형입니다. |
owner |
입찰 전략을 소유한 고객의 ID입니다. |
owner |
입찰 전략을 소유한 고객의 descriptiveName입니다. |
통합 필드 하나만 설정할 수 있습니다. |
|
maximize |
예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다. |
maximize |
캠페인에서 예산이 지출될 때 최대한 많은 전환이 발생하도록 설정하는 자동 입찰 전략입니다. |
target |
타겟 CPA는 설정된 타겟 전환당비용(CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 입찰 전략입니다. |
target |
선택한 노출 비율을 기준으로 자동으로 최적화하는 입찰 전략입니다. |
target |
특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 입찰 전략입니다. |
target |
예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 입찰 전략입니다. |
MaximizeConversionValue
예산을 지출하면서 캠페인의 전환 가치를 최대한 높일 수 있는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetRoas": number } |
필드 | |
---|---|
target |
타겟 광고 투자수익(ROAS) 옵션 이 옵션을 설정하면 입찰 전략이 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화합니다. 타겟 ROAS가 높으면 입찰 전략에서 전체 예산을 지출하지 못할 수 있습니다. 타겟 ROAS를 설정하지 않으면 입찰 전략은 예산에 대해 최대한 높은 ROAS를 달성하는 것을 목표로 합니다. |
MaximizeConversions
캠페인에서 가장 많은 전환이 발생하는 방향으로 예산이 지출되는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
필드 | |
---|---|
target |
타겟 전환당비용 (CPA) 옵션입니다. 전환당 지출하고자 하는 평균 금액입니다. |
target |
타겟 전환당비용 (CPA) 옵션 획득당 지출하고자 하는 평균 금액입니다. |
TargetCpa
설정된 타겟 전환당비용 (CPA)으로 최대한 많은 전환이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetCpaMicros": string } |
필드 | |
---|---|
target |
평균 CPA 타겟입니다. 이 타겟은 계정의 통화를 기준으로 최소 청구 가능 단위보다 크거나 같아야 합니다. |
TargetRoas
특정 타겟 광고 투자수익(ROAS)을 평균화하면서 수익을 극대화하는 데 도움이 되는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetRoas": number } |
필드 | |
---|---|
target |
지출 단위당 선택한 수익(전환 데이터 기준)입니다. |
TargetSpend
예산 내에서 최대한 많은 클릭이 발생하도록 입찰가를 설정하는 자동 입찰 전략입니다.
JSON 표현 |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
필드 | |
---|---|
targetSpendMicros |
클릭수를 최대화할 지출 목표입니다. TargetSpend 입찰자는 이 값 또는 자연 제한 지출 금액 중 더 작은 값을 지출하려고 시도합니다. 지정하지 않으면 예산이 지출 목표로 사용됩니다. 이 필드는 지원 중단되었으며 더 이상 사용하지 않아야 합니다. 자세한 내용은 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html을 참고하세요. |
cpc |
입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 전략에서 관리하는 모든 키워드에 이 한도가 적용됩니다. |
CustomerManagerLink
고객-관리자 링크 관계를 나타냅니다.
JSON 표현 |
---|
{
"resourceName": string,
"status": enum ( |
필드 | |
---|---|
resource |
리소스의 이름입니다. CustomerManagerLink 리소스 이름의 형식은 |
status |
고객과 관리자 간의 연결 상태입니다. |
manager |
고객에 연결된 관리자 고객입니다. |
manager |
고객-관리자 링크의 ID입니다. 이 필드는 읽기 전용입니다. |
start |
CustomerManagerLink가 생성된 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
ManagerLinkStatus
링크의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
ACTIVE |
현재 유효한 관계를 나타냅니다. |
INACTIVE |
종료된 관계를 나타냅니다. |
PENDING |
관리자가 관계를 요청했지만 아직 고객이 수락하지 않았음을 나타냅니다. |
REFUSED |
관리자가 관계를 요청했지만 고객이 거부했습니다. |
CANCELED |
관리자가 관계를 요청했으나 관리자가 취소했음을 나타냅니다. |
CustomerClient
지정된 고객과 고객 고객 간의 링크입니다. CustomerClient는 관리자 고객에게만 존재합니다. 관리자 자신뿐만 아니라 모든 직접 및 간접 고객 고객이 포함됩니다.
JSON 표현 |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
필드 | |
---|---|
resource |
고객 클라이언트의 리소스 이름입니다. CustomerClient 리소스 이름의 형식은 |
applied |
요청하는 고객이 소유하고 있으며 고객 계정에 적용된 라벨의 리소스 이름입니다. 라벨 리소스 이름의 형식은 다음과 같습니다.
|
status |
고객 고객의 상태입니다. 읽기 전용입니다. |
client |
특정 고객에 연결된 클라이언트-고객의 리소스 이름입니다. 읽기 전용입니다. |
level |
지정된 고객과 고객 사이의 거리입니다. 자체 링크의 경우 수준 값은 0입니다. 읽기 전용입니다. |
time |
클라이언트의 시간대의 Common Locale Data Repository(CLDR) 문자열 표현입니다(예: America/Los_Angeles). 읽기 전용입니다. |
test |
고객이 테스트 계정인지 식별합니다. 읽기 전용입니다. |
manager |
클라이언트가 관리자인지 식별합니다. 읽기 전용입니다. |
descriptive |
클라이언트를 설명하는 이름입니다. 읽기 전용입니다. |
currency |
고객의 통화 코드(예: 'USD', 'EUR')입니다. 읽기 전용입니다. |
id |
고객 클라이언트의 ID입니다. 읽기 전용입니다. |
DynamicSearchAdsSearchTermView
동적 검색 광고 검색어 보기
JSON 표현 |
---|
{ "resourceName": string, "landingPage": string } |
필드 | |
---|---|
resource |
동적 검색 광고 검색어 뷰의 리소스 이름입니다. 동적 검색 광고 검색어 보기 리소스 이름의 형식은 다음과 같습니다.
|
landing |
동적으로 선택된 노출의 방문 페이지 URL입니다. 이 필드는 읽기 전용입니다. |
GenderView
성별 보기 genderView 리소스는 추가된 기준이 아닌 유효한 게재 상태를 반영합니다. 성별 기준이 없는 광고 그룹은 기본적으로 모든 성별에 표시되므로 모든 성별이 통계와 함께 genderView에 표시됩니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
성별 뷰의 리소스 이름입니다. 성별 보기 리소스 이름의 형식은 다음과 같습니다.
|
GeoTargetConstant
지역 타겟팅 상수입니다.
JSON 표현 |
---|
{
"resourceName": string,
"status": enum ( |
필드 | |
---|---|
resource |
지역 타겟 상수의 리소스 이름입니다. 지역 타겟 상수 리소스 이름의 형식은 다음과 같습니다.
|
status |
지역 타겟팅 상수 상태입니다. |
id |
지역 타겟 상수의 ID입니다. |
name |
지역 타겟 상수의 영어 이름입니다. |
country |
타겟과 연결된 ISO-3166-1 alpha-2 국가 코드입니다. |
target |
지역 타겟팅 상수 타겟 유형입니다. |
canonical |
타겟 이름과 상위 요소 및 국가 이름으로 구성된 정규화된 영어 이름입니다. |
parent |
상위 지역 타겟 상수의 리소스 이름입니다. 지역 타겟팅 상수 리소스 이름의 형식은 다음과 같습니다.
|
GeoTargetConstantStatus
지역 대상 상수의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정된 값이 없습니다. |
UNKNOWN |
수신된 값을 이 버전에서 알 수 없습니다. 응답 전용 값입니다. |
ENABLED |
지역 타겟 상수가 유효합니다. |
REMOVAL_PLANNED |
지역 대상 상수는 더 이상 사용되지 않으며 삭제될 예정입니다. |
KeywordView
키워드 보기입니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
키워드 뷰의 리소스 이름입니다. 키워드 뷰 리소스 이름의 형식은 다음과 같습니다.
|
라벨
라벨
JSON 표현 |
---|
{ "resourceName": string, "status": enum ( |
필드 | |
---|---|
resource |
리소스의 이름입니다. 라벨 리소스 이름은 |
status |
라벨의 상태입니다. 읽기 전용입니다. |
text |
색이 있는 배경에 텍스트를 표시하는 라벨 유형입니다. |
id |
라벨의 ID입니다. 읽기 전용입니다. |
name |
라벨 이름입니다. 이 필드는 필수이며 새 라벨을 만들 때 비워 둘 수 없습니다. 이 문자열의 길이는 1~80 사이여야 합니다(1 및 80 포함). |
LabelStatus
라벨의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
ENABLED |
라벨이 사용 설정되었습니다. |
REMOVED |
라벨이 삭제되었습니다. |
TextLabel
컬러 배경에 텍스트를 표시하는 라벨 유형입니다.
JSON 표현 |
---|
{ "backgroundColor": string, "description": string } |
필드 | |
---|---|
background |
라벨의 배경 색상(16진수 형식)입니다. 이 문자열은 정규 표현식 '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'와 일치해야 합니다. 참고: 관리자 계정에서는 배경색이 표시되지 않을 수 있습니다. |
description |
라벨에 관한 간단한 설명입니다. 길이는 200자(영문 기준) 이하여야 합니다. |
LanguageConstant
언어
JSON 표현 |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
필드 | |
---|---|
resource |
언어 상수의 리소스 이름입니다. 언어 상수 리소스 이름의 형식은 다음과 같습니다.
|
id |
언어 상수의 ID입니다. |
code |
언어 코드(예: 'en_US', 'en_AU', 'es', 'fr' 등)입니다. |
name |
언어의 전체 이름(영어로 표시)입니다(예: '영어(미국)', '스페인어' 등). |
targetable |
언어의 타겟팅 가능 여부입니다. |
LocationView
위치 보기는 위치 기준별로 캠페인 실적을 요약합니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
위치 뷰의 리소스 이름입니다. 위치 뷰 리소스 이름의 형식은 다음과 같습니다.
|
ProductBiddingCategoryConstant
제품 입찰 카테고리입니다.
JSON 표현 |
---|
{ "resourceName": string, "level": enum ( |
필드 | |
---|---|
resource |
제품 입찰 카테고리의 리소스 이름입니다. 제품 입찰 카테고리 리소스 이름은 다음과 같은 형식입니다.
|
level |
제품 입찰 카테고리의 수준입니다. |
status |
제품 입찰 카테고리의 상태입니다. |
id |
제품 입찰 카테고리의 ID입니다. 이 ID는 이 도움말(https://support.google.com/merchants/answer/6324436)에 설명된 google_product_category ID와 같습니다. |
country |
제품 입찰 카테고리의 2자리 대문자 국가 코드입니다. |
product |
상위 제품 입찰 카테고리의 리소스 이름입니다. |
language |
제품 입찰 카테고리의 언어 코드입니다. |
localized |
languageCode에 따라 현지화된 제품 입찰 카테고리의 값을 표시합니다. |
ProductBiddingCategoryLevel
제품 입찰 카테고리의 수준을 설명하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
LEVEL1 |
1단계 |
LEVEL2 |
수준 2 |
LEVEL3 |
수준 3. |
LEVEL4 |
4단계 |
LEVEL5 |
레벨 5. |
ProductBiddingCategoryStatus
제품 입찰 카테고리의 상태를 설명하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
ACTIVE |
카테고리가 활성 상태이며 입찰에 사용할 수 있습니다. |
OBSOLETE |
카테고리가 지원 중단되었습니다. 보고 목적으로만 사용됩니다. |
ProductGroupView
제품 그룹 뷰
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
제품 그룹 뷰의 리소스 이름입니다. 제품 그룹 뷰 리소스 이름의 형식은 다음과 같습니다.
|
ShoppingPerformanceView
쇼핑 실적 뷰입니다. 여러 제품 측정기준 수준에서 집계된 쇼핑 캠페인 통계를 제공합니다. 브랜드, 카테고리, 맞춤 속성, 제품 상태, 제품 유형과 같은 판매자 센터의 제품 측정기준 값은 해당 이벤트가 기록된 날짜 및 시간의 각 측정기준 상태를 반영합니다.
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
쇼핑 실적 뷰의 리소스 이름입니다. 쇼핑 실적 보기 리소스 이름의 형식은 |
UserList
사용자 목록 고객이 타겟팅할 수 있는 사용자 목록입니다.
JSON 표현 |
---|
{
"resourceName": string,
"type": enum ( |
필드 | |
---|---|
resource |
사용자 목록의 리소스 이름입니다. 사용자 목록 리소스 이름의 형식은 다음과 같습니다.
|
type |
이 목록의 유형입니다. 이 필드는 읽기 전용입니다. |
id |
사용자 목록의 ID입니다. |
name |
이 사용자 목록의 이름입니다. 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 } |
필드 | |
---|---|
resource |
사용자 위치 뷰의 리소스 이름입니다. UserLocation 뷰 리소스 이름의 형식은 다음과 같습니다.
|
country |
국가의 기준 ID입니다. |
targeting |
위치가 타겟팅되었는지 여부를 나타냅니다. |
WebpageView
웹페이지 뷰
JSON 표현 |
---|
{ "resourceName": string } |
필드 | |
---|---|
resource |
웹페이지 뷰의 리소스 이름입니다. 웹페이지 뷰 리소스 이름의 형식은 다음과 같습니다.
|
방문
방문
JSON 표현 |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
필드 | |
---|---|
resource |
방문의 리소스 이름입니다. 방문 리소스 이름의 형식은 다음과 같습니다.
|
id |
방문 ID입니다. |
criterion |
Search Ads 360 키워드 ID입니다. 값이 0이면 키워드가 기여 비구분 상태임을 나타냅니다. |
merchant |
클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. 사용자가 Search Ads 360에서 인벤토리 계정을 링크할 때 Search Ads 360이 이 ID를 생성합니다. |
ad |
광고 ID 값이 0이면 광고가 기여 비구분 상태임을 나타냅니다. |
click |
방문 페이지에 클릭 ID URL 매개변수로 전달되는 각 방문에 대한 고유한 문자열입니다. |
visit |
방문 이벤트의 타임스탬프입니다. 타임스탬프는 고객의 시간대로 표시되며 "yyyy-MM-dd HH:mm:ss" 형식입니다. |
product |
클릭된 제품의 ID입니다. |
product |
클릭된 제품의 영업 채널: 온라인 또는 로컬. |
product |
제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다. |
product |
클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다. |
product |
클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다. |
asset |
방문 이벤트 중에 상호작용한 확장 소재의 ID입니다. |
asset |
방문 이벤트의 애셋 필드 유형입니다. |
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 ( |
필드 | |
---|---|
resource |
전환의 리소스 이름입니다. 전환 리소스 이름의 형식은 다음과 같습니다.
|
id |
전환의 ID입니다. |
criterion |
Search Ads 360 기준 ID입니다. 값이 0이면 기준이 비구분 상태임을 나타냅니다. |
merchant |
클릭된 제품이 포함된 Search Ads 360 인벤토리 계정 ID입니다. 사용자가 Search Ads 360에서 인벤토리 계정을 링크할 때 Search Ads 360이 이 ID를 생성합니다. |
ad |
광고 ID 값이 0이면 광고가 기여 비구분 상태임을 나타냅니다. |
click |
방문 페이지에 클릭 ID URL 매개변수로 전달되며, 전환의 기인 대상이 되는 방문에 대한 고유 문자열입니다. |
visit |
전환에 기여한 Search Ads 360 방문 ID입니다. |
advertiser |
오프라인 전환의 경우 광고주가 제공하는 ID입니다. 광고주가 이러한 ID를 지정하지 않으면 Search Ads 360이 ID를 생성합니다. 온라인 전환의 경우 광고주의 플러드라이트 지침에 따라 ID 열 또는 floodlightOrderId 열과 동일합니다. |
product |
클릭된 제품의 ID입니다. |
product |
클릭된 제품의 영업 채널: 온라인 또는 로컬. |
product |
제품에 대한 데이터가 포함된 판매자 센터 피드에 설정된 언어(ISO-639-1)입니다. |
product |
클릭된 오프라인 판매점 인벤토리 광고의 스토어입니다. 오프라인 제품 피드에 사용된 스토어 ID와 일치해야 합니다. |
product |
클릭한 제품이 포함된 인벤토리 피드에 등록된 국가(ISO-3166 형식)입니다. |
attribution |
전환 기인 대상: 방문 또는 키워드+광고. |
conversion |
전환 이벤트의 타임스탬프입니다. |
conversion |
전환이 마지막으로 수정된 시간의 타임스탬프입니다. |
conversion |
전환의 기인 대상이 되는 방문의 타임스탬프입니다. |
conversion |
전환으로 기록된 항목 수입니다. 수량 URL 매개변수에 따라 결정됩니다. 광고주가 매개변수를 동적으로 채워야 하며(예: 전환에서 판매된 항목 수) 그렇지 않은 경우 기본값은 1입니다. |
conversion |
전환 이벤트에 대해 백만 분의 1 단위로 조정된 수익입니다. 항상 광고 게재 계정의 통화로 표시됩니다. |
floodlight |
플러드라이트 통화 안내 수정 전 플러드라이트 이벤트와 연관된 원래의 변경되지 않은 수익입니다(현재 보고서의 통화). |
floodlight |
광고주가 전환을 위해 제공한 플러드라이트 주문 ID입니다. |
status |
전환 상태(사용 설정됨 또는 삭제됨)입니다. |
asset |
전환 이벤트 중에 상호작용이 발생한 확장 소재의 ID입니다. |
asset |
전환 이벤트의 애셋 필드 유형입니다. |
AttributionType
SearchAds360의 전환 기여 분석 유형
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
VISIT |
전환이 방문으로 발생합니다. |
CRITERION_AD |
전환 기여도가 기준 및 광고 쌍에 부여됩니다. |
ConversionStatus
전환의 가능한 상태입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
ENABLED |
전환이 사용 설정되었습니다. |
REMOVED |
전환이 삭제되었습니다. |
측정항목
측정항목 데이터
JSON 표현 |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
필드 | |
---|---|
all |
모든 전환의 가치입니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열의 세부정보는 https://support.google.com/sa360/answer/9250611에서 확인할 수 있습니다. |
all |
총 전환수입니다. 여기에는 includeInConversionsMetric의 값과 관계없이 모든 전환이 포함됩니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요. |
conversion |
전환 맞춤 측정항목 |
conversions |
전환 날짜별로 입찰 가능 전환 가치의 합계입니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. |
conversions |
입찰 가능한 전환 유형의 전환 날짜별 전환수 합계입니다. 기여 분석 모델링으로 인해 소수점 이하로 표시될 수 있습니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. |
historical |
광고 소재의 이전 품질평가점수입니다. |
historical |
이전 방문 페이지 만족도의 품질 |
historical |
이전 검색의 예상 클릭률 (CTR)입니다. |
interaction |
유료 및 무료 상호작용 유형입니다. |
raw |
원시 이벤트 전환 측정항목입니다. |
absolute |
검색 절대 상단 노출 점유율은 가장 눈에 잘 띄는 검색 위치에 표시되는 검색 광고 노출수의 비율입니다. |
all |
조회 후 전환이 아닌 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다. |
all |
모든 전환의 가치입니다. |
all |
총 전환수입니다. 여기에는 includeInConversionsMetric의 값과 관계없이 모든 전환이 포함됩니다. |
all |
모든 전환 가치를 광고 상호작용의 총 비용(예: 텍스트 광고의 클릭수 또는 동영상 광고의 조회수)으로 나눈 값입니다. |
all |
광고를 클릭한 후에 매장에 전화하기 위해 '통화' 버튼을 클릭한 횟수입니다. 통화 연결 여부나 통화 시간은 포함되지 않습니다. 이 측정항목은 피드 항목에만 적용됩니다. |
all |
광고를 클릭한 후에 매장으로 이동하기 위해 '경로 검색' 버튼을 클릭한 횟수입니다. 이 측정항목은 피드 항목에만 적용됩니다. |
all |
상호작용에서 발생한 모든 전환의 가치를 총 상호작용 수로 나눈 값입니다. |
all |
광고를 클릭한 후에 매장의 메뉴를 보기 위해 링크를 클릭한 횟수입니다. 이 측정항목은 피드 항목에만 적용됩니다. |
all |
광고를 클릭한 후에 매장에서 주문한 횟수입니다. 이 측정항목은 피드 항목에만 적용됩니다. |
all |
광고를 클릭한 후에 발생한 기타 전환(예: 매장에 대한 리뷰 게시, 매장 위치 저장) 횟수입니다. 이 측정항목은 피드 항목에만 적용됩니다. |
all |
광고를 클릭한 후에 매장을 방문한 예상 횟수입니다. 이 측정항목은 피드 항목에만 적용됩니다. |
visits |
Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다. |
all |
광고를 클릭한 후에 매장의 URL로 연결된 횟수입니다. 이 측정항목은 피드 항목에만 적용됩니다. |
average |
상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다. |
average |
모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요. |
average |
평균 CPM(1,000회 노출당비용)입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요. |
clicks |
클릭수입니다. |
content |
광고가 디스플레이 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 콘텐츠 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
content |
디스플레이 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 콘텐츠 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. |
content |
디스플레이 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 콘텐츠 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
conversions |
전환 발생 가능 상호작용당 입찰 가능 전환의 평균 수입니다 (상호작용에서 발생). 광고 상호작용이 입찰 가능 전환으로 이어지는 평균 빈도를 나타냅니다. |
client |
고객 계정 전환의 가치입니다. 여기에는 includeInClientAccountConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. |
conversions |
입찰 가능 전환 가치를 전환 발생 가능 상호작용의 총 비용으로 나눈 값입니다. |
conversions |
상호작용에서 발생한 전환의 가치를 광고 상호작용 수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. |
client |
고객 계정 전환수입니다. 여기에는 includeInClientAccountConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. |
cost |
일정 기간에 발생한 클릭당비용(CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요. |
cost |
광고 상호작용 비용을 모든 전환으로 나눈 값입니다. |
cost |
입찰 가능한 전환당 평균 전환 가능 비용입니다. |
cost |
광고 상호작용 비용을 현재 모델 기여도 전환수로 나눈 값입니다. 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. |
cross |
고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 allConversions에 포함되어 있습니다. |
cross |
전환 날짜별 교차 기기 전환수입니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요. |
cross |
교차 기기 전환의 가치의 합계입니다. |
cross |
전환 날짜별 교차 기기 전환 가치의 합계입니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요. |
ctr |
광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다. |
conversions |
전환이 발생한 횟수 여기에는 includeInConversionsMetric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다. |
conversions |
'전환수' 필드에 포함된 전환에 대한 전환 가치의 합계입니다. 이 측정항목은 전환 액션의 가치를 입력한 경우에만 유용합니다. |
average |
평균 품질평가점수입니다. |
historical |
이전 품질평가점수입니다. |
impressions |
Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다. |
interaction |
사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다. |
interactions |
상호작용 횟수입니다. 상호작용이란 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회 등 광고 형식과 관련된 중요한 사용자 액션을 말합니다. |
invalid |
보고 기간 동안 총 클릭수(필터링된 클릭수 + 필터링되지 않은 클릭수)에서 필터링된 클릭이 차지하는 비율입니다. |
invalid |
Google에서 불법으로 간주하여 비용을 청구하지 않는 클릭수 |
general |
전체 클릭수 (필터링된 클릭수 + 필터링되지 않은 클릭수)에서 일반 무효 클릭으로 인해 필터링된 클릭이 차지하는 비율입니다. 이러한 클릭이란 Google에서 반복적인 필터링 (예: 알려진 무효 데이터 센터 트래픽, 봇 및 스파이더 또는 기타 크롤러, 불규칙한 패턴 등)을 통해 감지된 클릭을 불법으로 간주하는 클릭을 말합니다. 무효 클릭은 비용을 발생시키지 않으며, 계정 통계에 영향을 주지 않습니다. 자세한 내용은 https://support.google.com/campaignmanager/answer/6076504의 도움말 페이지를 참고하세요. |
general |
일반 무효 클릭 수입니다. '일반 무효 클릭'은 일반적인 필터링 수단 (예: 알려진 무효 데이터 센터 트래픽, 봇 및 스파이더 또는 기타 크롤러, 비정상적인 패턴 등)을 통해 감지된 무효 클릭의 하위 집합입니다. 무효 클릭은 비용을 발생시키지 않으며, 계정 통계에 영향을 주지 않습니다. 자세한 내용은 https://support.google.com/campaignmanager/answer/6076504의 도움말 페이지를 참고하세요. |
mobile |
모바일 친화적인 페이지로 연결되는 모바일 클릭의 비율입니다. |
search |
가장 눈에 잘 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 또는 검색 광고 노출수의 비율입니다. 자세한 내용은 https://support.google.com/sa360/answer/9566729를 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다. |
search |
예산 부족으로 인해 검색 결과의 상단 광고 중 첫 번째 광고로 게재되지 않은 빈도를 추정하는 숫자입니다. 참고: 검색 예산 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
search |
광고가 검색 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 검색 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
search |
예산 부족으로 인해 광고가 상단 자연 검색 결과에 인접하여 게재되지 않은 빈도를 추정한 값입니다. 참고: 검색 예산 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
search |
검색 네트워크에서 발생한 클릭수를 발생 가능한 것으로 예상된 최대 클릭수로 나눈 값입니다. 참고: 검색 결과 클릭 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. |
search |
발생한 노출수를 키워드 검색 유형에 관계없이 키워드와 정확히 일치하거나 키워드의 유사 검색어와 검색 네트워크에서 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 일치검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. |
search |
검색 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. |
search |
광고 순위가 낮아 검색 결과의 상단 광고 중 첫 번째 광고로 게재되지 않은 빈도를 추정하는 숫자입니다. 참고: 검색 순위 절대 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
search |
검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
search |
광고 순위가 낮아 광고가 상단 자연 검색 결과에 인접하여 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상단 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다. |
search |
상단 광고에서 발생한 노출수를 상단 광고에서 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 상단 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다. 상단 광고는 일반적으로 상단 자연 검색 결과 위에 게재되지만, 일부 검색어의 경우에는 상단 자연 검색 결과 아래에 게재될 수 있습니다. |
top |
상단 자연 검색 결과에 인접하여 게재되는 광고 노출수의 비율입니다. |
value |
모든 전환의 가치를 전체 전환수로 나눈 값입니다. |
value |
모든 전환의 가치를 전체 전환수로 나눈 값입니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요. |
value |
입찰 가능 전환 가치를 입찰 가능 전환수로 나눈 값입니다. 입찰 가능한 각 전환의 평균 가치를 보여줍니다. |
value |
전환일별 입찰 가능 전환 가치를 전환일별 입찰 가능 전환수로 나눈 값입니다. 입찰 가능한 각 전환의 평균 가치를 전환 날짜별로 보여줍니다. 이 열이 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. |
client |
총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용(예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다. |
client |
고객 계정 크로스셀(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)를 참고하세요. |
cross |
크로스셀(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 매개변수를 참고하세요. |
client |
고객 계정 크로스셀(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)를 참고하세요. |
cross |
크로스셀(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 매개변수를 참고하세요. |
client |
고객 계정 크로스셀(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 매개변수를 참고하세요. |
cross |
크로스셀(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 매개변수를 참고하세요. |
client |
고객 계정 크로스셀(cross-sell)을 통해 판매된 제품수는 다른 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통해 판매된 제품수는 광고에 기여한 모든 주문의 크로스셀(cross-sell) 제품 총 개수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 크로스셀(cross-sell)을 통해 판매된 제품수는 2개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. |
cross |
크로스셀(cross-sell)을 통해 판매된 제품수는 다른 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 해당 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통해 판매된 제품수는 광고에 기여한 모든 주문의 크로스셀(cross-sell) 제품 총 개수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 크로스셀(cross-sell)을 통해 판매된 제품수는 2개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. |
client |
고객 계정 리드 매출원가 (COGS)는 동일한 제품을 광고한 결과로 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 상호작용된 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이러한 제품의 비용은 리드 매출원가에 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 리드 매출원가는 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요. |
lead |
리드 매출원가(COGS)는 동일한 제품을 광고한 결과로 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이러한 제품의 비용은 리드 매출원가에 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 리드 매출원가는 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요. |
client |
고객 계정 리드 총이익은 동일한 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가 (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)를 참고하세요. |
lead |
리드 총이익은 동일한 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가(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 매개변수를 참고하세요. |
client |
고객 계정 리드 수익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고 제품과 판매된 제품이 일치하면 해당 제품의 판매에서 발생한 총 가치가 리드 수익에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 리드 수익은 10,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요. |
lead |
리드 수익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고 제품과 판매된 제품이 일치하면 해당 제품의 판매에서 발생한 총 가치가 리드 수익에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 같은 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 리드 수익은 10,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요. |
client |
고객 계정 판매된 리드 단위 수는 동일한 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우(쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 판매된 제품의 총 수가 판매된 리드 단위 아래에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 판매된 리드 단위는 1개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. |
lead |
판매된 리드 단위 수는 동일한 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 판매된 제품의 총 수가 판매된 리드 단위 아래에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭한 다음 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 판매된 리드 단위는 1개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. |
값
일반 데이터 컨테이너입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
통합 필드 value . 값 value 은 다음 중 하나여야 합니다. |
|
boolean |
불리언 |
int64 |
int64입니다. |
float |
부동 소수점 수 |
double |
double |
string |
문자열. |
QualityScoreBucket
가능한 품질평가점수 버킷을 나열하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
BELOW_AVERAGE |
광고 소재의 품질이 평균보다 낮습니다. |
AVERAGE |
광고 소재의 품질이 평균입니다. |
ABOVE_AVERAGE |
광고 소재의 품질이 평균보다 높습니다. |
InteractionEventType
유료 및 무료 상호작용의 가능한 유형을 설명하는 열거형입니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
반환 값에만 사용됩니다. 이 버전에서 알 수 없는 값을 나타냅니다. |
CLICK |
사이트를 클릭합니다. 대부분의 경우 이 상호작용은 외부 위치(일반적으로 광고주의 방문 페이지)로 이동합니다. 클릭 이벤트의 기본 InteractionEventType이기도 합니다. |
ENGAGEMENT |
사용자가 광고와 상호작용하겠다는 의도를 표현한 것입니다. |
VIDEO_VIEW |
사용자가 동영상 광고를 조회했습니다. |
NONE |
광고 전환 이벤트의 기본 InteractionEventType입니다. 광고 전환 행에서 무료 상호작용(예: 광고 전환)을 '프로모션'하여 핵심 측정항목의 일부로 보고해야 한다고 표시하지 않는 경우에 사용됩니다. 이는 다른 (광고) 전환에 해당합니다. |
세그먼트
필드만 세그먼트
JSON 표현 |
---|
{ "adNetworkType": enum ( |
필드 | |
---|---|
ad |
광고 네트워크 유형입니다. |
conversion |
전환 액션 카테고리입니다. |
conversion |
전환 맞춤 측정기준입니다. |
day |
요일입니다(예: MONDAY). |
device |
측정항목이 적용되는 기기입니다. |
keyword |
키워드 기준 |
product |
제품의 채널입니다. |
product |
제품의 단일 채널 판매 여부입니다. |
product |
제품 상태입니다. |
product |
판매된 제품의 상태입니다. |
raw |
원시 이벤트 전환 측정기준입니다. |
conversion |
전환 액션의 리소스 이름입니다. |
conversion |
전환 액션 이름입니다. |
date |
측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17). |
geo |
도시를 나타내는 지역 타겟 상수의 리소스 이름입니다. |
geo |
국가를 나타내는 지역 타겟 상수의 리소스 이름입니다. |
geo |
대중교통을 나타내는 지역 타겟 상수의 리소스 이름입니다. |
geo |
지역을 나타내는 지역 타겟팅 상수의 리소스 이름입니다. |
hour |
시간대(0~23 사이의 숫자, 양 끝값 포함) |
month |
월의 첫 번째 날짜로 표시되는 월입니다. 형식은 yyyy-MM-dd입니다. |
product |
제품의 입찰 카테고리(수준 1)입니다. |
product |
제품의 입찰 카테고리(수준 2)입니다. |
product |
제품의 입찰 카테고리(수준 3)입니다. |
product |
제품의 입찰 카테고리(수준 4)입니다. |
product |
제품의 입찰 카테고리(수준 5)입니다. |
product |
제품의 브랜드입니다. |
product |
제품의 판매 국가에 대한 지역 타겟 상수의 리소스 이름입니다. |
product |
제품의 커스텀 속성 0입니다. |
product |
제품의 커스텀 속성 1입니다. |
product |
제품의 커스텀 속성 2입니다. |
product |
제품의 커스텀 속성 3입니다. |
product |
제품의 커스텀 속성 4입니다. |
product |
제품의 상품 ID입니다. |
product |
제품의 언어에 대한 언어 상수의 리소스 이름입니다. |
product |
판매된 제품의 입찰 카테고리 (수준 1)입니다. |
product |
판매된 제품의 입찰 카테고리 (수준 2)입니다. |
product |
판매된 제품의 입찰 카테고리 (수준 3)입니다. |
product |
판매된 제품의 입찰 카테고리 (수준 4)입니다. |
product |
판매된 제품의 입찰 카테고리 (수준 5)입니다. |
product |
판매된 제품의 브랜드입니다. |
product |
판매된 제품의 커스텀 속성 0입니다. |
product |
판매된 제품의 커스텀 속성 1입니다. |
product |
판매된 제품의 커스텀 속성 2입니다. |
product |
판매된 제품의 맞춤 속성 3입니다. |
product |
판매된 제품의 커스텀 속성 4입니다. |
product |
판매된 제품의 상품 ID입니다. |
product |
판매된 제품의 이름입니다. |
product |
판매된 제품 유형(수준 1)입니다. |
product |
판매된 제품 유형(수준 2)입니다. |
product |
판매된 제품 유형(수준 3)입니다. |
product |
판매된 제품 유형(수준 4)입니다. |
product |
판매된 제품 유형(수준 5)입니다. |
product |
제품의 스토어 ID입니다. |
product |
제품의 이름입니다. |
product |
제품 유형(수준 1)입니다. |
product |
제품 유형(수준 2)입니다. |
product |
제품 유형(수준 3)입니다. |
product |
제품 유형(수준 4)입니다. |
product |
제품 유형(수준 5)입니다. |
quarter |
분기의 첫 번째 날짜로 표시되는 분기입니다. 분기에 대한 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식입니다. |
week |
월요일부터 일요일까지로 정의되고 월요일 날짜로 표시되는 주입니다. yyyy-MM-dd 형식입니다. |
year |
연도(yyyy 형식)입니다. |
asset |
CustomerAsset, CampaignAsset, AdGroupAsset 측정항목에만 사용됩니다. 상호작용 측정항목이 확장 소재 자체에서 발생했는지 아니면 다른 확장 소재 또는 광고 단위에서 발생했는지 나타냅니다. 상호작용(예: 클릭)은 게재된 광고의 모든 부분(예: 광고 자체 및 사이트링크와 같은 기타 구성요소)에서 함께 게재될 때 집계됩니다. interactionOnThisAsset이 true이면 이 특정 확장 소재에서 상호작용이 발생한 것이고 interactionOnThisAsset이 false이면 이 특정 확장 소재가 아닌 이 확장 소재와 함께 게재된 광고의 다른 부분에서 상호작용이 발생한 것입니다. |
AdNetworkType
Google Ads 네트워크 유형을 열거합니다.
열거형 | |
---|---|
UNSPECIFIED |
지정되지 않음 |
UNKNOWN |
이 버전에서는 값을 알 수 없습니다. |
SEARCH |
Google 검색 |
SEARCH_PARTNERS |
검색 파트너 |
CONTENT |
(디스플레이 네트워크용) |
YOUTUBE_SEARCH |
YouTube 검색 |
YOUTUBE_WATCH |
YouTube 동영상 |
MIXED |
교차 네트워크 |
키워드
키워드 기준 세그먼트입니다.
JSON 표현 |
---|
{
"info": {
object ( |
필드 | |
---|---|
info |
키워드 정보 |
ad |
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 |
애셋 리소스 이름입니다. |
interaction |
CustomerAsset, CampaignAsset, AdGroupAsset 측정항목에만 사용됩니다. 상호작용 측정항목이 확장 소재 자체에서 발생했는지 아니면 다른 확장 소재 또는 광고 단위에서 발생했는지 나타냅니다. |