Compartir el píxel de Meta entre empresas
Puede haber distintos casos de uso en los que las empresas deban acceder a un conjunto de datos del píxel de una empresa en otra empresa (normalmente una agencia), como para administrar anuncios, analizar el rendimiento o subir eventos.
A continuación se indican las integraciones de la API que se necesitan para establecer una relación entre el píxel y la empresa de la agencia. Si la empresa del destinatario (agencia) también administra anuncios para el cliente y tiene que usar ese píxel para las cuentas publicitarias, consulta el paso 3.
Requisitos previos: requisitos de las aplicaciones
Las aplicaciones deben tener la función Acceso estándar a la administración de anuncios (acceso avanzado). Las aplicaciones también deben tener los siguientes permisos:
business_managementads_managementoads_readymanage_pages
Paso 1: Iniciar el uso compartido del píxel con la empresa de la agencia
Para este paso, se necesita un identificador de acceso de usuario con los permisos de la aplicación anteriores de un administrador de la empresa propietario del píxel.
POST <ads_pixel>/agencies?business=<agency_business_id>&permitted_tasks=[<permitted_tasks_for_agency_business>]
Las opciones y los parámetros de esta solicitud son los siguientes:
| Nombre | Descripción |
|---|---|
Tipo: numérico | Obligatorio. Identificador de la empresa de la agencia que recibe acceso al píxel. |
Tipo: lista:cadena | Obligatorio. Ejemplo: ['ANALYZE', 'UPLOAD', 'ADVERTISE'] Tareas permitidas para la agencia en el píxel. Valores posibles: ANALYZE: ver, analizar y anunciar. UPLOAD: subir datos de conversiones en el sitio web a este conjunto de datos. ADVERTISE: conectar cuentas publicitarias a este conjunto de datos de Facebook. Usar este conjunto de datos con fines publicitarios. EDIT: administrar el conjunto de datos, editar la configuración, analizar y anunciar. (Actualmente, el acceso de tipo EDIT está restringido; contacta con tu representante de Meta para añadir la aplicación a la lista de permitidos). |
Gestionamos una solicitud en función del estado de la relación con la otra empresa:
- Empresas que tienen una relación aprobada existente. Compartimos el píxel directamente con ellas.
- Empresas que tienen una relación en curso existente. Añadimos el píxel a la solicitud para que, cuando la empresa destinataria apruebe esta solicitud, compartamos el píxel.
- Empresas sin ninguna relación. Creamos un acuerdo de uso compartido con el píxel adjunto para que, cuando la empresa destinataria apruebe esta solicitud, el píxel se comparta con la empresa.
Si el píxel se comparte correctamente con la empresa, se devuelve la siguiente respuesta:
{
success: true,
}
Si la aceptación del acuerdo de uso compartido de la solicitud está pendiente, la solicitud de la API devuelve la siguiente respuesta con pending_request_id. Cuando la empresa destinataria acepte la solicitud, el píxel se compartirá automáticamente con dicha empresa. Consulta el paso 2 para aceptar o rechazar la solicitud.
{
"success": true,
"pending_request_id": "{request_id}"
}
Ten en cuenta que hay un límite con respecto a la cantidad de empresas con las que se puede compartir un píxel.
Paso 2: Aceptar la solicitud pendiente (si es necesario)
Una vez iniciada la solicitud de uso compartido del píxel, la empresa de la agencia puede recibir una solicitud de acuerdo de uso compartido pendiente si la agencia todavía no tiene ninguna relación con la empresa propietaria del píxel. Los administradores de la empresa destinataria pueden ver y aceptar esta solicitud en sus cuentas de Business Manager.
Para aprobar o rechazar la solicitud de relación con la API, obtén el valor de request_id de la respuesta de error del paso 1.
La API necesita un identificador de acceso de usuario del administrador de la empresa destinataria con business_mangement o ads_management permission para la aplicación.
POST <request_id>?request_status="approve"
Si la operación se lleva a cabo correctamente, la API devuelve esta respuesta:
{
success: bool
}
Las opciones y los parámetros de esta solicitud son los siguientes:
| Nombre | Descripción |
|---|---|
Tipo: cadena | Obligatorio. Indica si la empresa que recibe una solicitud de uso compartido del píxel la aprueba o la rechaza. Valores posibles: |
Paso 3: Compartir el píxel con las cuentas publicitarias de la empresa de la agencia
Si una agencia administra anuncios para un cliente y tiene que permitir que las cuentas publicitarias dedicadas del cliente usen el conjunto de datos del píxel, se usa esta API.
Cuando el píxel se comparte con una empresa con permisos de publicidad y análisis, la empresa puede permitir a las cuentas publicitarias de la empresa usar el conjunto de datos del píxel con fines publicitarios.
La API necesita un identificador de acceso de usuario con los permisos business_management, ads_management o ads_read del administrador de la empresa.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
| Nombre | Descripción |
|---|---|
Tipo: numérico | Obligatorio. Empresa que administra anuncios y tiene acceso al píxel y las cuentas publicitarias. El usuario cuyo identificador de acceso se utilizó debe tener permisos de administrador en esta empresa. |
Tipo: numérico | Obligatorio. Cuenta publicitaria que se permitirá en el píxel. |
Paso 4: Eliminar la conexión de uso compartido del píxel
Si la conexión entre el píxel y la empresa de la agencia ya no es necesaria, usa la siguiente API para eliminar la conexión.
Delete <adspixel>/agencies?business=<agency_business_id>
La API necesita un identificador de acceso de usuario administrador de la empresa propietaria del píxel.
Si la operación se lleva a cabo correctamente, la API devuelve esta respuesta:
{
success: true
}