versión API de marketing

Referencia de la API de marketing

La siguiente es una lista completa de los nodos raíz para las API de marketing de Facebook, con enlaces a la documentación de referencia de cada uno. Los perímetros disponibles se muestran por separado. Para obtener información sobre los antecedentes de la arquitectura de la API y cómo llamar a nodos raíz y sus perímetros, consulta Uso de la API Graph.

Los principales nodos raíz son los siguientes:

Nodo raíz Representa

/{USER}

Alguien en Facebook que crea anuncios. Todos los usuarios publicitarios pueden tener un rol en varias cuentas publicitarias.

/act_{AD_ACCOUNT_ID}

Representa la entidad comercial que administra los anuncios.

/{CAMPAIGN_ID}

Define el objetivo de las campañas publicitarias. Contiene uno o varios conjuntos de anuncios.

/{AD_SET_ID}

Contiene todos los anuncios que comparten el mismo presupuesto, calendario, puja y segmentación.

/{AD_ID}

Contiene información para un anuncio, como elementos del contenido e información sobre mediciones.

Usuario

Perímetros

Perímetro Representa

/adaccountgroups

Grupo de cuentas publicitarias asociadas a esta persona

/adaccounts

Todas las cuentas publicitarias asociadas a esta persona

/accounts

Todas las páginas y lugares en los que un usuario es administrador

/promotable_events

Todos los eventos promocionables que has creado, o bien eventos promocionables de páginas en las que eres un administrador

/promotable_domains

Todos los dominios que esta persona puede promocionar

Cuenta publicitaria

Todas las colecciones de objetos publicitarios en las API de marketing pertenecen a una cuenta publicitaria.

Perímetros

Perímetro Representa

/campaigns

Define el objetivo de las campañas y contiene uno o varios conjuntos de anuncios.

/adsets

Contiene todos los anuncios que comparten el mismo presupuesto, calendario, puja y segmentación.

/ads

Datos para un anuncio, como elementos del contenido e información sobre mediciones

/adcreatives

Define la apariencia y el contenido del anuncio.

/adimages

Biblioteca de imágenes que puede usarse en el contenido del anuncio. Se puede subir y administrar de forma independiente.

/advideos

Biblioteca de vídeos que puede usarse en el contenido del anuncio. Se puede subir y administrar de forma independiente.

/activities

Registro de las acciones realizadas en la cuenta publicitaria.

/adtags

Conjunto de etiquetas en la cuenta publicitaria. Se utiliza para etiquetar campañas, conjuntos de anuncios o anuncios similares.

/adcampaignconversions

Datos de conversión agregados según los conjuntos de anuncios en la cuenta publicitaria

/adgroupconversions

Datos de conversión agregados según los anuncios en la cuenta publicitaria

/customaudiences

Audiencias personalizadas de la cuenta publicitaria. Ayudan a dirigir los anuncios a personas que ya están relacionadas con tu negocio.

/generatepreviews

Genera la vista previa de un anuncio.

/offsitepixels

Píxeles asociados a esta cuenta

/reachestimate

Genera el alcance estimado del anuncio según una especificación de segmentación concreta.

/reportstats

API de informes para recuperar datos de la cuenta publicitaria y programar informes

/adcampaignstats

Conjunto de estadísticas agregadas según los conjuntos de anuncios en la cuenta publicitaria

/adgroupstats

Conjunto de estadísticas agregadas según los anuncios en la cuenta publicitaria

/targetingsentencelines

Genera una descripción en lenguaje natural de la segmentación para el conjunto de anuncios.

/users

Lista de las personas asociadas a una cuenta publicitaria

/insights

Interfaz de estadísticas. Deduplica resultados en objetos secundarios, permite ordenarlos y generar informes asíncronos.

Campaña publicitaria

Perímetros

Perímetro Representa

/adsets

Contiene todos los anuncios que comparten el mismo presupuesto, calendario, puja y segmentación.

/ads

Datos necesarios para un anuncio, como los elementos del contenido y la información sobre mediciones.

/adtags

Etiquetas para las campañas. Se utiliza para encontrar fácilmente campañas similares.

Devuelve un único conjunto de estadísticas agregadas según las campañas.

/insights

Interfaz de estadísticas. Entre las funciones se incluyen la deduplicación de objetos secundarios, ordenación e informes asíncronos.

Conjunto de anuncios

Perímetros

Perímetro Representa

/ads

Datos necesarios para un anuncio, como los elementos del contenido y la información sobre mediciones.

/adcreatives

Define el contenido y apariencia del anuncio.

/activities

Registro de las acciones realizadas en el conjunto de anuncios

/adtags

Etiquetas para los conjuntos de anuncios. Se utiliza para encontrar fácilmente conjuntos de anuncios similares.

/conversions

Datos de conversión para el conjunto de anuncios

/insights

Interfaces de estadísticas. Entre las funciones se incluyen la deduplicación de objetos secundarios, ordenación e informes asíncronos.

Perímetros

Perímetro Representa

/adcreatives

Define la apariencia y el contenido del anuncio.

/adtags

Etiquetas para los anuncios. Se utiliza para encontrar anuncios similares.

/conversions

Datos de conversión para el anuncio

/keywordstats

Devuelve las estadísticas por palabra clave dirigida del anuncio.

/previews

Genera vistas previas del anuncio a partir de un anuncio existente.

/reachestimate

Calcula el alcance estimado de un anuncio.

Conjunto de estadísticas para el anuncio

/targetingsentencelines

Obtiene una descripción en lenguaje natural de la segmentación para el conjunto de anuncios.

/trackingtag

Asigna etiquetas de clics a un anuncio. Con las etiquetas de seguimiento de clics, especifica una URL que se activa cuando alguien hace clic en un anuncio.

/insights

Interfaz de estadísticas. Entre las funciones se incluyen la deduplicación de objetos secundarios, ordenación e informes asíncronos.

Contenido

Perímetros

Perímetro Representa

/previews

Genera vistas previas del anuncio a partir de un objeto de contenido del anuncio existente.