advPxl("event", "add_to_cart");
advPxl("event", "initiated_checkout");

advPxl("conversion", "purchase", {
  transaction_id: "order123",              // required
  transaction_gross_revenue: 10999,        // required (cents)
  transaction_currency: "EUR",             // required
  transaction_shipping_costs: 499,         // optional (cents)
  transaction_tax: 1900,                   // optional (cents)
  transaction_city: "Berlin",              // optional
  transaction_country_code: "DE",          // optional
  transaction_discount_code: "SUMMER20",   // optional
  customer_id: "customer@email.com",       // optional (hashed server-side)
  is_new_customer: 1,                       // optional (1 = new, 0 = returning)
});

advPxl("conversion", "purchase", {
  transaction_id: "order123",
  transaction_gross_revenue: 2000,
  transaction_currency: "EUR",
  transaction_items: [
    {
      transaction_item_id: "123",
      transaction_item_name: "Product 1",
      transaction_item_price: 1000,
      transaction_item_tax: 50,
      transaction_item_quantity: 2,
    },
    {
      transaction_item_id: "124",
      transaction_item_name: "Product 2",
      transaction_item_price: 500,
      transaction_item_quantity: 1,
    },
  ],
});

advPxl("conversion", "lead", {
  transaction_id: "lead-456",
});

// Inline — non-reserved keys auto-merged into properties
advPxl("conversion", "purchase", {
  transaction_id: "order123",
  transaction_gross_revenue: 10999,
  transaction_currency: "EUR",

  // Anything non-reserved → events.properties JSON
  payment_provider: "klarna_invoice",
  shipping_method: "standard",
  affiliation: "DACH Store",
});

// Or explicit — the `properties` key wins on conflict
advPxl("event", "add_to_cart", {
  properties: {
    product_category: "skincare",
    cart_size: 4,
  },
});

window.adverfly = window.adverfly || [];
window.adverfly.activate_autocapture = true;
advPxl("init", 8397799);

<!-- Class-based -->
<div class="adv-no-capture">
  <input type="text" name="internal-note" />
</div>

<!-- Attribute-based -->
<section data-adv-no-capture>
  <button>Internal action</button>
</section>

window.adverfly = window.adverfly || [];
window.adverfly.autocapture_config = {
  url_ignorelist: [/\/admin/, "/debug"],
  css_selector_allowlist: [".track-me", "[data-adv-track]"],
};
advPxl("init", 8397799);

window.adverfly = window.adverfly || [];
window.adverfly.activate_loyalty = true;
advPxl("init", 8397799);

<!-- Adverfly Loyalty — Balance check
     Two ways to use this:
       1. Drop the <a> below into your footer / account page.
       2. OR add href="#adv-balance" to ANY existing link in your shop —
          the script below catches it globally. -->
<a href="#adv-balance"
   style="color:inherit;text-decoration:underline;cursor:pointer;">
  Mein Guthaben anzeigen
</a>

<script>
  (function () {
    window.adverfly = window.adverfly || [];
    window.adverfly.activate_loyalty = true;

    function trigger() {
      var email = (window.adverfly && window.adverfly.customer_id)
        || prompt("Bitte gib deine E-Mail-Adresse ein:");
      if (!email) return;
      advPxl("balance", { email: email });
      alert("Danke! Falls deine Adresse bei uns hinterlegt ist, erhältst du dein Guthaben in wenigen Minuten per E-Mail.");
    }

    document.addEventListener("click", function (e) {
      var t = e.target;
      if (!t || !t.closest) return;
      var link = t.closest('a[href$="#adv-balance"], #adv-loyalty-balance');
      if (!link) return;
      e.preventDefault();
      trigger();
    });
  })();
</script>

window.adverfly.customer_id = "kunde@example.com"; // typically set by the platform
advPxl("balance"); // no second arg needed

<button onclick="advPxl('balance', { email: '{{ customer.email | default: '' }}' || prompt('E-Mail eingeben:') })">
  Mein Guthaben anzeigen
</button>
<script>
  window.adverfly = window.adverfly || [];
  window.adverfly.activate_loyalty = true;
</script>

<script>
  window.adverfly = window.adverfly || [];
  function advPxl() {
    var args = [false];
    for (var i = 0; i < arguments.length; i++) {
      args.push(arguments[i]);
    }
    adverfly.push(args);
  }
  advPxl("init", YOUR_WORKSPACE_ID);
  window.adverfly.store_currency = "EUR";
  window.adverfly.store_timezone = "Europe/Berlin";

  var script = document.createElement("script");
  script.type = "text/javascript";
  script.async = true;
  script.src = "https://sos-de-fra-1.exo.io/adv/advv2.01.js";
  document.getElementsByTagName("head")[0].appendChild(script);
</script>

<script>
  // Fires on the purchase confirmation page
  advPxl("conversion", "purchase", {
    transaction_id: {{DL - Transaction ID}},
    transaction_gross_revenue: {{DL - Revenue}} * 100,
    transaction_currency: {{DL - Currency}}
  });
</script>

<script>
  if (window.dataLayer) {
    function advForwardPurchase(event) {
      if (!event || event.event !== "purchase") return;
      var ec = event.ecommerce || {};

      // "9.99" / 9.99 → 999 (cents). toFixed handles float drift,
      // replace strips the decimal point.
      var toCents = function (v) {
        return Number(v || 0).toFixed(2).toString().replace(/\D/g, "") || 0;
      };

      // pageCountryCode is shipped as "de_DE" — take the country part.
      var pageCC = (window.dataLayer || [])
        .map(function (e) { return e && e.pageCountryCode; })
        .filter(Boolean).pop() || "";
      var countryCode = pageCC.split("_").pop().toUpperCase().slice(0, 2);

      advPxl("conversion", "purchase", {
        // Reserved keys → typed columns
        transaction_id: ec.transaction_id || event.transaction_id,
        transaction_gross_revenue: toCents(ec.value || event.value),
        transaction_currency: ec.currency || event.currency,
        transaction_tax: toCents(ec.tax || event.tax),
        transaction_shipping_costs: toCents(ec.shipping || event.shipping),
        transaction_country_code: countryCode,
        customer_id: event.transactionEmail || ec.customer_id || "",

        transaction_items: (ec.items || []).map(function (it) {
          return {
            transaction_item_id: it.item_id || it.id,
            transaction_item_name: it.item_name || it.name,
            transaction_item_price: toCents(it.price),
            transaction_item_quantity: Number(it.quantity || 1),
          };
        }),

        // Non-reserved keys → events.properties JSON (auto-merged server-side)
        payment_provider: event.transactionPaymentType || "",
        shipping_method: event.transactionShippingMethod || "",
        affiliation: event.transactionAffiliation || "",
      });
    }

    // Hook every future push + replay anything already in the queue
    var originalPush = window.dataLayer.push;
    window.dataLayer.push = function () {
      var args = [].slice.call(arguments);
      originalPush.apply(this, args);
      args.forEach(advForwardPurchase);
    };
    window.dataLayer.forEach(advForwardPurchase);
  }
</script>

<script>
  // Add to Cart tag - trigger on add_to_cart event
  advPxl("event", "add_to_cart");
</script>

<script>
  // Initiated Checkout tag - trigger on checkout start
  advPxl("event", "initiated_checkout");
</script>

const script = document.createElement("script");
script.type = "text/javascript";
script.async = true;
script.src = "https://sos-de-fra-1.exo.io/adv/script-shopify.js";
document.getElementsByTagName("script")[0].parentNode.appendChild(script);

window.adverfly_web_pixel = true;
window.adverfly_init = init;
window.adverfly_browser = browser;
window.adverfly_settings = api.settings;

window.adverfly = window.adverfly || [];
window.advPxl = function () {
  adverfly.push([false, ...arguments]);
};

analytics.subscribe("all_events", (event) => {
  window.adverfly.push(["all_shopify_events", event]);
  advPxl("init", YOUR_WORKSPACE_ID);
  window.adverfly.store_currency = "EUR";
  window.adverfly.store_timezone = "Europe/Berlin";

  if (event.name === "page_viewed") {
    advPxl("check", "vikeys", event);
  }
});

<script async src="https://cdn.adverfly.com/preset-pixel-adv.js"></script>
<script>
  window.adverfly = window.adverfly || [];
  window.adverfly.activate_widgets = true;
  advPxl("init", YOUR_WORKSPACE_ID);
</script>

<script src="https://cdn.jsdelivr.net/npm/@adverfly/sdk/dist/adverfly.iife.js"></script>
<script>
  const adv = new Adverfly({ workspaceId: 188334 });
  /* `Adverfly` is now a global class — no module system required. */
</script>

<script type="module">
  import { Adverfly } from "https://cdn.jsdelivr.net/npm/@adverfly/sdk/dist/index.mjs";
  const adv = new Adverfly({ workspaceId: 188334 });
</script>

npm install @adverfly/sdk

import { Adverfly } from "@adverfly/sdk";

const adv = new Adverfly({ workspaceId: 188334 });

await adv.identify({ email: "user@example.com" });

adv.setContext({
  cart_value: 49.9,
  last_viewed_creatives: ["sku_a", "sku_b"],
});

const variant = await adv.personalize({ trigger: "exit_intent" });

if (variant) {
  showMyPopup({
    title: variant.config.title,
    copy: variant.config.copy,
    onCtaClick: () => adv.click(variant.id),
    onDismiss: () => adv.dismiss(variant.id),
  });
  await adv.trackImpression(variant.id);
}

interface PopupConfig {
  title: string;
  copy: string;
  cta?: string;
  cta_url?: string;
  image_url?: string;
}

const variant = await adv.personalize<PopupConfig>({ trigger: "exit_intent" });
if (variant) {
  console.log(variant.config.title); // typed!
}

const off = adv.on("decision", ({ trigger, variant }) => {
  console.log(`[${trigger}] →`, variant?.id ?? "no match");
});

/* Returns an unsubscribe function */
off();

import { Adverfly, type Variant } from "@adverfly/sdk";

const AdverflyContext = createContext<Adverfly | null>(null);

export function usePersonalization<T>(trigger: string) {
  const adv = useContext(AdverflyContext)!;
  const [variant, setVariant] = useState<Variant<T> | null>(null);

  useEffect(() => {
    adv.personalize<T>({ trigger }).then((v) => {
      setVariant(v);
      if (v) adv.trackImpression(v.id);
    });
  }, [adv, trigger]);

  return {
    variant,
    click: (props?) => variant && adv.click(variant.id, props),
    dismiss: () => variant && adv.dismiss(variant.id),
    success: (props?) => variant && adv.success(variant.id, props),
  };
}

/* Cloudflare Worker — server-render a personalized hero block */
export default {
  async fetch(request: Request) {
    const adv = new Adverfly({
      workspaceId: 188334,
      manualIdentity: true,  // we manage identity ourselves
    });
    await adv.identify({ customerId: getCookieUserId(request) });

    const variant = await adv.personalize({
      trigger: "ssr_hero",
      context: { country: request.cf?.country },
    });

    return new Response(renderHero(variant?.config), {
      headers: { "content-type": "text/html" },
    });
  },
};