Converge supports tracking Storefront and Checkout events on Funnelish natively.


Installation Instructions

The Converge Website installation for a Funnelish storefront consists of:

1

Create a new Webhook Source in Converge

  1. In Converge, navigate to Sources and click on
    Create New Source
  2. Pick Server-side from the modal
  3. Name your source: e.g. {Storename} Funnelish Storefront and pick the Funnelish-app from the dropdown.

    funnelish-2

  4. 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.

    funnelish-18

    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.
  5. Click on Create Source.
  6. Copy the link that is displayed under Postback Endpoint, you will need it later.

    funnelish-4

2

Create a Funnelish Automation to send events to the webhook

  1. Open your Funnelish dashboard, and click on Automations in the top bar and then Create a new automation.

    funnelish-4

  2. Choose Start from scratch in the modal that pops up and click Create.

    funnelish-5

  3. Give your automation the name Converge and click on New trigger.

    funnelish-6

  4. Choose On purchase under triggers and click on Create.

    funnelish-7

  5. Choose Add an action.

    funnelish-8

  6. Choose Add new webhook and fill in the webhook from step 3.

    funnelish-9

  7. Activate the Funnel in the top right corner.

    funnelish-11

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.
3

Set up website tracking for your funnels

You need to do the following steps for every new and existing funnel you set up.
  1. 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.

    funnelish-12

  2. Navigate to Custom codes and click on New tracking code.

  3. Give the new tracking code a name you can remember and turn Lazy load off.

    funnelish-13

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

    You will need to do a few modifications described in steps 5-7 to the script.
  5. 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.

funnelish-14

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

funnelish-15

  1. 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.
  2. Click on Create code and on Save changes.

funnelish-16


Event Spec

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

Event NameEvent DescriptionIntegration
PageViewWhen a customer views a page.Pixel
Viewed ProductWhen a customer views a product.Pixel
Added To CartWhen a customer adds an item to cartPixel
Started CheckoutWhen a customer initiates the checkout process.Pixel
Placed OrderWhen a customer places an orderWebhook

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

Event NameEvent DescriptionIntegration
Placed Funnelish OrderEvent that stitches Funnelish website sessions with Shopify backend orders.Webhook