이제 새 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.

user_list

사용자 목록입니다. 고객이 타겟팅할 수 있는 사용자 목록입니다. 사용자 목록의 고유 키는 id 필드로 구성됩니다. access_reason이 SHARED로 설정된 일부 예외적인 경우를 제외하고 name는 특정 고객이 소유한 사용자 목록에 대해서도 고유해야 합니다. 고유한 이름 제약조건을 위반하면 UserListError.INVALID_NAME 오류가 발생합니다.

기여도가 부여된 리소스
customer

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

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

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

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

리소스 필드
id
name
resource_name
type

세그먼트
date
keyword.ad_group_criterion
keyword.info.match_type
keyword.info.text

user_list.id
필드 설명	사용자 목록의 ID입니다.
카테고리	`ATTRIBUTE`
데이터 유형	`INT64`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

user_list.name
필드 설명	이 사용자 목록의 이름입니다. 이름이 동일한 사용자 목록의 `access_reason`이 `SHARED`으로 설정된 일부 경우를 제외하고 사용자 목록별로 고유합니다.
카테고리	`ATTRIBUTE`
데이터 유형	`STRING`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

user_list.resource_name
필드 설명	사용자 목록의 리소스 이름입니다. 사용자 목록 리소스 이름은 `customers/{customer_id}/userLists/{user_list_id}` 형식을 갖습니다.
카테고리	`ATTRIBUTE`
데이터 유형	`RESOURCE_NAME`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	거짓
반복	거짓

user_list.type
필드 설명	이 목록의 유형입니다. 이 필드는 읽기 전용입니다.
카테고리	`ATTRIBUTE`
데이터 유형	`ENUM CRM_BASED EXTERNAL_REMARKETING LOGICAL REMARKETING RULE_BASED SIMILAR UNKNOWN UNSPECIFIED`
URL 입력	`google.ads.searchads360.v0.enums.UserListTypeEnum.UserListType`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

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

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

segments.keyword.info.match_type
필드 설명	키워드의 일치 유형입니다.
카테고리	`SEGMENT`
데이터 유형	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
URL 입력	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

segments.keyword.info.text
필드 설명	키워드의 텍스트입니다(최대 80자 및 10개 단어).
카테고리	`SEGMENT`
데이터 유형	`STRING`
URL 입력	`N/A`
필터링 가능	참
선택 가능	참
Sortable	참
반복	거짓

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

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

user_list.id

user_list.name

user_list.resource_name

user_list.type

segments.date

segments.keyword.ad_group_criterion

segments.keyword.info.match_type

segments.keyword.info.text

user_list