API de marketing

Segmentación detallada

Con la búsqueda de segmentación, puedes encontrar segmentaciones con un tipo de segmentación en una única llamada a la API. Con la API de segmentación detallada, puedes buscar varios tipos de segmentación al mismo tiempo con una única solicitud. También puedes obtener sugerencias basadas en la consulta.

La API tiene cuatro extremos: Búsqueda, Sugerencias, Navegación y Validación.

La respuesta para estos extremos contiene lo siguiente:

Nombre Descripción

id

Tipo: cadena

Identificador de la audiencia objetivo.

name

Tipo: cadena

Nombre de la audiencia objetivo.

audience_size_lower_bound

entero

Tamaño estimado de la audiencia objetivo del límite inferior

audience_size_upper_bound

entero

Tamaño estimado de la audiencia objetivo del límite superior.

path

Tipo: matriz de cadenas

Incluye la categoría y todas las categorías principales que abarca la segmentación.

description

Tipo: cadena

Breve descripción de la audiencia objetivo.

Si no proporcionas un valor para limit_type, filtraremos los resultados con menos de 2000 personas en cuatro categorías: work_employers, work_positions, education_majors y education_schools. De lo contrario, obtendrías resultados menos significativos. Cuando usas el parámetro limit_type, filtramos según una de esas cuatro categorías y no devolvemos todos los resultados.

Recupera audiencias objetivo para los anuncios que coinciden con la consulta de búsqueda. En este extremo, puedes proporcionar los siguientes parámetros:

curl -G \
-d "q=harvard" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsearch
Nombre Descripción

q

Tipo: cadena

Obligatorio.

Cadena de consulta.

limit

Tipo: entero

Opcional.

Número de resultados.

limit_type

Tipo: cadena

Opcional.

Limita el tipo de audiencia que se recupera. El valor predeterminado es todos los tipos.

Valores válidos:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

Tipo: cadena

Opcional.

Configuración regional para mostrar los nombres y descripciones de las audiencias, en caso de estar disponible. El valor predeterminado es la configuración regional de la cuenta publicitaria.

Sugerencias

Devuelve audiencias adicionales a las que te puedes dirigir en función de la selección de audiencias que proporciones.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003263791114}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingsuggestions

Proporciona estos parámetros:

Nombre Descripción

targeting_list

Tipo: matriz de {'type':'{TYPE}', 'id':{ID}}

Obligatorio.

Matriz de pares {'type':'{TYPE}', 'id':{ID}} como audiencia de entrada para obtener sugerencias.

limit

Tipo: entero

Opcional.

Número de resultados. El valor predeterminado es 30. El máximo es 45.

limit_type

Tipo: cadena

Opcional.

Limita el tipo de audiencia que se recupera. El valor predeterminado es todos los tipos.

Valores válidos:

  • interests
  • education_schools
  • education_majors
  • work_positions
  • work_employers
  • relationship_statuses
  • college_years
  • education_statuses
  • family_statuses
  • industries
  • life_events
  • behaviors
  • income

locale

Tipo: cadena

Opcional.

Configuración regional para mostrar los nombres y descripciones de las audiencias. El valor predeterminado es la configuración regional de la cuenta publicitaria.

Navegación

Obtén la segmentación con una taxonomía estructurada para las categorías de Facebook, los proveedores de datos externos y algunos intereses. Los resultados de este extremo aparecen en la función Explorar, en el componente de IU de segmentación detallada del Administrador de anuncios.

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingbrowse

Proporciona los parámetros opcionales siguientes:

Nombre Descripción

limit_type

Tipo: cadena

Limita el tipo de audiencia que se recupera. El valor predeterminado es todos los tipos.

locale

Tipo: cadena

Configuración regional para mostrar los nombres y descripciones de las audiencias. El valor predeterminado es la configuración regional de la cuenta publicitaria.

Validación

Verifica si una audiencia es válida para la segmentación. Resulta de utilidad si ya has creado un conjunto de anuncios y quieres verificar si la especificación de segmentación sigue siendo válida. Si la segmentación no es válida, elimínala de la especificación de segmentación.

curl -G \
-d "targeting_list=[{'type':'interests','id':6003283735711}, {'type':'relationship_statuses','id':100}]" \
-d "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/targetingvalidation

Además de los campos de respuesta estándar de la segmentación detallada, este extremo también devuelve lo siguiente:

Nombre Descripción

valid

Tipo: booleano

Si la segmentación de la audiencia es válida o no.

A continuación se incluye la lista de los parámetros de entrada:

Nombre Descripción

targeting_list

Tipo: matriz de {'type':'{TYPE}', 'id':{ID}}

Matriz de pares {'type':'{TYPE}', 'id':{ID}} para validar. Opción preferida.

id_list

Tipo: matriz de cadenas

Matriz de identificadores para validar. Solo se completa correctamente si el identificador es único e identificable en nuestra base de datos de audiencias.

name_list

Tipo: matriz de cadenas

Matriz de cadenas para validar. Solo intereses, no distingue entre mayúsculas y minúsculas.

locale

Tipo: cadena

Configuración regional para mostrar los nombres y descripciones de las audiencias. El valor predeterminado es la configuración regional de la cuenta publicitaria.

Proporciona al menos uno de los parámetros siguientes: targeting_list, id_list y name_list.