Page Summary
-
A user list is a list of users a customer may target for advertising.
-
User list data includes an ID, name, resource name and type.
-
User list resource names follow the format:
customers/{customer_id}/userLists/{user_list_id}. -
User list types include CRM-based, external remarketing, logical, remarketing, rule-based, and similar.
A user list. This is a list of users a customer may target. The unique key of a user list consists of the following fields: id
. Note that the name
must also be unique for user lists owned by a given customer, except in some cases where access_reason
is set to SHARED
. Violating the unique name constraint produces error: UserListError.INVALID_NAME
.
| Attributed resources |
|---|
| customer |
Fields from the above resources may be selected along with this
resource in your SELECT and WHERE clauses. These fields will not segment
metrics in your SELECT
clause.
Fields/Segments/Metrics
This page shows all metrics and segments that can be put in the same SELECT clause as the fields of user_list
.
However, when you specify user_list
in the FROM clause, some metrics and segments
cannot be used.
Use the following filter to show only the fields that can be used when user_list
is specified in the FROM clause.
Is user_list
specified in the FROM clause of your query?
| Resource fields |
|---|
| id |
| name |
| resource_name |
| type |
user_list.id
ATTRIBUTE
INT64
N/A
user_list.name
access_reason
set to SHARED
.ATTRIBUTE
STRING
N/A
user_list.resource_name
customers/{customer_id}/userLists/{user_list_id}
ATTRIBUTE
RESOURCE_NAME
N/A
user_list.type
ATTRIBUTE
google.ads.searchads360.v0.enums.UserListTypeEnum.UserListType
segments.date
SEGMENT
DATE
N/A
segments.keyword.ad_group_criterion
SEGMENT
RESOURCE_NAME
N/A
segments.keyword.info.match_type
SEGMENT
google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType
segments.keyword.info.text
SEGMENT
STRING
N/A
