Package google.ads.searchads360.v0.common

색인

AdScheduleInfo

AdSchedule 기준을 나타냅니다.

AdSchedule은 광고가 게재되는 요일 및 시간 간격으로 지정됩니다.

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

필드
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 사이여야 합니다(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

FeedItem이 타겟팅된 FeedItemSet입니다. 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를 설정하지 않으면 입찰 전략은 예산에 대해 최대한 높은 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

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

average_cpm

double

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

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)의 합계입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

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_by_conversion_date

double

전환 날짜별 교차 기기 전환수입니다. by_conversion_date 열의 세부정보는 https://support.google.com/sa360/answer/9250611에서 확인할 수 있습니다.

cross_device_conversions_value

double

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

cross_device_conversions_value_by_conversion_date

double

전환 날짜별 교차 기기 전환 가치의 합계입니다. by_conversion_date 열에 관한 자세한 내용은 https://support.google.com/sa360/answer/9250611에서 확인하세요.

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에서 불법으로 간주하여 비용을 청구하지 않는 클릭수입니다.

general_invalid_click_rate

double

전체 클릭수 (필터링된 클릭수 + 필터링되지 않은 클릭수)에서 일반 무효 클릭으로 인해 필터링된 클릭이 차지하는 비율입니다. Google에서 불법으로 간주하는 클릭으로, 일반적인 필터링 수단 (예: 알려진 무효 데이터 센터 트래픽, 봇 및 스파이더 또는 기타 크롤러, 비정상적인 패턴 등)을 통해 감지됩니다. 무효 클릭은 비용을 발생시키지 않으며, 계정 통계에 영향을 주지 않습니다. 자세한 내용은 https://support.google.com/campaignmanager/answer/6076504의 도움말 페이지를 참고하세요.

general_invalid_clicks

int64

일반 무효 클릭수입니다. '일반 무효 클릭'은 일반적인 필터링 수단 (예: 알려진 무효 데이터 센터 트래픽, 봇 및 스파이더 또는 기타 크롤러, 비정상적인 패턴 등)을 통해 감지된 무효 클릭의 하위 집합입니다. 무효 클릭은 비용을 발생시키지 않으며, 계정 통계에 영향을 주지 않습니다. 자세한 내용은 https://support.google.com/campaignmanager/answer/6076504의 도움말 페이지를 참고하세요.

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원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

cross_sell_cost_of_goods_sold_micros

int64

크로스셀(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_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원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 값이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

client_account_cross_sell_revenue_micros

int64

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

int64

크로스셀(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_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원입니다. 이 측정항목은 장바구니 데이터를 사용한 전환 추적을 보고하는 경우에만 사용할 수 있습니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metrics_currency 매개변수를 참고하세요.

lead_cost_of_goods_sold_micros

int64

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

client_account_lead_gross_profit_micros

int64

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

lead_gross_profit_micros

int64

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

int64

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

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

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

app_store

MobileAppVendor

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

PercentCpc

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

필드
cpc_bid_ceiling_micros

int64

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

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 측정항목에만 사용됩니다. 상호작용 측정항목이 확장 소재 자체에서 발생했는지 아니면 다른 확장 소재 또는 광고 단위에서 발생했는지 나타냅니다. 상호작용(예: 클릭)은 게재된 광고의 모든 부분(예: 광고 자체 및 사이트링크와 같은 기타 구성요소)에서 함께 게재될 때 집계됩니다. interaction_on_this_asset이 true이면 상호작용이 이 특정 확장 소재에 있음을 의미하고 interaction_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

이 targeting_dimension에 대해 선택한 기준에 대해서만 광고가 게재되도록 제한할지 또는 이 targeting_dimension의 모든 값을 타겟팅하고 다른 TargetingDimensions의 타겟팅을 기반으로 광고를 게재할지 나타냅니다. 값이 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

전화번호의 2자리 국가 코드입니다. 예: '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 Advertising에 적용됩니다.

call_tracking_enabled

bool

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

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 Advertising에 적용됩니다.

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! 일본만 해당하는 입력란입니다.

use_searcher_time_zone

bool

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

mobile_preferred

bool

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

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

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

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

YoutubeVideoAsset

YouTube 저작물

필드
youtube_video_title

string

YouTube 동영상 제목입니다.

youtube_video_id

string

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