Primeros pasos

Para utilizar Business Manager, una empresa necesita al menos una página, un administrador, un nombre de empresa y una dirección de correo electrónico válida.

El nombre de empresa se utiliza solo para tu empresa y cualquier otra empresa con la que decidas compartir objetos. Después de crear esta empresa, puedes añadir páginas, cuentas publicitarias, aplicaciones, objetos de seguimiento de conversiones fuera del sitio y otros activos relacionados con los anuncios que pertenezcan a una empresa.

Requisitos

• Tu aplicación necesita un nivel de acceso a la API de marketing adecuado para utilizar la API de Business Manager. Ten en cuenta que, en algunos casos, la aplicación puede necesitar acceso avanzado. Obtén más información sobre los diferentes niveles de acceso.
• La aplicación también necesita el permiso business_management.
• El usuario también necesita el permiso business_management.

Crear una nueva cuenta de Business Manager

Crea una nueva cuenta de Business Manager para representar a tu empresa. Crea una nueva cuenta de Business Manager solamente si vas a configurar una nueva cuenta de Business Manager para ti o tus clientes. Si necesitas otra cuenta publicitaria o acceso a otra página, debes utilizar los permisos existentes de administrador y activos. No se puede eliminar una cuenta de Business Manager.

Por ejemplo, crea una nueva cuenta de Business Manager con una solicitud POST:

curl \
  -F "name=Pomni Media" \
  -F "vertical=ADVERTISING" \
  -F "primary_page=<PAGE_ID>" \
  -F "timezone_id=1" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<USER_ID>/businesses"

Requisitos

Para crear una empresa, necesitas lo siguiente:

• Un identificador de acceso.
• Un identificador de página.
• Un sector.
• Un identificador de usuario específico de la aplicación.

El identificador de página que proporciones debe ser el de la página principal de la empresa. Esta página representa públicamente a la empresa en Facebook. La persona que crea la empresa es un administrador de dicha página. Si no tienes una página para representar a tu empresa en Facebook, crea una.

El sector es una de estas constantes de cadena:

ADVERTISING , AUTOMOTIVE , CONSUMER_PACKAGED_GOODS , ECOMMERCE , EDUCATION , ENERGY_AND_UTILITIES , ENTERTAINMENT_AND_MEDIA , FINANCIAL_SERVICES , GAMING , GOVERNMENT_AND_POLITICS ,MARKETING , ORGANIZATIONS_AND_ASSOCIATIONS , PROFESSIONAL_SERVICES , RETAIL , TECHNOLOGY , TELECOM , TRAVEL , OTHER

Para ver las propiedades de una empresa, utiliza su identificador. El identificador forma parte de la respuesta a la solicitud de creación de una cuenta de Business Manager:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>?access_token=<ACCESS_TOKEN>"

También puedes ver una lista de las cuentas de Business Manager a las que puedes acceder:

curl "https://graph.facebook.com/<API_VERSION>/me/businesses?access_token=<ACCESS_TOKEN>"

Los campos de la respuesta incluyen:

Actualizar cuentas de Business Manager

Actualiza los campos de la cuenta de Business Manager con una solicitud POST a https://graph.facebook.com/{API_VERSION}/{BUSINESS_ID}. Por ejemplo, cambia el nombre de la empresa:

curl \
-F "name=My Actual Business Name" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Cambia el sector de la empresa con la siguiente solicitud POST:

curl \
-F "vertical=RETAIL" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Tienes las opciones siguientes:

Puedes actualizar la página principal con la siguiente solicitud POST. La página principal debe ser propiedad de la cuenta de Business Manager.

curl \
  -F "primary_page=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

También puedes actualizar todo lo anterior en una solicitud POST:

curl \
  -F "name=My Actual Business Name" \
  -F "vertical=RETAIL" \
  -F "primary_page=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/"

Administrar personas y roles

Hay dos tipos de roles en Business Manager:

Para obtener más información sobre los roles, consulta Configurar roles de catálogo en Business Manager.

Inicialmente el creador de la empresa es el único usuario de la empresa y es un administrador.

Invitar a personas

Para añadir a tus compañeros de trabajo a la empresa, debes invitarlos. Para invitarlos, proporciona una dirección de correo electrónico válida a la que tengan acceso. El envío de solicitudes para añadir empleados a una cuenta de Business Manager está limitado. Al alcanzar este límite, obtendrás el código de error 17 y deberás reanudar el proceso 24 horas después.

Para invitar a alguien como administrador, envía una solicitud POST:

curl \
-F "email=some@email.com" \
-F "role=ADMIN" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"

Para invitar a alguien como empleado, envía una solicitud POST:

curl \
-F "email=some@email.com" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users"

Facebook envía una invitación por correo electrónico a la dirección de correo electrónico de trabajo especificada. El invitado debe consultar el correo electrónico y seguir el proceso de registro. Cuando termine, podrás verlo en tu lista de usuarios.

Personas en Business Manager

A partir de la versión 2.11, contamos con extremos independientes para obtener usuarios según su estado. Realiza una solicitud GET para recuperar cada grupo de usuarios. Para obtener todos los usuarios de la empresa (ten en cuenta que se necesita acceso avanzado):

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_users?access_token=<ACCESS_TOKEN>"

Para obtener los usuarios del sistema, con acceso de nivel de sistema:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>"

Para obtener los usuarios pendientes invitados a acceder a una empresa, pero que aún no han aceptado:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_users?access_token=<ACCESS_TOKEN>"

Los extremos devuelven los usuarios activos, pendientes o del sistema de la empresa. Por ejemplo:

{
  "data": [
    {
      "id": "<BUSINESS_ID>",
      "name": "Alpha MK",
      "email": "some@email.com",
      "role": "EMPLOYEE",
    }
  ]
}

Los resultados de los usuarios pendientes tienen un aspecto similar al siguiente:

{
  "data": [
    {
      "id": "<BUSINESS_ID>",
      "email": "some@email.com",
      "role": "EMPLOYEE",
      "status": "PENDING",
      "owner": {
        "id": "USER_ID",
        "name": "Generic Emporium"
      }
    }
  ]
}

Las definiciones de los campos devueltos son las siguientes:

Cambiar roles

Para cambiar el rol de un usuario activo en la empresa, proporciona el identificador de dicho usuario. Por ejemplo, puedes actualizar a un empleado al rol de administrador con esta solicitud POST:

curl \
  -F "role=ADMIN" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"

Para pasar a alguien del rol de administrador al de empleado, realiza una solicitud POST:

curl \
  -F "role=EMPLOYEE" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>"

Puedes cambiar el rol de un usuario pendiente con esta solicitud POST:

curl \
  -F "role=EMPLOYEE" \
    -F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"

Eliminar usuarios

Elimina los permisos otorgados a alguien en función de sus solicitudes de miembros en las cuentas de Business Manager. Limita el acceso a las cuentas publicitarias y las páginas. Si el usuario tiene acceso a cuentas publicitarias o páginas de fuera de la cuenta de Business Manager, dichos permisos no cambian. Por ejemplo, es posible que alguien se haya añadido o que tenga acceso mediante otra cuenta de Business Manager.

Para eliminar a un usuario activo de la empresa, realiza una llamada DELETE:

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

Para cancelar a un usuario pendiente con una solicitud DELETE:

curl \
  -X DELETE \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<PENDING_USER_ID>"

Así se elimina a los usuarios de la empresa y se elimina el acceso a los activos de tu empresa.

Administrar activos comerciales

Los activos comerciales son los objetos de Facebook (por ejemplo, páginas, aplicaciones, etc.) que administra un administrador. Un administrador puede ser un usuario o una empresa, o en el caso de las aplicaciones, un desarrollador o un anunciante. Los tipos de activos comerciales son los siguientes:

• Páginas
• Cuentas
• Aplicaciones
• Catálogos
• Píxeles de Facebook

Consulta Activos comerciales para ver ejemplos de consulta y obtener más información.

Facturas

La API de Business Manager te permite ver y administrar orígenes de crédito asociados a una empresa. La API reintenta todas las facturas visibles para una cuenta de Business Manager. Esto significa que todas las facturas de las que es responsable esta cuenta de Business Manager son visibles mediante la API, y no solo las facturas que pertenecen a un identificador de empresa individual.

Línea de crédito normal propiedad de la cuenta de Business Manager

En el caso de los socios de la API de marketing que tienen activada la facturación, se puede utilizar la línea de crédito normal propiedad de la cuenta de Business Manager.

Los socios de marketing de Facebook (FBMP) deben ponerse en contacto con su representante de ventas para configurar la cuenta de Business Manager para el crédito. Asegúrate de solicitar la línea de crédito normal propiedad de la cuenta de Business Manager. Una configurado esto, puedes empezar a utilizar la API de creación de cuentas publicitarias para empezar a crear cuentas publicitarias. Los cargos se cobrarán en la línea de crédito de la cuenta de Business Manager.

En el caso de las cuentas publicitarias creadas mediante la siguiente API, distribuiremos dinámicamente el crédito entre las cuentas y actualizaremos los límites de crédito y el gasto para evitar alcanzar los límites de crédito. Podrás ver el crédito resumido disponible y la cantidad de crédito de cada cuenta publicitaria.

En este momento solo admitimos la responsabilidad normal, no admitimos la responsabilidad secuencial. El proceso para configurar esto permanecerá sin cambios.

Facturación a final de mes

Cuando se establece la línea de crédito para una empresa y esta la utiliza para publicar anuncios, generamos facturas para la cuenta empresarial a final de mes. Para ver las facturas de la empresa, necesitas un rol financiero. En el caso de los administradores y los empleados normales de una empresa, puedes asignar permisos en People en Business Manager. También puedes asignar permisos de finanzas a usuarios del sistema con Business Manager.

Para recuperar facturas de una cuenta empresarial con la API, envía una solicitud GET:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?start_date=2017-01-01&end_date=2017-04-01"

Los resultados de ejemplo tienen un aspecto similar al siguiente:

{
  "business_invoices": {
    "data": [
      {
        "id": "1659175694099710",
        "billing_period": "2017-03-01"
      },
      {
        "id": "1303851778395619",
        "billing_period": "2017-01-01"
      },
      {
        "id": "1415846861611329",
        "billing_period": "2017-02-01"
      }
    ],
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MgZDZD"
      }
    }
  },
  "id": "249554531892085"
}

Puedes obtener los detalles de las facturas de nivel de campaña con esta solicitud:

curl -G \
-d "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_invoices?fields=billed_amount_details,billing_period,entity,id,invoice_id,payment_term,type,campaigns&start_date=2019-06-01&end_date=2019-07-01"

La respuesta es similar a esta:

{
  "business_invoices": {
    "data": [
      {
        "billed_amount_details": {
          "currency": "USD",
          "net_amount": "387.70",
          "tax_amount": "0.00",
          "total_amount": "387.70"
        },
        "billing_period": "2017-03-01",
        "entity": "FBUS",
        "id": "1659175694099710",
        "invoice_id": "22736800",
        "liability_type": "Normal",
        "invoice_type": "Invoice",
        "payment_term": "CUSTOMER",
        "type": "Invoice",
        "campaigns": {
          "data": [
            {
              "campaign_id": "6056967798500",
              "campaign_name": "Nhận ưu đãi",
              "tags": [
                "hello2"
              ],
              "billed_amount_details": {
                "currency": "USD",
                "net_amount": "207.62",
                "tax_amount": "0.00",
                "total_amount": "207.62"
              }
            },
            {
              "campaign_id": "6056958052500",
              "campaign_name": "Nhận ưu đãi",
              "billed_amount_details": {
                "currency": "USD",
                "net_amount": "180.08",
                "tax_amount": "0.00",
                "total_amount": "180.08"
              }
              "impressions": 100,
              "clicks": 50,
              "conversions": 30
            }
          ]
        }
      },
      {
        "billed_amount_details": {
          "currency": "USD",
          "net_amount": "382.99",
          "tax_amount": "0.00",
          "total_amount": "382.99"
        },
        ......
    "paging": {
      "cursors": {
        "before": "MAZDZD",
        "after": "MgZDZD"
      }
    }
  },
  "id": "1515766328651000"
}

También puedes recuperar los campos de facturación adicionales:

• invoice_date: fecha en que Facebook generó la factura.
• due_date: fecha de vencimiento de la factura.
• payment_status: muestra si la factura se ha pagado (Paid), no se ha pagado (Unpaid) o se ha pagado parcialmente (Partially Paid).
• amount_due: importe que se debe, y está pendiente, actualmente en la factura.
• download_uri: descarga un PDF de la factura en este URI.

API de métodos de pago

Para recuperar el método de pago de crédito extendido asociado a una cuenta de Business Manager, envía esta solicitud GET.

curl "https://www.graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/extendedcredits"

Si quieres configurar un método de pago para una empresa, ve a la sección de configuración de la empresa en Business Manager.

Asignación de crédito dinámica

La asignación de crédito dinámica, también conocida como DCAF, es nuestro sistema de asignación de crédito para ajustar periódicamente el crédito disponible por cuenta publicitaria. Nuestro script automatizado se ejecuta aproximadamente cada 30 minutos y distribuye el crédito disponible de manera uniforme en todas las cuentas activas que tienen la DCAF activada. El crédito disponible incluye el crédito aprobado total menos el saldo pendiente total. Esto ayuda a administrar los gastos en el nivel de cuenta publicitaria y a asignar pagos para cada cuenta publicitaria.

Una empresa también puede “desactivar” una cuenta publicitaria facturada y eliminar la cuenta publicitaria de la lista que necesita asignación de crédito. Las empresas ya no necesitan que Facebook administre este estado.