# Comment exporter les créations publicitaires Google et conserver les preuves de leur source

Enregistrer des créations publicitaires Google publiques avec leurs enregistrements sources exige de conserver les identifiants d'annonceur, les identifiants de création, les pages sources, les pointeurs de média ou d'aperçu, les dates publiques et les heures de collecte. Une bibliothèque de liens enregistrée conserve les enregistrements de preuves et les pointeurs. Elle ne transforme pas les médias distants en fichiers permanents. Une création est un seul élément publicitaire public, et non une campagne. Une observation est un seul enregistrement daté d'une création au moment de la collecte. Un pointeur est un lien vers une ressource. Un manifeste est un fichier de paramètres de collecte et de synthèse.

Les recherches par domaine peuvent correspondre à plusieurs comptes d'annonceur différents. [Vérifiez l'identité de l'annonceur](/fr/articles/verifier-comptes-annonceurs-avant-rapport-publicites-concurrentes/) et conservez les valeurs inconnues. Un lien indisponible plus tard ne prouve pas que Google a supprimé l'annonce.

## Définitions

- Création : un seul élément publicitaire public. Ce n'est pas une campagne.
- Identifiant d'annonceur : l'identité de compte Google pour un annonceur.
- Identifiant de création : l'identité Google d'une création sous un annonceur.
- Observation : un enregistrement d'une création au moment de la collecte.
- Pointeur : un lien vers une ressource distante de média ou d'aperçu.
- Manifeste : un fichier de paramètres de collecte et de synthèse.
- Variation : un élément de média ou d'aperçu à l'intérieur d'un enregistrement de création. Ce n'est pas nécessairement un test publicitaire distinct.
- Aperçu : une ressource source utilisée pour afficher une création. Il peut exiger un rendu et n'est pas toujours un fichier téléchargeable.
- Actor : un programme hébergé de collecte de données.
- Tâche publiée : une configuration publique d'Actor enregistrée.
- **`null`** : aucune valeur utilisable n'est disponible. Ce n'est pas 0.

## Configuration et portée de la collecte

Pour collecter les données de créations, configurez un Actor tel que le [Google Ads Transparency Scraper](https://apify.com/chronometrica/google-ads-transparency-scraper) public. L'Actor accepte de 1 à 100 cibles, qui peuvent être des noms, des domaines, des identifiants, des URL d'annonceur ou des URL de création. Le paramètre `maxItems` va de 1 à 5000, avec une valeur par défaut de 10 partagée entre toutes les cibles.

La tâche publiée a pour valeurs par défaut `nike.com`, la région `ANYWHERE`, la plateforme `ALL`, le format d'annonce `ALL`, les détails de diffusion désactivés et un plafond de 20 éléments [Google Ads Creative Library Export | Ads Data](https://apify.com/chronometrica/google-ads-transparency-scraper/examples/google-ads-creative-library-export). Les recherches par domaine peuvent correspondre à plusieurs comptes d'annonceur. Vous devez donc utiliser un identifiant ou une URL d'annonceur exact et vérifié lorsque vous étudiez un compte précis. Utilisez une recherche par domaine seulement si vous prévoyez d'examiner et de séparer les comptes ensuite. Réduisez le plafond de collecte et laissez les détails de diffusion désactivés, sauf si votre recherche exige spécifiquement les métadonnées de diffusion. Les filtres de date facultatifs acceptent des dates réelles jusqu'à aujourd'hui. Rappelez-vous qu'un plafond de collecte est une limite, et non un historique publicitaire complet.

## Carte des champs et limites des données

Chaque ligne enregistrée met en correspondance des champs de données précis de la plateforme source. `advertiserId` et `creativeId` forment une paire unique d'identité de création. Vous ne devez jamais identifier un compte par le seul nom de marque. `creativeUrl` pointe vers la page publique de détail de la source. `mediaUrl` et `previewUrl` sont tous deux des pointeurs sources distants qui peuvent renvoyer `null`, et un aperçu peut être une ressource JavaScript plutôt qu'un fichier direct. La liste `variations` et `variationCount` enregistrent des ressources enfants imbriquées avec leurs URL et leurs dimensions, mais ces ressources enfants ne sont pas des variantes de campagne indépendantes.

Les champs `firstShownAt` et `lastShownAt` fournissent des dates publiques d'affichage lorsqu'elles sont disponibles, mais ils ne garantissent pas une diffusion continue ni le moment de la collecte. Le champ `approxDaysShown` est une valeur source approximative et ne doit pas être transformé en jours continus exacts, en dépenses publicitaires ou en succès de campagne. L'horodatage `observedAt` enregistre le moment où l'Actor a collecté l'enregistrement. Les champs demandés de région, de plateforme et de format fournissent un contexte de collecte plutôt qu'une liste complète des emplacements desservis. Les champs `status` et `statusReason` indiquent la qualité de la ligne, où `ok` signifie une collecte réussie et où `partial` peut signifier un format manquant. Les champs de payeur facultatifs peuvent être absents ou désactivés, et un payeur n'est pas nécessairement l'annonceur. De plus, le référentiel source de Google peut exposer des champs propres à un lieu que cet Actor ne renvoie pas [Aide sur la transparence Google Ads](https://support.google.com/adspolicy/answer/13733850?hl=en-CA).

## Clés d'observation et manifestes faits par le lecteur

Les identifiants d'annonceur et de création doivent être traités comme une paire, car le même identifiant de création sous deux annonceurs différents représente deux identités distinctes. L'Actor ne supprime les doublons de cette paire qu'à l'intérieur d'un seul run, alors que les runs ultérieurs conservent une nouvelle observation. Parce que la ligne de l'Actor ne fournit pas d'identifiant de run, vous devez créer des champs faits par le lecteur.

Créez un `collection_batch_id` fait par le lecteur pour le regroupement de votre lot. Conservez l'identifiant de run réel, la version de build, l'identité du jeu de données, les paramètres de collecte, les heures de collecte et le résumé du run dans un manifeste de collecte distinct fait par le lecteur. Votre clé d'observation suggérée combine l'identifiant de lot, l'identifiant d'annonceur et l'identifiant de création. Gardez vos reçus de run internes séparés de votre rapport final de preuves.

## Stockage des données JSON et variations

JSON est un format de données textuel qui conserve les hiérarchies structurées. Les fichiers JSON complets conservent les variations imbriquées, alors qu'un export CSV n'est qu'une vue facultative en tableau plat. Une ligne d'observation parente peut contenir des lignes de variation imbriquées, mais ces variations enfants ne sont pas des tests distincts de création ou de campagne. Conservez toujours les valeurs `null` au lieu de les remplacer par 0 ou par des données inventées. Une bibliothèque d'affichage est une vue dérivée. Vous devez donc toujours conserver les fichiers d'observation d'origine comme enregistrements sous-jacents de cette vue.

## Méthode complète de collecte et de conservation

1. Configurez la portée de vos cibles, la région, la fenêtre de dates publiques et le plafond d'éléments. Utilisez un identifiant ou une URL d'annonceur exact et vérifié lorsque vous étudiez un compte précis, et n'utilisez les recherches par domaine qu'avec un examen après la collecte. Laissez les détails de diffusion désactivés, sauf s'ils sont requis.
2. Exécutez le run de l'Actor [Google Ads Transparency Scraper](https://apify.com/chronometrica/google-ads-transparency-scraper) avec les paramètres de la tâche publiée [Google Ads Creative Library Export | Ads Data](https://apify.com/chronometrica/google-ads-transparency-scraper/examples/google-ads-creative-library-export).
3. Enregistrez votre configuration de collecte dans un manifeste fait par le lecteur. Stockez l'identifiant de run, la version de build, l'identité du jeu de données, les paramètres de collecte, les heures de collecte et le résumé du run séparément de votre rapport public de preuves.
4. Inspectez les champs du résumé OUTPUT, y compris `creativesSaved`, `duplicatesSkipped`, `unusableCreativesSkipped`, `stopReason` et `targetOutcomes`. Gardez distincts les enregistrements partiels, les cibles en échec, les résultats à 0 et les arrêts par plafond. Rappelez-vous qu'un jeu de données de sortie vide ou réduit ne peut pas prouver qu'un annonceur n'a diffusé aucune annonce.
5. Appliquez la règle d'acceptation exacte : exigez des valeurs non vides pour `advertiserId`, `creativeId`, `creativeUrl` et `observedAt` pour une observation identifiée. Examinez les champs `status` et `statusReason`. Conservez les valeurs explicitement manquantes de `mediaUrl` ou de `previewUrl` ; ne transformez pas `null` en 0 et n'inventez pas de lien. Mettez en quarantaine les lignes dont l'identité est manquante dans un fichier d'examen distinct, au lieu de fusionner des vides.
6. Créez des colonnes faites par le lecteur, séparées des champs de l'Actor. Attribuez un `collection_batch_id` fait par le lecteur et construisez votre clé d'observation en combinant l'identifiant de lot, l'identifiant d'annonceur et l'identifiant de création.
7. Stockez des fichiers d'observation JSON complets afin de conserver les variations imbriquées. Conservez les enregistrements de variation enfants sous leur ligne d'observation parente, sans compter les ressources enfants comme des tests indépendants de création ou de campagne.
8. Effectuez et enregistrez des vérifications de liens séparées et indépendantes, avec l'heure de vérification, le type de pointeur, la méthode et le résultat. Conservez les pointeurs antérieurs lorsque de nouveaux pointeurs arrivent, et gardez les enregistrements d'observation même lorsque les liens distants deviennent indisponibles.
9. Ajoutez les lots de collecte ultérieurs sans remplacer vos fichiers d'observation antérieurs. Conservez les enregistrements historiques à côté de votre affichage dérivé de la vue la plus récente.
10. Remettez votre bibliothèque source finalisée, votre manifeste de collecte, vos enregistrements datés de vérification de liens et votre vue la plus récente dérivée à l'étape de rapport. Utilisez la paire d'origine d'identifiant d'annonceur et d'identifiant de création pour retrouver la source, en vous arrêtant avant toute notation de création ou toute recommandation de campagne.

## Vérifications de liens indépendantes et requêtes HTTP HEAD

Créez un enregistrement distinct de vérification de lien qui contient l'identité parente et le lot, le type de pointeur, l'heure de vérification, la méthode et le résultat. Une requête HTTP HEAD demande à un serveur seulement les en-têtes de réponse, et non le contenu du fichier. Le rendu signifie afficher avec succès un aperçu à l'intérieur d'un navigateur. Un code de réponse HTTP 200 signifie que la ressource a répondu lors de cette vérification, mais une réponse `image/png` diffère d'une réponse `application/javascript`.

Aucune de ces réponses ne prouve une image rendue, un archivage permanent du fichier, des droits de réutilisation ou une disponibilité durable. La petite vérification de métadonnées du 13 octobre 2026 a enregistré 2 observations `ok` provenant de 2 comptes, mais les vérifications d'en-têtes n'ont prouvé que des réponses datées, et non un historique répété ni une couverture complète. Le téléchargement des ressources et le rendu des aperçus sont hors de la portée de cette méthode de liens sources.

## Ajout des lots ultérieurs et traitement des pointeurs indisponibles

Ajoutez les lots ultérieurs sans remplacer vos fichiers d'observation antérieurs. Un affichage actuel peut montrer la dernière observation par paire d'identité, mais il doit renvoyer vers les enregistrements historiques. Lorsqu'un ancien pointeur échoue, conservez son enregistrement source, enregistrez la vérification en échec et examinez la page source publique lors d'un examen autorisé ultérieur si nécessaire. Un pointeur en échec, ou une observation absente dans une collecte plafonnée, ne prouve pas qu'une annonce a été supprimée. Ne devinez pas d'URL et n'essayez pas de récupérer des annonces supprimées. Comme aucun test de runs répétés ni aucun test de longue durée n'a été effectué, l'exemple enseigne seulement le raisonnement de conservation.

## Exemple fictif et analyse des comptages

Tous les enregistrements et identifiants de cet exemple sont fictifs. A/B/C1/C2 sont des étiquettes pédagogiques et non des fixtures sources réelles. Aucun fichier média n'est téléchargé.

| Lot | Annonceur | Création | Variations | Situation du lien |
| --- | --- | --- | --- | --- |
| S1 | A | C1 | 2 | pointeur de média disponible lors de la vérification fictive du 1er octobre 2026 à 12:05 UTC |
| S1 | A | C2 | 1 | pointeur d'aperçu disponible lors de cette vérification |
| S1 | B | C1 | 1 | pointeur de média disponible lors de cette vérification |
| S2 | A | C1 | 1 | nouveau pointeur disponible lors de la vérification fictive du 2 octobre 2026 à 12:05 UTC ; conservez le pointeur S1 |
| S2 | A | C2 | 1 | pointeur indisponible lors de cette vérification ultérieure ; conservez l'observation |

Cette collecte produit 5 lignes d'observation, calculées comme 3 lignes dans le lot S1 plus 2 lignes dans le lot S2 (3 + 2 = 5). Il y a 3 paires uniques d'identité de création : A:C1, A:C2 et B:C1. La somme des nombres de variations sur toutes les lignes conservées donne 6 observations de variation, calculées comme 2 plus 1 plus 1 plus 1 plus 1 (2 + 1 + 1 + 1 + 1 = 6). Ces observations de variation sont des ressources enfants à l'intérieur d'enregistrements parents, et non 6 créations uniques ni des tests publicitaires distincts.

Une vue de la dernière observation par identité contient 3 lignes correspondant aux 3 identités uniques, avec 2 vérifications de liens disponibles et datées et 1 vérification indisponible. L'annonceur B:C1 reste représenté par son observation S1, et son absence du lot S2 ne prouve pas la suppression de l'annonce. Les 5 observations doivent toutes être conservées dans la bibliothèque. Cette conservation d'enregistrements préserve les enregistrements de preuves et les pointeurs sans prétendre à un historique publicitaire complet, à un stockage permanent des fichiers média, au succès des annonces ou à des résultats de tests réels de runs répétés.

La visibilité publique n'accorde pas d'autorisation générale de réutilisation [Conditions Google : Autres contenus](https://policies.google.com/terms?hl=en). Cette méthode conserve les enregistrements sources et les pointeurs ; le téléchargement ou la republication des ressources est hors de ce flux de travail de liens sources.

## Prochaine action utile de l'Actor

Ouvrez [Google Ads Transparency Scraper](https://apify.com/chronometrica/google-ads-transparency-scraper), copiez la tâche de bibliothèque publiée, choisissez l'identité de l'annonceur, réduisez le plafond et enregistrez les observations identifiées avec leur manifeste. Examinez-les avant de les utiliser dans un rapport sur les concurrents.

## Sources et lectures complémentaires

- [Google Ads Transparency Scraper](https://apify.com/chronometrica/google-ads-transparency-scraper)
- [Google Ads Creative Library Export | Ads Data](https://apify.com/chronometrica/google-ads-transparency-scraper/examples/google-ads-creative-library-export)
- [Aide sur la transparence Google Ads](https://support.google.com/adspolicy/answer/13733850?hl=en-CA)
- [Conditions Google : Autres contenus](https://policies.google.com/terms?hl=en)