GA4-OpenAI event mapping table for the Addingwell OpenAI CAPI tag
In Inherit from client mode, the tag automatically converts the following GA4 events into OpenAI standard events:
| GA4 event | OpenAI standard event | Data shape (data.type) |
|---|---|---|
| page_view | page_viewed | contents |
| view_item | contents_viewed | contents |
| add_to_cart | items_added | contents |
| begin_checkout | checkout_started | contents |
| purchase | order_created | contents |
| generate_lead | lead_created | customer_action |
| sign_up | registration_completed | customer_action |
| schedule | appointment_scheduled | customer_action |
| subscribe | subscription_created | plan_enrollment |
| start_trial | trial_started | plan_enrollment |
Any GA4 event missing from this table is sent to OpenAI as a custom event (type: custom), with the GA4 event name as custom_event_name. Characters not allowed by OpenAI (anything other than letters, digits, _ and -) are replaced with _. For example, add_to_wishlist is sent as the custom event add_to_wishlist.
Data sent depending on the event shape
data.type | Fields sent by the tag |
|---|---|
| contents | amount (GA4 value × 100), currency, contents built from items (id, name, content_type, quantity, amount) |
| customer_action | amount and currency when present, without a contents array |
| plan_enrollment | amount, currency, contents and plan_id (GA4 plan_id parameter, otherwise the item_id of the first item) |
| custom | amount, currency, contents, plan_id and any field added in Custom Data Override |
OpenAI expects the amount in the currency’s minor unit (cents for the euro or the dollar). The tag always multiplies the GA4 value by 100.