ROASify

Documentation

Docs

How ROASify works, how to set it up, and what its statuses mean.

What ROASify does

When a Shopify order is refunded or cancelled, ROASify automatically sends a correction to Google Ads — a full retraction for a complete refund, or a corrected value for a partial refund — so the refunded sale stops being counted as a real conversion.

It's a focused add-on, not a replacement for your existing Purchase tracking. It never sends new conversions to Google Ads — only corrections to conversions your existing setup (Shopify's native Google & YouTube channel, GA4, Elevar, or another app) already tracked. Google Ads only — Meta's Conversions API has no equivalent adjustment mechanism.

Setup

1. Install the app and open it from your Shopify admin.
2. Go to Settings and click Connect Google Ads — a one-time OAuth step, separate from the Shopify install.
3. Click Discover accounts & conversion actions to find your Ads account and Purchase conversion action automatically.
4. Review the selected account and conversion action, then click Save.
5. Check Enable adjustment sync and Save again to turn corrections on.

Use Validate connection on the Overview tab any time to confirm the connection is working — it sends a real, harmless request to Google Ads using a made-up order id, so it never touches real conversion data.

How adjustments work

Every refund or cancellation is evaluated against the order's current state in Shopify, not tracked as a running total locally:

• Full refund or cancellation with a captured payment — the conversion is retracted.
• Partial refund — the conversion's value is restated to match what the order is actually worth now.
• Cancellation with no payment ever captured — correctly ignored, since nothing was converted in the first place.

Google matches an adjustment to the original conversion using an order identifier. ROASify tries your order's numeric Shopify ID first, then automatically retries with the plain order number (e.g. 1001) if the first doesn't match — covering the two common ways Purchase-tracking setups key their conversions, without needing you to configure anything.

"No matching Google Ads conversion" — what it means

You may see this on the Events tab, shown as sent with an info icon. It means the request reached Google Ads and was processed correctly — Google is telling ROASify there was never a Purchase conversion recorded for that order under either identifier it tried. There's nothing broken, and nothing further for ROASify to do for that order.

This is expected, not an error, and it happens for a few ordinary reasons:

• The order was created directly in Shopify admin (a draft order, a manually entered order) rather than through a real checkout that Google Ads ever saw.
• The order predates connecting Google Ads or enabling sync in ROASify.
• The order came through a sales channel that isn't part of your Google Ads conversion tracking setup.

Troubleshooting

Google Ads shows "not connected" after I connected it

Make sure you clicked Save after using Discover — the account and conversion action fields are only written to your settings once saved, not immediately when Discover finds them.

A sync shows a real error, not "no conversion found"

Check the Detail column on the Events tab for the specific message. Transient failures (timeouts, rate limits) retry automatically up to 3 times before landing in a dead-letter list you can review and replay from the dashboard. Errors that say your Google Ads credentials were rejected mean the connection needs to be re-established from Settings.

The dashboard shows stale or missing data

Use the Refresh button on the Events tab, or reload the app from your Shopify admin.

Support

For anything not covered here, contact 7labs@dmitru.com.