API de marketing

Segmentación detallada

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

La API tiene cuatro puntos de conexión: Búsqueda, Sugerencias, Exploración y Validación.

La respuesta a estos puntos de conexión incluye lo siguiente:

Nombre Descripción

id

Tipo: cadena

ID de público objetivo

name

Tipo: cadena

Nombre del público objetivo

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

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

description

Tipo: cadena

Una breve descripción del público objetivo

Si no proporcionas limit_type, filtramos los resultados con menos de 2.000 personas en cuatro categorías: work_employers, work_positions, education_majors y education_schools. De lo contrario, obtienes resultados menos significativos. Cuando usas limit_type, filtramos resultados de una de esas cuatro categorías y no devolvemos todo.

Recupera públicos objetivo para tus anuncios que coincidan con tu consulta de búsqueda. Puedes proporcionar los siguientes parámetros en este punto de conexión:

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 público que vas a recuperar. Predeterminado en 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.

La configuración regional para mostrar los nombres y descripciones del público, si está disponible. Predeterminado en la configuración regional de la cuenta publicitaria

Sugerencias

Devuelve públicos adicionales que puedes segmentar en función de unos pocos públicos seleccionados que proporcionas.

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 de {'type':'{TYPE}', 'id':{ID}} como público de entrada para 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 público que vas a recuperar. Predeterminado para 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.

La configuración regional para mostrar los nombres y descripciones del público. Predeterminado en la configuración regional de la cuenta publicitaria

Exploración

Obtén la segmentación en una taxonomía estructurada en el caso de las categorías de Facebook, los proveedores de datos de terceros y algunos intereses. Los resultados de este punto de conexión aparecen en la funcionalidad de exploración, 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 siguientes parámetros opcionales:

Nombre Descripción

limit_type

Tipo: cadena

Limita el tipo de público que vas a recuperar. Predeterminado en todos los tipos.

locale

Tipo: cadena

La configuración regional para mostrar los nombres y descripciones del público. Predeterminado en la configuración regional de la cuenta publicitaria

Validación

Verifica si un público es válido para la segmentación o no. Te resultará útil si ya creaste un conjunto de anuncios y quieres verificar que su especificación de segmentación siga siendo válida. Si la segmentación no es válida, deberías eliminarla 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 segmentación detallada, este punto de conexión también devuelve lo siguiente:

Nombre Descripción

valid

Tipo: booleano

Si el público objetivo es válido o no

Aquí encontrarás la lista de parámetros de entrada:

Nombre Descripción

targeting_list

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

Matriz de pares de {'type':'{TYPE}', 'id':{ID}} para validación. Perferido.

id_list

Tipo: matriz de cadenas

Matriz de identificadores para validación. Se procesa correctamente solo si un identificador es identificable exclusivamente en nuestra base de datos de públicos

name_list

Tipo: matriz de cadenas

Matriz de cadenas para validación. Solo intereses; no distingue entre mayúsculas y minúsculas

locale

Tipo: cadena

Configuración regional para mostrar los nombres y descripciones del público. Predeterminado en la configuración regional de la cuenta publicitaria

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