이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. searchads-api-announcements Google 그룹에 가입하여 향후 개선사항 및 출시에 관한 최신 정보를 받아 보세요.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

customer_asset

고객과 애셋 간의 연결입니다.

기여도가 부여된 리소스
asset
customer

SELECT 및 WHERE 절에서 이 리소스와 함께 위의 리소스의 필드를 선택할 수 있습니다. 이러한 필드는 SELECT 절의 측정항목을 세분화하지 않습니다.

리소스 세분화
ad_group
campaign

위 리소스의 필드는 SELECT 및 WHERE 절에서 이 리소스와 함께 선택하면 측정항목을 분할합니다.

필드/세그먼트/측정항목

이 페이지에는 customer_asset 필드와 동일한 SELECT 절에 넣을 수 있는 모든 측정항목과 세그먼트가 표시됩니다. 하지만 FROM 절에서 customer_asset를 지정하면 일부 측정항목과 세그먼트를 사용할 수 없습니다. FROM 절에 customer_asset이 지정된 경우 사용할 수 있는 필드만 표시하려면 다음 필터를 사용하세요.

customer_asset이 쿼리의 FROM 절에 지정되어 있나요?

리소스 필드
asset
resource_name
상태

세그먼트
ad_format_type
ad_network_type
asset_interaction_target.asset
asset_interaction_target.interaction_on_this_asset
conversion_action
conversion_action_category
conversion_action_name
date
day_of_week
device
개월
분기
주
year

측정항목
absolute_top_impression_percentage
all_conversions
all_conversions_from_interactions_rate
all_conversions_from_interactions_value_per_interaction
all_conversions_value
all_conversions_value_per_cost
average_cost
average_cpc
average_cpm
clicks
client_account_conversions
client_account_conversions_value
client_account_view_through_conversions
conversions_from_interactions_value_per_interaction
cost_micros
cost_per_all_conversions
cross_device_conversions
cross_device_conversions_value
ctr
노출수
interaction_event_types
interaction_rate
interactions
top_impression_percentage
value_per_all_conversions

customer_asset.asset
필드 설명	필수 항목입니다. 변경할 수 없습니다. 고객에 연결된 애셋입니다.
카테고리	`ATTRIBUTE`
데이터 유형	`RESOURCE_NAME`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	거짓
반복	거짓

customer_asset.resource_name
필드 설명	고객 애셋의 리소스 이름입니다. CustomerAsset 리소스 이름은 `customers/{customer_id}/customerAssets/{asset_id}~{field_type}` 형식을 갖습니다.
카테고리	`ATTRIBUTE`
데이터 유형	`RESOURCE_NAME`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	거짓
반복	거짓

customer_asset.status
필드 설명	고객 애셋의 상태입니다.
카테고리	`ATTRIBUTE`
데이터 유형	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
URL 입력	`google.ads.searchads360.v0.enums.AssetLinkStatusEnum.AssetLinkStatus`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.ad_format_type
필드 설명	광고 형식 유형입니다.
카테고리	`SEGMENT`
데이터 유형	`ENUM TEXT UNKNOWN UNSPECIFIED VERTICAL_ADS_BOOKING_LINK VERTICAL_ADS_PROMOTION`
URL 입력	`google.ads.searchads360.v0.enums.AdFormatTypeEnum.AdFormatType`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.ad_network_type
필드 설명	광고 네트워크 유형입니다.
카테고리	`SEGMENT`
데이터 유형	`ENUM CONTENT MIXED SEARCH SEARCH_PARTNERS UNKNOWN UNSPECIFIED YOUTUBE_SEARCH YOUTUBE_WATCH`
URL 입력	`google.ads.searchads360.v0.enums.AdNetworkTypeEnum.AdNetworkType`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.asset_interaction_target.asset
필드 설명	애셋 리소스 이름입니다.
카테고리	`SEGMENT`
데이터 유형	`RESOURCE_NAME`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.asset_interaction_target.interaction_on_this_asset
필드 설명	CustomerAsset, CampaignAsset, AdGroupAsset 측정항목과 함께만 사용됩니다. 상호작용 측정항목이 애셋 자체에서 발생했는지 아니면 다른 애셋 또는 광고 단위에서 발생했는지를 나타냅니다.
카테고리	`SEGMENT`
데이터 유형	`BOOLEAN`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.conversion_action
필드 설명	전환 액션의 리소스 이름입니다.
카테고리	`SEGMENT`
데이터 유형	`RESOURCE_NAME`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.conversion_action_category
필드 설명	전환 액션 카테고리입니다.
카테고리	`SEGMENT`
데이터 유형	`ENUM ADD_TO_CART BEGIN_CHECKOUT BOOK_APPOINTMENT CONTACT CONVERTED_LEAD DEFAULT DOWNLOAD ENGAGEMENT GET_DIRECTIONS IMPORTED_LEAD LEAD OUTBOUND_CLICK PAGE_VIEW PHONE_CALL_LEAD PURCHASE QUALIFIED_LEAD REQUEST_QUOTE SIGNUP STORE_SALE STORE_VISIT SUBMIT_LEAD_FORM SUBSCRIBE_PAID UNKNOWN UNSPECIFIED`
URL 입력	`google.ads.searchads360.v0.enums.ConversionActionCategoryEnum.ConversionActionCategory`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.conversion_action_name
필드 설명	전환 액션 이름입니다.
카테고리	`SEGMENT`
데이터 유형	`STRING`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.date
필드 설명	측정항목이 적용되는 yyyy-MM-dd 형식의 날짜입니다(예: 2018-04-17).
카테고리	`SEGMENT`
데이터 유형	`DATE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.day_of_week
필드 설명	요일입니다(예: MONDAY).
카테고리	`SEGMENT`
데이터 유형	`ENUM FRIDAY MONDAY SATURDAY SUNDAY THURSDAY TUESDAY UNKNOWN UNSPECIFIED WEDNESDAY`
URL 입력	`google.ads.searchads360.v0.enums.DayOfWeekEnum.DayOfWeek`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.device
필드 설명	측정항목이 적용되는 기기입니다.
카테고리	`SEGMENT`
데이터 유형	`ENUM CONNECTED_TV DESKTOP MOBILE OTHER TABLET UNKNOWN UNSPECIFIED`
URL 입력	`google.ads.searchads360.v0.enums.DeviceEnum.Device`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.month
필드 설명	월의 첫 번째 날짜로 표시되는 월입니다. yyyy-MM-dd 형식으로 지정됩니다.
카테고리	`SEGMENT`
데이터 유형	`DATE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.quarter
필드 설명	분기의 첫날 날짜로 표시되는 분기입니다. 분기에 달력을 사용합니다. 예를 들어 2018년 2분기는 2018-04-01에 시작됩니다. yyyy-MM-dd 형식으로 지정됩니다.
카테고리	`SEGMENT`
데이터 유형	`DATE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.week
필드 설명	주(월요일부터 일요일까지)는 월요일 날짜로 표시됩니다. yyyy-MM-dd 형식으로 지정됩니다.
카테고리	`SEGMENT`
데이터 유형	`DATE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.year
필드 설명	연도이며, 형식은 yyyy입니다.
카테고리	`SEGMENT`
데이터 유형	`INT32`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.absolute_top_impression_percentage
필드 설명	검색 절대 상단 노출 점유율은 가장 눈에 잘 띄는 검색 위치에 표시되는 검색 광고 노출수의 비율입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.all_conversions
필드 설명	총 전환수입니다. 여기에는 include_in_conversions_metric의 값과 관계없이 모든 전환이 포함됩니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.all_conversions_from_interactions_rate
필드 설명	상호작용으로 인한 모든 전환수 (조회 후 전환과 반대)를 광고 상호작용 수로 나눈 값입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.all_conversions_from_interactions_value_per_interaction
필드 설명	상호작용에서 발생한 모든 전환의 가치를 총 상호작용 수로 나눈 값입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.all_conversions_value
필드 설명	모든 전환의 가치입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.all_conversions_value_per_cost
필드 설명	모든 전환의 가치를 광고 상호작용 (예: 텍스트 광고 클릭 또는 동영상 광고 조회)의 총비용으로 나눈 값입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.average_cost
필드 설명	상호작용 1회당 지불하는 평균 금액입니다. 이 금액은 광고의 총 비용을 총 상호작용 수로 나눠 계산합니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.average_cpc
필드 설명	모든 클릭의 총 비용을 발생한 총 클릭수로 나눈 값입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause의 metrics_currency 매개변수를 참고하세요.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.average_cpm
필드 설명	평균 CPM(1,000회 노출당비용)입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause의 metrics_currency 매개변수를 참고하세요.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.clicks
필드 설명	클릭수입니다.
카테고리	`METRIC`
데이터 유형	`INT64`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.client_account_conversions
필드 설명	고객 계정 전환수입니다. 여기에는 include_in_client_account_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.client_account_conversions_value
필드 설명	고객 계정 전환의 가치입니다. 여기에는 include_in_client_account_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.client_account_view_through_conversions
필드 설명	총 조회 후 전환 수입니다. 이는 고객이 이미지 또는 리치 미디어 광고를 보고 나서 다른 광고와 상호작용(예: 클릭)하지 않고 사이트에서 전환을 완료할 때 발생합니다.
카테고리	`METRIC`
데이터 유형	`INT64`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.conversions_from_interactions_value_per_interaction
필드 설명	상호작용에서 발생한 전환 가치를 광고 상호작용 수로 나눈 값입니다. 여기에는 include_in_conversions_metric 속성이 true로 설정된 전환 액션만 포함됩니다. 전환 기반 입찰을 사용할 경우 입찰 전략이 이러한 전환에 맞게 최적화됩니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.cost_micros
필드 설명	일정 기간에 발생한 클릭당비용(CPC)과 1,000회 노출당비용(CPM)의 합계입니다. 이 측정항목은 금전적 가치이며 기본적으로 고객의 통화로 반환됩니다. https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause의 metrics_currency 매개변수를 참고하세요.
카테고리	`METRIC`
데이터 유형	`INT64`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.cost_per_all_conversions
필드 설명	광고 상호작용 비용을 모든 전환수로 나눈 값입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.cross_device_conversions
필드 설명	고객이 하나의 기기에서 광고를 클릭한 후 다른 기기 또는 브라우저에서 전환할 때 발생하는 전환입니다. 교차 기기 전환은 이미 all_conversions에 포함되어 있습니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.cross_device_conversions_value
필드 설명	교차 기기 전환의 가치의 합계입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.ctr
필드 설명	광고에서 발생한 클릭수를 광고가 게재된 횟수(노출수)로 나눈 값입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.impressions
필드 설명	Google 네트워크에서 검색 결과 페이지 또는 웹사이트에 광고가 게재된 횟수입니다.
카테고리	`METRIC`
데이터 유형	`INT64`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.interaction_event_types
필드 설명	유료 및 무료 상호작용 유형입니다.
카테고리	`METRIC`
데이터 유형	`ENUM`
URL 입력	`google.ads.searchads360.v0.enums.InteractionEventTypeEnum.InteractionEventType`
필터링 가능	참
선택 가능	참
Sortable	거짓
반복	참

metrics.interaction_rate
필드 설명	사용자가 광고를 본 후 광고와 상호작용하는 빈도입니다. 상호작용 수를 광고가 게재된 횟수로 나눈 값입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.interactions
필드 설명	상호작용 수입니다. 상호작용이란 텍스트 및 쇼핑 광고의 클릭, 동영상 광고의 조회 등 광고 형식과 관련된 중요한 사용자 액션을 말합니다.
카테고리	`METRIC`
데이터 유형	`INT64`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.top_impression_percentage
필드 설명	상단 자연 검색 결과에 인접하여 게재되는 광고 노출수의 비율입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

metrics.value_per_all_conversions
필드 설명	모든 전환의 가치를 모든 전환수로 나눈 값입니다.
카테고리	`METRIC`
데이터 유형	`DOUBLE`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

customer_asset 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

필드/세그먼트/측정항목

customer_asset.asset

customer_asset.resource_name

customer_asset.status

segments.ad_format_type

segments.ad_network_type

segments.asset_interaction_target.asset

segments.asset_interaction_target.interaction_on_this_asset

segments.conversion_action

segments.conversion_action_category

segments.conversion_action_name

segments.date

segments.day_of_week

segments.device

segments.month

segments.quarter

segments.week

segments.year

metrics.absolute_top_impression_percentage

metrics.all_conversions

metrics.all_conversions_from_interactions_rate

metrics.all_conversions_from_interactions_value_per_interaction

metrics.all_conversions_value

metrics.all_conversions_value_per_cost

metrics.average_cost

metrics.average_cpc

metrics.average_cpm

metrics.clicks

metrics.client_account_conversions

metrics.client_account_conversions_value

metrics.client_account_view_through_conversions

metrics.conversions_from_interactions_value_per_interaction

metrics.cost_micros

metrics.cost_per_all_conversions

metrics.cross_device_conversions

metrics.cross_device_conversions_value

metrics.ctr

metrics.impressions

metrics.interaction_event_types

metrics.interaction_rate

metrics.interactions

metrics.top_impression_percentage

metrics.value_per_all_conversions

customer_asset