Business Management APIs

Referencia

Publicación

Extremo	Descripción
`/{ad-account-id}/ads`	Crea un anuncio.
`/{business-id}/initiated_sharing_agreements`	Aprueba o rechaza una solicitud de acuerdo comercial pendiente.
`/{business-creative-folder-id}`	Crea o actualiza una carpeta de contenido del negocio.
`/{business-id}/creative_folders`	Proporciona una carpeta de contenido del negocio.
`/{business-id}/images`	Sube imágenes a una carpeta de contenido.
`/{business-id}/videos`	Sube vídeos a una carpeta de contenido.
`/{business-creative-folder-id}/agencies`	Añade un socio a una carpeta de contenido.
`/{business-creative-folder-id}/assigned_users`	Obtén una lista de las personas que tienen acceso a la carpeta de contenido del negocio.

Lectura

Extremo	Descripción
`/{business-creative-folder-id}`	Obtén los detalles de una carpeta de contenido del negocio.
`/{business-id}/creative_folders`	Obtén una lista de las carpetas de contenido del negocio a las que puede acceder una empresa.
`/{business-id}/creatives`	Obtén imágenes y vídeos empresariales del negocio.
`/{business-id}/initiated_sharing_agreement`	Obtén una lista de las solicitudes de acuerdo pendientes. Este extremo se volvió a introducir en mayo de 2020. Previamente, `/initiated_sharing_agreement` se había retirado con el lanzamiento de la versión 6.0 de la API Graph.
`/{business-image-id}`	Obtén los detalles de una imagen.
`/{business-image-id}/insights`	Obtén las insights de una imagen compartida.
`/{business-video-id}`	Obtén los detalles del vídeo compartido.
`/{business-video-id}/insights`	Obtén las insights del vídeo compartido.
`/{business-creative-folder-id}/agencies`	Obtén una lista de las empresas que tienen acceso a la carpeta de contenido.
`/{business-creative-folder-id}/assigned_users`	Obtén una lista de las personas que tienen acceso a la carpeta de contenido.

Eliminación

Extremo	Descripción
`/{business-creative-folder-id}`	Elimina una carpeta de contenido.
`/{business-creative-folder-id}/agencies`	Quita a un socio de la carpeta de contenido.
`/{business-creative-folder-id}/assigned_users`	Quita a un usuario de la carpeta de contenido.
`/{business-image-id}`	Quita una imagen compartida.
`/{business-video-id}`	Quita un vídeo compartido.

Tareas permitidas

Tarea permitida del usuario empresarial	Descripción
`CREATE_CONTENT`	Este usuario puede crear carpetas.
`MANAGE_CONTENT`	Este usuario puede administrar las piezas de contenido de la carpeta de contenido.
`MANAGE_PERMISSIONS`	Este usuario puede administrar los permisos de la carpeta de contenido del negocio.
`VIEW_CONTENT`	Este usuario puede ver las piezas de contenido de una carpeta de contenido.
`VIEW_INSIGHTS`	Este usuario puede ver las insights de una pieza de contenido.

Insights

Estas métricas se encuentran en desarrollo.

Nombre de la métrica	Descripción
`impressions`	Número de veces que la imagen o el vídeo apareció en un anuncio.
`inline_link_clicks`	Número de clics en los enlaces del anuncio. Los clics en los enlaces insertados usan un intervalo de atribución fijo de un día después del clic.
`video_play_actions`	Número de veces que el vídeo empieza a reproducirse. Contamos este valor para cada impresión de vídeo y excluimos las reproducciones sucesivas.
`actions`	Número total de acciones que las personas han llevado a cabo y que se atribuyen a tus anuncios. Las acciones pueden incluir interacciones, clics o conversiones. Consulta una lista completa de los tipos admitidos en este documento.
`video_thruplay_watched_actions`	Número de veces que se ha reproducido el vídeo completo o durante al menos 15 segundos.
`quality_ranking`	Clasificación de la calidad percibida del anuncio. La calidad se mide con los comentarios de un anuncio y la experiencia posterior al clic. Un anuncio se clasifica en relación con otros anuncios que han competido por la misma audiencia. Algunos valores posibles son los siguientes: `BELOW_AVERAGE_10` `BELOW_AVERAGE_20` `BELOW_AVERAGE_35` `AVERAGE` `ABOVE_AVERAGE` `UNKNOWN` (si no hay suficiente información sobre el anuncio) Esto está relacionado con el diagnóstico de la pertinencia de los anuncios.

Se encuentran disponibles los desgloses siguientes:

age
gender
country
objective
publisher_platform
platform_position
device_platform
optimization_goal