Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Card-Linked Offers (Beta)

Card Linked Offers (CLO) reward shoppers who pay with a debit or credit card they've linked to a partner's program, such as a cashback app or a bank rewards program. These purchases don't come through a tracking link, so your CLO partner sends the transactions to impact.com. Your part is to create an event type for these transactions, validate it with a test file, and share its details with your partner.

1

Create the event type

Create a new event type for your CLO transactions. Follow the steps in Create an Event Type, using these settings:

  • Name: CardLinkedTransactions

  • Type: Online Sale. If you see the Select A Conversion Type screen first, select Online Conversion.

  • Code: Optional. Your partner can send this code instead of the Event Type ID to identify the event type.

  • Tracking Method: Leave the default for now. You set this in the next step.

  • Returns Processing: Keep the default, Process returns using the Pending Payouts screen. CLO doesn't support returns or negative transaction amounts.

2

Set up an email address for your test file

To validate the event type, you email it a test file. Set up the address you send it to:

  1. On the Event Type Overview screen, hover over your event type and select [More] → View/Edit.

  2. Under Tracking Method, select Non-Pixel Tracking (advanced), then select Batch upload.

  3. Select Create new connection, then complete the Create Connection screens:

    1. On Direction, enter a Connection Name. Keep Give data to impact.com, then select Next.

    2. On Type, keep Conversions, then select Next.

    3. On Method, select EMAIL and keep Push to impact.com. Enter *.csv as the File Pattern, then select Next.

    4. On Credentials, select Create New Credentials and enter a Credential Name. Optionally, add a Return email address for receipt/result files to get processing receipts by email. Select Create.

    5. On the Credentials Provisioned screen, select Copy and save the email address somewhere safe. Then select Next.

    6. On Review, check the details, then select Create.

  4. Back on your event type, select your new connection from the Connection drop-down menu, then select Save.

If your account shows Email file to system SMTP server under Tracking Method instead, select it, then select Save and copy the email address that appears.

You only use this address for your test file. Your partner sends the real transactions through their own connection.

3

Add the event type to your terms

Add the CLO event type to the terms you use with your partner. Learn how to add custom terms.

The test in the next step needs the event type in your terms, and you can't send the terms to your partner until the event type is validated.

4

Test and validate the event type

  1. On the Event Type Overview screen, hover over your event type and select [More] → Test. You can also open the event type and select Actions → Test.

  2. On the Test Your Integration screen, select a zero-payout testing Template Term, such as Zero Payout (Testing Only), then select Online Tracking Link as the Ad.

  3. Under Run Test, select Start test in a new window. You can also select Copy and paste the link into a new browser window. You don't need to complete a purchase on the page that opens: you only need its click ID.

  4. Copy the click ID from the landing page URL. It's the value of the irclickid parameter.

  5. Create a CSV file with the columns in the example below. CampaignId is your Program ID and EventTypeId is your Event Type ID. Set EventDate to NOW, Amount to 0.00, and ClickId to the click ID you copied. Using NOW makes sure the event date isn't earlier than your test click.

  6. Email the CSV file as an attachment to the email address you set up in step 2. Leave the subject and body empty.

  7. From the left navigation bar, select [Engage] → Transactions → Test Actions. Your test action can take up to 30 minutes to appear. Your file might show a contract error on the File Submissions screen. That's expected, and the test action still appears here.

  8. Hover over your test action and select [More] → View Details.

  9. Review the details, then select Approve at the top right. The event type's status changes from Pending Validation to Active.

Example test file:

CampaignId,EventTypeId,Amount,EventDate,CurrencyCode,OrderId,ClickId
12345,78901,0.00,NOW,USD,test-clo-val-001,<your click ID>

For more about test actions, see Create Test Actions.

Troubleshoot your test
Issue
What to do

Your test action doesn't appear after 30 minutes

On the File Submissions screen ([User profile] → Settings, then File Submissions under Technical), check that impact.com received your file. Make sure your email has one CSV attachment and an empty subject and body. If you use a Batch upload connection, the file name must match your file pattern and can't start with receipt_ or result_.

The File Submissions screen shows a contract error

This is expected. Your test action still appears on the Test Actions screen.

You set a specific EventDate and the test action doesn't appear

Set EventDate to NOW so the event date isn't earlier than your test click, then send the file again.

You see "You cannot send these terms to a Partner until you have validated the selected Event Types for this Template Term!"

Validate the event type in this step first, then send the terms again.

5

Share the details with your partner

Once the event type is Active, send the terms to your partner, then share these details with them:

  • Event Type ID: shown in parentheses after the event type's name on the Event Type Overview screen

  • Program ID

  • Event Type Code, if you set one

Optionally, also share your Merchant IDs (MIDs). They help your partner identify transactions from shoppers who have a relationship with the partner, for example through a loyalty account or a clipped offer.

6

View and approve transactions

Your partner sends eligible transactions to impact.com through their own connection. Learn how partners submit card-linked transactions. Once they do, you can view the transactions:

  1. From the left navigation bar, select [Engage] → Transactions.

  2. Select Pending Payouts → Actions.

  3. To see only card-linked transactions, filter by your CLO event type.

Transactions are approved automatically based on your contract terms, or you can approve them manually. To approve a transaction manually, select [Drop-down menu] → Approve in the Actions column.

Tip: To review and reconcile transactions manually, consider open-ended locking, which lets you explicitly approve each action.

Last updated