Información general sobre la administración de activos

Un negocio puede acceder a varios activos. Tu negocio es el propietario de los activos o accede a ellos como agencia. Usa las API de activos del administrador comercial de Facebook para agregar, eliminar o consultar la relación entre un negocio y sus activos, y para administrar los activos comerciales y el acceso a ellos.

El término agencia se refiere a un tipo de entidad comercial que puede administrar activos que son propiedad de otra empresa, o puede acceder a ellos. Esta relación permite a la agencia realizar tareas o acciones específicas en nombre del cliente, como administrar cuentas publicitarias, páginas u otros activos digitales.

Grupos de activos comerciales

Los grupos de activos comerciales ayudan a los grandes anunciantes o agencias a administrar de manera eficiente los usuarios y activos en sus negocios. Debes organizarlos de una manera que se ajuste a las operaciones del mundo real. Por ejemplo, una empresa puede estructurar sus activos y usuarios según la marca, la región, el cliente o un principio organizador de su elección.

Los grupos de activos comerciales pueden contener cuentas publicitarias, páginas, píxeles de Facebook, conjuntos de eventos offline, apps, catálogos, conversiones personalizadas y cuentas de Instagram. Los activos pueden ser propiedad de un negocio o compartidos para proporcionar acceso a una agencia.

Puedes usar esta API para agregar usuarios a un grupo de activos comerciales. Una vez agregados, puedes otorgar a las personas permisos para acceder a los activos de un grupo de activos comerciales. De este modo, puedes otorgar acceso a varios activos a la vez, sin crear demasiados administradores en el nivel del negocio.

Con esta API, puedes administrar los grupos de activos comerciales ya creados a través del administrador comercial o puedes administrar los activos dentro del grupo de activos comerciales. Puedes hacer lo siguiente:

Obtener una lista de grupos de activos comerciales asociados con un negocio.
Eliminar o renombrar un grupo de activos comerciales.
Ver todos los activos de un grupo de activos comerciales.
Obtener, agregar, editar y eliminar permisos de usuarios para acceder a los activos de un grupo de activos comerciales.
Asignar usuarios a un grupo de activos comerciales.
Obtener, agregar y eliminar activos de un grupo de activos comerciales.

Permisos

Para usar la API de grupos de activos comerciales, tu app necesita el nivel de acceso a la API de marketing adecuado:

En el caso de todos los puntos de conexión de agregación y eliminación, el usuario del token de acceso debe ser un administrador del negocio. Si no, se rechazará el acceso.
En el caso de todos los puntos de conexión de la API, tu app necesita el permiso business_management.

Necesitas permisos adicionales en el caso de los siguientes puntos de conexión:

Puntos de conexión del grupo de activos comerciales	Permisos obligatorios
Obtener lista de cuentas publicitarias	`ads_management`
Obtener lista de catálogos de productos, agregar catálogo de productos o eliminar catálogo de producto	`ads_management`
Obtener lista de cuentas de Instagram, agregar cuenta de Instagram o eliminar cuenta de Instagram	`ads_management`. Si usas la versión 4.0 de la API de marketing, también necesitas `instagram_basic`.
Obtener lista de píxeles	`ads_read`
Obtener lista de conjuntos de eventos offline	`ads_management`
Obtener lista de conversiones personalizadas	`ads_read`
Agregar conversión personalizada	`ads_management`

Limitaciones

Obtienes un error si intentas reducir o eliminar permisos de un activo incluido en un grupo de activos comerciales a través de las siguientes llamadas a la API:

Solicitud DELETE a /{page_id}/assigned_users
Solicitud POST a /{page_id}/assigned_users
Solicitud DELETE a /act_{ad_account_id}/assigned_users
Solicitud POST a /act_{ad_account_id}/assigned_users.

Para reducir o eliminar permisos, sigue estos pasos:

Haz una llamada para obtener una lista de los grupos de activos asociados a un negocio. Busca grupos de activos en los que contained_asset_id sea igual a {page_id} o {ad_account_id}.
Por cada identificador de grupo de activos comerciales devuelto, haz una llamada a la API para eliminar un usuario de ese grupo.
A continuación, llama a las solicitudes DELETE o POST mencionadas antes para eliminar el permiso de ese usuario en la página o en la cuenta publicitaria.

Si proporcionas funciones de administración de permisos en tu app para otros negocios, debes usar esta API para evitar incoherencias y errores entre la API y el administrador comercial.

No puedes configurar permisos en aplicaciones, catálogos, cuentas de Instagram ni conversiones personalizadas a través del grupo de activos comerciales. En su lugar, debes asignar permisos en el nivel de los activos.

Por ejemplo, si agregas a Roger a un grupo de activos comerciales en el administrador comercial de Jasper, puede obtener permisos para acceder a cualquier página, cuenta publicitaria, píxel, etc., de ese grupo de activos comerciales. Sin embargo, para eliminar o editar los permisos de Roger de acceso a un activo del grupo de activos comerciales de Jasper, debes realizar esta acción en el mismo grupo de activos comerciales.

Puedes agregar permisos de usuario en el nivel de activos con la API de activos, como cambiar a alguien de moderador de página a administrador. Consulta los ejemplos de página y cuenta publicitaria.

Los grupos de activos comerciales reemplazaron a la API de Proyectos el 13 de octubre de 2019. Debes migrar todas las apps de la API de Proyectos a grupos de activos comerciales.

Roles permitidos

Cuando se agrega un usuario nuevo a un negocio, se puede asignar uno de los dos roles siguientes a través de la API de usuarios comerciales:

Constante de API	Nombre	Descripción
`ADMIN`	Administrador del negocio	Puede administrar todos los aspectos de la configuración del negocio, como modificar o eliminar la cuenta y agregar o eliminar personas.
`EMPLOYEE`	Empleado del negocio	Puede ver toda la información en la configuración del negocio, pero no puede realizar cambios en este, excepto agregar páginas o cuentas publicitarias que administre.

Catálogos

Los siguientes roles se pueden asignar a cualquier usuario del negocio, administrador o empleado, en catálogos a los que puede acceder este negocio usando las API de catálogo:

Constante de API	Nombre	Descripción
`['MANAGE', 'ADVERTISE']`	Administrador del catálogo	Puede administrar todos los aspectos del catálogo. Tiene acceso completo de lectura y escritura, como crear, actualizar o eliminar artículos, administrar feeds, adjuntar catálogos a píxeles y apps, crear conjuntos de productos, publicar anuncios de catálogo Advantage+ y cambiar la configuración del catálogo.
`['ADVERTISE']`	Anunciante del catálogo	Puede crear conjuntos de productos y publicar anuncios de catálogo Advantage+ con el catálogo. No puede editar sus productos, sus feeds ni la configuración del catálogo.

Cuentas publicitarias

Las siguientes tareas se pueden asignar a cualquier usuario del negocio en relación con las cuentas publicitarias a las que puede acceder este negocio usando las API de cuenta publicitaria:

Constante de API	Nombre	Descripción
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	Administrador de la cuenta publicitaria	Puede administrar todos los aspectos de campañas, informes, facturación y permisos de cuentas, y establecer los límites de gasto de la cuenta publicitaria. También puede asociar métodos de pago del negocio.
`['ADVERTISE', 'ANALYZE']`	Anunciante en la cuenta publicitaria	Puede ver anuncios, editarlos y configurarlos con el método de pago asociado a la cuenta publicitaria.
`['ANALYZE']`	Analista de la cuenta publicitaria	Puede ver el rendimiento de los anuncios.

Páginas

Puedes asignar las siguientes tareas a cualquier usuario de un negocio en las páginas a las que puede acceder este negocio usando las API de página:

Constante de API	Nombre	Descripción
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Administrador de la página	Puede administrar los roles de página, enviar mensajes y crear publicaciones en nombre de la página, crear anuncios y ver estadísticas.
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Editor de la página	Puede editar la página, enviar mensajes y publicar en nombre de la página, crear anuncios y ver estadísticas.
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Moderador de la página	Puede responder a comentarios en la página y eliminarlos, enviar mensajes en nombre de la página, crear anuncios y ver estadísticas. No puede crear publicaciones en nombre de la página.
`['ADVERTISE', 'ANALYZE']`	Anunciante de la página	Puede crear anuncios de la página y ver estadísticas. No puede crear publicaciones en nombre de la página.
`['ANALYZE']`	Analista de la página	Puede ver estadísticas. No puede crear publicaciones en nombre de la página.

Apps

No hay ninguna API de administración de roles ni tareas para apps en el administrador comercial.

Cuentas de Instagram

No hay una administración de roles para las cuentas de Instagram en el administrador comercial. Los usuarios con acceso a cuentas publicitarias asociadas a cuentas de Instagram pueden publicar anuncios para esas cuentas de Instagram.