Delivery Preference Update
Also known as: Delivery Change Request, Change Delivery Address, Delivery Instructions Update, Reschedule Delivery, Delivery Options Update
Fires when a placed order's delivery address, instructions or time window (preference_type) is changed via self-service, carrier portal or agent. Feeds failed-delivery and delivery-window analysis.
Event Serialization
always
Business Use Case
["1️⃣ Customer Service lead: agent-made address changes rise → adds self-service change links to shipping emails.","2️⃣ Fulfilment Operations: address changes after dispatch spike → adds a pre-dispatch hold to cut redirect fees.","3️⃣ Delivery Product Manager: time_window changes cluster on one slot → reviews that slot's capacity at checkout."]
Business Criticality
Medium
Journey / Navigation Area
Generic
Owning Function
Customer Service
Calculation Notes
["1️⃣ Fires on the server-confirmed save of the change, after address validation and carrier acceptance; not on form open or rejected edits.","2️⃣ Serialization always: one hit per saved preference_type; one save changing address and time window sends two hits sharing change_id.","3️⃣ Required: transaction_id, preference_type, change_id, change_source, order_status. Optional: delivery_time_window, delivery_region, tracking_number.","4️⃣ Never send address lines, postcode, phone or instruction free text; delivery_region is state/province level only. Honour analytics consent.","5️⃣ Carrier-portal changes (UPS My Choice, FedEx Delivery Manager) count only when ingested server-side with change_source = carrier_portal.","6️⃣ Common mistake: firing on checkout address edits. Those belong to add_shipping_info; this event is post-purchase only."]
Platform Events
| Platform | Event |
|---|---|
| Google Analytics 4 | submit_form |
| Adobe | form_submit |
Data Mappings
W3 Data Layer
{
"event": [
{
"eventInfo": {
"eventName": "submit_form",
"eventAction": "submit_form",
"type": "other"
},
"category": {
"primaryCategory": "Post-Purchase Logistics"
}
}
],
"transaction": {
"transactionID": "ORD-48213097",
"profile": {
"order": {
"orderStatus": "processing",
"fulfillmentMethod": "ship_to_home",
"trackingNumber": "1Z999AA10123456784"
}
},
"attributes": {
"formType": "delivery_preference_update",
"preferenceType": "time_window",
"changeID": "chg_2f88ac91",
"changeSource": "self_service_web",
"deliveryTimeWindow": "2026-09-27 14:00-16:00",
"deliveryRegion": "TX"
}
}
}GA4 Data Layer
{
"event": "submit_form",
"form_type": "delivery_preference_update",
"transaction_id": "ORD-48213097",
"order_status": "processing",
"preference_type": "time_window",
"change_id": "chg_2f88ac91",
"change_source": "self_service_web",
"delivery_time_window": "2026-09-27 14:00-16:00",
"delivery_region": "TX",
"fulfillment_method": "ship_to_home",
"tracking_number": "1Z999AA10123456784"
}Adobe Client Data Layer
{
"event": "form_submit",
"form_type": "delivery_preference_update",
"transaction_id": "ORD-48213097",
"order_status": "processing",
"preference_type": "time_window",
"change_id": "chg_2f88ac91",
"change_source": "self_service_web",
"delivery_time_window": "2026-09-27 14:00-16:00",
"delivery_region": "TX",
"fulfillment_method": "ship_to_home",
"tracking_number": "1Z999AA10123456784"
}XDM Mapping
{
"eventType": "web.formFilledOut",
"commerce": {
"order": {
"purchaseID": "transaction_id"
}
},
"_tenant": {
"ecommerce": {
"delivery": {
"formType": "form_type",
"preferenceType": "preference_type",
"changeId": "change_id",
"changeSource": "change_source",
"orderStatus": "order_status",
"deliveryTimeWindow": "delivery_time_window",
"deliveryRegion": "delivery_region",
"fulfillmentMethod": "fulfillment_method",
"trackingNumber": "tracking_number"
}
}
}
}Source Data
Digital Analytics (GA4)
Dependencies
Prerequisite: List the dependencies required for this Event
Events:
Dimensions:
Report Attributes
preference_type change_source order_status delivery_region fulfillment_method device_category
Segment Eligibility
true
Governance
Dimensions
Governance & Metadata
GitHub
catalog/events/delivery-preference-update.yml