Skip to end of metadata
Go to start of metadata

IP Range List Service

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. 

On This Page

Intended Use Case

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.

Not Designed for Blacklisting

This service is not designed for blacklisting IPs. See the Profile Service limitation below for more details.

Limitations

The following limitations exist for the IP Range List Service:

  • You can create up to 100 IP range lists.
  • A single "include" IP range list (include set to true) cannot contain more than 3500 ranges.
  • A single "exclude" IP range list (include set to 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. 

REST API

View all of your IP range lists:
GET https://api.appnexus.com/ip-range-list

View a specific IP range list:
GET https://api.appnexus.com/ip-range-list?id=LIST_ID

Add a new IP range list:
POST https://api.appnexus.com/ip-range-list

Modify an existing IP range list:
PUT https://api.appnexus.com/ip-range-list?id=LIST_ID

Delete an IP range list: 
DELETE https://api.appnexus.com/ip-range-list?id=LIST_ID

Find out which fields you can filter and sort by:
GET https://api.appnexus.com/ip-range-list/meta

JSON Fields

Name

Type

Description

Default

Required on

id

int

The unique ID of this IP range list.

 

PUT, in query string

ip_ranges

array of objects

This array holds ranges of IP addresses. See the IP Ranges table below for details on the object fields.

 

POST, PUT

name

string

The name of the IP range list.

 

POST, PUT

description

string

An optional description of this IP range list.

null

 

include

boolean

Whether to include the IP ranges in this list in campaign targeting using the Profile Service.

false

 

num_ip_ranges

int

Read-only. The current number of IP ranges in this list.

 

 

last_modified

date

Read-only. When this object was last updated.

 

 

IP Ranges

Each object in the ip_ranges array contains the following fields.

Name

Type

Description

Required on

from_ip

string

The starting IP address. If no following to_ip field is included, this is treated as the only address to include or exclude. This string must be in valid IPV4 address format, i.e., "198.2.1.1".

POST, PUT

to_ip

string

The (optional) ending IP address. If this field is not included, the IP address in the from_ip field will be used alone. If this field is included, the addresses between the fields form a range. Ranges must be listed in ascending order, e.g., {"from_ip":"192.168.2.1", "to_ip":"192.168.2.100"}.

 

Examples

 View an IP range list
 Create an IP range list
 Update an IP range list
Add an IP range list to your profile

Related Topics