API de marketing

Búsqueda de segmentación

Los conjuntos de anuncios se segmentan a partir de ciertos criterios que debes proporcionar en las especificaciones de segmentación. La mayoría de los segmentos son valores predefinidos, por ejemplo, “Japón” como país o “Tokio” como ciudad.

Puedes buscar los valores válidos con la API de marketing y la búsqueda de segmentación: https://graph.facebook.com/{API_VERSION}/search. Debes proporcionar la cadena de consultas en formato UTF8.

Estado de las opciones de segmentación

Para verificar el estado actual o planificado de los objetos de segmentación, usa el parámetro targeting_option_list:

curl -G \
  -d 'targeting_option_list=[<TARGETING_OPTION_ ID>,<TARGETING_OPTION_ID>]' 
  -d 'type=targetingoptionstatus'  
  https://graph.facebook.com/<API_VERSION>/search

Respuesta:

{"data":[{"id":"<TARGETING_OPTION_ ID>","current_status":"NON-DELIVERABLE"},{"id":"<TARGETING_OPTION_ID>","current_status":"NON-DELIVERABLE","future_plan":[{"key":"2018-05-10T00:00:00+0000","value":"DEPRECATING"}]}]

Campos devueltos

CampoValor

current_status

  • NORMAL
  • NON-DELIVERABLE: no entrega, aunque es posible que el anuncio esté configurado para entregar de acuerdo con reglas determinadas previamente.
  • DEPRECATING: los conjuntos de anuncios segmentados para este objetivo siguen entregando, pero el objeto no puede usarse para crear nuevos conjuntos de anuncios o actualizarlos. Cuando se actualizan, los conjuntos de anuncios con ese término se rechazan, a menos que se elimine el término.
  • NON-DELIVERABLE-IN-EXCLUSION: el objeto no puede usarse para la segmentación de exclusiones.
  • UNKNOWN

future_plan

Mapa de marca de tiempo de estados. Devuelve un mapa de fechas y de estados planificados, que tienen los mismos valores disponibles en current_status.

Geografía

Busca la segmentación por país, grupo de países, ciudad, estado, código postal y otras zonas geográficas en type=adgeolocation. Puedes especificar parámetros opcionales con type=adgeolocation. Para buscar el código de país de Estados Unidos:

curl -G \
  -d 'location_types=["country"]' \
  -d 'type=adgeolocation' \
  -d 'q=un' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
  "data": [
    {
      "key": "GB", 
      "name": "United Kingdom", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "AE", 
      "name": "United Arab Emirates", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }, 
    {
      "key": "UM", 
      "name": "United States Minor Outlying Islands", 
      "type": "country", 
      "supports_city": false, 
      "supports_region": false
    }
  ]
}

key es un número fijo y único por categoría, como la categoría de países o grupos de países. Otros campos, incluido name, están sujetos a cambios. Puedes usar key para definir las especificaciones de segmentación.

En la respuesta:

  • Si el valor de supports_region es true, este país tiene códigos de región.
  • Si el valor de supports_city es true, este país tiene códigos de ciudad.
Nombre Descripción

location_types

Tipo: matriz

country, country_group, region, city, zip, geo_market o electoral_district (el último solo para EE. UU.).
location_types es preferible antes que type=adcountry, etc.

region_id

Tipo: entero

Región en la que se buscará.

country_code

Tipo: cadena

País en el que se buscará: country_code=US.

Países

Cada país que puedes segmentar tiene un código de país. Parámetros opcionales para type=adgeolocation&location_types=['country']:

Nombre Descripción

q

Tipo: cadena

La cadena para autocompletar valores. Para incluir todos los países con location_types=['country'], deja q= en blanco y define el límite en un número alto, limit=1000.

match_country_code

Tipo: booleano

Adopta false como valor predeterminado.

Busca el país por su código de país. El resultado coincide con country_code y no con name.

Grupo de países

Todos los grupos de países tienen un código para buscar y obtener una lista de países. Para todos los grupos de países con la denominación mercosur:

curl -G \
  -d 'location_types=["country_group"]' \
  -d 'type=adgeolocation' \
  -d 'q=mercosur' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
  "data": [
    {
      "key": "mercosur",
      "name": "Mercosur",
      "type": "country_group",
      "country_codes": [
        "BR",
        "AR",
        "UY",
        "PY",
        "VE"
      ],
      "is_worldwide": false,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Si el valor de is_worldwide es true, este es un grupo de países a nivel mundial. Si el valor de supports_region es true, el grupo de países tiene códigos de región. Si el valor de supports_city es true, el grupo tiene códigos de ciudad.

Regiones

Para buscar todas las regiones que empiezan con el código al:

curl -G \
  -d 'location_types=["region"]' \
  -d 'type=adgeolocation' \
  -d 'q=al' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
  "data": [
    {
      "key": "3843",
      "name": "Alabama",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "3844",
      "name": "Alaska",
      "type": "region",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "527",
      "name": "Alberta",
      "type": "region",
      "country_code": "CA",
      "country_name": "Canada",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "1089",
      "name": "Alsace",
      "type": "region",
      "country_code": "FR",
      "country_name": "France",
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Opciones para type=adgeolocation&location_types=['region']:

Nombre Descripción

q

Tipo: cadena

Cadena para autocompletar valores. Para obtener todos los países con location_types=['region'], no proporciones parámetros en q= y define el límite en un número alto, limit=1000.

Si el valor de supports_region es true, puedes dirigirte a esta región. Si el valor de supports_city es true, la región tiene códigos de ciudad.

Ciudades

A partir de marzo de 2019, reclasificamos varias ciudades con otros roles, pero puedes seguir usando city. La búsqueda arrojará resultados que eran ciudades.

Para buscar los códigos de todas las ciudades que empiezan con Manhattan:

curl -G \
     -d 'location_types=["city"]' \
     -d 'type=adgeolocation' \
     -d 'q=Manhattan' \
     -d 'access_token=ACCESS_TOKEN' \
     https://graph.facebook.com/VERSION/search

Respuesta:

{
  "data": [
    {
      "key": "2447439",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Kansas",
      "region_id": 3859,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2439596",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Illinois",
      "region_id": 3856,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2479541",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Montana",
      "region_id": 3869,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2428908",
      "name": "Manhattan",
      "type": "city",
      "country_code": "US",
      "country_name": "United States",
      "region": "Florida",
      "region_id": 3852,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "2703980",
      "name": "Manhattan",
      "type": "subcity",
      "country_code": "US",
      "country_name": "United States",
      "region": "New York",
      "region_id": 3875,
      "supports_region": true,
      "supports_city": true,
      "geo_hierarchy_level": "SUBCITY",
      "geo_hierarchy_name": "BOROUGH"
    },
   ...

Si el valor de supports_region es "true", la región de esta ciudad está disponible para su segmentación. Si supports_city se configura en true, la ciudad está disponible para su segmentación.

Zonas geográficas

Tenemos otras zonas geográficas que puedes usar en la segmentación. Algunas todavía no están definidas, como se explica debajo.

ÁreaDescripción

LARGE_GEO_AREA

Conocida comúnmente como distrito o gobernación, abarca cientos de kilómetros cuadrados o más. Ejemplo: Akkar, en Lebanon.

MEDIUM_GEO_AREA

Conocida comúnmente como condado, abarca más de una ciudad. Ejemplo: el condado de Henrico, en el estado de Virginia, en United States

SMALL_GEO_AREA

Conocida comúnmente como una zona residencial cerca de una ciudad o un pueblo. Ejemplo: El Rosario, cerca de Marbella, en Spain.

SUBCITY

Por ejemplo, un municipio. Ejemplo: Brooklyn, en New York.

NEIGHBORHOOD

Zona dentro de una ciudad. Ejemplo: Barton Estates, Irving, en Texas.

SUBNEIGHBORHOOD

Todavía no está disponible.

METRO_AREA

Zona densamente poblada alrededor de una ciudad grande. Todavía no está disponible.

La jerarquía de las zonas geográficas es la siguiente (de mayor a menor):

  • REGION
  • LARGE_GEO_AREA
  • MEDIUM_GEO_AREA
  • SMALL_GEO_AREA
  • METRO_AREA
  • CITY
  • SUBCITY
  • NEIGHBORHOOD
  • SUBNEIGHBORHOOD

Código postal

También puedes buscar códigos postales para segmentar en Facebook. Para la búsqueda de código postal, se recomienda el uso de adgeolocation con location_types=['zip']. Visita el servicio de ayuda de Meta para ver una lista de los países con códigos postales admitidos.

Busca los códigos postales que empiezan con 9:

curl -G \
  -d 'location_types=["zip"]' \
  -d 'type=adgeolocation' \
  -d 'q=9' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/LATEST-API-VERSION/search

Respuesta:

{
  "data": [
    {
      "key": "US:90028",
      "name": "90028",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Los Angeles",
      "primary_city_id": 2420379,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94110",
      "name": "94110",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Francisco",
      "primary_city_id": 2421836,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:94501",
      "name": "94501",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "Alameda",
      "primary_city_id": 2417628,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:95190",
      "name": "95190",
      "type": "zip",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "primary_city": "San Jose",
      "primary_city_id": 2421846,
      "supports_region": true,
      "supports_city": true
    }
  ]
}

Configuraciones regionales

Las configuraciones regionales pueden segmentarse por códigos regionales. Para buscar todas las configuraciones regionales que empiezan con en:

curl -G \
  -d 'type=adlocale' \
  -d 'q=en' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
{
      "data": [
        {
          "key": 51, 
          "name": "English (Upside Down)"
        }, 
        {
          "key": 6, 
          "name": "English (US)"
        }, 
        {
          "key": 24, 
          "name": "English (UK)"
        }
      ]
    }
}
Nombre Descripción

q

Tipo: cadena

Cadena para autocompletar valores. Para obtener todas las configuraciones regionales, deja q= en blanco y define el límite en un número alto limit=1000.

Códigos de DMA

Para obtenerlos, especifica type=adgeolocation y location_types=['geo_market'] en la consulta. Para buscar códigos DMA que empiezan con “New”:

curl -G \
  -d 'location_types=["geo_market"]' \
  -d 'type=adgeolocation' \
  -d 'q=New' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

El resultado:

{
  "data": [
    {
      "key": "DMA:622",
      "name": "New Orleans",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:501",
      "name": "New York",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "DMA:533",
      "name": "Hartford &amp; New Haven",
      "type": "geo_market",
      "country_code": "US",
      "country_name": "United States",
      "supports_region": true,
      "supports_city": true
    },
    {
....
    }
  ]
}

Distritos electorales

Para buscar distritos electorales segmentables, especifica type=adgeolocation y location_types=['electoral_district']. Para buscar los distritos electorales de California:

curl -G \
  -d 'location_types=["electoral_district"]' \
  -d 'type=adgeolocation' \
  -d 'q=California' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
  "data": [
    {
      "key": "US:CA14",
      "name": "California's 14th District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
    {
      "key": "US:CA02",
      "name": "California's 2nd District",
      "type": "electoral_district",
      "country_code": "US",
      "country_name": "United States",
      "region": "California",
      "region_id": 3847,
      "supports_region": true,
      "supports_city": true
    },
 ...
}

Metadatos de geolocalización

Puedes usar parámetros opcionales adicionales con type=adgeolocationmeta:

curl -G \
  -d 'cities=[2418779]' \
  -d 'zips=["US:90210"]' \
  -d 'countries=["US","JP"]' \
  -d 'regions=[10]' \
  -d 'type=adgeolocationmeta' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta es un objeto JSON con metadatos de geolocalización especificados:

{
  "data": {
    "countries": {
      "US": {
        "key": "US", 
        "type": "country", 
        "name": "United States", 
        "supports_city": true, 
        "supports_region": true
      }, 
      "JP": {
        "key": "JP", 
        "type": "country", 
        "name": "Japan", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "regions": {
      "10": {
        "key": "10", 
        "type": "region", 
        "name": "Dubai", 
        "country_code": "AE", 
        "supports_city": true, 
        "supports_region": false
      }
    }, 
    "cities": {
      "2418779": {
        "key": "2418779", 
        "type": "city", 
        "name": "Danville", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }, 
    "zips": {
      "US:90210": {
        "key": "US:90210", 
        "type": "zip", 
        "name": "90210", 
        "primary_city": "Beverly Hills", 
        "region_id": 3847, 
        "region": "California", 
        "country_code": "US", 
        "supports_city": true, 
        "supports_region": true
      }
    }
  }
}

Opciones:

Nombre Descripción

countries

Tipo: cadena

Matriz de códigos de país.

regions

Tipo: entero

Matriz de códigos de región.

country_groups

Tipo: cadena

Matriz de códigos de grupo de países.

cities

Tipo: entero

Matriz de claves de ciudad.

zips

Tipo: cadena

Matriz de códigos postales completos. Por ejemplo, US:92103.

Sugerencias de radio

Para segmentar en torno a una ubicación específica, puedes llegar a suficientes personas con un radio sugerido mediante suggested_radius:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta es un objeto JSON con suggested_radius y distance_unit.

{
  "data": [
    {
      "suggested_radius": 10,
      "distance_unit": "mile"
    }
  ]
}

En este ejemplo, se muestra suggested_radius con un valor distance_unit especificado:

curl -G \
  -d 'latitude=37.449478' \
  -d 'longitude=-122.173016' \
  -d 'type=adradiussuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search
{
  "data": [
    {
      "suggested_radius": 16,
      "distance_unit": "kilometer"
    }
  ]
}

Utiliza los siguientes parámetros:

Nombre Descripción

latitude

Tipo: flotante

Obligatorio.

Latitud de la ubicación

longitude

Tipo: flotante

Obligatorio.

Longitud de la ubicación

distance_unit

Tipo: cadena

Opcional.

Unidad de medición, mile o kilometer

Consulta también los anuncios de difusión local para usar con las sugerencias.

Intereses

Envía una solicitud GET al punto de conexión /search y configura type en adinterest y q para buscar un interés específico:

curl -G \
  -d 'type=adinterest' \
  -d 'q=baseball' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta devolverá los siguientes campos:

Nombre Descripción

id

número entero

Identificador de Facebook para la segmentación por intereses

locale

cadena

Si está disponible, recupera el contenido en el idioma de una configuración regional determinada con el formato language_TERRITORY. El valor predeterminado es en_US.

name

cadena

Nombre del interés

path

Matriz de cadenas

Incluye la categoría y las categorías principales para la segmentación.

Sugerencias de intereses

Envía una solicitud GET al punto de conexión /search y configura type en adinterestsuggestion para obtener una lista de los intereses que se sugieren en relación con tu interés.

Ejemplo de consulta

curl -G \
  -d 'interest_list=["Basketball"]' \
  -d 'type=adinterestsuggestion' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/search

Ejemplo de respuesta

{
  "data": [
    {
      "id": "6003598240487",
      "name": "la biblia",
      "audience_size": 7419780,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003022269556",
      "name": "Rugby football",
      "audience_size": 13214830,
      "path": [
  ],
      "description": null
   },
   {
      "id": "6003146664949",
      "name": "Netball",
      "audience_size": 4333770,
      "path": [
  ],
"description": null
   },
   {
      "id": "6003013291881",
      "name": "Kaizer Chiefs F.C.",
      "audience_size": 1812850,
      "path": [
  ],
      "description": null
  },
  ....
  {
      "id": "6003400886535",
      "name": "espn sportscenter",
      "audience_size": 222960,
      "path": [
  ],
     "description": null
  },
  {
     "id": "6002925969459",
     "name": "watching movies",
     "audience_size": 4630950,
     "path": [
  ],
     "description": null
  },
  {
     "id": "6003214125247",
     "name": "lakers",
     "audience_size": 340360,
     "path": [
  ],
     "description": null
  }

Tienes estas opciones:

Nombre Descripción

interest_list

Tipo: matriz de cadenas

Obligatorio.

Lista de términos para los que quieres sugerencias. Distingue mayúsculas de minúsculas.

Limitaciones

  • Una búsqueda no devolverá todos los intereses disponibles.
  • Los intereses pueden cambiar de nombre en cualquier momento y, si esto sucede, la validación por nombre puede generar un error. Por lo tanto, recomendamos validar los intereses por interest_fbid_list en lugar de hacerlo por nombre. Para comprobar si los términos son válidos, consulta con type=adinterestvalid y el interés que se debe validar:
curl -G \
  -d 'interest_list=["Japan","nonexistantkeyword"]' \
  -d 'type=adinterestvalid' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
  "data": [
    {
      "name": "Japan",
      "valid": true,
      "id": 6003700426513,
      "audience_size": 68310258
    },
    {
      "name": "nonexistantkeyword",
      "valid": false
    }
  ]
}

Opciones:

Nombre Descripción

interest_list

Tipo: matriz de cadenas

Obligatorio si no se proporciona interest_fbid_list.

Lista de términos para validar. Distingue mayúsculas de minúsculas.

interest_fbid_list

Tipo: matriz de identificadores

Obligatorio si no se proporciona interest_list.

Lista de identificadores para validar.

Intereses

Para explorar la segmentación por intereses posibles, envía una solicitud GET al punto de conexión /search con type configurado en adTargetingCategory, y class, en interests.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=interests' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Limitaciones

  • Una búsqueda no devolverá todos los intereses disponibles.

Comportamientos

Segmenta a partir de las acciones de un usuario o de su comportamiento de compra anterior. Recupera todas las opciones de segmentación de comportamiento posibles con type=adTargetingCategory&class=behaviors.

curl -G \
  -d 'type=adTargetingCategory' \
  -d 'class=behaviors' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

La respuesta incluye lo siguiente:

Nombre Descripción

name

Tipo: cadena

Nombre de la segmentación de comportamiento

id

Tipo: entero

Identificador de Facebook de la segmentación de comportamiento

audience_size_lower_bound

Número entero

Límite inferior del tamaño estimado del público objetivo

audience_size_upper_bound

Número entero

Límite superior del tamaño estimado del público objetivo

path

Tipo: matriz de cadenas

Categoría y categorías principales para la segmentación

description

Tipo: cadena

Describe al público objetivo

type

Tipo: cadena

Clase de categoría de segmentación

Datos demográficos

Entre estos datos, se incluyen el lugar de trabajo, la formación, los tipos de puesto y los tipos de estado de las relaciones. También se puede segmentar a partir de cuán reciente es un acontecimiento importante: 3 meses, 6 meses o 1 año. Puedes segmentar las instituciones educativas por identificador y por nombre.

Para buscar todas las instituciones educativas que empiezan con ha:

curl -G \
  -d 'type=adeducationschool' \
  -d 'q=ha' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

 {
  "data": [
    {
      "name": "Harvard University", 
      "id": 105930651606,
      "coverage": 8395398,
      "subtext": "Cambridge, Massachusetts"
    }, 
    {
      "name": "Hajvery University", 
      "id": 148971135122588,
      "coverage": 124162
    }, 
    {
      "name": "Harvard-Westlake School", 
      "id": 107799365910274,
      "coverage": 14106
    }
  ]
}

Especializaciones educativas

Puedes segmentar las especializaciones por identificador y por nombre. Para buscar todas las especializaciones que empiezan con ph:

curl -G \
  -d 'type=adeducationmajor' \
  -d 'q=ph' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
  "data": [
    {
      "name": "Photography", 
      "id": 108170975877442,
      "coverage": 613618
    }, 
    {
      "name": "Physics", 
      "id": 109279729089828,
      "coverage": 942491
    }, 
    {
      "name": "Philosophy", 
      "id": 108026662559095,
      "coverage": 701271
    }
  ]
}

Empresa

Puedes consultar las empresas segmentables por identificador y por nombre. Para buscar todas las empresas que empiezan con mic:

curl -G \
  -d 'type=adworkemployer' \
  -d 'q=mic' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
  "data": [
    {
      "name": "Western Michigan University", 
      "id": 10022826163,
      "coverage": 24366
    }, 
    {
      "name": "University of Michigan", 
      "id": 21105780752,
      "coverage": 17357
    }, 
    {
      "name": "Michigan State University - SPARTANS", 
      "id": 8891783019,
      "coverage": 65853
    }
  ]
}

Cargo

Cada cargo autodeclarado y segmentable tiene un identificador y un nombre. Para obtener todos los cargos que incluyen Business Analyst:

curl -G \
  -d 'type=adworkposition' \
  -d 'q=Business Analyst' \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v<API_VERSION>/search

Respuesta:

{
   "data": [
    {
      "name": "Business Analyst", 
      "id": 105763692790962,
      "coverage": 282124
    }, 
    {
      "name": "Financial Analyst", 
      "id": 112930925387573,
      "coverage": 212889
    }
  ]
}

La respuesta tiene estos campos:

Nombre Descripción

name

Tipo: cadena

Nombre de la segmentación demográfica

id

Tipo: entero

Identificador de Facebook de la segmentación demográfica

coverage

Tipo: entero

Tamaño estimado del público objetivo

subtext

Tipo: cadena

Descripción del público objetivo

Los siguientes son parámetros comunes para esta API. Para ver los parámetros de entrada específicos de cada tipo, consulta los siguientes detalles.

Nombre del parámetro Descripción

q

Obligatorio para la mayoría de los tipos de búsqueda.

Cadena para autocompletar valores.

type

Obligatorio.

Tipo de datos para autocompletar que se van a recuperar. Consulta a continuación.

list

Opcional.

Recupera los identificadores globales de Facebook preferidos en lugar de los códigos FIPS. Compatible con adzipcode.

Cuando se usa, el valor debe ser igual a GLOBAL.

limit

Opcional.

Resultados máximos para devolver; predeterminados: 8.

A partir de la categoría de datos para autocompletar, proporciona el valor de type correspondiente. Para recuperar las configuraciones locales, especifica type=adlocale. Las categorías válidas son las siguientes:

Valor del parámetro “type” Descripción

adeducationschool

Autocompletar la segmentación para universidad

adeducationmajor

Autocompletar la segmentación para especialización universitaria

adgeolocation

Autocompletar combinando para país, ciudad, estado y código postal

adgeolocation.adcountry

Autocompletar para país

adgeolocation.adzipcode

Autocompletar para código postal

adgeolocation.adgeolocationmeta

Metadatos adicionales para geolocalizaciones

adgeolocation.adradiussuggestion

Devuelve el radio recomendado en torno a la ubicación

adinterest

Autocompletar la segmentación para configuración regional

adinterest.adinterestsuggestion

Sugerencias basadas en la segmentación por intereses

adinterest.adinterestvalid

Valida la cadena como una opción de segmentación por intereses

adlocale

Autocompletar la segmentación para configuración regional

adTargetingCategory

El parámetro q se ignora. Puedes ver todas las opciones de segmentación posibles para la clase con el parámetro class.
Valores posibles de class: interests, behaviors, demographics, life_events, industries, income, family_statuses, user_device y user_os

adworkemployer

Autocompletar valores para empresa

adworkposition

Autocompletar valores para puesto

Exploración demográfica

Recupera todas las opciones de segmentación demográfica posibles con type=adTargetingCategory y class.

Nombre Descripción

class

Tipo: cadena

Especifica una opción: life_events, industries, income, family_statuses o user_device. Al especificar demographics, se recupera todo.


Las opciones de segmentación demográfica no están disponibles en todos los países. Facebook puede devolver diferentes resultados, incluso resultados vacíos, según la configuración del país de origen del usuario cuyo token de acceso se está usando para hacer esta llamada a la API.

La respuesta incluye los siguientes campos:

Nombre Descripción

name

Tipo: cadena

Nombre de la segmentación demográfica.

id

Tipo: entero

Identificador de Facebook de la segmentación demográfica

audience_size_lower_bound

Número entero

Límite inferior del tamaño estimado del público objetivo

audience_size_upper_bound

Número entero

Límite superior del tamaño estimado del público objetivo

description

Tipo: cadena

Descripción del público objetivo.

type

Tipo: cadena

Tipo de datos demográficos. Es útil para recuperar todos los datos demográficos.

path

Tipo: matriz de cadenas

Incluye la categoría y las categorías principales de la segmentación.