# SamCart Troubleshooting

> Systematically verify your SamCart and AnyTrack integration to identify and fix tracking issues using this step-by-step diagnostic checklist.

Systematically verify your integration to identify tracking issues. Focus on the critical checkpoints that actually impact functionality.

## Quick Diagnostic Tests

* **Not seeing conversions?**\
  → Check AnyTrack integration log first - if empty, webhook isn't configured → Return to the setup guide and complete the instructions.
* **Conversions tracked in AnyTrack but not reaching ad platforms?**\
  → Verify ad platform connections in AnyTrack are authenticated and Conversion API is enabled.
* **Wrong `revenue` amounts?**\
  → Confirm webhook is sending complete order data including upsells. You should see a list of items in the event log.

<Prerequisites
  title="Before you begin"
  items={[
    { label: "You have an AnyTrack account with a Personal Plan or higher", done: true },
    { label: "You have admin access to both AnyTrack and SamCart accounts", done: true },
    { label: "The AnyTrack Tracking Tag is installed on your website", done: true },
  ]}
/>

## Core Integration Status

* [ ] **AnyTrack tag loads** on all pages (check browser dev tools → Network tab on SamCart pages AND any external landing pages)
* [ ] **Webhook receiving data** (check AnyTrack integration log for recent events)
* [ ] **`atclid` parameter appears** in SamCart URLs when navigating from external pages

## SamCart Configuration Audit

### Tag Installation

* [ ] **Tag in correct location**: SamCart → Account Settings → Tracking & Pixels → `<head>` field
* [ ] **"Enable Pixel Firing Before Redirecting"** is ON
* [ ] **Content URL parameter includes `atclid`**
* [ ] **Custom parameter `atclid` created** and added to all products and upsells

### Webhook Setup

* [ ] **Webhook rule configured**: Global → Send Notify URL for POST → Order Completed
* [ ] **Exact webhook URL** provided by AnyTrack for the Samcart integration
* [ ] **Samcart via Zapier** you have follow exactly the provided instructions

## Event Firing Verification

Test with a real purchase flow:

* [ ] **PageView** fires on landing page visits
* [ ] **OutboundClick** fires when clicking from external page to SamCart
* [ ] **InitiateCheckout** fires when checkout page loads
* [ ] **AddPaymentInfo** fires when payment details entered
* [ ] **Purchase event** appears in AnyTrack log within 5 minutes of completion (includes upsells in total order value)

## Configuration Conflicts

* [ ] **No duplicate Tracking Tags** in SamCart (Facebook, Google, TikTok Tracking Tags removed)
* [ ] **Client-side tracking disabled** (if account connected before May 2025)
* [ ] **Slide checkout enabled** in AnyTrack (if using SamCart slide checkout feature)

## Multi-Page Funnel Check

*Only if your funnel includes pages outside SamCart:*

* [ ] **External landing pages** have AnyTrack tag installed and links to samcart checkout pages include the `utm_content=0asd8...aduh` parameter appended.
* [ ] **Click IDs pass through** entire funnel chain to SamCart

## Data Flow Validation

Use external platforms to verify conversions are being tracked and sent according to your tracking plan.

* [ ] **Facebook Event Manager** conversions appears within 20 minutes (via Conversion API only)
* [ ] **Google Analytics 4 Debugging** conversions appears in real time
* [ ] **Attribution data** matches between AnyTrack and ad accounts (Ad platforms have attribution delays, check after 24 hours)
* [ ] **Revenue values**: In AnyTrack, campaign report verify the values sync correctly with actual order amounts.

## Related Articles

- [TikTok Ads](/docs/tiktok-ads)
- [Install AnyTrack Tag](/docs/install-anytrack-tag)
- [Integration Event Log](/docs/integration-event-log)
