Rastrear la tienda

Puedes usar Web Bot Auth para autorizar de forma segura que tus propios rastreadores, scripts o herramientas accedan a la tienda online pública de Shopify. Web Bot Auth se basa en las firmas de mensajes HTTP, que se generan en el panel de control de Shopify. Debes incluir la firma en los encabezados HTTP de cada solicitud para que se pueda verificar que proviene de una fuente autorizada.

Puedes usar firmas con herramientas automatizadas propias o externas que accedan a la tienda online para realizar auditorías de accesibilidad y de SEO, pruebas automatizadas, análisis de datos y otros casos de uso similares. Los motores de búsqueda y los modelos de lenguaje de gran tamaño (LLM) pueden indexar la tienda sin necesidad de usar firmas.

Características de las firmas

Las firmas tienen las siguientes características:

  • Autenticación segura: puedes generar firmas criptográficamente seguras para los rastreadores.
  • Control de vencimiento: puedes configurar las firmas para que venzan después de un período específico. El período máximo es de 3 meses.
  • Gestión centralizada: puedes administrar y ver todas las firmas en un solo lugar.
  • Nombres personalizados: puedes asignarle un nombre personalizado a cada firma para identificarla.
  • Alcance del dominio: cada firma se usa para un dominio específico que debe estar conectado a la tienda de Shopify.

Consideraciones para crear firmas

Antes de crear y usar firmas, revisa las siguientes consideraciones:

  • El rastreo de la tienda con firmas tiene como único fin analizar tu tienda online. Las firmas no otorgan acceso a Shopify Checkout debido a las capas adicionales de seguridad del pago.
  • Usa nombres claros y descriptivos para las firmas.
  • Las firmas caducan automáticamente y no se pueden renovar. Cuando una firma caduque, crea una nueva y actualiza las herramientas.
  • Cada firma se usa para un solo dominio, por lo que debes especificar para cuál de los dominios conectados se usará la firma. Solo puedes seleccionar dominios que se hayan conectado a Shopify.

Crear una firma

Puedes crear y administrar firmas directamente en el panel de control de Shopify.

  1. Desde el panel de control de Shopify, ve a Tienda online > Preferencias.

  2. En la sección Acceso del rastreador, haz clic en Crear firma.

  3. En el campo Nombre, escribe un nombre descriptivo para la firma.

  4. En el campo Dominio, selecciona el dominio que quieres usar con esta firma.

  5. En la sección Válida durante, selecciona un plazo de validez para la firma.

  6. Haz clic en Crear.

  7. Opcional: Para copiar los valores de Signature-Input y Signature recién creados, haz clic en Copiar junto a cada valor.

Una vez que una firma vence, deja de ser válida. No puedes renovar una firma vencida, pero puedes crear una nueva.

Agregar una firma a las solicitudes

Puedes copiar las firmas y luego agregarlas a los encabezados HTTP de las solicitudes. Cada firma consta de 3 encabezados HTTP que debes incluir.

Nombres y valores de los encabezados HTTP requeridos para autenticar las solicitudes de los rastreadores con una firma
Nombre del encabezadoValor del encabezado
Signature-InputAgrega el valor de la entrada de la firma.
SignatureAgrega el valor de la firma.
Signature-AgentEl valor de Signature-Agent es una cadena que contiene un URI válido del agente. Usa el "https://shopify.com" (con comillas) para este valor.

Para obtener instrucciones sobre cómo agregar encabezados personalizados, consulta la siguiente documentación:

Ver firmas

En el panel de control de Shopify puedes ver la siguiente información sobre las firmas existentes:

  • Nombre de la firma
  • Dominio asociado
  • Los primeros caracteres de los valores de Signature-Input y Signature
  • Valor de Signature-Agent
  • Fecha de vencimiento y estado de la firma
  1. Desde el panel de control de Shopify, ve a Tienda online > Preferencias.

  2. En la sección Acceso del rastreador, revisa la información sobre las firmas.

Solucionar problemas de las firmas

Selecciona el problema de la firma y sigue los pasos de resolución.

Soluciona problemas de autenticación

Si el rastreador recibe errores por límite de solicitudes, la firma no es válida. Verifica lo siguiente:

  • Confirma que usas el formato de firma correcto en los encabezados HTTP.
  • Asegúrate de enviar los encabezados Signature-Input, Signature y Signature-Agent en cada solicitud.
  • Verifica que la firma no haya vencido. Revisa la fecha de vencimiento en el panel de control de Shopify.
  • Rastrea el dominio asociado a la firma.
Recuperar firmas perdidas

Si perdiste la firma, completa los siguientes pasos para recuperarla:

  1. Desde el panel de control de Shopify, ve a Tienda online > Preferencias.
  2. En la sección Acceso del rastreador, localiza la firma en la lista.
  3. Haz clic en Copiar para copiar los valores de Signature-Input, Signature y Signature-Agent en el portapapeles.
Cambiar la fecha de vencimiento de una firma

No puedes cambiar la fecha de vencimiento de la firma después de crearla. Para establecer una fecha de vencimiento distinta, crea una nueva firma con la fecha que prefieras y luego actualiza tus servicios para usarla.

La firma anterior sigue siendo válida y funciona hasta la fecha de vencimiento original.