Brand Mappings — Naming Brands Consistently
This screen lets you see and adjust how brand names arriving from affiliate programs are matched to brands in the Routy catalog. It lives under Account Integration → Brands.
What this screen is for
When Routy reads an account's report, the brand arrives as free text — exactly
as the affiliate program writes it (Casino XYZ, casino-xyz UK, XYZ Sport).
Those strings mean nothing on their own, so each one has to be mapped to a
brand in the Routy catalog. Once mapped, every event and every report row for
that name is attributed to the right brand.
Each row on this screen is one mapping: a source name from one program, pointing at one catalog brand. A source name with no catalog brand yet is shown as Unmapped — Routy has seen the name but doesn't know what it is.
How to read the screen
Each row shows:
- Source name — the brand string exactly as the program reports it. This is what Routy matches on, so spelling and spacing matter.
- Program — the affiliate program the name comes from, by name, with its id next to it. Click it to open the program.
- Mapped brand — the catalog brand the name points at, as a green badge, or Unmapped.
- Updated — when the mapping last changed.
The same source name can exist under several programs, and each one is mapped separately — two programs may use the same word for different brands.
Mapping a brand
You can map a brand straight from the table:
- Click the Mapped brand cell on the row you want to fix.
- Pick the catalog brand from the dropdown. Only brands belonging to that row's program are listed.
- Click Save. To remove a mapping without deleting the row, click Unmap — the source name stays, but it goes back to Unmapped.
The same popup is available on the Events screens, so you can fix a mapping at the moment you notice a wrong brand.
Adding a mapping by hand
Use Add Mapping when you already know a name is coming and want it mapped before the first report arrives.
- Choose the Program.
- Type the Source name exactly as the program will report it.
- Choose a Catalog brand, or leave it empty to record the name as unmapped.
The program and source name together identify the mapping — they can't be changed afterwards. Editing an existing mapping only changes the brand it points at. To correct a misspelled source name, delete the mapping and add the correct one.
Bulk update
When several source names need the same treatment — a dozen spellings of one brand, or a batch of rows to clear out — handle them in one go instead of row by row.
- Tick the rows you want. On a phone, use the checkbox on each card; on a desktop, use the checkboxes in the table, or the one in the header to take everything currently loaded.
- Click Bulk update in the top-right.
- Choose what to do:
- Map to a catalog brand — point every selected name at the same brand. Only available when the whole selection is from one program, because a brand belongs to a program. If you've selected rows from several programs, filter by program first.
- Unmap — keep the names, clear the brand they point at.
- Delete mappings — remove the rows entirely.
- Confirm. The drawer shows progress row by row, then a summary.
Rows are updated one at a time, so a failure part-way through doesn't undo the ones that already succeeded. Anything that failed is listed at the end with the reason, and Retry failed re-runs just those. Stop after current halts the run without touching the rows it hasn't reached.
Changing a filter or the search clears your selection — the rows it referred to may no longer be in the list.
Finding what you need
- Search matches the source name.
- Program filter narrows to a single program.
- Mapping filter shows only Mapped or only Unmapped rows — start with Unmapped to find the names still waiting for attention.
- The funnel button clears every filter at once.
Common tasks
"A brand shows up twice in reports." The program is sending two spellings of the same brand. Search for the brand, and map every spelling to the same catalog brand.
"I mapped a brand but the report still shows the old one." Mappings apply when a report is next processed. Re-run the account's task, or wait for the next scheduled run.
"The brand I need isn't in the dropdown." The dropdown only lists brands attached to that row's program. Add the brand to the program in the catalog first, then come back and map it.
"I deleted a mapping by mistake." Add it again with Add Mapping, using the same program and source name.
When to escalate to engineering
- The source name in reports doesn't match any row here, and no new row appears after a report run.
- A mapping is saved but events keep arriving unmapped for the same name.
- Saving a mapping returns an error every time.