La vida cotidiana en OnPage SEO implica muchas herramientas, por lo que en algún momento surge la necesidad de reunir todos los datos relevantes en una sola visión general, lo que se llama un tablero de mandos. Por el contrario, la fusión de datos no debería ser un acto laborioso y mensual, sino que idealmente debería ser automatizada.
En este artículo, se describe cómo puedes cargar datos de proyectos de Ryte a través de la API en una hoja de cálculo y en Data Studio para tus propios fines de supervisión y de elaboración de informes mediante Google Apps Script. Está dirigido a principiantes y usuarios avanzados que ya están familiarizados con algunos términos técnicos básicos. El código está disponible para su descarga gratuita, con un caso de uso para la orientación.
Para los usuarios de cuentas de negocios (y niveles superiores), Ryte ofrece acceso a los datos del proyecto a través de API REST. La Guía de integración de la API de Ryte describe los puntos más importantes del acceso programático.
Como se describe en la guía de integración, para cada visualización en el módulo Website Success hay una lista desplegable con la opción "Api-Call", cuyo código debe copiarse. Esta es la subsiguiente carga útil POST para la consulta respecto al punto final /zoom/, no directamente la llamada completa de la API.
Actualmente, las consultas de la API solo están disponibles para el módulo Website Success, por lo que este artículo solo cubrirá eso.
Figura 1: API Call en el menú desplegable
Figura 2: Vista más cercana de la llamada a la API para un objeto seleccionado
Ahora comienza la búsqueda de las vistas relevantes para tu propio proyecto. ¿Me interesan los errores de códigos de estado, los mapas de sitios, el multilingüismo o todo a la vez? Para cada cuadro y tabla del módulo Website Success, se puede copiar un bloque de código Api-Call, más precisamente una carga POST en formato JSON.
Después de recopilar varias vistas, es esencial poder procesar varias vistas y consultas simultáneamente. Una solución sencilla es la siguiente implementación a través de la secuencia de comandos de Google Apps y el código proporcionado.
RESERVA: Dependiendo del proyecto, las diferentes vistas son interesantes. Hemos reunido una selección aleatoria y la hemos empaquetado en un objeto de configuración, que puede ampliarse en el siguiente script según tus propios deseos.
Cada carga útil POST copiada debe procesarse con una herramienta de minimización JSON, como la de codebeautify.org, antes de pegarse en el script para mostrar el contenido en una línea y mantener el script claro.
A continuación, se utiliza para Javascript en combinación con el entorno de ejecución Google Apps Script. Apps Script es la forma más fácil de experimentar con las API como un comercializador en línea o SEO de afinador de Google sin tener que conocer o crear la base técnica desde cero.
El primer paso es crear un script en script.google.com. Aquí se inserta el código de abajo y se elimina el cuerpo de la función existente "function myFunction() {}". Si más tarde se controlan por tiempo varios scripts del mismo proyecto, deben tener nombres específicos. A continuación, encontrarás el código completo para copiar incluyendo la función "function onPageApiCall() {}".
Figura 3: Creación de un script en script.google.com
Aquí el código está listo para ser copiado.
Después de crear y guardar el script, se inicia la configuración. A continuación, se encuentra nuestra lista de consultas a la API de Website Success; esperamos que los nombres sean lo suficientemente significativos:
Figura 4: Lista de consultas a la API de Website Success
Para la implementación del ejemplo, hemos combinado cargas útiles JSON de los gráficos de resumen de Ryte, llamado "action" en el lenguaje API: "aggregate" y vistas de lista, llamado "action": "list". El resultado son dos bloques de código:
1. las cargas útiles individuales minimizadas por solicitud;
2. un conjunto consolidado de objetos ONPAGE_CALLS por área.
Por lo tanto, una extensión de las cargas útiles en 1. debe ir acompañada de una extensión del conjunto en 2.
Todas las cargas útiles están provistas de estas tres constantes, por lo que, al copiar un script, estos valores solo necesitan cambiarse en un lugar:
La ventaja de las constantes en Javascript es que pueden utilizarse con un alcance global en cualquier punto del código, sin integración específica, como parámetros de funciones o métodos.
Por último, está la hoja de cálculo del documento de Google en la que se escribe. Para configurar la hoja, solo es necesario:
Figura 5: URL de las hojas de cálculo de Google
Aquí puedes ver un archivo de ejemplo con datos de demostración.
El código está disponible en esta lista pública de Github.
Dado que en la configuración actual se ejecutan 26 solicitudes de API, una primera ejecución puede tardar hasta 5 minutos. En la opción de menú Vista > Registro de ejecución se pueden seguir los pasos exactos.La ejecución comienza de la siguiente manera:
Figura 6: Protocolo de ejecución ("Ausführungsprotokoll")
Si todo funciona correctamente, la siguiente tabla debería ser visible en la pestaña "Ryte":
Figura 7: Tabla en la hoja de cálculo de Google
Cada bloque de contenido es un objeto o tabla independiente. En la presentación actual, todavía no los hemos convertido en una sola tabla. Sin embargo, con un formato condicional, ya tienen un sólido valor informativo con una fácil comparabilidad con otros proyectos: las vistas de lista
Figura 8: Formato condicional en el documento de la hoja de cálculo de Google
De manera similar a los puntos grises 1-3 de prioridad en Website Success, las cantidades pueden utilizarse para visualizar el grado de los campos problemáticos de Ryte, lo que permite establecer rápidamente las prioridades del proyecto para el próximo periodo.
El último paso para la automatización es un disparador de script periódico que puede configurarse usando el icono del reloj de la esquina superior izquierda del menú. Asegura la ejecución automatizada en un momento recurrente. Aquí, puedes elegir entre los intervalos "cada hora", "diario" y "semanal".
Figura 9: Ajuste del disparador del script
Para aquellos que aún no se han enterado: Google Data Studio es una poderosa herramienta para conectar diferentes fuentes de datos y visualizarlos en un tablero basado en la web con selector de periodo de tiempo, filtro y otras funciones. Quedan pocos deseos abiertos.
Basándonos en las actuales (y legítimas) hipótesis de Data Studio, aprovechamos la oportunidad para diseñar un ejemplo de integración ejemplar de Ryte a través de las hojas de Google.
Figura 10: Ejemplo de integración de Ryte
En el ejemplo del tablero, los valores de la lista de 13 categorías de Website Success se dan hasta un valor máximo de 200, aunque, por supuesto, pueden establecerse aún más altos en el script. Los valores pueden dar una rápida orientación sobre el estado del sitio y los potenciales importantes. En el caso del ejemplo, se pueden definir las siguientes áreas problemáticas:
Aquí el tablero está listo para ser copiado.
Después de copiarla, la hoja de cálculo de la demostración también puede clonarse y enlazarse al script.
Los datos generados también pueden combinarse fácilmente con otras plantillas, como el panel de control de la consola de búsqueda, para mostrar informes SEO completos en Data Studio.
La gestión de calidad de los sitios web comienza con la optimización de las páginas y el rastreo. Mediante la secuencia de comandos de Google Apps, los resultados del rastreo de Website Success pueden integrarse fácilmente en sus propias estructuras de informe. La solución mostrada está fuertemente entrelazada con la configuración, seguramente hay una implementación más elegante y también genérica. ¡Agradecemos las ideas y sugerencias en los comentarios!
¡Revisa el SEO de tu sitio web gratis!
Escrito el 10.12.2020 por Charlène Groß.
Charlène es parte del equipo de marketing y apoya la estrategia de marketing de contenido en Ryte. Ella tiene una gran trayectoria en SEO y creación de contenido, la cual ha acumulado durante sus cinco años en una agencia en Augsburgo. También es una apasionada en pastelería y le encanta actividades en el tiempo libre.