Everflow Integration
Purpose:
The purpose of this walkthrough is to help you set up your EverFlow Integration.
Pre Requisites:
- Alias: The alias to identify this integration within the WebForce system.
- Domain: You will obtain this value from Everflow.
- Key: You will obtain this value from Everflow.
- Network ID: You will obtain this value from Everflow.
- Advertiser ID: You will obtain this value from Everflow. Right now we can only work with one advertiser per account.
Note: Each piece of this integration needs to be completed as this is how information from WebForce is fed into Everflow and data from Everflow is fed back into WebForce. This is the integration walkthrough. If you are looking on how to complete your tracking links, click here!
Everflow setup and configuration: https://www.loom.com/share/7be10213ab9841a4a6b894b0b7e963af
- In your your WebForce Instance navigate to Integrations
- Click on Integrations on the left side menu. Here you can view all your current integrations.
- Click the blue plus sign to add additional integrations
- Click Configure under Everflow
- Here are the REQUIRED fields for the integration:
-
Alias: The alias to identify this integration within the WebForce system.
-
Domain: You will obtain this value from Everflow.
-
Key: You will obtain this value from Everflow.
-
Network ID: You will obtain this value from Everflow.
-
Advertiser ID: You will obtain this value from Everflow. Right now we can only work with one advertiser per account.
-
- Log into your Everflow Account
- Ad your network ID which can be located under the Control Center > Configuration
- Your Network ID is listed under the general tab. Copy this and add it to the Network ID field in WebForce.
- In the same screen naviagte to the Domains tab, copy the primary one and paste it into the Domain field in WebForce.
- Add ALIAS for your Integration
- Go back to your main account screen
- Add the copied API Key from Everflow into the Key field
- Next, to grab the Advertiser ID you will go to Advertisers > Manage
- Copy the ID and paste it into the Advertiser iD field in WebForce
- If the advertiser has a verification token, copy it and put it in the Verification token field.
-
Finally, click on the Save button and you have finished the initial setup.
Post Back Events
Once you have finished the initial setup you have the ability to configure other data points to generate conversions and trigger various events.
Lead Capture
A lead capture occurs when a potential customer fills out the lead form component used in the funnel pages. In order to generate lead conversions in Everflow, you will need to provide an offer ID and an event ID (normal event ID or advertiser event ID).
Offer ID
There are multiple ways to define the Offer ID. Here, we have listed them by priority. Basically what this means is that if you provide all/ or even some of them the first found will be the one used within WebForce.
-
Within the editor tool, you can add a hidden input called ef_offer_id to the Lead form component. Simply input the value of the offer ID you want to use.
-
In the admin you can go to Funnels > Edit on the desired funnel > Edit on the desired page > Metadata click on the button to add a new record for the key. Use ef_offer_id and put in the value the ID.
-
-
In the admin you can go to Funnels > Edit on the desired funnel > Metadata click on the button to add a new record for the key use ef_offer_id and put in the value the ID.
-
In the admin, you can go to Integrations and click on View configuration in the Everflow card, Navigate to the events tab and define an offer ID in the Funnel section.
Event ID
There are multiple ways to define the Event ID. Here, we have listed them by priority. Basically what this means is that if you provide all/ or even some of them the first found will be the one used within WebForce.
-
In the editor, you can add a hidden input called ef_event_id (normal event) or ef_adv_event_id (advertiser event) to the Lead form component. Inside put the value of the ID.
-
In the admin, you can go to Funnels > Edit on the desired funnel > Edit on the desired page > Metadata. Click on the button to add a new record for the key use ef_lead_event_id (normal event) or ef_adv_lead_event_id (advertiser event) and in the value put the ID.
-
In the admin, you can go to Funnels > Edit on the desired funnel > Metadata. Click on the button to add a new record for the key use ef_lead_event_id (normal event) or ef_adv_lead_event_id (advertiser event), and in the value put the ID.
-
In the admin, you can go to Integrations and click on View configuration in the Everflow card, go to the events tab, and in the Lead capture advertiser event id field put your advertiser event ID.
Funnel Checkout
Every time a successful transaction happens within a funnel at check out. An Offer ID is needed to generate an Everflow conversion.
There are multiple ways to define the Offer ID. Here, we have listed them by priority. Basically what this means is that if you provide all/ or even some of them the first found will be the one used within WebForce.
- In the editor tool, you can add a hidden input to the desired offer called ef_offer_id to the Checkout component. Inside put the value of the offer ID you want to use.
-
In the admin you can go to Offers > Edit on the desired Offer > Metadata click on the button to add a new record for the key use ef_offer_id and put in the value the ID.
-
In the admin you can go to Funnels > Edit on the desired funnel > Edit on the desired page > Metadata click on the button to add a new record for the key use ef_offer_id and put in the value the ID.
-
In the admin you can go to Funnels > Edit on the desired funnel > Metadata click on the button to add a new record for the key use ef_offer_id and put in the value the ID.
-
In the admin, you can go to Integrations and click on View configuration in the Everflow card, go to the events tab and define an offer ID in the Funnel section.
Funnel upsell
Every time a successful transaction happens in a funnel upsell an Offer ID is needed to generate an Everflow conversion. Additionally, you can provide an event or an advertiser event. If no event is provided the base event will be triggered.
Offer ID
There are multiple ways to define the Offer ID. Here, we have listed them by priority. Basically what this means is that if you provide all/ or even some of them the first found will be the one used within WebForce.
-
In the editor, you can add a hidden input called ef_offer_id to the Upsell component. Inside put the value of the offer ID you want to use.
-
-
In the admin you can go to Offers > Edit on the desired Offer > Metadata click on the button to add a new record for the key use ef_offer_id and put in the value the ID.
-
In the admin you can go to Funnels > Edit on the desired funnel > Edit on the desired page > Metadata click on the button to add a new record for the key use ef_offer_id and put in the value the ID.
-
In the admin you can go to Funnels > Edit on the desired funnel > Metadata click on the button to add a new record for the key use ef_offer_id and put in the value the ID.
-
In the admin, you can go to Integrations and click on View configuration in the Everflow card, go to the events tab and define an offer ID in the Funnel section.
Event ID
There are multiple ways to define the Event ID. Here, we have listed them by priority. Basically what this means is that if you provide all/ or even some of them the first found will be the one used within WebForce.
-
In the editor, you can add a hidden input called ef_event_id (normal event) or ef_adv_event_id (advertiser event) to the Upsell component. Inside put the value of the ID.
-
In the admin, you can go to Funnels > Edit on the desired funnel > Edit on the desired page > Metadata click on the button to add a new record for the key use ef_upsell_event_id (normal event) or ef_adv_upsell_event_id (advertiser event) and in the value put the ID.
-
In the admin, you can go to Funnels > Edit on the desired funnel > Metadata click on the button to add a new record for the key use ef_upsell_event_id (normal event) or ef_adv_upsell_event_id (advertiser event), and in the value put the id.
Admin/Quote orders
To trigger conversions on admin sells you will need an Offer ID, an event ID can be provided optionally.
Offer ID
-
In the admin, you can go to Integrations and click on View configuration in the Everflow card, go to the events tab and define an offer ID in the Admin section.
Event ID
-
In the admin, go to your products, edit in the desired one.
-
Click in Metadata
-
Add new metadata, for the key use ef_event_id_admin(normal event) or ef_adv_event_id_admin (advertiser event) and for the value use your event ID. The event that you put here should be defined (in Everflow) in the offer provided in the previous section.
When providing events, multiple conversions can be triggered because the event can be only defined in a product. For example, if you sell an order with 3 products where the third product has a custom event, this will trigger two conversions. One using the product 1 and 2 and the base event, and another using the product 3 with the custom event.
Shop orders
To trigger conversions on shop sells is needed an offer ID, an event ID can be provided optionally.
Offer ID
-
In the admin, you can go to Integrations and click on View configuration in the Everflow card, go to the events tab and define an offer ID in the Shop section
Event ID
-
In the admin, go to your products, edit within the desired product.
-
Click in Metadata
-
Add new metadata, for the key use ef_event_id_shop(normal event) or ef_adv_event_id_shop (advertiser event) and for the value use your event ID. Keep in mind the event that you put here should be defined (in Everflow) in the offer provided in the previous section.
When providing events, multiple conversions can be triggered because the event can be only defined in a product. For example, if you sell an order with 3 products where the third product has a custom event, this will trigger two conversions. One using the product 1 and 2 and the base event, and another using the product 3 with the custom event
Subscriptions/Recurring payments
A subscription can be created from three different channels Funnel, Admin, or Shop. To trigger conversions on recurring payments an offer ID and an event ID is needed.
Offer ID
There are multiple ways to define the Offer ID. Here, we have listed them by priority. Basically what this means is that if you provide all/ or even some of them the first found will be the one used within WebForce.
-
In the admin got Products > Edit on your desired one > Subscription plans > On the desired one click on the vertical dots > Metadata add new metadata, for the key use ef_offer_id and put in the value the ID.
-
Depending on the source of the subscription, it will use the global Funnel/Admin/Shop offer ID.
Event id
There are multiple ways to define the Event ID. Here, we have listed them by priority. Basically what this means is that if you provide all/ or even some of them the first found will be the one used within WebForce.
-
In the admin go to Products > Edit on your desired one > Subscription plans > On the desired one click on the vertical dots > Metadata add new metadata, for the key use ef_subscription_event_id (normal event) or ef_adv_subscription_event_id (advertiser event) and put in the value the ID.
-
Depending on the source of the subscription, it will use the global Funnel/Admin/Shop event or advertiser event ID
-
.
Affiliate id
To be capable of triggering all of the conversions explained before an affiliate ID is also needed. When working with Lead capture/Funnel sells you need to specify it through a parameter in the URL.
For example: https://domain.com/someurl?affid=1
You can set the affiliate id in 4 different parameter names:
-
affid
-
affId
-
aff_id
-
affiliate_id
When working with Admin/Shop sells the affiliate ID is obtained by recovering the first conversion for that customer.
When working with subscriptions it is obtained by recovering the conversion of the purchase that created the subscription.
If the affiliate ID is not found the conversion won’t be triggered.
How to verify if the Integration is working:
- Very important before being able to test, we must have an Affiliate Link ready to use.
- Perform a live transaction and a test transaction.
- Follow this walkthrough to perform a test transaction: Creating a Test Order
- After performing the transaction check your orders
To check a live order go to Orders and select the Order number as shown below
To check a Test order just go to Orders and click the Funnel icon on the top right corner
Once you have selected the Funnel icon the dropdown will appear, just select Test and Apply to view only the Test orders
Check List:
- Alias: The alias to identify this integration within the WebForce system.
- Domain: You will obtain this value from Everflow.
- Key: You will obtain this value from Everflow.
- Network ID: You will obtain this value from Everflow.
- Advertiser ID: You will obtain this value from Everflow. Right now we can only work with one advertiser per account.