Configurar una nueva cuenta de Business Manager secundaria

La solución de Business Manager de dos niveles se diseñó originalmente para que cada identificador de acceso de usuario solo pudiera crear una cuenta de Business Manager secundaria. Sin embargo, ahora los usuarios pueden crear varias cuentas de Business Manager secundarias siempre que establezcan una página principal en cada cuenta de Business Manager secundaria.

Nota: Dependiendo de si el campo appsecret_proof está activado en la configuración de la aplicación, es posible que appsecret_proof se requiera como parámetro en cada llamada que realices. Consulta el documento Seguridad de las solicitudes de la API Graph para obtener información sobre cómo definir esta opción y cómo generar appsecret_proof.

Introducción

Antes de empezar, te recomendamos que revises los requisitos e información siguientes:

Permisos de la aplicación

business_management
ads_management

Identificadores

PARENT_BM_ID: identificador de la cuenta de Business Manager del socio que es propietario de la aplicación.
CHILD_BM_ID: identificador de la cuenta de Business Manager que la cuenta de Business Manager principal crea para el cliente.

Identificadores de acceso

USER_Personal_Access_Token: identificador de acceso de la persona que proporciona las credenciales para crear la cuenta de Business Manager secundaria.
- Este identificador se genera mediante el inicio de sesión con Facebook.
- El socio debe solicitar los ámbitos globales de business_management en las empresas y páginas del usuario en lugar de los ámbitos granulares.
- Esta persona debe tener privilegios de administrador en la página que se comparte con la cuenta de Business Manager secundaria.
- Si la página es propiedad de otra cuenta de Business Manager, esta persona debe tener privilegios de administrador en la cuenta de Business Manager que es propietaria de la página.
- Este identificador se usa para autorizar la creación de la cuenta de Business Manager secundaria y para compartir con ella la página con fines publicitarios.
PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: identificador de acceso del usuario administrador del sistema de la cuenta de Business Manager principal.
- Este identificador se usa para crear y administrar cuentas de Business Manager secundarias.
CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: identificador de acceso del usuario administrador del sistema que se ha creado en la cuenta de Business Manager secundaria.
- Este identificador se usa para crear y administrar campañas y otras actividades de la cuenta de Business Manager secundaria.

Crear una cuenta de Business Manager secundaria

Mediante USER_Personal_Access_Token, crea una cuenta de Business Manager secundaria.

Ejemplo: devuelve el identificador de una cuenta de Business Manager secundaria.

curl \
  -F 'id=<Parent_Business_Manager_ID>' \
  -F 'name=Advertisers child BM (recommend naming similar to page)' \
  -F 'vertical=OTHER' \ // Specify the Business vertical
  -F 'shared_page_id=<PAGE_ID_FROM_USER>' \  //Optional parameter but needed if you want to publish ads promoting this page
                                             //Note: the user must be an admin of the BM that owns this page if this page is owned
  -F 'page_permitted_tasks=["ADVERTISE", "ANALYZE"]' \
  -F 'timezone_id=1' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Id>/owned_businesses

Respuesta:

{
    “ID” : “12312812123132”  //store this child business manager ID and associate to user
}

Crear varias cuentas de Business Manager secundarias por usuario

Si el usuario quiere crear varias cuentas de Business Manager secundarias con las mismas credenciales de usuario, primary_page debe establecerse en las cuentas de Business Manager secundarias existentes que se hayan creado para ese usuario. Realiza otra llamada POST para establecer el valor de primary_page de la cuenta de Business Manager secundaria existente:

curl \
  -F 'primary_page=<PAGE_ID>' \
  -F 'access_token=<USER_Personal_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<BM_ID>

Al crear otra cuenta de Business Manager secundaria:

Todas las cuentas de Business Manager secundarias existentes deben tener un valor de primary_page único.
El valor de shared_page_id debe establecerse en la nueva cuenta de Business Manager secundaria.
Si el valor de shared_page_id se usa para crear una nueva cuenta de Business Manager secundaria, no puede ser primary_page en ninguna de las cuentas de Business Manager secundarias existentes.

Configurar el método de pago

Para pagar los anuncios de la cuenta de Business Manager secundaria, tendrás que compartir tu línea de crédito con cada cuenta de Business Manager secundaria.

Paso 1. Abre una línea de crédito. Ponte en contacto con tu representante de Facebook y abre una LOC en esa cuenta de Business Manager si aún no existe. La línea de crédito aparecerá como método de pago en la cuenta de Business Manager principal.

Paso 2. Acepta las condiciones legales de la línea de crédito.

Abre Business Manager > Configuración de la empresa > Métodos de pago.
Haz clic en Configuración de crédito y, a continuación, en “Condiciones legales”. Acepta las condiciones legales.

Paso 3. Obtén el identificador de la línea de crédito y compártelo con la cuenta de Business Manager secundaria.

Ve a tu cuenta de Business Manager principal, accede a Configuración de la empresa > Métodos de pago y haz clic en el método de pago. Almacena el valor de PARENT_BM_Line_Of_Credit_ID de la URL. La URL tiene un aspecto similar al siguiente:
```
https://business.facebook.com/settings/payment-methods/<PARENT_BM_Line_Of_Credit_ID>?business_id=<BUSINESS_ID>
```

Usa este identificador de la línea de crédito de la cuenta de Business Manager principal en la llamada a la API siguiente para compartir el identificador de la línea de crédito de la cuenta de Business Manager principal con la secundaria. El parámetro amount es opcional.

curl \
  -F 'receiving_business_id=<CHILD_BUSINESS_MANAGER_ID>' \
  -F 'amount=<OPTIONAL_PARAMETER>' \  
  -F 'access_token=<Parent_BM_Admin_System_User_Access_Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<PARENT_BM_Line_Of_Credit_ID>/owning_credit_allocation_configs

Si no especificas ninguna cantidad, la línea de crédito se dividirá a partes iguales entre las cuentas de Business Manager secundarias.

Si solo especificas una cantidad, esa porción de la línea de crédito se asignará a la cuenta de Business Manager secundaria.

Obtener el identificador de usuario del sistema secundario

En la cuenta de Business Manager secundaria, usa esta llamada a la API para crear un usuario del sistema y obtener el identificador de acceso. Este identificador se usa en todas las llamadas posteriores a la cuenta de Business Manager secundaria para crear o administrar anuncios para este usuario.

curl \
  -F 'id=<CHILD_BUSINESS_MANAGER>' \
  -F 'app_id=<App_ID>' \
  -F 'scope=ads_management,business_management' \
  -F 'access_token=<Parent BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET>' \
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/access_token

Obtener el identificador de usuario del sistema

Cuando obtengas el identificador de acceso, puedes usarlo para encontrar el identificador de usuario específico de la aplicación. Es importante conservarlo para guardarlo más adelante.

curl -G \
  -d 'access_token=<Child BM System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BM_ID>/system_users

Obtener el identificador del origen de fondos (LOC)

Obtén el nuevo origen de fondos de la cuenta de Business Manager secundaria. Para este ejemplo, usa este origen de fondos posteriormente al crear una cuenta publicitaria.

curl -G \
  -d 'fields=id,max_balance' \
  -d 'access_token=<Child BM Admin System User Access Token>' \
  -d 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<CHILD_BUSINESS_MANAGER_ID>/extendedcredits

Pagos

Pago de línea de crédito

payment-methods/<CHILD_PAYMENT_METHOD_ID>?business_id=

Guarda el identificador de este método de pago para usarlo más adelante.

Crear una nueva cuenta publicitaria con el origen de fondos predeterminado

Usa el identificador del método de pago de la cuenta de Business Manager secundaria como parámetro funding_id.

El parámetro funding_id no se puede actualizar una vez creada la cuenta publicitaria.

curl \
  -F 'name=Advertisers Ad Account' \
  -F 'currency=USD' \
  -F 'timezone_id=1' \
  -F 'end_advertiser=<PAGE_ID>' \
  -F 'media_agency=NONE' \
  -F 'partner=NONE' \
  -F 'funding_id=<PAYMENT_METHOD_ID(from above)>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/CHILD_BM_ID/adaccount

Añadir el usuario del sistema como administrador a la nueva cuenta publicitaria

Añade el usuario del sistema como administrador a la nueva cuenta publicitaria en la cuenta de Business Manager secundaria:

curl \
  -F 'user=<SYSTEM_USER_ID(from above)>' \
  -F 'tasks=MANAGE,ADVERTISE,ANALYZE' \
  -F 'business=<CHILD_BM_ID>' \
  -F 'access_token=<Child BM Admin System User Access Token>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \   // Optional, depending on your app's security settings
  https://graph.facebook.com/<API_VERSION>/<act_ACCOUNT_ID>/assigned_users

¡Enhorabuena! Este es el último paso de la configuración de una cuenta de Business Manager secundaria para crear y administrar las campañas del cliente.

Buscar cuentas de Business Manager secundarias

Para buscar los identificadores de todas las cuentas de Business Manager secundarias, ejecuta el siguiente comando para filtrar por el identificador de usuario específico de la aplicación del cliente:

curl -i -X GET \
  -F 'access_token=<PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN>' \
  -F 'appsecret_proof=<APP_SECRET_PROOF>' \  // Optional, depending on your app's security settings
"https://graph.facebook.com/<API_VERSION>/<parent_bm_id>/owned_businesses?client_user_id=<Client’s app scoped user ID>

Busca el identificador de usuario específico de la aplicación con /me?fields=ids_for_apps (identificador de acceso del usuario del cliente).

Siguientes pasos

En los siguientes temas se tratan más funciones o acciones que puedes usar para mejorar tu experiencia con Business Manager.

Asimismo, consulta las guías de uso compartido de activos para obtener información sobre cómo acceder a los activos del cliente en las cuentas de Business Manager secundarias: