Package google.ads.searchads360.v0.common

색인

AdScheduleInfo

AdSchedule 기준을 나타냅니다.

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

AdSchedule은 하루에 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 이하여야 합니다.

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

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

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에서 metric_currency 매개변수를 참고하세요.

average_cpm

double

평균 CPM(1,000회 노출당비용)입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause에서 metric_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에서 metric_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_value

double

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

ctr

double

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

conversions

double

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

conversions_value

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

cross_sell_cost_of_goods_sold_micros

int64

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

lead_revenue_micros

int64

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

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_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 반응형 검색 광고

입력란
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).

month

string

월(1일의 일자)로 표시됩니다. 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 측정항목과만 함께 사용하세요. 상호작용 측정항목이 애셋 자체에서 발생했는지 아니면 다른 애셋 또는 광고 단위에서 발생했는지를 나타냅니다. 상호작용 (예: 클릭수)은 함께 게재될 때 게재된 광고의 모든 부분 (예: 광고 자체 및 사이트링크와 같은 기타 구성요소)에서 집계됩니다. contacts_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

라벨의 배경색(RGB 형식)입니다. 이 문자열은 정규식 '^#([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

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

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

YoutubeVideoAsset

YouTube 저작물

입력란
youtube_video_title

string

YouTube 동영상 제목

youtube_video_id

string

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