impact.com connection

What it reads

For each connected impact.com account, Growth Dept MTA reads the brand's actions, the conversions impact.com records for its partners, by action date. Programs, partners and ads map to campaigns, ad sets and ads. For each day it adds up what impact.com bills for the actions (the partner's payout plus impact.com's fees on it, or the payout alone where no fee is given), the number of actions and their sale amount. Reversed actions are left out. Dates follow the account's time zone, and hours come from the action times.

That cost is the spend, so impact.com partners appear in reports with their cost under platform Impact and category Affiliate. The same totals fill the impact.com platform-reported columns: spend, conversions and revenue.

An action also carries details about the customer. Growth Dept MTA never reads those fields and keeps only the daily totals.

A pull runs about once an hour and re-reads the last 7 days, and a nightly pull re-reads the last 30. Each pull replaces the rows for its window, so days that impact.com restates end up matching impact.com. Spend is converted to the brand's currency as it arrives, at the European Central Bank rate for each day.

Connecting

impact.com connects with credentials you paste instead of a sign-in screen.

1. In impact.com, open your user menu > Settings > API (under Technical) and choose Create Access Token. Give it read-only scopes, and copy its Account SID and Auth Token.
2. Sign in to Growth Dept MTA as an owner or admin of the brand's organization. Other members can see Settings > Connections but cannot change it.
3. Open Settings > Connections. On the impact.com card, paste them into Account SID and Auth Token, then click Connect.
4. Growth Dept MTA checks them with one small read on impact.com. If impact.com accepts them, they are stored encrypted, the account appears on the card, and a backfill starts over the brand's lookback window (Settings > Lookback window), or as far back as impact.com keeps data if that is shorter. If the check fails, the form shows the error and nothing is saved.

impact.com offers a sign-in connection only to partners it registers privately, so the token is the way to connect.

To replace the credentials, for example before a token ends, paste the new ones into the same form. The connection keeps its data and carries on with the new ones.

If you have been sending impact.com spend through the spend API or a spreadsheet, remove those rows before you connect. They carry their own account ID, so they would be counted on top of the connected account's spend. Settings > Data Spreadsheets lists each upload. Once the connection is live, the spend API and spreadsheets refuse new impact.com rows.

Tracking parameters

Add these to the Program Tracking Template in impact.com (Settings, then Tracking), so partner clicks count under Impact. Settings > UTM guide in Growth Dept MTA shows the same string with a copy button.

utm_source=impact&utm_medium=affiliate&utm_campaign=<partner name>

Limits

• Click and placement fees that impact.com bills outside actions are not part of the spend.
• There are no impressions, clicks, thumbnails or view-through conversions.
• impact.com allows 1,000 requests an hour. When a pull reaches that, it waits for the limit to reset or carries on in a follow-up job.
• If impact.com rejects the stored token, for example after it is deleted in impact.com, the account's row on the card shows the error until a new token is pasted into the same form.
• Growth Dept MTA only reads from impact.com. It does not change campaigns, budgets or ads.

Disconnecting

Each linked account has its own Disconnect button in its row on the impact.com card. Only owners and admins can use it. After you confirm:

• Syncing for that account stops.
• The stored Account SID and Auth Token is deleted.
• Data already pulled stays in your reports.

Connecting the account again later starts a new backfill.