Partager via

Service liste de plages d’adresses IP

Le service de liste de plages d’adresses IP est utilisé pour gérer les listes de plages d’adresses IP qui peuvent être utilisées pour le ciblage par le service de profil. Les fonctionnalités fournies par ce service sont similaires au service de liste de domaines.

Cas d’usage prévu

Le cas d’usage prévu pour ce service est destiné aux acheteurs mobiles qui souhaitent diffuser des publicités aux utilisateurs où la facturation directe des clients est activée, c’est-à-dire que les achats sont facturés à l’opérateur et ajoutés à la facture mobile. Dans ce scénario, les campagnes ciblent les plages d’adresses IP des passerelles pour les tours cellulaires qui autorisent la facturation directe de l’opérateur.

Pour cibler réellement les listes de plages d’adresses IP que vous créez et gérez ici, ajoutez-les au ip_range_list_targets champ dans le service de profil.

Remarque

Non conçu pour bloquer l’inventaire (listes de blocage)

Ce service n’est pas conçu pour bloquer les adresses IP (comme les listes de blocage). Pour plus d’informations, consultez les limitations ci-dessous.

Limitations

Les limitations suivantes existent pour le service de liste de plages d’adresses IP :

  • Vous pouvez créer jusqu’à 100 listes de plages d’adresses IP.
  • Une liste de plages d’adresses IP ("include"includedéfinie sur true) ne peut pas contenir plus de 3 500 plages.
  • Une seule "exclude" liste de plages d’adresses IP (include définie sur false) ne peut pas contenir plus de 10 plages.

En outre, les limitations suivantes existent sur le service de profil lors du ciblage de plage d’adresses IP Listes :

Par profil, vous pouvez cibler jusqu’à 10 "include" listes de plages d’adresses IP (include définie sur true) et pas plus de 1 "exclude" liste de plages d’adresses IP (include définie sur false). Les plages d’adresses IP exclues doivent être un sous-ensemble des plages d’adresses IP incluses.

API REST

HTTP, méthode Endpoint Description
GET https://api.appnexus.com/ip-range-list Affichez toutes vos listes de plages d’adresses IP.
GET https://api.appnexus.com/ip-range-list?id=LIST_ID Afficher une liste de plages d’adresses IP spécifiques.
GET https://api.appnexus.com/ip-range-list/meta Découvrez les champs que vous pouvez filtrer et trier.
POST https://api.appnexus.com/ip-range-list Ajoutez une nouvelle liste de plages d’adresses IP.
PUT https://api.appnexus.com/ip-range-list?id=LIST_ID Modifier une liste de plages d’adresses IP existante.
DELETE https://api.appnexus.com/ip-range-list?id=LIST_ID Supprimer une liste de plages d’adresses IP.

Champs JSON

Champ Type Description
description string Description facultative de cette liste de plages d’adresses IP.
Par défaut:null
id int ID unique de cette liste de plages d’adresses IP.
Obligatoire sur :PUT
include valeur booléenne Indique s’il faut inclure les plages d’adresses IP de cette liste dans le ciblage de campagne à l’aide du service de profil.
Par défaut:false
ip_ranges tableau d’objets Ce tableau contient des plages d’adresses IP. Pour plus d’informations sur les champs d’objet, consultez le tableau Plages d’adresses IP ci-dessous.
Obligatoire sur :POST Et PUT
last_modified date Date de la dernière mise à jour de cet objet.
En lecture seule.
name string Nom de la liste de plages d’adresses IP.
Obligatoire sur :POST Et PUT
num_ip_ranges int Nombre actuel de plages d’adresses IP dans cette liste.
En lecture seule.

Plages d’adresses IP

Chaque objet du ip_ranges tableau contient les champs suivants.

Champ Type Description
from_ip string Adresse IP de départ. Si aucun champ suivant to_ip n’est inclus, il est traité comme la seule adresse à inclure ou à exclure. Cette chaîne doit être au format d’adresse IPV4 valide, "198.2.1.1"c’est-à-dire .
Obligatoire sur :POST, PUT
to_ip chaîne Adresse IP de fin (facultative). Si ce champ n’est pas inclus, l’adresse IP dans le from_ip champ est utilisée seule. Si ce champ est inclus, les adresses entre les champs forment une plage. Les plages doivent être répertoriées dans l’ordre croissant , par exemple, {"from_ip":"192.168.2.1",
"to_ip":"192.168.2.100"}.

Exemples

Afficher une liste de plages d’adresses IP

$ curl -b cookies -c cookies 'https://api.appnexus.com/ip-range-list?id=2'

{
    "response": {
        "status": "OK",
        "count": 1,
        "start_element": 0,
        "num_elements": 100,
        "ip-range-list": {
            "id": 2,
            "name": "Sky IPs 1",
            "description": "Targeted Sky IP Addresses",
            "include": true,
            "last_modified": "2014-02-19 15:04:36",
            "ip_ranges": [
        {
            "from_ip": "2.120.0.0",
                    "to_ip": "2.120.0.0"
            },
            {
                "from_ip": "2.216.0.0",
                    "to_ip": "2.216.0.0"
            },
                {
                    "from_ip": "5.64.0.0",
                    "to_ip": "5.64.0.0"
            },
                {
                    "from_ip": "90.192.0.0",
                    "to_ip": "90.192.0.0"
            },
                {
                    "from_ip": "94.0.0.0",
                    "to_ip": "94.0.0.0"
                },
                {
                    "from_ip": "151.224.0.0",
                    "to_ip": "151.224.0.0"
                },
                {
                    "from_ip": "176.24.0.0",
                    "to_ip": "176.24.0.0"
                },
                {
                    "from_ip": "176.248.0.0",
                    "to_ip": "176.248.0.0"
                }
            ],
            "num_ip_ranges": 8
    }
}

Create une liste de plages d’adresses IP

$ cat ip-range-list.json

{
    "ip-range-list": {
        "ip_ranges": [
            {
                "to_ip": "168.100.1.105",
                "from_ip": "168.100.1.100"
            },
            {
                "from_ip": "168.109.109.100"
            }
        ],
        "include": true,
        "description": "Yet another nice little IP range list for testing.",
        "name": "Rich's Second Ever IP range list"
    }
}
 
$ curl -b cookies -X POST -d @ip-range-list.json 'https://api.appnexus.com/ip-range-list'
 
{
    "response": {
        "status": "OK",
        "count": 1,
        "id": 3,
        "start_element": 0,
        "num_elements": 100,
        "ip-range-list": {
            "id": 3,
            "name": "Rich's Second Ever IP range list",
            "description": "Yet another nice little IP range list for testing.",
            "include": true,
            "last_modified": "2014-02-25 20:21:12",
            "ip_ranges": [
            {
                    "from_ip": "168.100.1.100",
                    "to_ip": "168.100.1.105"
            },
            {
                    "from_ip": "168.109.109.100",
                    "to_ip": "168.109.109.100"
            }
            ],
            "num_ip_ranges": 2
        }
    }
}

Mettre à jour une liste de plages d’adresses IP

$ cat update-ip-range-list.json

{
    "ip-range-list": {
        "ip_ranges": [
            {
                "to_ip": "168.100.1.105",
                "from_ip": "168.100.1.100"
            },
            {
                "to_ip": "192.168.1.100",
                "from_ip": "192.168.1.1"
            },
            {
                "from_ip": "168.109.109.100"
            }
        ]
}
 
$ curl -b cookies -X PUT -d @update-ip-range-list.json 'https://api.appnexus.com/ip-range-list?id=3'
 
{
  "response": 
    "status": "OK",
    "count": 1,
    "id": "3",
    "start_element": 0,
    "num_elements": 100,
    "ip-range-list": {
      "id": 3,
      "name": "Rich's First IP range list, now with updates!",
      "description": "Just a nice little IP range list for testing. Recently updated.",
      "include": true,
      "last_modified": "2014-12-10 18:49:00",
      "ip_ranges": [
        {
          "from_ip": "168.100.1.100",
          "to_ip": "168.100.1.105"
        },
        {
          "from_ip": "168.109.109.100",
          "to_ip": "168.109.109.100"
        },
        {
          "from_ip": "192.168.1.1",
          "to_ip": "192.168.1.100"
        }
      ],
      "num_ip_ranges": 3
    }
  }
}

Ajouter une liste de plages d’adresses IP à votre profil

$ cat profile-update.json
 
{
    "profile": {
        "ip_range_list_targets": [
            {
                "id":5
            }
        ]
    }
}
 
$ curl -b cookies -X PUT -d @profile-update.json 'https://api.appnexus.com/profile?id=294641&advertiser_id=41884'
 
{
    "response":{
         "num_elements":100,
         "start_element":0,
         "id":"294641",
         "count":1,
         "status":"OK"
         "profile":{
             "exelate_targets":null,
             "segment_targets":null,
             "publisher_targets":null,
             "platform_publisher_targets":null,
             "platform_placement_targets":null,
             "platform_content_category_targets":null,
             "placement_targets":null,
             "deal_targets":null,
             "content_category_targets":null,
             "mobile_app_instance_list_targets":null,
             "mobile_app_instance_targets":null,
             "ip_range_list_targets": [
                {
                    "id": 5
                    "include": false,
                    "description": "Test IP range list",
                    "name": "Test IP range list",
                }
            ],
             "operating_system_extended_targets":null,
             "venue_targets":null,
             "site_targets":null,
             "position_targets":null,
             "operating_system_family_targets":null,
             "operating_system_targets":null,
             "ip_targets":null,
             "inventory_network_resold_targets":null,
             "inventory_group_targets":null,
             "intended_audience_targets":null,
             "gender_targets":null,
             "querystring_targets":null,
             "device_model_targets":null,
             "screen_size_targets":null,
             "device_type_targets":null,
             "supply_type_targets":null,
             "carrier_targets":null,
             "segment_group_targets":null,
             "member_targets":null,
             "postal_code_targets":null,
             "size_targets":null,
             "language_targets":null,
             "domain_list_targets":null,
             "domain_targets":null,
             "dma_targets":null,
             "browser_family_targets":null,
             "browser_targets":null,
             "daypart_targets":null,
             "age_targets":null,
             "inventory_attribute_targets":null,
             "inventory_source_targets":null,
             "inv_class_targets":null,
             "city_targets":null,
             "region_targets":null,
             "country_targets":null,
             "user_group_targets":null,
             "mobile_app_instance_list_action_include":false,
             "mobile_app_instance_action_include":false,
             "use_operating_system_extended_targeting":false,
             "operating_system_family_action":"exclude",
             "created_on":"2013-09-16 17:22:30",
             "is_template":false,
             "allow_unaudited":false,
             "trust":"seller",
             "require_cookie_for_freq_cap":true,
             "operating_system_action":"exclude",
             "venue_action":"exclude",
             "min_minutes_per_imp":null,
             "max_page_imps":null,
             "max_lifetime_imps":null,
             "max_day_imps":null,
             "max_session_imps":null,
             "publisher_id":null,
             "advertiser_id":41884,
             "daypart_bitmap":null,
             "non_audited_url_action":"include",
             "is_expired":false,
             "querystring_boolean_operator":"and",
             "querystring_action":"exclude",
             "location_target_longitude":null,
             "location_target_latitude":null,
             "location_target_radius":null,
             "device_model_action":"exclude",
             "screen_size_action":"exclude",
             "device_type_action":"exclude",
             "supply_type_action":"exclude",
             "carrier_action":"exclude",
             "session_freq_type":"platform",
             "min_session_imps":null,
             "segment_boolean_operator":"and",
             "language_action":"exclude",
             "inventory_action":"exclude",
             "domain_list_action":"exclude",
             "domain_action":"exclude",
             "dma_action":"exclude",
             "daypart_timezone":null,
             "last_modified":"2014-02-05 19:52:32",
             "use_inventory_attribute_targets":false,
             "browser_action":"exclude",
             "city_action":"exclude",
             "region_action":"exclude",
             "country_action":"exclude",
             "description":null,
             "code":null,
             "id":294641
        }
    }
}
  • Last updated on