Configurar un nuevo administrador comercial secundario

La solución del administrador comercial de 2 niveles se diseñó originalmente para que cada token de acceso de usuario pudiera crear solo un administrador comercial secundario. Sin embargo, el usuario ahora puede crear múltiples administradores comerciales secundarios siempre y cuando se establezca una página principal en cada administrador comercial secundario.

Nota: En función de que appsecret_proof esté activado en la configuración de tu app, appsecret_proof podría ser necesario como parámetro en cada llamada que hagas. Consulta el documento Garantizar solicitudes de API Graph para saber cómo configurar esta opción y cómo generar appsecret_proof.

Empezar

Antes de empezar, recomendamos revisar estos requisitos y esta información:

Permisos de la aplicación

business_management
ads_management

Identificadores

PARENT_BM_ID: identificador del administrador comercial del socio que es el propietario de la app.
CHILD_BM_ID: identificador del administrador comercial que el administrador comercial principal crea para el cliente.

Tokens de acceso

USER_Personal_Access_Token: token de acceso de la persona que proporciona las credenciales para crear el administrador comercial secundario.
- Este token se genera mediante el inicio de sesión con Facebook.
- El socio debería solicitar alcance business_management global en las empresas y páginas del usuario en lugar del alcance detallado.
- Esta persona debería tener privilegios de administrador en la página que se comparte en el administrador comercial secundario.
- Si la página pertenece a otro administrador comercial, esta persona debería tener privilegios de administrador en el administrador comercial al cual pertenece la página.
- Este token se usa para autorizar la creación del administrador comercial secundario y para compartir la página en el administrador comercial secundario con fines publicitarios.
PARENT_BM_ADMIN_SYSTEM_USER_ACCESS_TOKEN: el token de acceso del usuario administrador del sistema en el administrador comercial principal.
- Este token se usa para crear y gestionar administradores comerciales secundarios.
CHILD_BM_SYSTEM_USER_ACCESS_TOKEN: el token de acceso del usuario administrador del sistema creado en el administrador comercial secundario.
- Este token se utiliza para crear y administrar campañas y otras actividades en el administrador comercial secundario.

Crear un administrador comercial secundario

Con el USER_Personal_Access_Token, crea un administrador comercial secundario.

Ejemplo: devuelve un identificador de administrador comercial secundario.

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 múltiples administradores comerciales secundarios por usuario

Si el usuario quiere crear múltiples administradores comerciales secundarios con las mismas credenciales de usuario, los administradores comerciales secundarios creados previamente para ese usuario deben tener la primary_page configurada. Haz otra llamada POST para configurar la primary_page del administrador comercial secundario ya 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 otro administrador comercial secundario:

Todos los administradores comerciales secundarios necesitan una primary_page única.
Se debe configurar shared_page_id en el nuevo administrador comercial secundario.
Si se usa shared_page_id para crear un nuevo administrador comercial secundario, no puede ser una primary_page en ninguno de los administradores comerciales secundarios actuales.

Configurar un método de pago

Para pagar los anuncios del administrador comercial secundario, deberás compartir tu línea de crédito con cada administrador comercial secundario.

Paso 1: abre una línea de crédito. Ponte en contacto con tu representante de Facebook y abre una línea de crédito (LOC) dentro de ese administrador comercial, si todavía no existe una. La LOC se mostrará como método de pago en el administrador comercial principal.

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

Abre Administrador comercial > Configuración del negocio > Métodos de pago.
Haz clic en Configuración de crédito y en Condiciones Legales. Acepta las condiciones legales.

Paso 3: consigue el identificador de la línea de crédito y compártelo con el administrador comercial secundario.

Dirígete a tu administrador comercial principal y accede a Configuración del negocio > Métodos de pago. Haz clic en el Método de pago. Almacena el 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>
```

Utiliza el identificador de línea de crédito del administrador comercial principal de la llamada a la API siguiente para compartir el identificador de línea de crédito del administrador comercial principal con el secundario. 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 una cantidad, tu línea de crédito se divide en partes iguales entre tus administradores comerciales secundarios.

Si especificas solo una cantidad, esa parte de tu línea de crédito se asigna al administrador comercial secundario.

Obtener el token de usuario del sistema secundario

En el administrador comercial secundario, usa esta llamada a la API para crear un usuario de sistema y obtener el token de acceso. Este token se utiliza para todas las llamadas posteriores al administrador comercial secundario, para crear o administrar anuncios de 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 ID del usuario del sistema

Una vez que obtengas el token de acceso, podrás usarlo para averiguar el identificador de usuario de la app. Es importante conservarlo para el almacenamiento posterior.

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 en el administrador comercial secundario. 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=

Almacena este identificador de método de pago para su uso posterior.

Crear una nueva cuenta publicitaria con el origen de fondos predeterminado

Usa el identificador de método de pago del administrador comercial secundario como parámetro funding_id.

funding_id no se puede actualizar después de que se haya creado 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

Agregar el usuario de sistema como administrador a la nueva cuenta publicitaria

Agrega el usuario de sistema como administrador a la nueva cuenta publicitaria en el administrador comercial secundario:

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

¡Felicitaciones! Este es el último paso en la configuración de un administrador comercial secundario para crear y administrar las campañas de tu cliente.

Encuentra administradores comerciales secundarios

Para encontrar todos los identificadores comerciales secundarios, ejecuta el siguiente comando a fin de filtrar por identificador de usuario específico de la app 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>

Encuentra el identificador de usuario específico de la app con /me?fields=ids_for_apps (token de acceso de usuario del cliente).

Próximos pasos

Los siguientes temas incluyen funciones o acciones adicionales que puedes usar para potenciar tu experiencia con los administradores comerciales.

Consulta también las guías de cómo compartir recursos para incorporar los recursos del cliente en administradores comerciales secundarios: