Entities: what they are and how to add one

On this page

Each entity has its own ad accounts, rules and tracking, and can cover a website, mobile apps, or both. Your first was created with the workspace; this article covers the second onward.

What an entity is

Each one holds:

  • Its domains, under Protected domains in Setup > Website > Domains.
  • Its detection rule sets, including the default set.
  • Its monitoring script, with its own key, on Setup > Website > Monitoring.
  • Its connected ad accounts: Google Ads, Meta Ads, TikTok Ads, Microsoft Ads, LinkedIn Ads, Snapchat Ads and Apple Ads.
  • Its mobile apps, connected through your tracking tool, such as Adjust or AppsFlyer.
  • Its products, switched on or off for this entity alone (Products for each entity).

Two brands or two websites get one each. Several ad accounts for one website share the same one.

You are always on exactly one entity. With several, the switcher at the top of the sidebar shows it, with its initials in a small tile and its status dot; pick another there, or click Manage entities for the full list. Tapper opens the entity you used last. Setup is always the pages of the entity you are on.

Products for each entity

Each entity has its own products, so one brand can run Lift, Vantage and Block while another runs Lift alone. The menu, the dashboard and the product pages follow the entity you are on. Open a page of a product that is off for this entity and Tapper takes you to Settings > Products with a line that says so.

Owners and Admins switch products in Settings > Products: one card per product for the entity you are on, with Turn on or Turn off for that entity alone. With several entities, pick the entity at the top of the page. Turn off asks you to confirm first. Every product has its own switch; Lift Products turns on and off with Lift. Once an ad account is connected, Block cannot be turned back on here after Turn off: Tapper support turns it on.

Where a product's card has Contact support, press it to change that product.

The status chip

Shown on the Setup pages, as the dot on the entity's tile in the switcher and in the entity list:

  • Protected: an ad account is connected, nothing needs fixing and blocking is on.
  • Monitor-only: connected, nothing is blocked.
  • Needs attention: a connected ad account is in error, or a website has no domain.
  • Not connected: no ad account or mobile app yet.
  • Lift active: a working entity on a Lift workspace.

Add an entity

The Add entity dialog ("An entity can hold a website, mobile apps, or both, with its own ad accounts and rules.") shows how many entities remain on your plan, as {n} entities remaining on your plan; with none left, you cannot add one. Only an Owner or Admin can connect an ad account to it.

  1. Under Setup in the sidebar, click Add entity (the last row), pick it in the entity switcher, or click Add entity on the Entities page.
  2. Type a Name.
  3. Tick the Products it should have; each box is ticked on its own, with the product's one line beside it. Your first entity has no such step: it takes the products you chose in the wizard.
  4. Click Create.

What happens next

The entity starts as Not connected, with Connect an ad account or a mobile app so Block can protect it. The connect button opens the wizard at Connect your accounts, then Install website monitoring.

Or finish it from its own pages, account first, since click tracking and blocking start once an ad platform is connected:

  1. Connect an ad account: in Setup > Ad accounts, click Add ad account or a platform's connect button, such as Connect Google Ads. Both open Add an ad account. See Add another ad account to an entity.
  2. Add a domain: Setup > Website > Domains, Add domain under Protected domains.
  3. Install the monitoring script: Setup > Website > Monitoring. See The monitoring script.

On a Lift workspace the line reads Connect an ad account to start Lift. There is no domain or script step, and once connected the chip reads Lift active.

A new entity has no click limits yet. On the Click limits tab of its default rule set, Choose your industry adds an industry's presets (Suggested thresholds by industry). The set starts in Monitor-only until an Owner, Admin or Manager on a paid plan switches blocking on: see Monitor-only.

The entity list

Manage entities opens the Entities page, "The websites and apps Block covers, and the ad accounts behind them.", with a search box, Add entity and one row per entity. Under an entity's name, a line says what it still needs, such as "Microsoft Ads account: Needs reconnecting." or "Add the domain of your website."

ColumnWhat it shows
NameThe entity's name.
PlatformsOne chip per connected platform, Mobile app for a mobile app, or None connected.
StatusThe entity's status chip: Protected, Monitor-only, Needs attention or Not connected.
TagWith Block, whether the entity's website sends its monitoring script's visits: Receiving events, Installed, no events (the tag is on the website but no visits arrived), Stopped (no visits in the last 24 hours) or Not installed.
ActionsTwo buttons: Edit name and Delete protection script.

If setup stopped partway, the banner Finish setting up this workspace resumes the wizard.

Rename or delete an entity

Click Manage entities in the switcher, then Edit name on the entity's row to rename it. Delete protection script is grayed out and says "Only Tapper can delete a protection script. Contact support.": Tapper does it, because it disconnects every ad account under the entity. Write to support@tapper.ai.

Still need help?

Chat with our team and mention this article.