Connecter Apple Search Ads à Google Sheets

Connectez Apple Ads et Google Drive à Hermoso, et les deux deviennent appelables depuis le même agent. apple_ads_report récupère les lignes de performance ; create_sheet et append_to_sheet les placent dans un tableur qui vous appartient. Pas de fichier d’export, pas d’entrepôt de données, pas de troisième outil qui détient vos identifiants.

À quoi cela ressemble

« Récupère les dépenses Apple Search Ads de la semaine passée par mot-clé et ajoute-les à ma feuille Apple Ads. » L’agent appelle le rapport, met les lignes en forme et les ajoute. Redemandez lundi prochain et la feuille s’allonge d’une semaine.

Le périmètre Drive que demande Hermoso est drive.file, qui n’atteint que les fichiers créés par Hermoso ou ceux que vous avez choisis, pas l’ensemble de votre Drive.

Comment connecter Apple Search Ads à Google Sheets

1. Connectez les deux comptes. Dans l’application, ouvrez Connecteurs et connectez Apple Ads, puis Google Drive. Sheets et Docs passent par la même autorisation Google, donc il n’y a qu’un seul écran de consentement, pas trois. Apple Ads fonctionne par échange de clés et non par bouton ; le guide de configuration Apple Search Ads l’explique, y compris comment connecter Apple Search Ads à Claude ou à ChatGPT, là où vous taperez la demande.
2. Demandez le premier export. « Donne-moi les performances Apple Search Ads par campagne sur les 30 derniers jours et place-les dans une nouvelle feuille appelée Apple Ads. » L’agent appelle apple_ads_report, puis create_sheet, et vous renvoie le lien.
3. Rendez-le récurrent. La même phrase avec « ajouter » au lieu de « nouvelle feuille », lancée à intervalle régulier depuis le client que vous utilisez (une tâche planifiée dans Claude ou ChatGPT, ou une tâche cron qui appelle la CLI Hermoso), ajoute un bloc de lignes à chaque fois. Rien n’est écrasé sauf si vous le demandez.
4. Pointez votre tableau de bord vers la feuille. Looker Studio, Power BI et Tableau lisent tous Google Sheets avec leurs propres connecteurs.

À quoi ressemble la feuille

Une ligne par entité et par période. Les colonnes suivent le niveau demandé (campagne, groupe d’annonces, annonce, mot-clé ou terme de recherche) plus les indicateurs qu’Apple fournit : impressions, taps, installations, dépenses, taux de tap, coût par tap et coût par acquisition. Demandez une granularité quotidienne et chaque entité obtient une ligne par jour ; demandez des totaux et elle n’en obtient qu’une. L’agent peut ajouter une ligne de totaux généraux, et sur les rapports App Store il peut garder les entités sans diffusion, de sorte qu’un mot-clé en pause apparaît à zéro au lieu de disparaître.

Comme l’agent met les lignes en forme avant de les écrire, vous pouvez demander exactement la feuille voulue : seulement les mots-clés au-dessus d’un seuil de dépense, le nom de la campagne à côté de son identifiant, les variations semaine après semaine calculées avant l’écriture. C’est un travail qu’un export CSV vous laisse à faire.

Ajouter, remplacer ou mettre en forme

Les outils Sheets couvrent toute la modification : append_to_sheet ajoute des lignes, update_sheet écrit une plage sur place, clear_sheet_range vide une plage au préalable lorsque vous voulez un remplacement plutôt qu’un empilement, format_sheet gère les en-têtes, les largeurs et les formats de nombres, et manage_sheet_tabs donne à chaque campagne ou à chaque mois son propre onglet. Une demande du type « rafraîchis la feuille du tableau de bord » consiste à vider puis à écrire, dans l’onglet que vous nommez.

Exporter Apple Search Ads vers Looker Studio depuis la feuille

Hermoso n’a pas de connecteur Looker Studio natif ; la feuille fait office de pont. Dans Looker Studio, créez une source de données, choisissez Google Sheets, puis sélectionnez le tableur et l’onglet dans lequel l’agent ajoute les lignes. Construisez le rapport une fois et laissez-le tel quel. Chaque ajout apparaît à l’actualisation suivante des données du tableau de bord, tant que les en-têtes de colonnes restent identiques d’une exécution à l’autre. Le même principe fonctionne pour Power BI et Tableau.

Vous préférez du JSON à une feuille ?

Le même rapport est disponible en JSON brut depuis l’API Hermoso (POST /v1/tools/apple_ads_report) ou la CLI. Voir Exporter Apple Search Ads en JSON, et exporter les données d’Apple Search Ads pour toutes les autres destinations.

Questions fréquentes

Comment connecter Apple Search Ads à Google Sheets ?

Connectez Apple Ads et Google Drive dans Hermoso, puis demandez à votre agent de placer le rapport dans une feuille. Il récupère les lignes avec apple_ads_report, les écrit avec create_sheet ou append_to_sheet, et vous renvoie le lien.

Hermoso a-t-il besoin d’accéder à tout mon Google Drive ?

Non. Il demande drive.file, ce qui couvre les fichiers créés par Hermoso et les fichiers que vous sélectionnez explicitement.

Quels niveaux et quels indicateurs peuvent figurer dans la feuille ?

Niveau campagne, groupe d’annonces, annonce, mot-clé ou terme de recherche, avec les impressions, taps, installations, dépenses, taux de tap, coût par tap et coût par acquisition, en totaux ou en série horaire, quotidienne, hebdomadaire ou mensuelle.

Un rapport planifié écrasera-t-il ma feuille ?

Pas sauf si vous le demandez. Les ajouts ajoutent des lignes ; un remplacement consiste à vider puis à écrire dans l’onglet que vous nommez, et l’agent ne le fait que si la demande le précise.

Looker Studio ou Power BI peuvent-ils lire le résultat ?

Oui. Hermoso n’a de connecteur natif pour aucun des deux, mais les deux lisent Google Sheets avec leurs propres connecteurs. Un tableau de bord construit sur la feuille s’actualise donc à mesure que l’agent y ajoute des lignes.

Le rapport peut-il tourner selon un calendrier ?

Oui, depuis le client dans lequel votre agent fonctionne : une tâche planifiée dans Claude ou ChatGPT, ou une tâche cron qui appelle la CLI ou l’API Hermoso. Chaque exécution récupère la nouvelle période et l’ajoute.