Add Shipping Info
Also known as: add_shipping_info, Shipping Info Added, Shipping Method Selected, Shipping Step Completed, Checkout Shipping Step
GA4 recommended add_shipping_info event, fired when a shopper submits a shipping method at checkout. It carries shipping_tier, cart value and items, and feeds shipping-step drop-off and delivery-mix analysis.
Event Serialization
always
Business Use Case
["1️⃣ Checkout Product Manager: shipping-step drop-off rises week on week → audit address form errors.","2️⃣ Pricing team: Express share of shipping_tier falls after a rate change → retest the free-shipping threshold.","3️⃣ Fulfilment Operations: tier mix shifts toward Next Day before peak → rebook carrier capacity for the forecast.","4️⃣ CRO team: step completion differs by device → prioritise address autocomplete tests on the weakest device."]
Business Criticality
High
Journey / Navigation Area
Checkout
Owning Function
Product
Calculation Notes
["1️⃣ Fires when the shipping step is submitted and address and method pass validation; not on method clicks or on page load.","2️⃣ Serialization always: re-fires on each resubmission; dedupe on checkout_id within a session when counting shipping-step completions.","3️⃣ Required: currency, value, items. Recommended: shipping_tier, coupon, checkout_id. value is merchandise total, excluding shipping and tax.","4️⃣ shipping_tier takes lowercase controlled values (standard, express, next_day, click_and_collect), as in add_payment_info; never rate IDs.","5️⃣ No PII: never send name, street address, postcode, email or phone. Send only when analytics_storage consent is granted.","6️⃣ Express wallets (Apple Pay, Shop Pay) must fire it on shipping selection in the wallet sheet, or the funnel shows false drop-off.","7️⃣ Common mistakes: firing on begin_checkout load, items out of sync with the cart, value sent as a string, currency missing."]
Platform Events
| Platform | Event |
|---|---|
| Google Analytics 4 | add_shipping_info |
| Adobe | add_shipping_info |
Data Mappings
W3 Data Layer
{
"digitalData": {
"event": [
{
"eventInfo": {
"eventName": "Add Shipping Info",
"eventAction": "add_shipping_info",
"type": "checkout"
}
}
],
"cart": {
"cartID": "{cart_id}",
"price": {
"currency": "{currency}",
"basePrice": "{value}"
},
"item": "{items}",
"attributes": {
"checkoutID": "{checkout_id}",
"shippingTier": "{shipping_tier}",
"fulfillmentMethod": "{fulfillment_method}",
"checkoutType": "{checkout_type}",
"coupon": "{coupon}"
}
}
}
}GA4 Data Layer
{
"event": "add_shipping_info",
"ecommerce": {
"currency": "{currency}",
"value": "{value}",
"coupon": "{coupon}",
"shipping_tier": "{shipping_tier}",
"checkout_id": "{checkout_id}",
"cart_id": "{cart_id}",
"fulfillment_method": "{fulfillment_method}",
"checkout_type": "{checkout_type}",
"items": "{items}"
}
}Adobe Client Data Layer
{
"event": "add_shipping_info",
"shipping": {
"shippingTier": "{shipping_tier}",
"fulfillmentMethod": "{fulfillment_method}",
"checkoutType": "{checkout_type}",
"checkoutId": "{checkout_id}",
"cartId": "{cart_id}",
"coupon": "{coupon}"
},
"cart": {
"currency": "{currency}",
"value": "{value}",
"items": "{items}"
}
}XDM Mapping
{
"eventType": "commerce.checkouts",
"commerce": {
"checkouts": {
"value": 1
},
"cart": {
"cartID": "{cart_id}"
},
"order": {
"currencyCode": "{currency}"
},
"promotion": {
"couponCode": "{coupon}"
}
},
"productListItems": "{items}",
"_tenant": {
"checkoutStepName": "shipping_info",
"checkoutID": "{checkout_id}",
"merchandiseValue": "{value}",
"shippingTier": "{shipping_tier}",
"fulfillmentMethod": "{fulfillment_method}",
"checkoutType": "{checkout_type}"
}
}Source Data
Digital Analytics (GA4)
Dependencies
Prerequisite: List the dependencies required for this Event
Dimensions:
Report Attributes
shipping_tier fulfillment_method checkout_type device_category coupon traffic_source
Segment Eligibility
true
Governance
Dimensions
Derived Dimensions
Derived Entities
Derived Metrics
Governance & Metadata
GitHub
catalog/events/add-shipping-info.yml