Servicio de lista de intervalos IP

Artículo
07/05/2024

El servicio de lista de intervalos IP se usa para administrar listas de intervalos IP que el servicio de perfiles puede usar para la selección de destino. La funcionalidad proporcionada por este servicio es similar a Domain List Service.

Caso de uso previsto

El caso de uso previsto para este servicio es para los compradores de dispositivos móviles que desean publicar anuncios a los usuarios en los que está habilitada la facturación directa del cliente, es decir, las compras se cobran al operador y se agregan a la factura de móvil. En este escenario, las campañas tienen como destino los intervalos IP de puertas de enlace de las torres de telefonía móvil que permiten la facturación directa del operador.

Para dirigirse realmente a las listas de intervalos IP que cree y administre aquí, agréguelas al ip_range_list_targets campo del servicio de perfiles.

Nota:

No diseñado para bloquear el inventario (listas de bloqueos)

Este servicio no está diseñado para bloquear direcciones IP (como listas de bloqueo). Para obtener más información, consulte las limitaciones que se indican a continuación.

Limitaciones

Existen las siguientes limitaciones para el servicio de lista de intervalos IP:

Puede crear hasta 100 listas de intervalos IP.
Una lista de intervalos IP única "include" (include establecida en true) no puede contener más de 3500 intervalos.
Una lista de intervalos IP única "exclude" (include establecida en false) no puede contener más de 10 intervalos.

Además, existen las siguientes limitaciones en profile service al dirigirse a listas de intervalos IP:

Por perfil, puede tener como destino hasta 10 "include" listas de intervalos IP (include establecido en true) y no más de 1 "exclude" lista de intervalos IP (include establecido en false). Los intervalos IP excluidos deben ser un subconjunto de los intervalos IP incluidos.

API de REST

Http (método)	Endpoint	Description
`GET`	https://api.appnexus.com/ip-range-list	Vea todas las listas de intervalos IP.
`GET`	https://api.appnexus.com/ip-range-list?id=LIST_ID	Ver una lista de intervalos IP específica.
`GET`	https://api.appnexus.com/ip-range-list/meta	Averigüe por qué campos puede filtrar y ordenar.
`POST`	https://api.appnexus.com/ip-range-list	Agregue una nueva lista de intervalos IP.
`PUT`	https://api.appnexus.com/ip-range-list?id=LIST_ID	Modifique una lista de intervalos IP existente.
`DELETE`	https://api.appnexus.com/ip-range-list?id=LIST_ID	Elimine una lista de intervalos IP.

Campos JSON

Campo	Tipo	Descripción
`description`	string	Descripción opcional de esta lista de intervalos IP. Predeterminado:`null`
`id`	Entero	Identificador único de esta lista de intervalos IP. Obligatorio activado:`PUT`
`include`	booleano	Si se deben incluir los intervalos IP en esta lista en la segmentación de campañas mediante el servicio de perfil. Predeterminado:`false`
`ip_ranges`	matriz de objetos	Esta matriz contiene intervalos de direcciones IP. Para obtener más información sobre los campos de objeto, consulte la tabla Intervalos IP siguiente. Obligatorio activado:`POST` y `PUT`
`last_modified`	date	La última vez que se actualizó este objeto. Solo lectura.
`name`	string	Nombre de la lista de intervalos IP. Obligatorio activado:`POST` y `PUT`
`num_ip_ranges`	Entero	Número actual de intervalos IP de esta lista. Solo lectura.

Intervalos IP

Cada objeto de la ip_ranges matriz contiene los campos siguientes.

Campo	Tipo	Descripción
`from_ip`	string	Dirección IP inicial. Si no se incluye ningún campo siguiente `to_ip` , se trata como la única dirección que se debe incluir o excluir. Esta cadena debe tener un formato de dirección IPV4 válido, es decir, `"198.2.1.1"`. Obligatorio en:`POST` , `PUT`
`to_ip`	string	Dirección IP final (opcional). Si no se incluye este campo, la dirección IP del `from_ip` campo se usará solo. Si se incluye este campo, las direcciones entre los campos forman un intervalo. Los intervalos deben aparecer en orden ascendente , por ejemplo, `{"from_ip":"192.168.2.1",` `"to_ip":"192.168.2.100"}`.

Ejemplos

Visualización de una lista de intervalos 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
    }
}

Creación de una lista de intervalos 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
        }
    }
}

Actualización de una lista de intervalos 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
    }
  }
}

Adición de una lista de intervalos IP al perfil

$ 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
        }
    }
}

Compartir a través de

Servicio de lista de intervalos IP

Caso de uso previsto

Limitaciones

API de REST

Campos JSON

Intervalos IP

Ejemplos

Visualización de una lista de intervalos IP

Creación de una lista de intervalos IP

Actualización de una lista de intervalos IP

Adición de una lista de intervalos IP al perfil

Recursos adicionales

Compartir a través de

Servicio de lista de intervalos IP

Caso de uso previsto

Limitaciones

API de REST

Campos JSON

Intervalos IP

Ejemplos

Visualización de una lista de intervalos IP

Creación de una lista de intervalos IP

Actualización de una lista de intervalos IP

Adición de una lista de intervalos IP al perfil

Temas relacionados

Recursos adicionales