UserAttribute
Stay organized with collections
Save and categorize content based on your preferences.
User attribute, can only be used with CUSTOMER_MATCH_WITH_ATTRIBUTES job type.
| Fields |
last_purchase_date_time
|
string
Timestamp of the last purchase made by the user. The format is YYYY-MM-DD HH:MM:SS[+/-HH:MM], where [+/-HH:MM] is an optional timezone offset from UTC. If the offset is absent, the API will use the account's timezone as default.
|
average_purchase_count
|
int32
Advertiser defined average number of purchases that are made by the user in a 30 day period.
|
average_purchase_value_micros
|
int64
Advertiser defined average purchase value in micros for the user.
|
acquisition_date_time
|
string
Timestamp when the user was acquired. The format is YYYY-MM-DD HH:MM:SS[+/-HH:MM], where [+/-HH:MM] is an optional timezone offset from UTC. If the offset is absent, the API will use the account's timezone as default.
|
lifecycle_stage
|
string
Optional. Advertiser defined lifecycle stage for the user. The accepted values are "Lead", "Active" and "Churned".
|
first_purchase_date_time
|
string
Optional. Timestamp of the first purchase made by the user. The format is YYYY-MM-DD HH:MM:SS[+/-HH:MM], where [+/-HH:MM] is an optional timezone offset from UTC. If the offset is absent, the API will use the account's timezone as default.
|
event_attribute[]
|
EventAttribute
Optional. Advertiser defined events and their attributes. All the values in the nested fields are required. Currently this field is in beta.
|
lifetime_value_micros
|
int64
Advertiser defined lifetime value for the user.
|
lifetime_value_bucket
|
int32
Advertiser defined lifetime value bucket for the user. The valid range for a lifetime value bucket is from 1 (low) to 10 (high), except for remove operation where 0 will also be accepted.
|
|
ShoppingLoyalty
The shopping loyalty related data. Shopping utilizes this data to provide users with a better experience. Accessible only to merchants on the allow-list with the user's consent.
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[],[],null,["# UserAttribute\n\nUser attribute, can only be used with CUSTOMER_MATCH_WITH_ATTRIBUTES job type.\n\n| Fields ||\n|-------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ### `last_purchase_date_time` | `string` Timestamp of the last purchase made by the user. The format is YYYY-MM-DD HH:MM:SS\\[+/-HH:MM\\], where \\[+/-HH:MM\\] is an optional timezone offset from UTC. If the offset is absent, the API will use the account's timezone as default. |\n| ### `average_purchase_count` | `int32` Advertiser defined average number of purchases that are made by the user in a 30 day period. |\n| ### `average_purchase_value_micros` | `int64` Advertiser defined average purchase value in micros for the user. |\n| ### `acquisition_date_time` | `string` Timestamp when the user was acquired. The format is YYYY-MM-DD HH:MM:SS\\[+/-HH:MM\\], where \\[+/-HH:MM\\] is an optional timezone offset from UTC. If the offset is absent, the API will use the account's timezone as default. |\n| ### `lifecycle_stage` | `string` Optional. Advertiser defined lifecycle stage for the user. The accepted values are \"Lead\", \"Active\" and \"Churned\". |\n| ### `first_purchase_date_time` | `string` Optional. Timestamp of the first purchase made by the user. The format is YYYY-MM-DD HH:MM:SS\\[+/-HH:MM\\], where \\[+/-HH:MM\\] is an optional timezone offset from UTC. If the offset is absent, the API will use the account's timezone as default. |\n| ### `event_attribute[]` | [EventAttribute](/google-ads/api/reference/rpc/v21/EventAttribute) Optional. Advertiser defined events and their attributes. All the values in the nested fields are required. Currently this field is in beta. |\n| ### `lifetime_value_micros` | `int64` Advertiser defined lifetime value for the user. |\n| ### `lifetime_value_bucket` | `int32` Advertiser defined lifetime value bucket for the user. The valid range for a lifetime value bucket is from 1 (low) to 10 (high), except for remove operation where 0 will also be accepted. |\n| ### `shopping_loyalty` | [ShoppingLoyalty](/google-ads/api/reference/rpc/v21/ShoppingLoyalty) The shopping loyalty related data. Shopping utilizes this data to provide users with a better experience. Accessible only to merchants on the allow-list with the user's consent. |"]]
