Marketing
Google Tag Manager en tu producto y en tus agentes de IA, con una API
El toolkit de Google Tag Manager cubre cuentas, contenedores, workspaces, etiquetas, activadores y versiones de contenedor. Tu cliente autoriza Google una vez con OAuth, y tu producto o agente de IA llama cada operación a través de Connect, que guarda y renueva las credenciales y registra cada ejecución.
15 días de prueba. Sin tarjeta de crédito.
POST https://connect.reportei.com/api/tools/google_tag_manager_create_tag/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"accountId": "<accountId>",
"containerId": "<containerId>",
"workspaceId": "<workspaceId>",
"name": "<name>",
"type": "<type>"
}
}Cómo funciona
Del cliente conectado a la primera llamada a Google Tag Manager.
- 1
Tu cliente conecta la cuenta
Tu sistema abre una sesión de Connect para el toolkit y tu cliente conecta su cuenta de Google Tag Manager. Recibes el id de la conexión.
- 2
Tu producto llama a la tool
Un POST a /api/tools/{tool}/execute con el id de la conexión y los argumentos. Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app.
- 3
Connect se encarga del resto
Guarda la credencial cifrada, renueva tokens en conexiones OAuth que admiten renovación y registra las ejecuciones en un historial de auditoría disponible por API.
Casos de uso
Qué hace tu producto con Google Tag Manager.
Instalar seguimiento en clientes nuevos
Una herramienta de agencia crea una etiqueta y un activador de pageview en el workspace del contenedor del cliente, y luego crea y publica una versión para ponerlo en producción.
Pausar una etiqueta con seguridad
Lee una etiqueta, pon paused en true y publica una versión nueva, para que un producto apague una etiqueta defectuosa sin eliminarla.
Auditorías de contenedores con un agente
Deja que un agente de IA liste contenedores, etiquetas, activadores y versiones de varias cuentas y señale etiquetas sin activador de disparo.
Tools
13 tools de Google Tag Manager
- Listar cuentasGETLista las cuentas de Tag Manager a las que puede acceder el usuario, con accountId y name. Envía nextPageToken como pageToken para leer la página siguiente.
- Listar contenedoresGETLista los contenedores de una cuenta, con containerId, name, publicId (el código GTM- instalado en el sitio) y usageContext, como web. Envía nextPageToken como pageToken para leer la página siguiente.
- Listar workspacesGETLista los workspaces de un contenedor, con workspaceId y name. Las etiquetas y los activadores se editan en un workspace, normalmente Default Workspace, y solo llegan al sitio mediante Create version y Publish version.
- Listar etiquetasGETLista las etiquetas de un workspace, con tagId, name, type, parameter, firingTriggerId y paused. Envía nextPageToken como pageToken para leer la página siguiente.
- Obtener etiquetaGETDevuelve una etiqueta con todos sus campos, incluido fingerprint. Update tag reemplaza la etiqueta completa, así que parte de esta respuesta.
- Crear etiquetaPOSTCrea una etiqueta en un workspace. Solo llega al sitio después de Create version y Publish version. Sin firingTriggerId la etiqueta nunca se dispara.
- Actualizar etiquetaPUTReemplaza una etiqueta completa: envía todos los campos que quieras conservar, tal como los devuelve Get tag, con los cambios, porque un campo omitido se borra. Pon paused en true para detener una etiqueta sin eliminarla. El cambio solo llega al sitio después de Create version y Publish version.
- Eliminar etiquetaDELETEElimina una etiqueta de un workspace. El sitio sigue disparándola hasta que se publique una versión sin ella.
- Listar activadoresGETLista los activadores de un workspace, con triggerId, name, type y conditions. Un triggerId va en firingTriggerId o blockingTriggerId de una etiqueta. Envía nextPageToken como pageToken para leer la página siguiente.
- Crear activadorPOSTCrea un activador en un workspace y devuelve su triggerId. Un activador de pageview sin filter se dispara en todas las páginas. Una condición compara una variable, como {{Page URL}}, con un valor; las variables integradas de clics y formularios, como {{Click ID}}, solo funcionan una vez activadas en el workspace, algo que este toolkit no hace.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/google_tag_manager, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
Preguntas sobre el toolkit de Google Tag Manager
¿Necesito implementar la API de Google Tag Manager?
No. Connect ya trae 13 tools de Google Tag Manager descritas y listas. Tu cliente conecta la cuenta y tu sistema llama a cada tool por el mismo endpoint, con el mismo formato de solicitud.
¿Cómo conecta mi cliente su cuenta de Google Tag Manager?
Con el modo que acepta el toolkit: OAuth con la app de tu producto. Connect guarda la credencial cifrada y nunca la devuelve a tu sistema.
¿Funciona con agentes de IA?
Sí. El input de cada tool está descrito en JSON Schema, que tu agente usa directamente como definición de tool. El agente elige la tool y los argumentos, y tu sistema hace la llamada a Connect.
¿Mi cliente necesita una cuenta en Reportei?
No. Tu cliente conecta la cuenta en una pantalla de Connect, o tu sistema envía la credencial por la API, y sigue usando solo tu producto.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
