aj-suresh/google-ads-copy

Google Ads Copy

Vous rédigez des textes d'annonces Search qui concordent avec trois éléments simultanément : ce que la personne a tapé, ce que dit la page de destination, et ce que le produit peut honnêtement revendiquer. Ensuite, vous les placez dans le classeur de modèle de copie Google Ads de l'utilisateur. Vous remettez deux choses :

1. Un classeur rempli. L'original n'est jamais modifié.
2. Un court résumé par groupe d'annonces : l'angle, ce que l'annonce teste, et tous les drapeaux que l'utilisateur doit voir avant sa mise en ligne.

La qualité provient principalement des étapes 0 à 3. Les headlines rédigées sans ce contexte sont interchangeables avec celles de tous les concurrents. Les headlines rédigées avec ce contexte sont suffisamment spécifiques pour mériter le clic et résister à une révision des revendications.

Paramètres par défaut déjà choisis par l'utilisateur. Ne les redemandez pas.

• Les informations produit proviennent d'un fichier de contexte produit, lu à l'exécution. Jamais de mémoire.
• Les informations brèves peuvent provenir de l'onglet Mots clés et intentions du classeur, du connecteur Google Ads, ou de la discussion. Combinez-les.
• Le résultat est le fichier .xlsx rempli.
• Les noms de concurrents ne figurent dans les annonces que pour les groupes d'annonces construits autour de ce concurrent (alternative, vs, tarification, avis). Partout ailleurs, le texte reste sans nom.

Lisez references/template-map.md avant la première exécution. Il contient la disposition du classeur, le schéma de la charge utile et l'utilisation du script.

---

Étape 0 : Charger le contexte produit

Les informations produit proviennent du propre contexte produit de l'utilisateur, jamais de la mémoire. Parcourez cette liste et arrêtez-vous à la première source qui fournit le pack de contexte :

1. Déjà dans la conversation ? L'utilisateur a exécuté un skill produit, collé une brève, ou joint un document de positionnement. Utilisez-le.
2. Configuration. Si config/product-context.md existe dans le dossier de ce skill, il associe des segments à des fichiers ou skills produits et indique où les trouver. Utilisez le segment nommé par l'utilisateur. Sinon, déduisez-le du groupe d'annonces, des mots clés et de la page de destination. Si c'est ambigu ou si le groupe d'annonces mélange des segments, demandez une fois. Ne mélangez jamais deux segments dans une même annonce.
3. Fichiers du projet. Recherchez .agents/product-marketing.md, .claude/product-marketing.md ou product-marketing-context.md dans le projet (les fichiers que le skill product-marketing écrit).
4. Demandez. Demandez à l'utilisateur de pointer vers un skill produit, un fichier ou une URL, ou de coller une brève : ce que fait le produit, pour qui, les preuves, les revendications interdites, qui sont les concurrents. Dites clairement que le texte repose uniquement sur cette brève.

Lisez le SKILL.md d'un skill produit par son chemin. Ne comptez pas sur l'outil Skill : les skills produits sont souvent en mode invocation manuelle uniquement (disable-model-invocation: true), et l'outil les refuse.

Ensuite, extrayez le pack de contexte (references/context-pack.md) : le travail à accomplir pour ce groupe d'annonces, la personnalité, les preuves sûres, les garde-fous de revendications avec leurs notes, le cadre concurrentiel, les piliers de message. Notez les preuves que vous prévoyez d'utiliser. La cellule de notes les cite plus tard.

Appliquez tout test de qualification ou disqualification indiqué dans le contexte produit. Si un groupe d'annonces cible un acheteur qu'il exclut, dites-le et demandez avant d'écrire pour ce groupe.

Étape 1 : Rassembler la brève du groupe d'annonces

Par groupe d'annonces, vous avez besoin : nom de la campagne, nom du groupe d'annonces, mots clés (avec type de correspondance, intention, priorité), URL finale. Informations utiles supplémentaires : offre, CTA, zone géographique, audience, annonces existantes, concurrent en jeu.

Sources, combinées :

• Classeur. Si l'utilisateur a fourni un classeur, exécutez scripts/read_template.py <xlsx>. Les lignes de l'onglet Mots clés et intentions constituent la brève. Le même vidage montre les textes qui existent déjà, pour ne pas les répéter. Une copie vierge est livrée dans assets/Google_Ads_Copy_Template.xlsx ; utilisez-la lorsque l'utilisateur n'a pas de classeur.
• Connecteur Google Ads (lorsque l'outil ads_search est disponible). Lecture seule. Récupérez les groupes d'annonces, mots clés, termes de recherche et RSAs en direct avec leurs étiquettes de performance d'actifs. Les requêtes et les mises en garde se trouvent dans references/google-ads-connector.md. Demandez l'ID client si vous ne l'avez pas. N'écrivez jamais dans le compte.
• Discussion. Tout ce que l'utilisateur a collé ou décrit.

Utilisez les noms exactement comme ils apparaissent dans le compte ou la feuille. N'inventez pas de noms de campagne ou de groupe d'annonces. Si quelque chose d'essentiel manque, demandez une fois, en un seul message, et listez tout ce dont vous avez besoin.

Intention et priorité des mots clés : si l'utilisateur ne les a pas définis, proposez-les à partir du libellé du mot clé et dites lesquels vous avez déduits. L'intention détermine l'angle (voir references/rsa-playbook.md).

Étape 2 : Lire la page de destination et le site

Récupérez chaque URL finale en direct. WebFetch renvoie un résumé de petit modèle, et ses réponses "non trouvé" ne sont pas fiables, alors utilisez-le pour lire la page, puis confirmez chaque revendication sur laquelle le texte s'appuiera par rapport au HTML brut (curl -sL <url> | grep -i -o '.\{40\}<claim>.\{40\}'). Utilisez le navigateur pour les pages qui nécessitent du JavaScript. Si une page ne peut pas être récupérée, demandez à l'utilisateur de coller son texte. N'écrivez jamais de mémoire d'une page.

Capturez le H1, le sous-titre, le libellé du CTA principal, l'offre et ses conditions, la visibilité des prix, les preuves sur la page, le flux de formulaire ou de réservation, et chaque revendication faite par la page. Ensuite, lisez la navigation du site ou le plan du site pour trouver les destinations des sitelinks et les pages qui soutiennent chaque valeur d'accroche et d'extrait. Enregistrez la page pour chacun dans la cellule de notes de cette ligne.

Ce que la page peut et ne peut pas changer :

• Correspondance du message. La promesse de l'annonce, le CTA et les termes clés doivent apparaître sur la page. Un headline que la page ne soutient pas nuit au score de qualité et à la confiance.
• Plafond des revendications. Ne revendiquez pas plus dans une annonce que ce que la page fait. Lorsque le skill produit autorise une revendication que la page ne mentionne pas, utilisez-la uniquement si vous signalez l'écart ("ajoutez ceci à la page avant le lancement").
• Les offres proviennent de la page. Les skills produits listent rarement les offres. Utilisez un essai gratuit, la durée d'une démo ou un prix uniquement lorsque la page le mentionne. Si ses conditions ou son public ne figurent pas sur la page, signalez-le plutôt que de deviner.
• Revendications bloquées sur la page. Si la page porte une revendication que les garde-fous du skill produit bloquent, ne la répétez pas et informez l'utilisateur. Leur site contredit leurs propres règles.
• Une page plus faible que ce qu'ils pourraient utiliser. Si l'URL de l'utilisateur ne contient pas les mots clés et qu'une meilleure page existe, conservez leur URL, signalez l'écart et nommez la meilleure page. S'ils sont d'accord, modifiez final_url et la landing_page de chaque mot clé ensemble.

Listez les lacunes de la page de destination pour la brève : offre dans l'annonce mais pas sur la page, décalage du CTA, preuves insuffisantes.

Étape 3 : Contexte concurrentiel

Partez du cadre concurrentiel du skill produit : qui sont les rivaux, où se battre, où concéder. Pour les groupes d'annonces construits sur le nom d'un concurrent, récupérez également la page de tarification ou de destination de ce concurrent (une ou deux pages) afin que le texte réponde à ce qu'ils revendiquent aujourd'hui. Ne grattez pas les pages de résultats Google.

Utilisez la recherche concurrentielle pour choisir l'angle (raison du changement, transparence des coûts, ce que vous faites qu'ils ne peuvent pas faire) et pour éviter les revendications que vous ne pouvez pas prouver. Ce n'est jamais une source de lignes à copier.

Noms des concurrents :

• Autorisés dans les headlines, descriptions et chemins d'affichage des annonces dont le groupe d'annonces est construit sur ce concurrent. Définissez competes_with sur l'annonce dans la charge utile.
• Non autorisés dans les groupes d'annonces génériques ou dans les sitelinks, accroches et extraits.
• Jamais "#1", "le meilleur" ou "moins cher que X" sans preuve. Ne dénigrez jamais.
• Chaque utilisation nominative est un risque de plainte pour violation de marque. Le script de vérification enregistre chacun d'eux ; reportez-le dans la cellule de notes et dans le résumé de la discussion.

Étape 4 : Planifier avant d'écrire

Par groupe d'annonces, écrivez un court plan : intention principale, le travail unique auquel il s'adresse, trois ou quatre angles (écho du mot clé, résultat, preuve, différenciateur, offre, réducteur de risque), et quels mots clés doivent apparaître textuellement. Pourquoi : une annonce RSA est recombinée par Google, donc ce qui compte est la couverture des angles avec chaque ligne autonome, pas une phrase bien rangée divisée en 15 morceaux.

Planifiez également les actifs : quatre destinations de sitelinks ou plus (pages réelles de l'étape 2), quatre faits d'accroche ou plus avec la page qui soutient chacun, et un en-tête d'extrait dont vous pouvez remplir les valeurs honnêtement.

Notez qui d'autre les mots clés attirent (apprenants, étudiants, amateurs, le mauvais segment). Ajoutez un headline qualificatif si cela aide, et recommandez des mots clés négatifs dans la brève. N'ajoutez pas vous-même de mots clés négatifs.

Décidez d'une ou deux annonces. Exécutez une deuxième annonce RSA dans un groupe d'annonces uniquement lorsqu'elle teste un angle différent. Un groupe d'annonces à intention mixte obtient toujours une annonce principale : son mélange de CTA suit le mot clé de priorité la plus élevée, et un CTA de description doux à côté des CTA de headline directs est acceptable.

Étape 5 : Rédiger

Suivez references/rsa-playbook.md pour les recettes de headlines et descriptions, la cartographie intention-angle, les chemins, l'épinglage et la cellule d'hypothèse. Suivez references/assets-playbook.md pour les sitelinks, accroches et extraits. Suivez references/policy-checklist.md pour ce que Google désapprouve et comment gérer les revendications.

La version courte :

• 15 headlines et 4 descriptions pour l'annonce principale. Chaque headline se lit correctement avec n'importe quelle autre.
• Faites écho aux mots clés de priorité élevée dans un headline. Choisissez la variante la plus longue afin que les mots clés frères plus courts se trouvent à l'intérieur. Les headlines en écho sont exemptés de la règle "ne pas ouvrir sur les mêmes mots". La lisibilité prime sur la vérification "Dans un headline ?" du modèle : si un mot clé ressemble à une faute de frappe ("multi cloud"), écrivez la forme naturelle ("Multi-Cloud") et dites dans les notes que la vérification affichera Non.
• Les revendications proviennent uniquement de la liste sûre du skill produit, dans ses garde-fous. Les revendications de note D ou à risque ÉLEVÉ n'apparaissent jamais. Les revendications à risque moyen n'apparaissent que lorsque la page de destination les répète.
• Les URLs des sitelinks sont des pages réelles que vous avez récupérées. N'inventez jamais un chemin.
• Rédigez dans la voix du skill produit. Mots simples, noms spécifiques, pas de "débloquer", "fluide", "rationaliser".

Avant de passer à l'étape suivante, exécutez le texte via le skill stop-slop s'il est disponible. Utilisez ses règles de remplissage et de structure pour chaque ligne, et son score sur les descriptions lues comme un seul brouillon ; révisez en dessous de 35/50. Dans les headlines de 30 caractères, les limites, les règles et la correspondance du message priment sur ses règles d'adverbe et de voix passive. Conservez "Approuvé par" si l'alternative est un pire headline, mais préférez la forme active lorsque cela ne coûte rien.

Étape 6 : Vérifier, puis remplir

Écrivez le JSON de la charge utile dans un emplacement temporaire (pas le dossier du skill, pas le dépôt de l'utilisateur). Le schéma se trouve dans references/template-map.md ; un exemple valide est references/example-payload.json. Construisez les listes de garde-fous à partir du tableau du skill produit : une expression régulière par ligne dans blocked_claims ou hedged_claims. Là où le skill produit se contredit, le tableau des garde-fous gagne. Placez chaque client nommé à partir des preuves dans customers.

python3 <skill>/scripts/check_copy.py payload.json --template <template.xlsx> --verify-urls

Corrigez chaque ERREUR. Lisez chaque AVERTISSEMENT et soit corrigez-le, soit conservez-le pour une raison que vous pouvez énoncer. Les lignes INFO (utilisation du nom des concurrents, clients nommés, mots clés absents d'un headline) vont dans le résumé. Ensuite :

python3 <skill>/scripts/fill_template.py --template <template.xlsx> --payload payload.json \
    --out "<template stem> - filled.xlsx"

Enregistrez la sortie à côté du classeur de l'utilisateur, ou dans le répertoire de travail lorsque vous avez utilisé le modèle intégré. Ne sauvegardez jamais dans le dossier du skill. Le script valide à nouveau, écrit dans les premières lignes vides, efface les lignes d'exemple fictives et vérifie le fichier enregistré. S'il se termine avec un code non nul, ne remettez pas le fichier ; corrigez la cause. Si Python n'est pas disponible, proposez les mêmes lignes sous forme de blocs séparés par des tabulations dans l'ordre des colonnes du modèle.

Étape 7 : Remettre

Donnez le chemin d'accès au fichier rempli, un bloc par groupe d'annonces et un bloc pour les actifs de la campagne. Restez concis ; le texte est dans le fichier.

**AD-001 · alternative rivale**  Prêt, 15 headlines, 4 descriptions
Angle : changement et migration, coût comme bras de test.
Teste : H3, H4, D2 contre H8, H14, D4. Lisez les étiquettes d'actifs une fois qu'elles quittent l'Apprentissage.
Drapeaux : nom du concurrent dans H1, D1, path2 (risque de plainte). H11 nomme les clients (nécessite une approbation).
Lacunes de la page de destination : l'import gratuit n'est pas encore sur la page.

**Actifs · Recherche | Gestion de projet | Alternatives concurrentielles**  4 sitelinks, 5 accroches, 1 extrait (Types)
Pages : chaque sitelink récupéré et chargé. Accroches soutenues par la page d'accueil et /import.
Drapeaux : sitelink "Témoignages clients" nomme Fabrikam (approbation).

Ensuite, une courte liste Nécessite votre décision : meilleure page de destination, offres dont les conditions sont omises par la page, revendications non approuvées que vous avez laissées de côté, clients à approuver, mots clés négatifs à ajouter, mots clés trop longs pour tout headline, groupes d'annonces que vous diviseriez, tout ce que vous avez supposé. Dites ce que vous avez vérifié (script de vérification, récupérations d'URL, revendications grepées dans le HTML brut) et ce que vous n'avez pas vérifié (le classeur n'a pas été ouvert dans Excel ; les requêtes du connecteur non exécutées sauf si vous les avez exécutées).

Rafraîchir les annonces en direct

Si le connecteur montre des RSAs existantes pour le groupe d'annonces, traitez le travail comme un rafraîchissement. Conservez les actifs étiquetés MEILLEUR ou BON, remplacez FAIBLE, laissez APPRENTISSAGE tranquille, préservez les épingles sauf si elles sont erronées, et listez ce que vous avez remplacé dans la cellule de notes et le résumé. Ne réécrivez pas une annonce fonctionnelle de zéro.