Package google.ads.searchads360.v0.common

색인

AdScheduleInfo

AdSchedule 기준을 나타냅니다.

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

같은 날에는 6개 이상의 AdSchedule을 추가할 수 없습니다.

필드
start_minute

MinuteOfHour

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

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

end_minute

MinuteOfHour

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

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

day_of_week

DayOfWeek

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

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

start_hour

int32

24시간 형식으로 표시한 시작 시간입니다. 이 필드는 0 이상, 23 이하여야 합니다.

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

end_hour

int32

24시간 형식으로 표시한 종료 시간입니다. 24 는 하루의 끝을 의미합니다. 이 필드는 0 이상, 24 이하여야 합니다.

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

AdTextAsset

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

필드
text

string

애셋 텍스트

AgeRangeInfo

연령대 기준입니다.

필드
type

AgeRangeType

연령대의 유형입니다.

AssetInteractionTarget

AssetInteractionTarget 세그먼트입니다.

필드
asset

string

애셋 리소스 이름입니다.

interaction_on_this_asset

bool

CustomerAsset, CampaignAsset 및 AdGroupAsset 측정항목에만 사용됩니다. 상호작용 측정항목이 애셋 자체에서 발생했는지 아니면 다른 애셋이나 광고 단위에서 발생했는지를 나타냅니다.

AssetUsage

저작물의 사용 정보가 포함됩니다.

필드
asset

string

애셋의 리소스 이름입니다.

served_asset_field_type

ServedAssetFieldType

저작물의 게재된 필드 유형입니다.

AudienceInfo

잠재고객 기준입니다.

필드
audience

string

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

BusinessProfileLocation

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

필드
labels[]

string

광고주가 비즈니스 프로필 계정의 위치에 라벨을 지정했습니다. 이 정보는 비즈니스 프로필 계정에서 동기화됩니다.

store_code

string

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

listing_id

int64

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

CallToActionAsset

클릭 유도 문구 애셋입니다.

필드
call_to_action

CallToActionType

클릭 유도 문구.

CustomParameter

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

필드
key

string

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

value

string

대체할 값입니다.

DeviceInfo

기기 기준입니다.

필드
type

Device

기기 유형입니다.

EnhancedCpc

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

전환으로 이어질 가능성이 높은 클릭에 대해서는 입찰가를 높이고, 전환으로 이어질 가능성이 낮은 클릭에 대해서는 입찰가를 낮추는 자동 입찰 전략입니다.

이 입찰 전략은 지원 중단되었으며 더 이상 만들 수 없습니다. 동일한 기능의 경우 Enhanced_cpc_enabled를 true로 설정한 ManualCpc를 사용합니다.

FrequencyCapEntry

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

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

GenderInfo

성별 기준

필드
type

GenderType

성별 유형입니다.

ImageAsset

이미지 확장 소재입니다.

필드
mime_type

MimeType

이미지 애셋의 MIME 유형입니다.

full_size

ImageDimension

원본 크기로 이 이미지에 대한 메타데이터입니다.

file_size

int64

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

ImageDimension

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

필드
height_pixels

int64

이미지의 높이입니다.

width_pixels

int64

이미지의 너비입니다.

url

string

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

키워드

키워드 기준 세그먼트.

필드
info

KeywordInfo

키워드 정보

ad_group_criterion

string

AdGroupCriterion 리소스 이름입니다.

KeywordInfo

키워드 기준입니다.

필드
match_type

KeywordMatchType

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

text

string

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

LanguageInfo

언어 기준입니다.

필드
language_constant

string

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

ListingGroupInfo

등록정보 그룹 기준입니다.

필드
type

ListingGroupType

목록 그룹의 유형입니다.

LocationGroupInfo

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

필드
geo_target_constants[]

string

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

radius_units

LocationGroupRadiusUnits

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

feed_item_sets[]

string

FeedItems가 타겟팅된 FeedItemSets 여러 ID가 지정되면 적어도 하나의 집합에 나타나는 모든 항목이 타겟팅됩니다. 이 필드는 geo_target_Constants와 함께 사용할 수 없습니다. 이는 선택사항이며 CREATE 연산에서만 설정할 수 있습니다.

radius

int64

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

LocationInfo

위치 기준입니다.

필드
geo_target_constant

string

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

ManualCpa

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

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

ManualCpc

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

필드
enhanced_cpc_enabled

bool

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

ManualCpm

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

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

MaximizeConversionValue

캠페인의 전환 가치를 최대한 높일 수 있는 방향으로 예산이 지출되는 자동 입찰 전략입니다.

필드
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

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

MaximizeConversions

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

필드
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

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

측정항목

측정항목 데이터

필드
all_conversions_value_by_conversion_date

double

모든 전환의 가치입니다. 이 열에 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열의 세부정보는 https://support.google.com/sa360/answer/9250611에서 확인할 수 있습니다.

all_conversions_by_conversion_date

double

총 전환수입니다. 여기에는 include_in_conversions_metric의 값과 관계없이 모든 전환이 포함됩니다. 이 열에 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열의 세부정보는 https://support.google.com/sa360/answer/9250611에서 확인할 수 있습니다.

conversion_custom_metrics[]

Value

전환 맞춤 측정항목입니다.

conversions_value_by_conversion_date

double

전환 날짜별 입찰 가능한 전환 가치의 합계입니다. 이 열에 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다.

conversions_by_conversion_date

double

입찰 가능한 전환 유형의 전환 날짜별 전환수 합계입니다. 기여 분석 모델링으로 인해 부분적일 수 있습니다. 이 열에 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다.

historical_creative_quality_score

QualityScoreBucket

광고 소재의 이전 품질평가점수입니다.

historical_landing_page_quality_score

QualityScoreBucket

이전 방문 페이지 만족도의 품질

historical_search_predicted_ctr

QualityScoreBucket

이전 검색의 예상 클릭률 (CTR)입니다.

interaction_event_types[]

InteractionEventType

유료 및 무료 상호작용의 유형입니다.

raw_event_conversion_metrics[]

Value

원시 이벤트 전환 측정항목입니다.

absolute_top_impression_percentage

double

검색 절대 상단 노출 점유율은 가장 눈에 잘 띄는 검색 위치에 표시되는 검색 광고 노출수의 비율입니다.

all_conversions_from_interactions_rate

double

조회 후 전환이 아니라 상호작용에서 발생한 모든 전환수를 광고 상호작용 수로 나눈 값입니다.

all_conversions_value

double

모든 전환의 가치입니다.

all_conversions

double

총 전환수입니다. 여기에는 include_in_conversions_metric의 값과 관계없이 모든 전환이 포함됩니다.

all_conversions_value_per_cost

double

모든 전환의 가치를 광고 상호작용 (예: 텍스트 광고 클릭, 동영상 광고 조회)의 총 비용으로 나눈 값입니다.

all_conversions_from_click_to_call

double

사용자가 '통화'를 클릭한 횟수 광고를 클릭하는 동안이나 클릭한 후에 매장에 전화할 수 있는 버튼 통화 연결 여부나 통화 시간은 포함되지 않습니다.

이 측정항목은 피드 항목에만 적용됩니다.

all_conversions_from_directions

double

사용자가 '경로 검색'을 클릭한 횟수 광고를 클릭한 매장으로 이동하는 버튼

이 측정항목은 피드 항목에만 적용됩니다.

all_conversions_from_interactions_value_per_interaction

double

상호작용에서 발생한 모든 전환의 가치를 총 상호작용 수로 나눈 값입니다.

all_conversions_from_menu

double

광고를 클릭한 후에 매장의 메뉴를 보기 위해 링크를 클릭한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

all_conversions_from_order

double

광고를 클릭한 후에 매장에서 주문한 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

all_conversions_from_other_engagement

double

광고를 클릭한 후에 발생한 기타 전환 (예: 매장에 대한 리뷰 게시, 매장 위치 저장) 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

all_conversions_from_store_visit

double

광고를 클릭한 후에 매장을 방문한 예상 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

visits

double

Search Ads 360이 성공적으로 기록하고 광고주의 방문 페이지로 전달한 클릭수입니다.

all_conversions_from_store_website

double

사용자가 광고를 클릭한 후 매장의 URL로 연결된 횟수입니다.

이 측정항목은 피드 항목에만 적용됩니다.

average_cost

double

상호작용당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다.

average_cpc

double

모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

average_cpm

double

평균 CPM(1,000회 노출당비용)입니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

clicks

int64

클릭수입니다.

content_budget_lost_impression_share

double

디스플레이 네트워크에 광고가 게재될 수 있었으나 예산 부족으로 인해 게재되지 못한 횟수의 예상 비율입니다. 참고: 콘텐츠 예산 상실 노출 점유율은 0~0.9 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

content_impression_share

double

디스플레이 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 콘텐츠 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

content_rank_lost_impression_share

double

디스플레이 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 콘텐츠 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

conversions_from_interactions_rate

double

전환 대상 상호작용당 평균 입찰 가능 전환수 (상호작용에서 발생한)입니다. 광고 상호작용이 입찰 가능한 전환으로 이어지는 평균 빈도를 보여줍니다.

client_account_conversions_value

double

고객 계정 전환의 가치입니다. 여기에는 include_in_client_account_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

conversions_value_per_cost

double

입찰 가능한 전환의 가치를 전환 가능한 상호작용의 총 비용으로 나눈 값입니다.

conversions_from_interactions_value_per_interaction

double

상호작용에서 발생한 전환의 가치를 광고 상호작용 수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

client_account_conversions

double

고객 계정 전환수입니다. 여기에는 include_in_client_account_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

cost_micros

int64

일정 기간에 발생한 클릭당비용(CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

cost_per_all_conversions

double

광고 상호작용의 비용을 모든 전환수로 나눈 값입니다.

cost_per_conversion

double

입찰 가능한 전환당 전환 가능한 평균 비용입니다.

cost_per_current_model_attributed_conversion

double

광고 상호작용의 비용을 현재 모델의 기여 전환수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

cross_device_conversions

double

고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다.

cross_device_conversions_value

double

교차 기기 전환의 가치의 합계입니다.

ctr

double

광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.

conversions

double

전환이 발생한 횟수 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.

conversions_value

double

'전환수' 필드에 포함된 전환에 대한 전환 가치의 합계입니다. 이 측정항목은 전환 액션의 가치를 입력한 경우에만 유용합니다.

average_quality_score

double

평균 품질평가점수입니다.

historical_quality_score

int64

이전 품질평가점수입니다.

impressions

int64

Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.

interaction_rate

double

사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다.

interactions

int64

상호작용 수입니다. 상호작용이란 텍스트 및 쇼핑 광고의 경우 광고 형식 클릭, 동영상 광고의 경우 조회 등과 관련된 주요 사용자 액션을 말합니다.

invalid_click_rate

double

보고 기간 동안 총 클릭수 (필터링된 클릭수 + 필터링되지 않은 클릭수)에서 필터링된 클릭수의 비율입니다.

invalid_clicks

int64

Google에서 불법으로 간주하여 비용을 청구하지 않는 클릭수

mobile_friendly_clicks_percentage

double

모바일 친화적 페이지로 연결되는 모바일 클릭수의 비율입니다.

search_absolute_top_impression_share

double

가장 눈에 잘 띄는 쇼핑 위치에 표시되는 고객의 쇼핑 또는 검색 광고 노출수 비율입니다. 자세한 내용은 https://support.google.com/sa360/answer/9566729를 참고하세요. 0.1 미만의 값은 0.0999로 보고됩니다.

search_budget_lost_absolute_top_impression_share

double

예산 부족으로 인해 광고가 검색결과의 상단 광고 중 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산 상실 절대 상단 노출 점유율은 0~0.9 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

search_budget_lost_impression_share

double

광고가 검색 네트워크에 게재될 수 있었지만 너무 낮은 예산으로 인해 게재되지 않은 횟수의 예상 비율입니다. 참고: 검색 예산 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

search_budget_lost_top_impression_share

double

예산 부족으로 인해 광고가 상단 자연 검색 결과에 인접하여 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 예산 상실 상단 노출 점유율은 0~0.9 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

search_click_share

double

검색 네트워크에서 실제로 발생한 클릭수를 발생 가능한 예상 클릭수로 나눈 값입니다. 참고: 검색 클릭 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

search_exact_match_impression_share

double

발생한 노출수를 키워드 검색 유형에 관계없이 키워드와 정확히 일치하거나 키워드의 유사 검색어와 검색 네트워크에서 발생 가능한 예상 노출수로 나눈 값입니다. 참고: 검색 일치검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

search_impression_share

double

검색 네트워크에서 발생 가능한 예상 노출수 대비 실제 발생한 노출수의 비율입니다. 참고: 검색 노출 점유율은 0.1~1의 범위로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

search_rank_lost_absolute_top_impression_share

double

광고 순위가 낮아 광고가 검색 결과 상단 광고 중 첫 번째 광고로 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상실 절대 상단 노출 점유율은 0~0.9 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

search_rank_lost_impression_share

double

검색 네트워크에서 낮은 광고 순위로 인해 발생하지 않은 노출 수의 예상 비율입니다. 참고: 검색 순위 노출 점유율 손실은 0~0.9의 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

search_rank_lost_top_impression_share

double

광고 순위가 낮아 광고가 상단 자연 검색 결과에 인접하여 게재되지 않은 빈도를 추정한 수치입니다. 참고: 검색 순위 상실 상단 노출 점유율은 0~0.9 범위로 보고됩니다. 0.9를 초과하는 값은 0.9001로 보고됩니다.

search_top_impression_share

double

상단 광고에서 발생 가능한 예상 노출수 대비 상단 광고에서 발생한 노출수의 비율입니다. 참고: 검색 상단 노출 점유율은 0.1~1의 값으로 보고됩니다. 0.1 미만의 값은 0.0999로 보고됩니다.

상단 광고는 일반적으로 상단 자연 검색 결과 위에 게재되지만, 일부 검색어의 경우에는 상단 자연 검색 결과 아래에 게재될 수 있습니다.

top_impression_percentage

double

상단 자연 검색 결과에 인접하여 게재되는 광고 노출의 비율입니다.

value_per_all_conversions

double

모든 전환의 가치를 전체 전환수로 나눈 값입니다.

value_per_all_conversions_by_conversion_date

double

모든 전환의 가치를 전체 전환수로 나눈 값입니다. 이 열에 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다. by_conversion_date 열의 세부정보는 https://support.google.com/sa360/answer/9250611에서 확인할 수 있습니다.

value_per_conversion

double

입찰 가능한 전환의 가치를 입찰 가능한 전환수로 나눈 값입니다. 입찰 가능한 각 전환의 평균 가치를 보여줍니다.

value_per_conversions_by_conversion_date

double

전환 날짜로 나눈 입찰 가능한 전환 가치를 전환 날짜로 나눈 입찰 가능한 전환수로 나눈 값입니다. 입찰 가능한 각 전환의 평균 가치를 표시 (전환 날짜별)합니다. 이 열에 날짜와 함께 선택된 경우 날짜 열의 값은 전환 날짜를 의미합니다.

client_account_view_through_conversions

int64

총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용(예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.

client_account_cross_sell_cost_of_goods_sold_micros

int64

고객 계정 크로스셀(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_sell_cost_of_goods_sold_micros

int64

크로스셀(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)를 참고하세요.

client_account_cross_sell_gross_profit_micros

int64

고객 계정 크로스셀(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_sell_gross_profit_micros

int64

크로스셀(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)를 참고하세요.

client_account_cross_sell_revenue_micros

int64

고객 계정 크로스셀(cross-sell) 수익은 다른 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 수익은 광고로 인해 발생한 크로스셀(cross-sell)에서 창출된 총 가치입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 크로스셀(cross-sell) 수익은 20,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

cross_sell_revenue_micros

int64

크로스셀(cross-sell) 수익은 다른 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell) 수익은 광고로 인해 발생한 크로스셀(cross-sell)에서 창출된 총 가치입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 크로스셀(cross-sell) 수익은 20,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

client_account_cross_sell_units_sold

double

고객 계정 크로스셀(cross-sell)을 통해 판매된 제품수는 다른 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통해 판매된 제품수는 광고에 기여한 모든 주문의 크로스셀(cross-sell) 제품 총 개수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 크로스셀(cross-sell)을 통해 판매된 제품수는 2개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

cross_sell_units_sold

double

크로스셀(cross-sell)을 통해 판매된 제품수는 다른 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 이러한 제품이 일치하지 않으면 크로스셀(cross-sell)로 간주됩니다. 크로스셀(cross-sell)을 통해 판매된 제품수는 광고에 기여한 모든 주문의 크로스셀(cross-sell) 제품 총 개수입니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 크로스셀(cross-sell)을 통해 판매된 제품수는 2개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

client_account_lead_cost_of_goods_sold_micros

int64

고객 계정 리드 매출원가 (COGS)는 동일한 제품을 광고한 결과로 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 상호작용된 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이러한 제품의 비용은 리드 매출원가에 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 리드 매출원가는 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

lead_cost_of_goods_sold_micros

int64

리드 매출원가(COGS)는 동일한 제품을 광고한 결과로 판매된 제품의 총 비용입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 상호작용된 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 이러한 제품의 비용은 리드 매출원가에 포함됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 매출원가는 3,000원이고 셔츠의 매출원가는 5,000원입니다. 이 주문의 리드 매출원가는 3,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

client_account_lead_gross_profit_micros

int64

고객 계정 리드 총이익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 이익에서 매출원가 (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_gross_profit_micros

int64

리드 총이익은 동일한 제품을 광고한 결과로 판매된 제품으로 얻은 이익에서 매출원가(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)를 참고하세요.

client_account_lead_revenue_micros

int64

고객 계정 리드 수익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고 제품과 판매된 제품이 일치하면 해당 제품의 판매에서 발생한 총 가치가 리드 수익에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 리드 수익은 10,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

lead_revenue_micros

int64

리드 수익은 동일한 제품을 광고한 결과로 판매된 제품에서 발생한 총 금액입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고 제품과 판매된 제품이 일치하면 해당 제품의 판매에서 발생한 총 가치가 리드 수익에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자와 셔츠를 구매했습니다. 모자의 가격은 10,000원, 셔츠의 가격은 20,000원입니다. 이 주문의 리드 수익은 10,000원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. metrics_currency 매개변수(https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause)를 참고하세요.

client_account_lead_units_sold

double

고객 계정 판매된 리드 단위 수는 동일한 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 판매된 제품의 총 수가 판매된 리드 단위 아래에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 판매된 리드 단위는 1개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

lead_units_sold

double

판매된 리드 단위 수는 동일한 제품을 광고한 결과로 판매된 총 제품 수입니다. 작동 방식: 웹사이트에서 완료된 구매의 장바구니 데이터를 사용한 전환 추적을 보고합니다. 구매 전에 상호작용한 광고에 연결된 제품이 있는 경우 (쇼핑 광고 참고) 이 제품은 광고 중인 제품으로 간주됩니다. 고객의 주문에 포함된 제품은 판매된 제품입니다. 광고된 제품과 판매된 제품이 일치하는 경우 판매된 제품의 총 수가 판매된 리드 단위 아래에 표시됩니다. 예: 사용자가 모자 쇼핑 광고를 클릭하고 동일한 모자, 셔츠, 재킷을 구매했습니다. 이 주문에서 판매된 리드 단위는 1개입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다.

MobileAppAsset

모바일 앱을 나타내는 애셋입니다.

필드
app_id

string

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

app_store

MobileAppVendor

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

PercentCpc

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

필드
cpc_bid_ceiling_micros

int64

입찰 전략으로 설정할 수 있는 최대 입찰가 한도입니다. 광고주가 입력하고 로컬 마이크로에서 지정하는 선택 입력란입니다. 참고: 0 값은 입찰_최대 한도를 정의되지 않은 것과 같은 방식으로 해석됩니다.

enhanced_cpc_enabled

bool

전환 가능성에 따라 각 입찰의 입찰가를 상향 또는 하향 조정합니다. 개별 입찰가는 cpc_bid_ 증가_micros를 초과할 수 있지만, 캠페인의 평균 입찰가는 'CPC'를 초과할 수 없습니다.

RealTimeBiddingSetting

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

필드
opt_in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

확장 동적 검색 광고

필드
description1

string

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

description2

string

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

ad_tracking_id

int64

광고의 추적 ID입니다.

SearchAds360ExpandedTextAdInfo

Search Ads 360 확장 텍스트 광고

필드
headline

string

광고의 제목입니다.

headline2

string

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

headline3

string

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

description1

string

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

description2

string

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

path1

string

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

path2

string

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

ad_tracking_id

int64

광고의 추적 ID입니다.

SearchAds360ProductAdInfo

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

Search Ads 360 제품 광고

SearchAds360ResponsiveSearchAdInfo

Search Ads 360 반응형 검색 광고

필드
headlines[]

AdTextAsset

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

descriptions[]

AdTextAsset

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

path1

string

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

path2

string

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

ad_tracking_id

int64

광고의 추적 ID입니다.

SearchAds360TextAdInfo

Search Ads 360 텍스트 광고

필드
headline

string

광고의 제목입니다.

description1

string

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

description2

string

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

display_url

string

광고의 표시 URL입니다.

display_mobile_url

string

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

ad_tracking_id

int64

광고의 추적 ID입니다.

세그먼트

세그먼트 전용 필드입니다.

필드
ad_network_type

AdNetworkType

광고 네트워크 유형입니다.

conversion_action_category

ConversionActionCategory

전환 액션 카테고리입니다.

conversion_custom_dimensions[]

Value

전환 맞춤 측정기준입니다.

day_of_week

DayOfWeek

요일(예: MONDAY)

device

Device

측정항목이 적용되는 기기입니다.

keyword

Keyword

키워드 기준

product_channel

ProductChannel

제품의 채널입니다.

product_channel_exclusivity

ProductChannelExclusivity

제품의 단일 채널 판매 여부입니다.

product_condition

ProductCondition

제품 상태입니다.

product_sold_condition

ProductCondition

판매된 제품의 상태입니다.

raw_event_conversion_dimensions[]

Value

원시 이벤트 전환 측정기준입니다.

conversion_action

string

전환 액션의 리소스 이름입니다.

conversion_action_name

string

전환 액션 이름입니다.

date

string

측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17).

geo_target_city

string

도시를 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geo_target_country

string

국가를 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

geo_target_metro

string

대도시를 나타내는 지역 타겟 상수의 리소스 이름입니다.

geo_target_region

string

지역을 나타내는 지역 타겟팅 상수의 리소스 이름입니다.

hour

int32

시간을 0 이상 23 이하의 숫자로 나타냅니다.

month

string

월(월의 첫 번째 날의 날짜로 표시) 형식은 yyyy-MM-dd입니다.

product_bidding_category_level1

string

제품의 입찰 카테고리(수준 1)입니다.

product_bidding_category_level2

string

제품의 입찰 카테고리(수준 2)입니다.

product_bidding_category_level3

string

제품의 입찰 카테고리(수준 3)입니다.

product_bidding_category_level4

string

제품의 입찰 카테고리(수준 4)입니다.

product_bidding_category_level5

string

제품의 입찰 카테고리(수준 5)입니다.

product_brand

string

제품의 브랜드입니다.

product_country

string

제품의 판매 국가에 대한 지역 타겟 상수의 리소스 이름입니다.

product_custom_attribute0

string

제품의 커스텀 속성 0입니다.

product_custom_attribute1

string

제품의 커스텀 속성 1입니다.

product_custom_attribute2

string

제품의 커스텀 속성 2입니다.

product_custom_attribute3

string

제품의 커스텀 속성 3입니다.

product_custom_attribute4

string

제품의 커스텀 속성 4입니다.

product_item_id

string

제품의 상품 ID입니다.

product_language

string

제품의 언어에 대한 언어 상수의 리소스 이름입니다.

product_sold_bidding_category_level1

string

판매된 제품의 입찰 카테고리 (수준 1)입니다.

product_sold_bidding_category_level2

string

판매된 제품의 입찰 카테고리 (수준 2)입니다.

product_sold_bidding_category_level3

string

판매된 제품의 입찰 카테고리 (수준 3)입니다.

product_sold_bidding_category_level4

string

판매된 제품의 입찰 카테고리 (수준 4)입니다.

product_sold_bidding_category_level5

string

판매된 제품의 입찰 카테고리 (수준 5)입니다.

product_sold_brand

string

판매된 제품의 브랜드입니다.

product_sold_custom_attribute0

string

판매된 제품의 맞춤 속성 0입니다.

product_sold_custom_attribute1

string

판매된 제품의 맞춤 속성 1입니다.

product_sold_custom_attribute2

string

판매된 제품의 맞춤 속성 2입니다.

product_sold_custom_attribute3

string

판매된 제품의 맞춤 속성 3입니다.

product_sold_custom_attribute4

string

판매된 제품의 맞춤 속성 4입니다.

product_sold_item_id

string

판매된 제품의 상품 ID입니다.

product_sold_title

string

판매된 제품의 이름입니다.

product_sold_type_l1

string

판매된 제품 유형(수준 1)입니다.

product_sold_type_l2

string

판매된 제품 유형(수준 2)입니다.

product_sold_type_l3

string

판매된 제품 유형(수준 3)입니다.

product_sold_type_l4

string

판매된 제품 유형(수준 4)입니다.

product_sold_type_l5

string

판매된 제품 유형(수준 5)입니다.

product_store_id

string

제품의 스토어 ID입니다.

product_title

string

제품의 이름입니다.

product_type_l1

string

제품 유형(수준 1)입니다.

product_type_l2

string

제품 유형(수준 2)입니다.

product_type_l3

string

제품 유형(수준 3)입니다.

product_type_l4

string

제품 유형(수준 4)입니다.

product_type_l5

string

제품 유형(수준 5)입니다.

quarter

string

분기 첫날의 날짜로 표시되는 분기입니다. 분기에 연도를 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. 형식은 yyyy-MM-dd입니다.

week

string

주(월요일에서 일요일까지로 정의되고 월요일 날짜로 표시됨) 형식은 yyyy-MM-dd입니다.

year

int32

yyyy 형식의 연도입니다.

asset_interaction_target

AssetInteractionTarget

CustomerAsset, CampaignAsset 및 AdGroupAsset 측정항목에만 사용됩니다. 상호작용 측정항목이 애셋 자체에서 발생했는지 아니면 다른 애셋이나 광고 단위에서 발생했는지를 나타냅니다. 상호작용 (예: 클릭수)은 함께 게재될 때 게재된 광고의 모든 부분 (예: 광고 자체 및 사이트링크와 같은 기타 구성요소)에서 집계됩니다. 상호작용_on_this_asset이 true이면 이 특정 애셋에서 상호작용이 발생했다는 의미이고, 상호작용_on_this_asset이 false인 경우 상호작용은 이 특정 애셋이 아니라 애셋과 함께 게재된 광고의 다른 부분에서 발생한 것입니다.

TargetCpa

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

필드
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetCpm

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

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

TargetImpressionShare

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

필드
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

타겟 위치에 표시할 광고의 마이크로 단위 비율입니다. 예를 들어 1% 는 10,000과 같습니다.

cpc_bid_ceiling_micros

int64

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

TargetOutrankShare

광고주가 특정 경쟁업체보다 높은 순위를 얻어야 하는 입찰 타겟 비율에 따라 입찰가를 설정하는 자동 입찰 전략입니다. 이 전략은 지원 중단되었습니다.

필드
cpc_bid_ceiling_micros

Int64Value

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

TargetRestriction

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

필드
targeting_dimension

TargetingDimension

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

bid_only

bool

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

TargetRoas

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

필드
target_roas

double

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetSpend

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

필드
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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

TargetingSetting

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

필드
target_restrictions[]

TargetRestriction

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

TextAsset

텍스트 애셋입니다.

필드
text

string

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

TextLabel

색이 있는 배경에 텍스트를 표시하는 라벨 유형입니다.

필드
background_color

string

16진수 형식의 라벨의 배경 색상입니다. 이 문자열은 정규 표현식 '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'와 일치해야 합니다. 참고: 관리자 계정의 경우 배경 색상이 표시되지 않을 수 있습니다.

description

string

라벨에 관한 간단한 설명입니다. 길이는 200자(영문 기준) 이하여야 합니다.

UnifiedCallAsset

통합 전화번호 확장 소재

필드
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

string

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

ad_schedule_targets[]

AdScheduleInfo

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

call_only

bool

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

call_tracking_enabled

bool

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

use_searcher_time_zone

bool

전화번호 광고 확장을 검색 사용자의 시간대로 표시할지 여부입니다. Microsoft Ads에 적용됩니다.

start_date

string

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

end_date

string

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

UnifiedCalloutAsset

통합 콜아웃 확장 소재

필드
callout_text

string

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

start_date

string

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

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

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

use_searcher_time_zone

bool

검색 사용자의 시간대로 애셋을 표시할지 여부입니다. Microsoft Ads에 적용됩니다.

UnifiedLocationAsset

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

필드
place_id

string

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

business_profile_locations[]

BusinessProfileLocation

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

location_ownership_type

LocationOwnershipType

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

UnifiedPageFeedAsset

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

필드
page_url

string

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

labels[]

string

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

UnifiedSitelinkAsset

통합 사이트링크 확장 소재입니다.

필드
description1

string

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

description2

string

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

start_date

string

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

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

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

tracking_id

int64

사이트링크 확장 소재의 클릭수를 추적하는 데 사용되는 ID입니다. Yahoo! Japan만 해당 필드에 입력하세요.

use_searcher_time_zone

bool

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

mobile_preferred

bool

휴대기기에 사이트링크 확장 소재를 표시할지 여부입니다. Microsoft Ads에 적용됩니다.

UserListInfo

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

필드
user_list

string

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

일반 데이터 컨테이너.

필드
통합 필드 value. 값 value은 다음 중 하나여야 합니다.
boolean_value

bool

불리언

int64_value

int64

int64입니다.

float_value

float

부동 소수점 수

double_value

double

double

string_value

string

문자열.

WebpageConditionInfo

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

필드
operand

WebpageConditionOperand

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

operator

WebpageConditionOperator

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

argument

string

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

WebpageInfo

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

필드
conditions[]

WebpageConditionInfo

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

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

coverage_percentage

double

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

criterion_name

string

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

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

YoutubeVideoAsset

YouTube 저작물

필드
youtube_video_title

string

YouTube 동영상 제목입니다.

youtube_video_id

string

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