Puerta de enlace de la API de conversiones para varias cuentas

La puerta de enlace de la API de conversiones para varias cuentas es un modo de la puerta de enlace de la API de conversiones que permite conectar orígenes de datos administrados por diferentes cuentas empresariales de Meta a la misma instancia de la puerta de enlace. La solución requiere que se implemente la plataforma de computación en la nube de Amazon Web Services (AWS) o Google Cloud Platform (GCP) y cuenta con una arquitectura que proporciona alta disponibilidad y escalabilidad. Los datos de cada cuenta empresarial están lógicamente aislados y separados y las otras cuentas empresariales conectadas a la instancia ni la entidad propietaria de la instancia pueden acceder a ellos a menos que se conceda acceso; de esta forma, se permite un uso seguro y eficiente de los recursos de la plataforma en la nube.

La puerta de enlace de la API de conversiones para varias cuentas permite a las agencias, socios, revendedores o anunciantes descentralizados globales crear una instancia de la puerta de enlace y conectar los orígenes de datos con los que trabajan a la API de conversiones y administrarlos.

La puerta de enlace de la API de conversiones es un método de implementación de autoservicio de la API de conversiones. Permite a las empresas reflejar sus datos de marketing del píxel de Meta a la API de conversiones que, en una configuración redundante con el píxel de Meta, ayuda al sistema de entrega a reducir el coste por acción.

La versión actual de la puerta de enlace de la API de conversiones para varias cuentas funciona con Amazon Web Services (AWS) y Google Cloud Platform (GCP).

Incorporación

Si tienes todo listo para comenzar la implementación, haz clic en el botón para consultar una guía de la incorporación de hosts.

Arquitectura general

En el siguiente diagrama se muestra el contexto de varias cuentas en el que una sola instancia de la puerta de enlace puede atender a más píxeles de Meta, administrados por diferentes cuentas empresariales y activados desde diferentes dominios.

En el siguiente diagrama se explica la conexión entre el píxel y la puerta de enlace, que es válida para cada una de las muchas conexiones de un contexto de puerta de enlace de la API de conversiones para varias cuentas.

• El píxel de Meta, que se activa en las páginas web del anunciante, permite a los anunciantes enviar acciones e información de los visitantes al extremo del píxel de Meta y la puerta de enlace de la API de conversiones.
• La puerta de enlace de la API de conversiones recibe las acciones y la información de los visitantes que se envían mediante el píxel de Meta, les aplica formato de acuerdo con las especificaciones de la API de conversiones y las envía al extremo de la API de conversiones.
• El parámetro de eliminación de duplicados (event_id) se genera automáticamente y se envía junto con los datos transferidos a los extremos del píxel de Meta y la API de conversiones.

Destinatarios

La puerta de enlace de la API de conversiones para varias cuentas puede ser la solución para:

• Agencias, socios y revendedores que quieren ofrecer un servicio para conectar los orígenes de datos de sus anunciantes a la puerta de enlace de la API de conversiones.
• Anunciantes con varios píxeles que se activan en diferentes dominios y se administran mediante diferentes cuentas empresariales, que quieren tener una solución centralizada basada en la puerta de enlace de la API de conversiones para conectar el tráfico del píxel a la API de conversiones de Meta.

Hosts y cuentas

Host: agencia, socio, revendedor o anunciante que crea y administra la instancia de la puerta de enlace. El host es el responsable de la configuración, la supervisión y la solución de problemas de la instancia, así como de la administración y la facturación de la cuenta de AWS o GCP. El host establece las condiciones del servicio ofrecido a las empresas que se conectan a la instancia.

Cuenta: empresa (anunciante) que conecta su píxel a la instancia de la puerta de enlace de un host. Te recomendamos que crees una cuenta si tienes uno o más píxeles que:

• Están administrados por el mismo grupo de personas (es decir, todos los usuarios de la cuenta tienen acceso al píxel mediante la cuenta empresarial).
• Se activan en el mismo dominio del anunciante.

Cuenta administrada: cuenta cuyas implementaciones del píxel de Meta y la API de conversiones (también) están administradas por una agencia, un socio o un revendedor (el host). En concreto, se delega en el host acceso de administrador a los píxeles de Meta específicos en la plataforma Administrador de eventos. En un proceso típico, el host creará la cuenta en la puerta de enlace y conectará los píxeles a la instancia de la puerta de enlace según las condiciones que haya establecido el host. Además, el host puede crear usuarios de la cuenta con permisos específicos para los empleados del anunciante que podrán administrar o, simplemente, ver la configuración de la cuenta. El host y el anunciante controlan la configuración específica del píxel y la conexión del píxel a la instancia de la puerta de enlace. La empresa puede cambiar a una cuenta no administrada en cualquier momento.

Cuenta no administrada: cuenta cuyas implementaciones del píxel de Meta y la API de conversionesno están administradas por una agencia, un socio o un revendedor. En un proceso típico, el host creará la cuenta e invitará a la empresa (un administrador de la cuenta) a incorporar la instancia y conectarse a ella según las condiciones que haya establecido el host. La empresa controla la configuración específica del píxel y la conexión del píxel a la instancia. La empresa puede cambiar a una cuenta administrada en cualquier momento.

Usuarios y permisos

Los hosts y las cuentas pueden crear usuarios con uno de los siguientes permisos:

Componentes técnicos

Amazon Web Services y Google Cloud Platform

La puerta de enlace de la API de conversiones para varias cuentas requiere que se implemente Amazon Web Services (AWS) o Google Cloud Platform (GCP), una plataforma de computación en la nube bajo demanda. La cuenta de AWS o GCP pertenece a la agencia, el socio, el revendedor o el anunciante que implementa la puerta de enlace de la API de conversiones para varias cuentas, es decir, el host, y no a Meta. Dicha agencia, socio, revendedor o anunciante también se encarga de su administración. El host puede implementar automáticamente la instancia sin necesidad de un desarrollador. La arquitectura de la puerta de enlace para varias cuentas se basa en AWS Elastic Kubernetes Service (EKS).

Componentes de software

Píxel de Meta

Biblioteca de JavaScript estándar de Meta cargada en las páginas web del anunciante que envía las acciones y la información de los clientes a Meta. En las Condiciones de las herramientas para empresas de Meta, se hace referencia a estos datos como “datos de las herramientas para empresas”. En el caso de los anunciantes que han integrado la puerta de enlace de la API de conversiones para varias cuentas, cuando se active, el píxel de Meta:

• Descargará y lanzará el código de cliente de WebSocket de la API de conversiones utilizado para comunicarse con la puerta de enlace de la API de conversiones para varias cuentas.
• Enviará los datos de eventos al extremo del píxel de Meta y a la puerta de enlace de la API de conversiones para varias cuentas mediante una conexión HTTP segura.

La puerta de enlace de la API de conversiones para varias cuentas

La agencia, el socio, el revendedor o el anunciante aloja la puerta de enlace de la API de conversiones para varias cuentas en su cuenta de Amazon Web Services (AWS) o Google Cloud Platform (GCP). Se aprovisiona en su cuenta de AWS o GCP. Se compone de lo siguiente:

• Un módulo que recibe eventos entrantes (acciones de los visitantes del sitio web) desde el píxel de Meta, les aplica formato de acuerdo con las especificaciones de la API de conversiones y los envía al extremo de la API de conversiones de Meta.
• Una interfaz de usuario en la que los hosts pueden administrar la instancia del host (usuarios, cuentas, actualizaciones, etc.).
• Una interfaz de usuario en la que las cuentas administran su cuenta (usuarios, orígenes de datos, enrutamiento de datos, etc.).

La extensión de Meta para empresas

La extensión de Meta para empresas (MBE) se utiliza en la puerta de enlace de la API de conversiones para varias cuentas a fin de facilitar la incorporación de hosts y cuentas y conectar de forma segura los orígenes de datos a la instancia.

Configuración de DNS

Los hosts necesitan configurar un registro CNAME en su proveedor de DNS para asociar un subdominio a la instancia de la puerta de enlace de la API de conversiones para varias cuentas (en concreto, al equilibrador de carga de la instancia) y hacerlo accesible desde la web.

Se recomienda que las cuentas configuren un registro CNAME en su proveedor de DNS mediante la asociación de un subdominio de su dominio al subdominio del host, de modo que se permita una conexión propia entre el píxel de Meta en su sitio web y la instancia de la puerta de enlace de la API de conversiones para varias cuentas.

Cloudflare como servicio de DNS integrado predeterminado

Un equilibrador de carga es un componente de la infraestructura de la puerta de enlace de la API de conversiones que ayuda a distribuir el tráfico de red entrante en varios servidores. Mediante un equilibrador de carga, podemos asegurarnos de que nuestra aplicación permanezca con alta disponibilidad y receptiva incluso durante periodos de tráfico elevado.

Además del equilibrio de carga, también usamos certificados SSL/TLS para cifrar los datos en tránsito entre los clientes y la puerta de enlace de la API de conversiones. Estos certificados se emiten cada vez que un anunciante configura un dominio propio. Un anunciante debe usar el dominio de la agencia de forma predeterminada si no ha configurado el dominio propio. La ventaja de configurar un dominio propio es que los eventos del píxel se dirigirán a este dominio que pertenece al anunciante, quien también se encarga de controlarlo; de lo contrario, los eventos del pixel circularán desde el anunciante a Meta, pero mediante el dominio de la agencia. Actualmente, la puerta de enlace de la API de conversiones admite la asociación de solo un certificado al balanceador de carga.

Con Cloudflare, podemos superar esta limitación. Uno de los beneficios clave del uso de Cloudflare es la capacidad de emitir hasta 5000 certificados SSL/TLS para dominios de anunciantes que apuntan al dominio de una agencia que Cloudflare administra o posee; es decir, permite a un máximo de 5000 anunciantes por instancia de la puerta de enlace de la API de conversiones utilizar un dominio propio. Si tienes una instancia de la puerta de enlace de la API de conversiones basada en AWS EKS, una ventaja más relacionada con el uso de Cloudflare es que también cuesta menos que usar el dominio de AWS CloudFront predeterminado y generado al azar que proporciona la puerta de enlace de la API de conversiones debido al coste más bajo de la terminación de SSL.

Uso compartido de datos

Mediante la puerta de enlace de la API de conversiones para varias cuentas, las empresas pueden compartir los mismos datos que se comparten al usar el píxel de Meta, con la excepción de la lista que se indica a continuación. Consulta la guía Soluciones empresariales de Meta para obtener más información.

Los siguientes datos no se admiten en la puerta de enlace de la API de conversiones:

• Las acciones de clientes configuradas con la herramienta de configuración de eventos
• Cookies de terceros de Meta

Inicio de la implementación

Si tienes todo listo para comenzar la implementación, haz clic en el botón para consultar una guía de la incorporación y administración de hosts.

Si tienes todo listo para comenzar la implementación, haz clic en el botón para consultar una guía de la incorporación de hosts.

Más información

• Puerta de enlace de la API de conversiones
• Preguntas frecuentes de las agencias que se incorporan a la puerta de enlace de la API de conversiones para varias cuentas
• Píxel de Meta
• Glosario
• Usar la API de conversiones
• Extensión de Meta para empresas (MBE)