Bulk Import

Data Import creates or updates records from a CSV file. It is how you migrate a roster from another platform, onboard a batch of partners, or backfill conversions that were never postbacked.

What You Can Import

AffClix Data Import screen with upload cards for employee, advertiser, affiliate, campaign and conversion CSV imports grouped under People and Campaigns and Conversions
Data Import — five record types, each with its own template.
TypeUse it forGuide
EmployeeOnboarding your own team in one go.Import Team Members
AdvertiserMigrating a client list.Import Advertisers
AffiliateMigrating a publisher roster.Import Affiliates
CampaignRecreating an offer catalogue.Import Campaigns
ConversionsBackfilling conversions that were never postbacked.Import Conversions

How an Import Works

  1. Download the template for that record type

    The template defines the exact columns and their order. Do not build a file from scratch.

  2. Fill it in without changing the header row

    Column names are how the importer maps your data. Renaming or reordering them breaks the mapping.

  3. Upload the CSV

    Use the matching upload card — an affiliate file uploaded to the advertiser importer will fail.

  4. Review the result under View Lists

    Every import produces a record of what succeeded and what did not, with per-row errors.

Test with five rows before importing five thousand

A malformed column that produces one bad record is a quick fix. The same mistake across a full roster means auditing and correcting every row afterwards. Always trial a small slice of the real file first.

Preparing a File

Save as CSV, UTF-8. Other encodings corrupt accented names and non-Latin scripts.
Keep the header row exactly as supplied. It is the mapping.
Quote any value containing a comma. Company names are the usual offender.
Use one consistent date format across the whole file.
Check for duplicate email addresses. They are the unique key on people records and will fail the row.
Remove trailing blank rows. Spreadsheets add them silently and they import as empty records.
Watch what your spreadsheet does to long numbers

Excel and Sheets will happily reformat a phone number into scientific notation or strip a leading zero from a country code. Format those columns as text before you paste data in.

Checking the Result

View Lists shows every import you have run, when, and its outcome. A partially successful import is normal — valid rows are created and invalid rows are reported with the reason.

Fix the rejected rows in a new file containing only those rows, and re-upload. Do not re-upload the whole file, or you will create duplicates of everything that already succeeded.

Migrating a Whole Network

Order matters, because later records reference earlier ones:

  1. Team members first

    Advertiser and affiliate records reference an account manager, who must already exist.

  2. Advertisers next

    Campaigns require an advertiser.

  3. Affiliates

    Independent of campaigns, so they can go before or after — but before you grant campaign access.

  4. Campaigns last

    They reference advertisers, and their access lists reference affiliates.

  5. Conversions only if you need history

    Backfilled conversions affect balances. Decide first whether they should be payable.

Imported IDs are new

Records get fresh AffClix IDs, not the ones from your old platform. Every tracking link has to be reissued, and any historical report you keep from the old system will not join to the new IDs. Store the old identifier in the External Campaign ID field where one exists.

Rate this article
Thanks for rating!

Was this article helpful?