Conecte o Apple Search Ads ao Google Sheets

Conecte o Apple Ads e o Google Drive à Hermoso e os dois ficam chamáveis pelo mesmo agente. apple_ads_report puxa as linhas de desempenho; create_sheet e append_to_sheet as colocam em uma planilha que é sua. Sem arquivo de exportação, sem data warehouse, sem uma terceira ferramenta guardando as suas credenciais.

Como fica na prática

"Puxe o gasto do Apple Search Ads da semana passada por palavra-chave e acrescente na minha planilha do Apple Ads." O agente chama o relatório, organiza as linhas e as acrescenta. Peça de novo na segunda-feira seguinte e a planilha cresce uma semana.

O escopo do Drive que a Hermoso pede é drive.file, que alcança os arquivos que ela criou ou que você escolheu, e não o seu Drive inteiro.

Como conectar o Apple Search Ads ao Google Sheets

1. Conecte as duas contas. No app, abra Conectores e conecte o Apple Ads e depois o Google Drive. Sheets e Docs usam a mesma autorização do Google, então é uma única tela de consentimento, e não três. O Apple Ads é uma troca de chaves, não um botão; o guia de configuração do Apple Search Ads explica, incluindo como conectar o Apple Search Ads ao Claude ou ao ChatGPT, onde você vai digitar o pedido.
2. Peça a primeira extração. "Puxe o desempenho do Apple Search Ads por campanha dos últimos 30 dias e coloque em uma planilha nova chamada Apple Ads." O agente chama apple_ads_report, depois create_sheet, e devolve o link.
3. Torne isso recorrente. A mesma frase com "acrescente" em vez de "planilha nova", rodada em um agendamento do cliente que você usa (uma tarefa agendada no Claude ou no ChatGPT, ou um cron chamando a CLI da Hermoso), adiciona um bloco de linhas a cada vez. Nada é sobrescrito, a menos que você peça.
4. Aponte o seu painel para a planilha. O Looker Studio, o Power BI e o Tableau leem o Google Sheets com os conectores próprios deles.

Como fica a planilha

Uma linha por entidade por período. As colunas seguem o nível que você pediu (campanha, grupo de anúncios, anúncio, palavra-chave ou termo de pesquisa) mais as métricas que a Apple informa: impressões, toques, instalações, gasto, taxa de toque, custo por toque e custo por aquisição. Se você pedir granularidade diária, cada entidade ganha uma linha por dia; se pedir totais, ganha uma só. O agente pode acrescentar uma linha de totais gerais e, nos relatórios da App Store, pode manter entidades sem entrega, para que uma palavra-chave pausada apareça como zero em vez de sumir.

Como o agente organiza as linhas antes de gravar, você pode pedir exatamente a planilha que quer: só palavras-chave acima de um limite de gasto, o nome da campanha ao lado do id, variações semana a semana já calculadas antes da gravação. É um trabalho que uma exportação em CSV deixa para você.

Acrescentar, substituir ou formatar

As ferramentas de Sheets cobrem toda a edição: append_to_sheet acrescenta linhas, update_sheet grava um intervalo no lugar, clear_sheet_range esvazia antes quando você quer substituir em vez de empilhar, format_sheet cuida de cabeçalhos, larguras e formatos numéricos, e manage_sheet_tabs dá a cada campanha ou a cada mês a sua própria aba. Um pedido de "atualize a planilha do painel" é uma limpeza seguida de uma gravação, na aba que você nomear.

Exporte o Apple Search Ads para o Looker Studio a partir da planilha

A Hermoso não tem conector nativo para o Looker Studio; a planilha é a ponte. No Looker Studio, crie uma fonte de dados, escolha Google Sheets e selecione a planilha e a aba para onde o agente acrescenta. Monte o relatório uma vez e deixe como está. Cada acréscimo aparece na próxima atualização de dados do painel, desde que os cabeçalhos das colunas permaneçam iguais entre as execuções. O mesmo padrão funciona para o Power BI e o Tableau.

Prefere JSON em vez de planilha?

O mesmo relatório está disponível como JSON bruto pela API da Hermoso (POST /v1/tools/apple_ads_report) ou pela CLI. Veja Exporte o Apple Search Ads para JSON, e exporte dados do Apple Search Ads para os demais destinos.

Perguntas frequentes

Como conecto o Apple Search Ads ao Google Sheets?

Conecte o Apple Ads e o Google Drive na Hermoso, depois peça ao seu agente que coloque o relatório em uma planilha. Ele puxa as linhas com apple_ads_report, grava com create_sheet ou append_to_sheet, e devolve o link.

A Hermoso precisa de acesso ao meu Google Drive inteiro?

Não. Ela pede drive.file, que cobre os arquivos que a Hermoso criou e os arquivos que você escolher explicitamente.

Quais níveis e métricas podem ir para a planilha?

Nível de campanha, grupo de anúncios, anúncio, palavra-chave ou termo de pesquisa, com impressões, toques, instalações, gasto, taxa de toque, custo por toque e custo por aquisição, em totais ou em série horária, diária, semanal ou mensal.

Um relatório agendado vai sobrescrever a minha planilha?

Não, a menos que você peça. Acréscimos adicionam linhas; uma substituição é uma limpeza seguida de uma gravação na aba que você nomear, e o agente só faz isso quando o pedido diz isso.

O Looker Studio ou o Power BI conseguem ler o resultado?

Sim. A Hermoso não tem conector nativo para nenhum dos dois, mas ambos leem o Google Sheets com os próprios conectores, então um painel construído sobre a planilha se atualiza conforme o agente acrescenta dados.

O relatório pode rodar em um agendamento?

Sim, a partir do cliente em que o seu agente roda: uma tarefa agendada no Claude ou no ChatGPT, ou um cron chamando a CLI ou a API da Hermoso. Cada execução puxa o novo período e o acrescenta.