version: 1, one required tag_id, optional test_mode, and between one and 1,000 events. Unknown fields are rejected.
Each event needs a stable event_id, an event_name, and timestamp_ms. The timestamp is Unix milliseconds and must be no more than seven days old or ten minutes in the future. web events also require source_url.
Use these canonical event names: page_viewed, contents_viewed, items_added, checkout_started, order_created, lead_created, registration_completed, appointment_scheduled, subscription_created, trial_started, app_installed, app_opened, and custom.
Common aliases such as purchase, add_to_cart, page_view, and signup are normalized. custom requires custom_event_name. app_installed and app_opened require action_source: "mobile_app" and data.type: "customer_action".
Use the same
event_id for browser and server copies of a conversion. Thrad deduplicates per tag_id and event_id; a repeat is returned as duplicate instead of creating another canonical event.