Funnelish

Converge supports tracking Storefront and Checkout events on Funnelish natively.

Installation Instructions

The Converge Website installation for a Funnelish storefront consists of:

Create a new Webhook Source in Converge

In Converge, navigate to Sources and click on
Create New Source
Pick Server-side from the modal
Name your source: e.g. {Storename} Funnelish Storefront and pick the Funnelish-app from the dropdown.
If you already have a Shopify source and Funnelish syncs all of the orders to Shopify, then you should not enable the “Track Funnelish orders as Placed Order conversions” option. If you will be using Funnelish as your order backend instead, then you should turn on the switch.

If left disabled, our Funnelish Webhook integration tracks a custom event called “Placed Funnelish Order” which stitches the web session to the Shopify Placed Order. It also means the actual Funnelish event will not be forwarded to any connections using Funnelish as a source. However, if you are using Funnelish as your order backend instead, then this option should be enabled. This means Funnelish orders will be forwarded as Placed Order events.
Click on Create Source.
Copy the link that is displayed under Postback Endpoint, you will need it later.

Create a Funnelish Automation to send events to the webhook

Open your Funnelish dashboard, and click on Automations in the top bar and then Create a new automation.
Choose Start from scratch in the modal that pops up and click Create.
Give your automation the name Converge and click on New trigger.
Choose On purchase under triggers and click on Create.
Choose Add an action.
Choose Add new webhook and fill in the webhook from Step 3.
Activate the Funnel in the top right corner.

Make sure the Facebook App in Funnelish is turned off completely, as you will suffer from duplicate tracking if this is not the case. Make sure the Facebook app is turned off both on a general level, and on a per-funnel basis.

Set up website tracking for your funnels

You need to do the following steps for every new and existing funnel you set up.

Navigate to your new funnel in Funnels and click on the Funnel you want to install Converge tracking for. When in the funnel, click on Funnel settings.
Navigate to Custom codes and click on New tracking code.
Give the new tracking code a name you can remember and turn Lazy load off.

Now you will want to copy-paste the script below.

<script
src="https://static.runconverge.com/pixels/YOUR-TRACKING-TOKEN.js"
async
></script>
<script>
window.cvg ||
((c = window.cvg =
    function () {
    c.process ? c.process.apply(c, arguments) : c.queue.push(arguments);
    }),
(c.queue = []));
cvg({ method: "track", eventName: "$page_load" });
</script>

<script>
let ViewContentURLIdentifier = "YOUR-VIEWCONTENT-IDENTIFIER";
let AddToCartURLIdentifier = "YOUR-ADDTOCART-IDENTIFIER";
let InitiateCheckoutURLIdentifier = "YOUR-CHECKOUT-IDENTIFIER";

if (window.location.href.includes(AddToCartURLIdentifier)) {
cvg({
    method: "track",
    eventName: "Added To Cart",
    properties: {
    product_id: "1",
    variant_id: "1",
    name: "Product Name",
    variant_name: "Variant Name",
    price: 0,
    currency: "EUR",
    quantity: 1,
    },
});
}

if (window.location.href.includes(ViewContentURLIdentifier)) {
cvg({
    method: "track",
    eventName: "Viewed Product",
    properties: {
    product_id: "1",
    variant_id: "1",
    name: "Product Name",
    variant_name: "Variant Name",
    price: 0,
    currency: "EUR",
    },
});
}

// InitiateCheckout and Added To Cart can be on the same URL
if (window.location.href.includes(InitiateCheckoutURLIdentifier)) {
cvg({
    method: "track",
    eventName: "Started Checkout",
    properties: {
        total_price: 0,
        total_tax: 0,
        total_shipping: 0,
        currency: "USD",
        items: [
        // Notice that this is a list of items
            {
            product_id: "1",
            variant_id: "1",
            name: "Product Name",
            variant_name: "Variant Name",
            price: 0,
            currency: "EUR",
            },
        ],
    }
    });
}
</script>

You will need to do a few modifications described in Steps 5-7 to the script.

Navigate to your Converge dashboard and find the pixel you are using for Funnelish. Click on the pixel and copy the tracking token as per the screenshot below.

Replace the YOUR-TRACKING-TOKEN field in the script pasted with your personal Converge token.

Replace the YOUR-ADDTOCART-IDENTIFIER and YOUR-CHECKOUT-IDENTIFIER values with values that uniquely identify a URL in the funnel where you want to trigger this event.

As an example, if you want to trigger an AddToCart event on the myfunnelishstore.com/cart page, then you will want to replace YOUR-ADDTOCART-IDENTIFIER with cart. These identifiers might be different values for different funnels, so double-check when implementing a new funnel.
Click on Create code and on Save changes.

Event Spec

This integration auto-tracks the following events on the browser with all properties available according to the Converge Event Spec.

Event Name	Event Description	Integration
PageView	When a customer views a page.	Pixel
Viewed Product	When a customer views a product.	Pixel
Added To Cart	When a customer adds an item to cart	Pixel
Started Checkout	When a customer initiates the checkout process.	Pixel
Placed Order	When a customer places an order	Webhook

This integration also auto-tracks some additional events that are not part of the Converge Event Spec.

Event Name	Event Description	Integration
Placed Funnelish Order	Event that stitches Funnelish website sessions with Shopify backend orders.	Webhook

Getting started

Sources

Connections

Attribution

Insights & Dashboards

Marketing Sources

Settings

Installation Instructions

Event Spec

Getting started

Sources

Connections

Attribution

Insights & Dashboards

Marketing Sources

Settings

​Installation Instructions

​Event Spec

Installation Instructions

Event Spec