Business Management APIs

Cuentas publicitarias

Como administrador del negocio, puedes reclamar cuentas publicitarias que pertenecen a un negocio. Esto te permite asignar fácilmente las cuentas publicitarias a las que las personas deben tener acceso. También puedes asignar métodos de pago compartidos a tus cuentas publicitarias.

Un negocio no puede reclamar grupos de cuentas publicitarias. Los usuarios con acceso a ciertos grupos de cuentas publicitarias seguirán disfrutando de ese acceso después de que se les agregue a un administrador comercial.

Reclamar cuentas

Si administras cuentas publicitarias fuera de un administrador comercial con el rol de administrador, puedes reclamarlas para tu negocio. Se trata de un procedimiento único. Una vez reclamadas, solo puedes administrar las cuentas publicitarias en ese administrador comercial.

Las cuentas de contenido no se pueden reclamar.

Para reclamar una cuenta publicitaria para tu negocio, debes suministrar el identificador de la cuenta publicitaria, con el formato act_###. Envía un POST: \El solicitante debe ser un administrador del negocio que reclama la cuenta publicitaria.

curl \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Si eres un administrador de la cuenta publicitaria, aprobaremos la reclamación de inmediato. Facebook devuelve access_status configurado en CONFIRMED.

Si eres un usuario que no tiene los permisos apropiados en la cuenta publicitaria, enviaremos una solicitud de propiedad a los administradores de la cuenta publicitaria. Cuando hayamos enviado la solicitud, la respuesta contendrá el access_status definido como PENDING.

Para aceptar una solicitud de propiedad, debes ser administrador de la cuenta publicitaria, iniciar sesión en el administrador de anuncios y aceptar la solicitud.

Solicitar acceso a cuentas

La mayoría de las empresas de marketing no necesitará reclamar cuentas publicitarias de sus clientes. Para solicitar el acceso a activos que pertenecen a otros administradores comerciales, consulta las funciones de empresa a empresa.

Crear cuentas publicitarias

Si quieres crear nuevas cuentas publicitarias para un negocio debes ser administrador. No puedes usar inicios de sesión compartidos de administradores del negocio para crear cuentas publicitarias nuevas ni realizar otras acciones.

Si deseas usar esta API, debes tener configuraciones de negocio y de página válidas. Si tienes cuentas publicitarias incompletas o páginas no publicadas por Facebook, no podrás crear una nueva cuenta publicitaria.

La creación de cuentas publicitarias mediante la API se limita a 5 cuentas publicitarias. Si deseas crear más de 5 cuentas publicitarias, debes hacerlo manualmente.

Estos son los campos disponibles:

Nombre Descripción

name

Tipo: cadena

Nombre de la cuenta publicitaria

timezone_id

Tipo: entero

Identificador de la zona horaria

currency

Tipo: cadena

Abreviatura de la divisa que se usa en esta cuenta publicitaria

partner

Tipo: largo o cadena

Socio comercial de Facebook (FBP). Debe ser el alias de una página de Facebook, el identificador de la página o el identificador de la app de Facebook. Si no está disponible, usa NONE o UNFOUND.

end_advertiser

Tipo: largo o cadena

Entidad a la que se dirigirán los anuncios. Debe ser una identificación de negocio. Si no está disponible, usa NONE o UNFOUND.

media_agency

Tipo: largo o cadena

Agencia (podría ser tu propio negocio). Debe ser el alias de una página de Facebook, el identificador de la página o el identificador de la app de Facebook. Si no está disponible, usa NONE o UNFOUND.

invoice

Tipo: booleano

Si un negocio tiene una línea de crédito normal con Facebook que le pertenece a un administrador comercial, agregaremos la cuenta publicitaria a dicha línea de crédito.

Para crear una nueva cuenta publicitaria de un negocio, especifica name, currency, timezone_id, end_advertiser, media_agency y partner. Consulta las siguientes condiciones:

  • media_agency y partner deben ser un alias de una página de Facebook, un identificador de la página de Facebook o un identificador de la app de Facebook.
  • end_advertiser debe ser un identificador del negocio.

Si la cuenta publicitaria no tiene un anunciante, una agencia de medios o un socio, especifica NONE. Si la cuenta publicitaria tiene un anunciante, una agencia de medios o un socio, pero no figura en Facebook como página o aplicación, especifica UNFOUND.

Para crear una cuenta publicitaria:

curl \
  -F "name=MyAdAccount" \
  -F "currency=USD" \
  -F "timezone_id=1" \
  -F "end_advertiser=<END_ADVERTISER_ID>" \
  -F "media_agency=<MEDIA_AGENCY_ID>" \
  -F "partner=NONE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/adaccount"

Si ya tienes una línea de crédito extendido con Facebook, puedes definir invoice en true. De este modo, nosotros asociamos tu nueva cuenta publicitaria con tu línea de crédito extendido.

La respuesta tendrá el siguiente aspecto:

{
  "id": "act_<ADACCOUNT_ID>",
  "account_id": "<ADACCOUNT_ID>",
  "business_id": "<BUSINESS_ID>",
  "end_advertiser_id": "<END_ADVERTISER_ID>",
  "media_agency_id": "<MEDIA_AGENCY_ID>",
  "partner_id": "NONE"
}

Ver cuentas propias

Ver todas las cuentas publicitarias a las que tu negocio tiene acceso mediante una llamada GET:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_ad_accounts"

Devuelve todas las cuentas publicitarias que le pertenecen a un negocio. Algunos campos son específicos de la relación del negocio y de la cuenta publicitaria.

  • permitted_tasks es una matriz de tareas que puedes asignar para esa cuenta publicitaria en particular.
  • access_type define si el negocio actúa como OWNER o AGENCY de la cuenta publicitaria.

Para ver las cuentas publicitarias donde el acceso sigue pendiente, haz esta llamada GET:

curl -G \
  -d "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_owned_ad_accounts"

Eliminar cuentas

No puedes eliminar cuentas publicitarias de tu negocio si eres el OWNER o si las cuentas están en el estado CONFIRMED. Si tienes una solicitud de acceso PENDING o cuentas con acceso de AGENCY a la cuenta publicitaria, puedes realizar esta llamada DELETE:

curl \
  -X DELETE \
  -F "adaccount_id=act_<AD_ACCOUNT_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/ad_accounts"

Ver acceso a cuentas

Puedes ver las cuentas publicitarias para las que alguien posee permisos con esta llamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_ad_accounts"

Para ver qué permisos tiene una persona en una cuenta publicitaria, realiza esta llamada GET:

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

Agregar personas a cuentas

Cuando el administrador comercial esté asociado a una cuenta publicitaria, podrás asignar tareas a otros usuarios del negocio. Las tareas posibles incluyen las siguientes:

Nombre Constante de API Descripción

Informes solamente

['ANALYZE']

Pueden verse datos en el rendimiento del anuncio

Usuario general

['ADVERTISE', 'ANALYZE']

Pueden verse y editarse anuncios, y crear anuncios con el método de pago asociado a la cuenta publicitaria. No se puede configurar nada en el nivel de la cuenta publicitaria, como el propio método de pago.

Administrador

['MANAGE', 'ADVERTISE', 'ANALYZE']

Pueden administrarse todos los aspectos de las campañas, los informes, la facturación y los permisos de la cuenta publicitaria.

Necesitas lo siguiente:

  • adaccount_id: identificador de la cuenta publicitaria, en formato act_123
  • user_id: identificador del usuario que se agregará
  • Tareas que se asignarán

Para agregar un nuevo usuario con las tareas ['MANAGE', 'ADVERTISE', 'ANALYZE'], debes hacer esta llamada POST:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'ADVERTISE', 'ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Cambiar permisos en cuentas

Para cambiar las tareas de un usuario actual, haz la misma llamada POST que harías para agregar un usuario nuevo:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ANALYZE']" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"

Eliminar personas de cuentas publicitarias

Para eliminar a alguien de una cuenta, necesitas lo siguiente:

  • adaccount_id: identificador de la cuenta publicitaria, en formato act_123
  • user_id: identificador del usuario que se eliminará

La llamada DELETE es:

curl \
  -X DELETE \
  -F "user=<BUSINESS_SCOPED_USER_ID>" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/assigned_users"