# Events

> This page documents the tracking events available for **theme developers** to call manually.

All functions are available via **`window.zidTracking`**.

---

## Select Item

**Function:** `zidTracking.sendGaSelectItemEvent(params)`

**Description:** Fires when a user clicks/selects a product from a product list (e.g., category page, search results, related products slider).

### Platforms

| Platform | Event Name | Sent |
|----------|------------|------|
| GA4 | `select_item` | Yes |
| GTM | `select_item` | Yes |
| GA Universal | `ec:setAction click` | Yes |
### Arguments

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product` | `object` | Yes | The product object |
| `listName` | `string` | No | Name of the list (defaults to `"products"`) |
| `listId` | `string` | No | Identifier for the list |
| `index` | `number` | No | Position of the product in the list (0-based) |

### Usage

```js
// Minimal usage - only product required
zidTracking.sendGaSelectItemEvent({
  product: productData
});

// Full usage with all optional parameters
zidTracking.sendGaSelectItemEvent({
  product: productData,
  listName: 'Related Products',
  listId: 'related_products_pdp',
  index: 2
});
```

### Example: Product Card Click

```js
// In your product card component
function onProductClick(product, index) {
  zidTracking.sendGaSelectItemEvent({
    product: product,
    listName: 'Category: Electronics',
    listId: 'category_electronics',
    index: index
  });

  // Navigate to product page
  window.location.href = product.url;
}
```
---

## View Cart

**Function:** `zidTracking.sendGaCartDetailViewedEvent(params)`

**Description:** Fires when the cart is viewed. Use this **only** when your theme displays cart contents outside the cart page (e.g., mini-cart, cart drawer, cart modal).

> **Important:** This event is automatically fired on the cart page. Do **not** call it on the cart page to avoid duplicate events.

### Platforms

| Platform | Event Name | Sent |
|----------|------------|------|
| GA4 | `view_cart` | Yes |
| GTM | `view_cart` | Yes |
| Facebook | `ViewCart` | Yes |

### Arguments

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cart` | `object` | Yes | The cart object |

### Usage

```js
// When mini-cart or cart drawer is opened
zidTracking.sendGaCartDetailViewedEvent({
  cart: cartData
});
```
---

## Summary

| Event | Function | When to Use |
|-------|----------|-------------|
| `select_item` | `sendGaSelectItemEvent` | User clicks a product in a list |
| `view_cart` | `sendGaCartDetailViewedEvent` | Cart viewed outside cart page (mini-cart, drawer) |
****