Exporter vos données depuis Apple Search Ads

Hermoso se connecte à Apple Search Ads et expose le compte sous forme d’outils que votre agent peut appeler : Claude, ChatGPT, Cursor, Codex, Cline, la CLI ou du HTTP classique. apple_ads_report récupère les performances par campagne, groupe d’annonces, annonce, mot-clé et terme de recherche, et les lignes reviennent sous forme de données, pas sous forme de fichier CSV à télécharger puis à déplacer ailleurs.

Le connecteur Apple Search Ads

Apple ne publie aucun flux OAuth pour son API publicitaire. La connexion est donc un échange de clés et non un bouton : Hermoso génère la clé de signature, vous collez sa moitié publique dans Apple Ads, puis vous recollez trois identifiants. Le guide de configuration Apple Search Ads détaille chaque étape, y compris le champ Public Key que la plupart des gens ne trouvent pas. Une seule connexion sert ensuite l’application web, le serveur MCP, la CLI et l’API REST : le même export fonctionne donc depuis Claude, ChatGPT ou Cursor. Connecter Apple Search Ads à Claude ou à ChatGPT se fait une fois, après quoi vous posez vos questions.

Le reporting n’est qu’une partie du service. La même connexion crée et fait tourner le compte : campagnes, groupes d’annonces, mots-clés et négatifs, ordres de budget, ciblage, suggestions de mots-clés et historique des modifications. La page du canal Apple Ads liste tous les outils.

Ce que contient le rapport

Un seul appel, cinq niveaux. apple_ads_report fournit des données au niveau campagne, groupe d’annonces, annonce, mot-clé ou terme de recherche, et chaque ligne contient les indicateurs qu’affiche le propre tableau de bord d’Apple : impressions, taps, installations, dépenses, taux de tap, coût par tap et coût par acquisition. Vous pouvez demander des totaux, ou une série à une granularité horaire, quotidienne, hebdomadaire ou mensuelle. Les lignes sont triées par dépense, de la plus élevée à la plus basse, à raison de 5 000 par page au maximum, avec une ligne de totaux généraux sur demande. Les rapports App Store peuvent aussi inclure les éléments sans diffusion : un mot-clé en pause apparaît donc à zéro au lieu de disparaître.

Deux règles imposées par Apple, que l’outil explique au lieu d’échouer en silence : un rapport en dessous du niveau campagne exige un identifiant de campagne (seul un rapport au niveau campagne couvre tout le compte), et les rapports de termes de recherche tournent dans le fuseau horaire de votre organisation, jamais en UTC. Les annonces sur Apple Plans sont également couvertes : un rapport pour les campagnes de marques locales passe par le même outil, avec un seul paramètre modifié.

Connecter Apple Search Ads à Google Sheets

C’est la seule destination vers laquelle Hermoso écrit lui-même. Connectez Google Drive à côté d’Apple Ads (une seule autorisation Google couvre Drive, Sheets et Docs), puis demandez : « Donne-moi les performances Apple Search Ads par mot-clé des 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. La semaine suivante, la même demande avec « ajouter » ajoute des lignes avec append_to_sheet au lieu de tout recommencer.

Hermoso demande à Google le périmètre drive.file, qui n’atteint que les fichiers qu’il a créés et ceux que vous choisissez, jamais tout votre Drive. Le guide complet, y compris le remplacement d’un onglet sur place et sa mise en forme, se trouve sur Connecter Apple Search Ads à Google Sheets.

Exporter Apple Search Ads vers Looker Studio

Hermoso n’a pas de connecteur Looker Studio natif, et nous préférons le dire plutôt que de laisser croire le contraire. Ce n’est pas nécessaire : Looker Studio lit Google Sheets avec son propre connecteur intégré, la feuille est donc le pont.

1. Demandez à l’agent d’écrire le rapport dans un seul onglet. Granularité quotidienne, une ligne par mot-clé et par jour, une ligne d’en-têtes et une colonne de dates. Demandez que la colonne de dates soit au format date (format_sheet s’en charge) pour que Looker Studio la lise comme une date.
2. Ajoutez la feuille comme source de données. Dans Looker Studio, créez une source de données, choisissez Google Sheets, sélectionnez le tableur et cet onglet, et gardez activée l’option « Utiliser la première ligne comme en-têtes ».
3. Construisez le rapport une seule fois. Dépenses par jour, coût par acquisition par mot-clé, installations par campagne : tout ce que vous reconstruiriez autrement dans un tableur chaque lundi.
4. Continuez d’ajouter des lignes. Chaque semaine, l’agent ajoute les nouvelles lignes au même onglet, et le tableau de bord les récupère à sa prochaine actualisation. Gardez les mêmes noms de colonnes d’une exécution à l’autre, car Looker Studio associe les champs par en-tête.

La même feuille fonctionne pour Power BI et Tableau, qui disposent chacun de leurs propres connecteurs Google Sheets.

Exporter Apple Search Ads en JSON

Si vous voulez les lignes brutes plutôt qu’un tableur, il existe trois façons de les obtenir, toutes basées sur la même connexion.

L’API REST. Chaque outil Hermoso est appelable à l’adresse POST /v1/tools/{name} avec une clé API que vous créez dans l’application, sur l’onglet MCP & CLI. Le corps de la requête contient les arguments de l’outil, et le champ data de la réponse contient le résultat structuré, avec les lignes dans data.rows :

curl -sX POST https://app.hermoso.ai/v1/tools/apple_ads_report \
  -H "Authorization: Bearer hmk_..." -H 'content-type: application/json' \
  -d '{"level":"keyword","campaignId":"1234567890","startTime":"2026-09-01","endTime":"2026-09-07","granularity":"DAILY"}' \
  | jq '.data.rows' > apple-search-ads.json

La CLI. npx -y hermoso call apple_ads_report --json '{...}' --structured affiche le même résultat structuré en JSON, prêt à être redirigé vers un fichier ou transmis à un autre script.

Votre agent. Dans n’importe quelle conversation, demandez les lignes en JSON et vous les recevez dans la réponse, déjà mises en forme comme vous l’avez demandé.

Pour les longs rapports, limit accepte jusqu’à 5 000 lignes par page et offset passe à la page suivante ; le champ hasMore du résultat indique s’il existe une autre page. La lecture d’un rapport ne consomme pas de crédits. La référence complète de l’API est dans la documentation développeur.

Autres destinations

« Direct » signifie que Hermoso écrit lui-même. Pour tout le reste, c’est une étape que l’outil que vous utilisez déjà accomplit.

• Google Sheets, Google Docs, Google Drive, OneDrive : direct.
• Looker Studio, Power BI, Tableau : via la feuille, chacun avec son propre connecteur Google Sheets.
• BigQuery : via la feuille, ou via votre propre agent. BigQuery peut interroger une Google Sheet comme table externe. Si votre agent tourne quelque part avec un client BigQuery et vos identifiants de projet, il peut insérer directement dans une table les lignes renvoyées par Hermoso.
• Excel : via la feuille ou un fichier. Téléchargez la feuille au format .xlsx, ou demandez à l’agent de déposer un fichier dans Google Drive ou OneDrive.
• PostgreSQL, Redshift, Snowflake ou tout entrepôt de données : via votre propre agent ou l’API. Hermoso renvoie du JSON ; ce qui détient vos identifiants de base de données écrit les données. Hermoso ne détient pas d’identifiants d’entrepôt.

Automatiser l’export hebdomadaire

La consigne est l’automatisation. Une phrase comme « Chaque lundi, récupère les performances Apple Search Ads de la semaine passée par mot-clé pour chaque campagne, ajoute-les à la feuille Apple Ads, et dis-moi quels mots-clés ont le plus bougé sur le coût par acquisition » constitue une tâche complète. Lancez-la à intervalle régulier avec la planification que votre client possède déjà (tâches planifiées dans Claude ou ChatGPT, ou tâche cron appelant la CLI ou l’API Hermoso) et la feuille, ainsi que tous les tableaux de bord qui la lisent, reste à jour.

Comme la même connexion modifie aussi le compte, le rapport et la correction vivent au même endroit : l’agent qui repère qu’un mot-clé voit son coût par acquisition doubler peut le mettre en pause ou ajouter un négatif dans la même conversation.

Questions fréquentes

Comment exporter les données d’Apple Search Ads ?

Connectez Apple Ads à Hermoso une fois, puis demandez à votre agent le rapport voulu, par exemple les performances par mot-clé de la semaine passée. L’outil apple_ads_report le récupère depuis l’API de reporting d’Apple, et l’agent l’écrit dans une Google Sheet, vous le renvoie en JSON, ou les deux.

Puis-je connecter Apple Search Ads à Google Sheets ?

Oui. Connectez Apple Ads et Google Drive dans Hermoso, puis demandez à l’agent de placer le rapport dans une feuille. Il crée la feuille avec create_sheet, ou ajoute des lignes à une feuille existante avec append_to_sheet, et peut répéter l’opération chaque semaine.

Puis-je exporter Apple Search Ads vers Looker Studio ?

Oui, en passant par Google Sheets. Hermoso n’a pas de connecteur Looker Studio natif. L’agent écrit le rapport dans une feuille, vous ajoutez cette feuille comme source de données Google Sheets dans Looker Studio une seule fois, et chaque ajout apparaît à la prochaine actualisation du tableau de bord.

Comment exporter les données Apple Search Ads en JSON ?

Appelez POST /v1/tools/apple_ads_report sur l’API Hermoso avec une clé API et lisez data.rows dans la réponse, ou lancez hermoso call apple_ads_report --json '{...}' --structured depuis la CLI. Les deux méthodes renvoient les mêmes lignes en JSON.

Existe-t-il une API de reporting pour Apple Search Ads ?

Oui, et Hermoso repose dessus. apple_ads_report couvre les performances par campagne, groupe d’annonces, annonce, mot-clé et terme de recherche, et les autres outils Apple Ads créent et gèrent le compte.

Puis-je obtenir les rapports de termes de recherche d’Apple Search Ads ?

Oui. Demandez le niveau terme de recherche et nommez la campagne. Apple ne fournit les termes de recherche que par campagne, dans le fuseau horaire propre à l’organisation.

Combien de lignes un rapport peut-il contenir ?

Jusqu’à 5 000 par page, triées par dépense de la plus élevée à la plus basse, avec un indicateur qui dit à l’agent s’il existe d’autres pages. Un rapport hebdomadaire par mot-clé tient en une seule page pour la plupart des comptes.

Cela couvre-t-il les annonces sur Apple Plans ?

Oui. Les rapports des campagnes de marques locales passent par le même outil, avec le type d’objet promu réglé sur Apple Plans au lieu de l’App Store.

Ai-je besoin d’un développeur pour la configuration ?

Non. Connectez Apple Ads une fois dans l’application, puis demandez à votre agent en langage courant : donne-moi la semaine passée par mot-clé et place-la dans une feuille. L’API et la CLI sont là si vous voulez automatiser par script.