Page tree
Skip to end of metadata
Go to start of metadata

Restriction Levels

Restrictions are available for Supply Sources, Demand Deals, and at the Account level.

Creating/Managing Restrictions Lists

Restrictions can be managed via the Restrictions drop down menu in the navigation bar.

Adding Entities to a List

Create a new list or edit an existing list by adding entities in the 'Add New' text area.  

Multiple entries should be new line separated.

After complete, click the Add button, then the Save button.

Removing Entities

You may filter for and then remove an entity from a list by clicking the “x” to the right of the entity.

Exporting Lists

A restrictions list may be exported to a CSV file by opening the list and clicking the Download button to the right of the search box.

Applying Restrictions Lists

From the Restriction List

  1. Navigate to the Supply or Demand tab. 
  2. Select the Supply Source(s) or Demand Deal(s) that you would like to apply the list to by checking their corresponding boxes.
  3. Select the list type for all newly selected Supply Sources or Demand Deals.
  4. For Domain Lists
    1. If a Black List, select a setting for invalid or empty domains and whether to allow mismatched declared and detected domains.
    2. If a White List, select whether to match against the domain list with declared domains only, or both declared and detected domains. 
      1. If declared only, select whether to allow mismatched declared and detected domains.
  5. For App Lists
    1. If List Type is 'App Name', the list can be applied as a white list or a black list.
      1. If a Black List, select a setting for invalid or empty entities (App Names, Bundle IDs, Device IDs, or IP Addresses)
    2. If List Type is 'App Name + Bundle ID', the list can only be applied as a white list.
  6. For Bundle ID, Device ID, and IP Lists
    1. If a Black List, select a setting for invalid or empty entities (App Names, Bundle IDs, Device IDs, or IP Addresses)

From a Supply Source or Demand Deal

  1. Navigate to the ‘Restrictions’ tab.  
  2. Choose the type of list you would like to apply.  
  3. For Domain Lists
    1. If a Black List, select a setting for invalid or empty domains.
    2. If a White List, select whether to match against the domain list with declared domains only, or both declared and detected domains. 
      1. If declared only, select whether to allow mismatched declared and detected domains.

    For App, Bundle ID, Device ID, and IP Lists
    1. If a Black List, select a setting for invalid or empty entities (App Names, Bundle IDs, Device IDs, or IP Addresses).
    2. 'App Name + Bundle ID' Lists may only be applied as White Lists.

Whitelist vs. Blacklist

  • Whitelist - Only entities on the list will be eligible for ad delivery.
  • Blacklist - All entities are eligible for ad delivery except the entities on the list.

Blacklist Specific Settings

Allowing vs. Restricting Invalid or Empty Entities

  • Allow - If selected, ad requests with entities (domains, apps, bundle ids, etc) that are not valid or not known (non-transparent), or empty will be eligible for ad delivery. 
  • Restrict - If selected, ad requests with entities that are not valid, not known (non-transparent), or empty will not be eligible for ad delivery.

Domain List Specific Settings

Whitelist: Declared Only vs. Declared and Detected

Declared Only - If selected, the declared domain (via the tag's pageurl parameter) will be used when cross referencing an applied domain list.

  •  Block if detected domain is available and does not match
    • When selected, if a detected domain is available and it doesn't match the declared domain, the request will not be eligible.  
    • When unselected, the request will be eligible if the declared domain is part of the list, regardless of whether the detected domain matches the declared domain.

Declared and Detected - If selected, both the declared domain (via pageurl parameter) and detected domain will be cross referenced with an applied domain list.  Both domains, must be part of the applied domain list for a request to be eligible. If a detected domain is not available the request will not be eligible. Note:  VPAID is required for obtaining the detected domain so VAST inventory would not be eligible.

Blacklist: Uses Declared and Detected

Domain blacklists look at both the declared domain and the detected domain.  If either matches a domain on the applied blacklist, the request will not be eligible.

App List Specific Settings

List Type

App Name - Selecting this List Type enforces that inventory matches the App Name in the list before being considered eligible.  App Name lists can be applied as white lists or black lists.

App Name + Bundle ID - Selecting this List Type enforces that inventory matches the App Name and the App Bundle ID combination in the list before being considered eligible.  'App Name + Bundle ID' Lists are more restrictive than App Name Lists or Bundle ID Lists on their own which only look at their respective fields.  'App Name + Bundle ID' lists can only be used as white lists.

Bundle ID List Specific Settings

 Block if detected bundle ID is available and does not match

  • When selected, if a detected bundle ID is available and it doesn't match the declared bundle ID, the request will not be eligible.  
  • When unselected, the request will be eligible if the declared bundle ID is part of the list, regardless of whether the detected bundle ID matches the declared bundle ID.

Account Level Restrictions

You may apply a Whitelist or Blacklist across your entire account (all Supply Sources) via Account Restrictions. 

To access Account Restrictions, go to the Account page and click the Restrictions tab.

How Whitelists / Blacklists affect Reporting

External Supply Sources:  When you apply a blacklist or whitelist to a Supply Source or have a blacklist or whitelist applied across your account (Account Restrictions) and the supplier sends a request from a entity that is not eligible due to the list restriction, LKQD™ will record this as an 'Ineligible Opportunity - Restrictions', not as an 'Opportunity'.  You may add the 'Ineligible Opportunity - Restrictions' metric to reporting to optimize the activity a supplier sends you from restricted entities.

Platform Connection Supply Source: LKQD™ will block the Ad Opportunity from coming into your account if the whitelist / blacklist conditions are not satisfied on your account and the Platform connection's account. This is to ensure optimal efficiency of internal LKQD™ Platform traffic.

On the demand side, you will not see any requests (and therefore no Ads, Wins, or Impressions) because the Demand Tag will not be loaded if it’s not eligible for delivery.

Please contact your LKQD account manager for more information.

  • No labels