Skip to main content

User Data Updated

When to Use​

Use this as an alternative when you cannot send updated user data together with a regular event (e.g., checkout_completed, login, sign_up).

The recommended approach is always to include the user object alongside any standard event. Use user_data_updated only when no other event is being triggered — for example, after a background CRM sync, a profile update on a page with no other tracked action, or when enriching user data from a third-party source.

warning

This is not a conversion event. It exists solely to sync user data to destinations (Google Analytics User-ID, Meta Advanced Matching, TikTok user parameters). Whenever possible, attach the user object to an existing event instead of using this standalone push.

Complete Reference​

event object

info

Optional. When included, use only static value user_data_updated for event.name. On web (JavaScript), the event object can be omitted entirely.

name string

name: "user_data_updated"

context object

info

Optional. Useful for webhook implementations to specify environment and data source.

url string required-if-applicable

info

Collected automatically for standard websites. Required only for SPA applications where URL changes don't trigger automatic page context updates.

url:"https://shop.example.com/products/laptop?color=silver&storage=512gb&utm_source=google"
warning

URL Parameter Sensitivity: Be mindful of sensitive information in URLs. Query parameters may contain personal identifiers, session tokens, or private information that should be handled according to privacy regulations.

page_type string recommended

info

Type of page (product, home ...)

page_type: "product"

environment string recommended

info

Allowed values: prod, dev

environment: "prod"

user object required

info
View complete User Object documentation

id string recommended

info

Unique customer identifier in your system.

id: "CUSTOMER_INTERNAL_ID"

email string recommended

info

Customer email address in plaintext. Do not send pre-hashed values — DATA Reshape automatically normalizes and hashes before sending to destinations.

email: "[email protected]"

phone string recommended

info

Customer phone number in E.164 format (plaintext). Do not send pre-hashed values — DATA Reshape automatically normalizes and hashes before sending to destinations.

phone: "+40712345678"

first_name string recommended

info

Customer first name

first_name: "John"

last_name string recommended

info

Customer last name

last_name: "Doe"

country string

info

Country name or ISO country code

country: "Romania"

region string recommended

info

State, province, or region name

region: "Bucuresti"

city string recommended

info

City or locality name

city: "Bucuresti"

street string

info

Street address including number

street: "Strada Principala 1"

postal_code string

info

Postal code or ZIP code

postal_code: "700000"

orders_total_number number recommended

info

Cumulative number of orders placed by this user

orders_total_number: 5

orders_canceled_number number recommended

info

Cumulative number of orders placed and canceled by this user

orders_canceled_number: 0

orders_total_value number recommended

info

Cumulative lifetime user orders value (decimal format: 2500.50)

orders_total_value: 1234.99

orders_refunded_value number recommended

info

Cumulative lifetime user orders value canceled (decimal format: 2500.50)

orders_refunded_value: 250.99

predicted_value number

info

Predicted lifetime value of a customer for your business

predicted_value: 100.99

created_at number recommended

info

Timestamp in milliseconds since Unix epoch representing the first time the user was recorded

created_at: 1754926521690

properties object recommended

info

Custom Customer Properties Examples

User Segmentation

Use the properties object to store custom user attributes, with property names defined by each business as needed, that enable advanced segmentation, personalization, and analytics across your marketing campaigns.

properties: {
  customer_type: "returning",
  membership_level: "platinum",
  preferred_category: ["electronics", "fashion"],
  last_purchase_date: "2024-12-15",
  average_order_value: "350.00",
  payment_method_preference: "card",
  registration_date: "2023-06-15"
}

Examples​

window.reshape = window.reshape || [];
reshape.push({
  "event": {
    "name": "user_data_updated"
  },
  "context": {
    "environment": "prod"
  },
  "user": {
    "id": "CUST_12345",
    "email": "[email protected]",
    "phone": "+40712345678",
    "first_name": "Alexandra",
    "last_name": "Popescu",
    "country": "RO",
    "region": "Bucuresti",
    "city": "Bucuresti",
    "street": "Bulevardul Unirii 45",
    "postal_code": "030167",
    "orders_total_number": 12,
    "orders_canceled_number": 1,
    "orders_total_value": 3450.50,
    "orders_refunded_value": 149.99,
    "predicted_value": 5000.00,
    "created_at": 1640995200000,
    "properties": {
      "customer_segment": "loyal",
      "loyalty_tier": "gold",
      "acquisition_channel": "organic"
    }
  }
});