Affiliatly Integration - Ours Privacy

Send completed orders and order status changes to Affiliatly so the right affiliate earns commission on every sale they refer.

BetaThis is in beta. The basics are stable, and more capabilities are on the way.

Use this page to connect Ours Privacy to Affiliatly and send your store's orders to your affiliate program, so each referred sale is credited to the affiliate who drove it and refunds or cancellations update their commission.

Before you start

An Affiliatly account for your store.
Your Affiliatly Code and Security Hash from the Affiliatly admin panel.
Affiliatly's tracking script installed on your site, and the Ours Privacy Web SDK on the same pages.
A completed-purchase event that carries a unique order ID and the order total.

Setup

In Affiliatly, open Account and copy Your Affiliatly Code. It looks like AF-10XXXXX.
On the same Account page, copy your Security Hash.
In Ours Privacy, open Destinations, add Affiliatly, and paste the values into Account Code and Security Hash.
Connect your completed-purchase event and set the mapping's Action to Record Purchase. Map a stable Order ID and the order Price.
Connect your refund and cancellation events and set Action to Update Order Status, with the same Order ID and the matching Order Status.
Publish your changes, then place a test order from a visit that starts with ?aff=1 on your store's URL and confirm it appears in your Affiliatly dashboard.

If you generate a new Security Hash in Affiliatly, update it in Ours Privacy too.

How orders are credited

Affiliatly credits an order to an affiliate in any of three ways:

Affiliate link visit. A visitor arrives through an affiliate's link. Keep Affiliatly's tracking script on your site so Affiliatly recognizes these visitors when they come back to buy.
Coupon code. The customer uses a coupon assigned to an affiliate. Map Coupon Code to credit these orders even without a link visit.
Customer email. The customer's email matches one Affiliatly already links to an affiliate. Turn on tracking by email in Affiliatly, then map Customer Email.

Orders that match none of these are not sent, because Affiliatly has no affiliate to credit.

Recommended event setup

Completed purchase: Record Purchase. Send it once per order.
Refunded or cancelled order: Update Order Status with Refunded or Cancelled. This stops the affiliate's commission on the original order. Never send a second Record Purchase for a refund.
Order later marked paid or fulfilled: Update Order Status with Paid, if your Affiliatly program waits for payment before approving commission.

A note on order values

Send the order total without shipping, in your store's default currency in Affiliatly, so commissions are calculated on the right amount.
Partial refunds are not adjusted automatically. Review the order's commission in Affiliatly when you refund part of an order.

Next steps

Need help?

Contact support@oursprivacy.com.

Affiliatly Destination