Skip to content

AvantLink

Give AvantLink affiliates a daily product feed and report every sale so the affiliate who sent it is credited

Updated View as Markdown

AvantLink Integration

AvantLink is an affiliate network: publishers and creators link to your products and earn a commission on the sales they send. The plugin gives AvantLink a daily product feed to build those links from, and reports each sale with its products so AvantLink can credit the affiliate who sent it.


Features

Feature Description
Product feed A CSV of the products you can sell right now, kept current automatically
Sitewide tracking AvantLink’s tracking script runs on every page of your store and checkout
Sales tracking Every order and its items reach AvantLink, whether paid by card, Sezzle or Credova
Order attribution Orders that arrive through an AvantLink feed link show AvantLink as their source

Prerequisites

Before connecting, you need:

  • An approved AvantLink merchant account
  • Your AvantLink merchant ID. It is the number in the sitewide tracking script AvantLink sends you, as in cdn.avmws.com/12345/
  • A published storefront on a custom domain

AvantLink is one of the marketplace feeds, which are available on the Growth and Pro plans.


Setting Up

  1. Navigate to Plugins > Marketplace
  2. Find AvantLink and click Activate
  3. Enter your merchant ID. You can paste the whole sitewide script AvantLink sent you instead, and the ID is read out of it
  4. Copy the product feed URL shown once the plugin is active. Configure shows it again later
  5. Send the feed URL to your AvantLink integration rep
  6. Run AvantLink’s tracking test once with a card, and once with Sezzle or Credova if you offer them

Your feed lives at /avantlink.csv on your storefront domain. AvantLink downloads it once a day, and the file is rebuilt at most every 5 minutes, so it is always current when AvantLink fetches it.

There are no scripts to add yourself. While the plugin is active, FirearmCart places AvantLink’s sitewide script on every page and reports each sale from the checkout.


Which Products Are Included

Products that are active and that a shopper can buy right now: in stock, set to keep selling when out of stock, or not tracking quantity. The feed has no availability column, so sold-out products are left out rather than sent to affiliates to promote. They return to the feed when they are back in stock.

Drafts and event registrations are never included.


Feed Fields

AvantLink maps these columns by hand when your account is set up, so talk to your integration rep before asking for any change to the feed.

Column Contents
SKU Your product SKU, or the product’s internal ID when it has none. AvantLink matches sales to products by this value
Product Name Product name
Department The product’s collection, or its product type when it has no collection
Retail Price Regular price. On a discounted product this is the compare-at price
Sale Price The selling price when a compare-at price above it is set, otherwise 0.00
Long Description Description as plain text, or the product name when there is no description
Image URL Primary product image, left empty when the product has none
Buy Link Product page URL, tagged so the resulting order is attributed to AvantLink
Brand Name Manufacturer, or brand when no manufacturer is set
Subcategory Product type
UPC The product’s barcode, or its UPC specification, when it is a valid UPC/GTIN
Manufacturer ID Manufacturer part number, from the product’s specifications

Sales Tracking

When an order completes, the checkout reports it to AvantLink with:

  • The order number
  • The merchandise subtotal after discounts, without tax or shipping
  • The coupon code, when one was used
  • The billing state
  • Whether this is the customer’s first purchase from your store
  • Each product’s SKU and quantity, and its price per unit after discounts

Sales paid with Sezzle or Credova are reported when the customer returns to your checkout from the provider. Each sale is reported once, from the browser that placed it. Opening the order confirmation again from an email never reports it a second time.


Troubleshooting

Check that the plugin is still active, because the feed URL returns a 404 while it isn’t. Then check that your storefront domain hasn’t changed. A new domain means a new feed URL, which you need to send to AvantLink.

Products Missing from the Feed

Confirm the product is active and can be bought right now. Sold-out products leave the feed until they are back in stock.

Sales Not Tracking

Make sure the merchant ID in the plugin matches the number in AvantLink’s sitewide script, then run AvantLink’s tracking test. Ad blockers can stop AvantLink’s script in a shopper’s browser, so test in a browser without one.


Navigation

Type to search…

↑↓ navigate↵ selectEsc close