Conectar Apple Search Ads a Google Sheets

Conecta Apple Ads y Google Drive a Hermoso y ambos quedan disponibles desde el mismo agente. apple_ads_report saca las filas de rendimiento; create_sheet y append_to_sheet las ponen en una hoja de cálculo que es tuya. Sin archivo de exportación, sin almacén de datos y sin una tercera herramienta que guarde tus credenciales.

Cómo se ve

"Saca el gasto de Apple Search Ads de la semana pasada por palabra clave y añádelo a mi hoja de Apple Ads." El agente llama al informe, da forma a las filas y las añade. Pregunta de nuevo el lunes siguiente y la hoja crece una semana más.

El ámbito de Drive que pide Hermoso es drive.file, que alcanza los archivos que creó o que tú elegiste, no todo tu Drive.

Cómo conectar Apple Search Ads a Google Sheets

1. Conecta las dos cuentas. En la app, abre Conectores, conecta Apple Ads y luego Google Drive. Sheets y Docs usan la misma autorización de Google, así que es una sola pantalla de consentimiento, no tres. Apple Ads es un intercambio de claves y no un botón; la guía de configuración de Apple Search Ads lo cubre, incluido cómo conectar Apple Search Ads a Claude o a ChatGPT, donde escribirás la petición.
2. Pide la primera extracción. "Saca el rendimiento de Apple Search Ads por campaña de los últimos 30 días y ponlo en una hoja nueva llamada Apple Ads." El agente llama a apple_ads_report, luego a create_sheet, y te devuelve el enlace.
3. Hazlo recurrente. La misma frase con "añadir" en lugar de "hoja nueva", ejecutada con una programación desde el cliente que uses (una tarea programada en Claude o ChatGPT, o un cron que llame a la CLI de Hermoso), añade un bloque de filas cada vez. Nada se sobrescribe a menos que lo pidas.
4. Apunta tu panel a la hoja. Looker Studio, Power BI y Tableau leen Google Sheets con sus propios conectores.

Cómo es la hoja

Una fila por entidad y por periodo. Las columnas siguen el nivel que pediste (campaña, grupo de anuncios, anuncio, palabra clave o término de búsqueda) más las métricas que informa Apple: impresiones, toques, instalaciones, gasto, tasa de toques, coste por toque y coste por adquisición. Si pides granularidad diaria, cada entidad tiene una fila al día; si pides totales, tiene una. El agente puede añadir una fila de totales generales, y en los informes de la App Store puede conservar las entidades sin entrega para que una palabra clave pausada aparezca como cero en lugar de desaparecer.

Como el agente da forma a las filas antes de escribirlas, puedes pedir exactamente la hoja que quieres: solo las palabras clave por encima de un umbral de gasto, el nombre de la campaña junto a su id, los cambios semana a semana calculados antes de escribir. Es un trabajo que una exportación CSV te deja a ti.

Añadir, reemplazar o dar formato

Las herramientas de Sheets cubren toda la edición: append_to_sheet añade filas, update_sheet escribe un rango en su sitio, clear_sheet_range vacía uno antes cuando quieres reemplazar en lugar de acumular, format_sheet se encarga de encabezados, anchos y formatos numéricos, y manage_sheet_tabs da a cada campaña o a cada mes su propia pestaña. Una petición de "actualiza la hoja del panel" es un borrado seguido de una escritura, en la pestaña que nombres.

Exportar Apple Search Ads a Looker Studio desde la hoja

Hermoso no tiene un conector nativo de Looker Studio; la hoja es el puente. En Looker Studio, crea una fuente de datos, elige Google Sheets, y selecciona la hoja de cálculo y la pestaña a la que añade el agente. Crea el informe una vez y déjalo. Cada añadido aparece en la siguiente actualización de datos del panel, siempre que los encabezados de columna sigan iguales entre ejecuciones. El mismo patrón sirve para Power BI y Tableau.

¿Prefieres JSON en lugar de una hoja?

El mismo informe está disponible como JSON en bruto desde la API de Hermoso (POST /v1/tools/apple_ads_report) o desde la CLI. Consulta Exportar Apple Search Ads a JSON, y exportar datos de Apple Search Ads para todos los demás destinos.

Preguntas frecuentes

¿Cómo conecto Apple Search Ads a Google Sheets?

Conecta Apple Ads y Google Drive en Hermoso, luego pide a tu agente que ponga el informe en una hoja. Saca las filas con apple_ads_report y las escribe con create_sheet o append_to_sheet, y te devuelve el enlace.

¿Hermoso necesita acceso a todo mi Google Drive?

No. Pide drive.file, que cubre los archivos que creó Hermoso y los que tú eliges explícitamente.

¿Qué niveles y métricas pueden entrar en la hoja?

Nivel de campaña, grupo de anuncios, anuncio, palabra clave o término de búsqueda, con impresiones, toques, instalaciones, gasto, tasa de toques, coste por toque y coste por adquisición, en totales o en una serie por hora, día, semana o mes.

¿Un informe programado sobrescribirá mi hoja?

No, a menos que lo pidas. Los añadidos agregan filas; un reemplazo es un borrado seguido de una escritura en la pestaña que nombres, y el agente solo lo hace cuando la petición lo dice.

¿Pueden Looker Studio o Power BI leer el resultado?

Sí. Hermoso no tiene un conector nativo para ninguno de los dos, pero ambos leen Google Sheets con sus propios conectores, así que un panel construido sobre la hoja se actualiza a medida que el agente la va completando.

¿Puede el informe ejecutarse de forma programada?

Sí, desde el cliente en el que se ejecuta tu agente: una tarea programada en Claude o ChatGPT, o un cron que llame a la CLI o a la API de Hermoso. Cada ejecución saca el periodo nuevo y lo añade.