Skip to content

Commit fc46f85

Browse files
committed
update ccjs event docs
1 parent f6874c6 commit fc46f85

1 file changed

Lines changed: 62 additions & 4 deletions

File tree

docs/campaign-cart/analytics/events.md

Lines changed: 62 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -444,7 +444,7 @@ Package swap (replace one item with another).
444444
445445
**When it fires:** When user swaps one package for another
446446
447-
**Auto-tracked:** No (manual tracking required)
447+
**Auto-tracked:** Yes (when using selector with swap mode)
448448
449449
**Example:**
450450
@@ -472,13 +472,69 @@ Package swap (replace one item with another).
472472
473473
---
474474
475+
### dl_viewed_upsell
476+
477+
Upsell page view.
478+
479+
**When it fires:** When an upsell page is viewed
480+
481+
**Auto-tracked:** Yes (in auto mode, when upsell page loads)
482+
483+
**Example:**
484+
485+
```javascript
486+
{
487+
event: 'dl_viewed_upsell',
488+
ecommerce: {
489+
currency: 'USD',
490+
value: 29.99,
491+
items: [{
492+
item_id: 'UPSELL-789',
493+
item_name: 'Upsell Package',
494+
price: 29.99,
495+
quantity: 1
496+
}]
497+
}
498+
}
499+
```
500+
501+
---
502+
503+
### dl_skipped_upsell
504+
505+
Upsell declined/skipped.
506+
507+
**When it fires:** When user declines or skips an upsell offer
508+
509+
**Auto-tracked:** Yes (in auto mode, when upsell is declined)
510+
511+
**Example:**
512+
513+
```javascript
514+
{
515+
event: 'dl_skipped_upsell',
516+
ecommerce: {
517+
currency: 'USD',
518+
value: 29.99,
519+
items: [{
520+
item_id: 'UPSELL-789',
521+
item_name: 'Upsell Package',
522+
price: 29.99,
523+
quantity: 1
524+
}]
525+
}
526+
}
527+
```
528+
529+
---
530+
475531
### dl_upsell_purchase
476532
477533
Upsell accepted (post-purchase).
478534
479535
**When it fires:** When user accepts an upsell offer
480536
481-
**Auto-tracked:** No (manual tracking required)
537+
**Auto-tracked:** Yes (in auto mode, when upsell is accepted)
482538
483539
**Example:**
484540
@@ -629,8 +685,10 @@ All events follow this GA4-compliant structure:
629685
| `dl_add_shipping_info` | Shipping entered | Yes | Manual |
630686
| `dl_add_payment_info` | Payment entered | Yes | Manual |
631687
| `dl_purchase` | Order complete | Yes | `next.trackPurchase()` (optional) |
632-
| `dl_package_swapped` | Package swap | No | Manual |
633-
| `dl_upsell_purchase` | Upsell accepted | No | Manual |
688+
| `dl_package_swapped` | Package swap | Yes | Manual |
689+
| `dl_viewed_upsell` | Upsell page view | Yes | Manual |
690+
| `dl_skipped_upsell` | Upsell declined | Yes | Manual |
691+
| `dl_upsell_purchase` | Upsell accepted | Yes | Manual |
634692
| `dl_view_search_results` | Search results | No | Manual |
635693
636694
## Event Validation

0 commit comments

Comments
 (0)