Ads & Enhanced Conversions

Der Tracker kann Conversions zusätzlich an GA4, Google Tag Manager und Meta/Facebook weiterleiten. Standardmäßig ist alles deaktiviert.

// Legacy: alles auf einmal (GA4, Tag Manager, Facebook)
window.usertraxConfig = { ads: true };

// Granular: nur das, was du brauchst
window.usertraxConfig = {
  ga4: true,         // gtag('event', ...) → Google Analytics 4
  tagManager: true,  // dataLayer.push(...) → Google Tag Manager
  facebook: true,    // fbq('track' / 'trackCustom', ...) → Meta Pixel
};

ads: true ist ein Legacy-Kurzschlüssel und aktiviert ga4, tagManager und facebook gemeinsam. Einzelne Flags überschreiben das nicht — sie sind die Alternative, wenn du ads nicht nutzen willst.

• Sendet gtag('event', eventName, params) mit:
  • value (aus total/value), currency, transaction_id (aus transaction_id/id), event_label (aus label)
  • optional tax, shipping, shipping_tier, payment_type, coupon, items[]
  • UTM-Parameter als utm_*
  • Click-IDs: gclid, msclkid, fbclid, ttclid
  • Primitive metadata-Felder als meta_*

• Flat-Push zu dataLayer inkl. metadata, utm, event_source: 'usertrax', optional event_id
• Wenn items[] gesetzt ist, zusätzlich:
  1. { ecommerce: null } (Clear)
  2. Nested Push { event, event_source, event_id?, ecommerce: { currency, value, transaction_id, items, … } }

Bekannte Event-Namen werden als Standard-Events gesendet (fbq('track', …)), sonst als Custom (trackCustom):

Payload u.a.:

• value, currency, transaction_id
• aus items[]: content_type: 'product', content_ids, contents (id, quantity, item_price), num_items
• Dedup: { eventID } aus event_id / id (gleicher Wert wie Server-CAPI)

Beispiel:

usertrax.push({
  event: "purchase",
  total: 99.99,
  currency: "EUR",
  event_id: "purchase_order_123",
  transaction_id: "order_123",
  items: [
    { item_id: "SKU-1", item_name: "Produkt", price: 99.99, quantity: 1 },
  ],
});

Aktiviere erweiterte Conversions, indem du Nutzerdaten setzt. Der Tracker normalisiert (trim/lowercase) und hasht diese Felder per SHA‑256 im Browser und übergibt sie an GA4 (gtag('set','user_data', ...)) und/oder den GTM dataLayer — je nachdem, ob ga4 bzw. tagManager (oder Legacy ads: true) aktiv ist.

Unterstützte Felder:

• email, phone/phone_number
• first_name, last_name
• address: street/street_address/address, city, region/state, postal_code/zip, country/country_code

Voraussetzungen: Ausführung im Browser mit crypto.subtle (HTTPS, moderne Browser).

window.usertrax.setUserData({
  email: "john@example.com",
  phone: "+1 555 123 4567",
  first_name: "John",
  last_name: "Doe",
  address: {
    street: "123 Main St",
    city: "Anytown",
    region: "CA",
    postal_code: "94016",
    country: "US",
  },
});

await tracker.setUserData({
  email: "john@example.com",
  phone: "+1 555 123 4567",
  first_name: "John",
  last_name: "Doe",
  address: {
    street: "123 Main St",
    city: "Anytown",
    region: "CA",
    postal_code: "94016",
    country: "US",
  },
});

Für eine persistente Person-ID und Traits auf allen Events siehe Nutzer-Identifikation.