Compartir el píxel de Meta entre empresas
Es probable que existan varios casos de uso en los que las empresas acceden al conjunto de datos del píxel de una empresa en otra empresa (por lo general, una agencia); por ejemplo, para administrar anuncios, analizar el rendimiento o subir eventos.
A continuación, se muestran las integraciones de API necesarias para establecer una relación entre el píxel y la empresa de la agencia. Si el destinatario (la agencia) también administra anuncios del cliente y necesita usar ese píxel para cuentas publicitarias, consulta el paso 3.
Requisitos previos: requisitos de la app
Las apps deben tener la función Acceso estándar a la administración de anuncios (acceso avanzado). Las apps también deberían tener los siguientes permisos:
business_managementads_managementoads_readymanage_pages
Paso 1: Inicia el uso compartido del píxel con la agencia
En este paso, se requiere un token de acceso de usuario con los permisos de la app desde un administrador comercial al que pertenezca el 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 incluyen lo siguiente:
| Nombre | Descripción |
|---|---|
Tipo: numérico | Obligatorio. El identificador 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 publicitar. UPLOAD: subir datos de conversión del sitio web a este conjunto de datos. ADVERTISE: conectar cuentas publicitarias a este conjunto de datos de Facebook. Usar este conjunto de datos para publicidad. EDIT: administrar conjuntos de datos, editar configuraciones, analizar y publicitar. (Por el momento, el acceso de EDIT está restringido; ponte en contacto con tu representante de Meta para incluir tu app en la lista de permitidas). |
Gestionamos una solicitud en función del estado de la relación con el otro negocio:
- Empresas que tienen una relación preexistente aprobada. Compartimos el píxel directamente con ellas.
- Empresas que tienen una relación en curso. Agregamos el píxel a la solicitud para que, cuando el destinatario apruebe esta solicitud, compartamos el píxel.
- Empresas que no tienen 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 ella.
Si el píxel se comparte correctamente con la empresa, se devuelve la siguiente respuesta:
{
success: true,
}
Si la solicitud está pendiente a espera de la aceptación del acuerdo de uso compartido, la solicitud a la API devuelve la siguiente respuesta con pending_request_id. Cuando la empresa destinataria acepta la solicitud, el píxel se comparte automáticamente con la empresa destinataria. 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 en relación con la cantidad de empresas con las que se puede compartir un píxel.
Paso 2: Acepta la solicitud pendiente (si es necesario)
Después de iniciar la solicitud para compartir el píxel, la agencia podría recibir una solicitud de acuerdo de uso compartido pendiente, si la agencia todavía no tiene una relación con la empresa a la que pertenece el píxel. La empresa destinataria puede ver y aceptar esta solicitud en el administrador comercial.
Para aprobar o rechazar la solicitud de relación con la API, obtén el request_id de la respuesta de error del paso 1.
La API requiere un token de acceso de usuario del administrador de la empresa destinataria con business_mangement o ads_management permission para la app.
POST <request_id>?request_status="approve"
Si se procesa correctamente, la API devuelve esta respuesta:
{
success: bool
}
Las opciones y los parámetros de esta solicitud incluyen lo siguiente:
| Nombre | Descripción |
|---|---|
Tipo: cadena | Obligatorio. Establece si la empresa que recibe la solicitud de uso compartido aprueba o rechaza la solicitud. Valores posibles: |
Paso 3: Comparte el píxel con las cuentas publicitarias de la agencia
Si una agencia administra anuncios por un cliente y necesita permitir que las cuentas publicitarias exclusivas de ese cliente usen el conjunto de datos del píxel, usa esta API.
Una vez compartido el píxel con una empresa que tiene permisos para publicar anuncios o realizar análisis, la empresa puede permitir que las cuentas publicitarias dentro de ella usen el conjunto de datos del píxel para hacer publicidad.
La API requiere un token de acceso de usuario con los permisos business_management, ads_management o ads_read del administrador de anuncios.
Post <ads_pixel>/shared_accounts?business=<business_id>&ad_account=<ad_account_id>
| Nombre | Descripción |
|---|---|
Tipo: numérico | Obligatorio. La empresa que administra anuncios y tiene acceso al píxel y cuentas publicitarias. El usuario cuyo token de acceso se usó debería tener permisos de administrador en esta empresa. |
Tipo: numérico | Obligatorio. Cuenta publicitaria que se permitirá en el píxel. |
Paso 4: Elimina la conexión para compartir el píxel
Si la conexión ente el píxel y la agencia ya no es necesaria, usa la siguiente API para eliminar esa conexión.
Delete <adspixel>/agencies?business=<agency_business_id>
La API requiere un token de acceso de usuario administrador de la empresa a la que pertenece el píxel.
Si se procesa correctamente, la API devuelve esta respuesta:
{
success: true
}