The IP Range List Service is used to manage lists of IP ranges that can be used for targeting by the Profile Service. The functionality provided by this service is similar to the Domain List Service.
The intended use case for this service is for mobile buyers who would like to serve ads to users where direct client billing is enabled, i.e., purchases are charged to the carrier and added to the mobile bill. In this scenario, campaigns target the IP ranges of gateways for cell towers that allow direct carrier billing.
To actually target the IP range lists you create and manage here, add them to the
ip_range_list_targets field in the Profile Service.
This service is not designed for blacklisting IPs. See the Profile Service limitation below for more details.
The following limitations exist for the IP Range List Service:
true) cannot contain more than 3500 ranges.
false) cannot contain more than 10 ranges.
In addition, the following limitations exist on the Profile Service when targeting IP Range Lists:
Per profile, you can target up to 10 "include" IP range lists (
include set to
true) and no more than 1 "exclude" IP range list (
include set to
false). The excluded IP ranges must be a subset of the included IP ranges.
View all of your IP range lists:
View a specific IP range list:
Add a new IP range list:
Modify an existing IP range list:
Delete an IP range list:
Find out which fields you can filter and sort by:
The unique ID of this IP range list.
array of objects
This array holds ranges of IP addresses. See the IP Ranges table below for details on the object fields.
The name of the IP range list.
An optional description of this IP range list.
Whether to include the IP ranges in this list in campaign targeting using the Profile Service.
Read-only. The current number of IP ranges in this list.
Read-only. When this object was last updated.
Each object in the
ip_ranges array contains the following fields.
The starting IP address. If no following
The (optional) ending IP address. If this field is not included, the IP address in the
In this example, we add a new ip range to ip range list 3.
This service is used for IP range list management. In order for targeting to take effect, the list must be added to your profile via the Profile Service.