Package google.ads.searchads360.v0.common

색인

AdScheduleInfo

광고 일정 기준을 나타냅니다.

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

동일한 날짜에 6개 이상의 AdSchedules를 추가할 수 없습니다.

필드
start_minute

MinuteOfHour

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

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

end_minute

MinuteOfHour

이 일정이 종료되는 종료 시간 이후의 분입니다. 일정에는 종료 분이 포함되지 않습니다.

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

day_of_week

DayOfWeek

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

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

start_hour

int32

24시간 형식의 시작 시간입니다. 이 필드는 0~23 사이여야 합니다(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를 사용하세요.

FinalAppUrl

지정된 운영체제의 앱으로 딥 링크되는 URL입니다.

필드
os_type

AppUrlOperatingSystemType

이 URL이 타겟팅하는 운영체제입니다. 필수 항목입니다.

url

string

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

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를 달성하는 것을 목표로 합니다.

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

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

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

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

client_account_lead_units_sold

double

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

lead_units_sold

double

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

unique_users

int64

요청된 기간 동안 광고를 본 순 사용자 수입니다. 이 측정항목은 집계할 수 없으며 92일 이하의 기간에 대해서만 요청할 수 있습니다. 이 측정항목은 디스플레이, 동영상, 디스커버리, 앱 캠페인 유형에서 사용할 수 있습니다.

average_impression_frequency_per_user

double

요청된 기간 동안 순 사용자가 광고를 본 평균 횟수입니다. 이 측정항목은 집계할 수 없으며 92일 이하의 기간에 대해서만 요청할 수 있습니다. 이 측정항목은 디스플레이, 동영상, 디스커버리, 앱 캠페인 유형에서 사용할 수 있습니다.

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_ceiling_micros를 초과할 수 있지만 캠페인의 평균 입찰가는 초과해서는 안 됩니다.

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 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! 일본만 해당되는 필드입니다.

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

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

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

YoutubeVideoAsset

YouTube 저작물입니다.

필드
youtube_video_title

string

YouTube 동영상 제목입니다.

youtube_video_id

string

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