Recherche, YouTube et DisplayRecherchez un annonceur et collectez ses publicités publiques sur Google. Comparez formats, dates d’apparition et messages entre marchés.
Essayez ces exemples pour le marketing, la croissance et l’analyse concurrentielle.
Avant un lancement SaaS, recherchez trois domaines concurrents. Étudiez formats et messages dans la recherche, le display et la vidéo pour préparer vos propres tests de canaux.
Gardez un inventaire des créations concurrentes avec vos notes sur les canaux à étudier.
Pour un lancement commercial, suivez l’annonceur dans deux pays cibles. Les dates de première et dernière diffusion permettent de comparer l’apparition des créations et les différences de texte.
Préparez une comparaison par pays avec des liens vers les annonces publiques.
Activez les détails pour un petit groupe d’annonceurs et gardez les URL des variantes. Récupérez les identifiants YouTube publics disponibles et examinez les contenus avant la production.
Classez les contenus par format pour que votre équipe retrouve ses références.
DU PREMIER ESSAI AU FLUX RÉCURRENT
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "all",
"maxAds": 50,
"fetchAdDetails": false,
"resolveMedia": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Collez ceci dans l’éditeur JSON de l’Actor. Remplacez les cibles d’exemple avant de lancer.
Voir le formulaire actuel sur ApifyNoms, domaines, identifiants et URL du Centre de transparence peuvent identifier un annonceur. Utilisez un identifiant si une marque a plusieurs entités juridiques ou si la recherche par nom choisit la mauvaise.
| Méthode de recherche | Quand l’utiliser | Ce qui change |
|---|---|---|
| Domaines web | Quand l’utiliserVous avez une liste de concurrents à suivre. | Ce qui changeDomaines vérifiés comme nike.com, plus précis qu’un nom de marque. Un domaine sans correspondance peut devenir une recherche par nom ; vérifiez l’annonceur retenu. |
| Nom d’annonceur ou de marque | Quand l’utiliserVous cherchez des résultats pertinents avant de choisir des cibles précises. | Ce qui changeRecherchez des marques ou entreprises. L’Actor vérifie aussi leur domaine et choisit un annonceur. Contrôlez l’identité et utilisez un identifiant AR pour la fixer. |
| Identifiants d’annonceurs | Quand l’utiliserVous connaissez l’entité exacte à collecter. | Ce qui changeIdentifiants AR des liens du Centre de transparence. Ils évitent les noms ambigus et permettent de suivre la même entité juridique dans le temps. |
| URL de la bibliothèque publicitaire | Quand l’utiliserVous avez déjà configuré la recherche sur le site source. | Ce qui changeCollez des liens d’annonceurs du Centre de transparence. Chaque lien conserve sa région et plateforme ; les réglages globaux complètent les filtres absents. |
Conserve les annonces vues pour la dernière fois à cette date ou après. Le filtre est appliqué après collecte ; l’endpoint Google ne propose pas de filtre de dates et ne garantit pas moins de requêtes.
Comparer le scraper associéUtilisez les noms exacts ci-dessous en JSON. Dans le formulaire Apify, saisissez les éléments des listes séparément et respectez les types numériques et booléens.
Valeur par défaut et préremplissage sont différents. La valeur par défaut s’applique si vous omettez un réglage ; le préremplissage est un exemple déjà saisi dans le formulaire Apify. Vérifiez cibles et limites avant chaque collecte. Certains réglages n’ont pas de valeur par défaut dans le schéma. Indiquez au moins une cible prise en charge.
searchTermsRecherchez des marques ou entreprises. L’Actor vérifie aussi leur domaine et choisit un annonceur. Contrôlez l’identité et utilisez un identifiant AR pour la fixer.
domainsDomaines vérifiés comme nike.com, plus précis qu’un nom de marque. Un domaine sans correspondance peut devenir une recherche par nom ; vérifiez l’annonceur retenu.
domainUn domaine au lieu d’une liste domains. Utilisez le domaine seul ; les chemins du site ne réduisent pas les annonces de l’annonceur.
advertiserIdsIdentifiants AR des liens du Centre de transparence. Ils évitent les noms ambigus et permettent de suivre la même entité juridique dans le temps.
advertiserIdVersion de advertiserIds pour un annonceur. Copiez la valeur AR de son lien, pas un identifiant de création.
transparencyUrlsCollez des liens d’annonceurs du Centre de transparence. Chaque lien conserve sa région et plateforme ; les réglages globaux complètent les filtres absents.
transparencyUrlUn lien d’annonceur avec la même priorité que transparencyUrls. La région du lien prime sur une région globale différente.
regionsPlusieurs pays créent des tâches par annonceur et région. Les doublons sont supprimés par creative_id. Vide couvre toutes les régions disponibles ; les pays non pris en charge sont ignorés.
regionUn pays, utilisé seulement si regions est vide. Préférez regions pour comparer plusieurs marchés.
platformLimite la plateforme publicitaire Google. Choisissez search, youtube, display, shopping, maps, play ou all. Les totaux peuvent se chevaucher.
all search youtube display shopping maps playminDateConserve les annonces vues pour la dernière fois à cette date ou après. Le filtre est appliqué après collecte ; l’endpoint Google ne propose pas de filtre de dates et ne garantit pas moins de requêtes.
maxDateConserve les annonces apparues à cette date ou avant. Avec minDate, sélectionne les diffusions chevauchant la période. Utilisez YYYY-MM-DD.
proxyConfigurationApify Proxy est recommandé ; un datacenter suffit généralement. Le résidentiel n’est pas obligatoire. Une configuration refusée peut utiliser le proxy par défaut du compte.
maxConcurrencyDe 1 à 10 tâches annonceur-région en parallèle. Utile pour plusieurs annonceurs ou régions ; un annonceur dans une région reste séquentiel.
maxAdsPlafond d’annonces uniques pour tout le run, toutes cibles et tous marchés compris. Commencez à 50. Sans ce plafond, une recherche large peut produire beaucoup plus de données.
maxPagesPlafond de pages par tâche annonceur-région. Une page contient jusqu’à pageSize annonces, au maximum 100. C’est une limite de test, pas globale.
fetchAdDetailsAjoute les régions, dates de diffusion régionales et variantes. Une requête supplémentaire par annonce ; activez seulement si ces champs sont nécessaires.
resolveMediaEffectue des requêtes supplémentaires pour retrouver les identifiants vidéo YouTube publics. Ne crée pas de lien public pour une vidéo display qui n’en possède pas.
pageSizeDe 1 à 100 annonces par requête. Les valeurs supérieures sont ramenées à 100 car Google refuse les lots plus grands. Gardez 100 sauf diagnostic.
delayMsPause entre requêtes de pages, en millisecondes. Augmentez-la en cas de limitation ; la réduire ne supprime ni la latence ni les limites de la source.
rawRenvoie la structure source plutôt que la présentation normalisée. Gardez false pour des colonnes cohérentes ; utilisez true pour déboguer ou effectuer vos propres transformations.
proxyRotationsRéessaie les requêtes refusées avec une nouvelle session proxy. Davantage d’essais peut surmonter des blocages temporaires, mais ajoute du temps et du trafic. Gardez le réglage par défaut sauf indication du journal.
resumeSauvegarde la progression environ toutes les 30 secondes pour reprendre après un redémarrage ou une migration Apify. Laissez-le activé.
continueFromLastRunPoursuit le travail inachevé du run précédent avec la même entrée. Les résultats précédents restent dans son dataset. Gardez false pour une collecte nouvelle ou régulière.
impersonateIdentité du navigateur utilisée pour les requêtes. Gardez la valeur par défaut sauf pour diagnostiquer un blocage immédiat. Elle modifie l’empreinte des requêtes, pas les données demandées.
proxySessionIdFixe une session proxy pour le débogage. Laissez vide en usage normal. Les tâches parallèles nécessitent leurs propres sessions et peuvent ignorer cette session fixe.
Cette référence reprend les paramètres de l’Actor. Vérifiez le formulaire actuel avant de modifier un flux de production. Voir le formulaire actuel sur Apify.
Chaque exemple est une exécution distincte. Commencez petit, vérifiez les résultats, puis élargissez. Adaptez les cibles, pays et dates à votre recherche.
Deux domaines et deux régions créent quatre tâches annonceur-région. La limite de 150 porte sur le jeu combiné et dédupliqué. Elle ne réserve pas un échantillon égal à chaque marque ou pays.
{
"domains": ["nike.com", "adidas.com"],
"regions": ["GB", "FR"],
"maxAds": 150,
"fetchAdDetails": false,
"proxyConfiguration": {
"useApifyProxy": true
}
}Filtrez sur YouTube et activez resolveMedia pour tenter d’obtenir les identifiants et URL vidéo. Vérifiez les champs avant de transmettre les liens à Claude ; certaines créations n’ont pas de vidéo directement accessible.
{
"domains": ["nike.com"],
"regions": ["GB"],
"platform": "youtube",
"maxAds": 50,
"resolveMedia": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Ajoutez les détails et une période de diffusion pour l’Allemagne. Les dates sont vérifiées après récupération des annonces : une courte période ne garantit pas une collecte peu coûteuse. Modifiez les dates et commencez avec une petite limite.
{
"domains": ["nike.com"],
"regions": ["DE"],
"minDate": "2026-09-01",
"maxDate": "2026-09-30",
"maxAds": 50,
"fetchAdDetails": true,
"proxyConfiguration": {
"useApifyProxy": true
}
}Conservez les identifiants d’annonceur et de création avec région, plateforme et date. Les options de détails et médias enrichissent les mêmes lignes, sans créer de jeu de performance. Utilisez Sheets pour examiner les créations, ou BigQuery et dbt pour l’historique dédupliqué. La source ne fournit ni dépenses, ni ROAS, ni conversions.
resume protège le run actuel si Apify le redémarre. continueFromLastRun poursuit un ancien run avec la même configuration ; ses données restent dans son dataset. Réunissez les deux datasets et augmentez une limite déjà atteinte. Relancez de zéro pour observer les changements d’aujourd’hui.
Enregistrez une configuration ci-dessus dans input.json. Définissez APIFY_TOKEN avec votre jeton Apify dans le terminal, puis envoyez le fichier comme corps de requête.
curl --fail-with-body --request POST \
--url "https://api.apify.com/v2/actors/jmlp~google-ads-transparency-center-scraper/runs" \
--header "Authorization: Bearer $APIFY_TOKEN" \
--header "Content-Type: application/json" \
--data-binary @input.jsonLa réponse contient un identifiant de collecte et defaultDatasetId, pas les résultats finaux. Attendez la réussite, définissez DATASET_ID avec cet identifiant et récupérez les lignes. Pour les gros jeux, utilisez limit et offset pour paginer.
curl --fail-with-body \
--url "https://api.apify.com/v2/datasets/$DATASET_ID/items?format=json" \
--header "Authorization: Bearer $APIFY_TOKEN"Référence API de lancement et d’export d’Apify
Options d’export des données
Modifiez un réglage à la fois, gardez une petite limite et consultez le résumé avant d’élargir.
Identifiants AR des liens du Centre de transparence. Ils évitent les noms ambigus et permettent de suivre la même entité juridique dans le temps.
Effectue des requêtes supplémentaires pour retrouver les identifiants vidéo YouTube publics. Ne crée pas de lien public pour une vidéo display qui n’en possède pas.
De 1 à 10 tâches annonceur-région en parallèle. Utile pour plusieurs annonceurs ou régions ; un annonceur dans une région reste séquentiel.
Un succès indique que l’Actor a terminé, pas que la source a fourni des données. Consultez SUMMARY.inputProblem, SUMMARY.problem et le journal : cible manquante, filtre non pris en charge ou requête refusée. Essayez une cible connue avec moins de filtres.
Vérifiez les limites globales, par recherche et par page, la couverture et les doublons. Plusieurs recherches peuvent trouver la même ligne. Le total annoncé par la source peut inclure des données non accessibles publiquement. Vérifiez les tâches inachevées avant de considérer le dataset complet.
Réunissez creative_id, advertiser_name, format, first_shown, last_shown et preview_url dans un tableau. Ajoutez une colonne de thème de campagne pour les notes de l’équipe.
Lire le guideDemandez à Claude de comparer formats et dates de diffusion d’un petit groupe d’annonceurs. Exigez les liens sources et séparez les interprétations des observations.
Lire le guideComparez les formats par annonceur et affichez l’apparition de nouveaux identifiants créatifs. Aplatissez le tableau des régions avant de créer un rapport par marché.
Lire le guideDédupliquez avec creative_id en conservant chaque observation datée. Stockez régions et variantes dans des tables liées pour éviter de gonfler le nombre de créations lors des jointures.
Lire le guide
Vérifie le schéma de jmlp/google-ads-transparency-center-scraper, puis collecte au maximum 50 résultats pour nike.com en GB. Résume les formats et dates disponibles, cite transparency_url et propose des questions marketing à étudier. N’estime ni dépenses ni ROAS.Conservez la date de collecte et les identifiants d’origine pour vérifier la provenance d’un résultat ou le comparer à une exécution ultérieure.
Les données de transparence Google n’indiquent ni conversions ni ROAS concurrents. Les dates sont filtrées après collecte : une plage étroite ne raccourcit pas forcément le parcours. Détails et résolution vidéo ajoutent des requêtes ; activez-les au besoin.
Il peut collecter des annonces de recherche, YouTube, Display, Shopping et Maps, selon la plateforme choisie et les données publiques disponibles.
Pas forcément. Le point d’accès source ne filtre pas par date : l’extracteur collecte les pages puis filtre les résultats. Limitez l’exécution avec maxAds et les options de détails.
Source et informations actuelles : Actor Google Ads Transparency de JMLP sur Apify.
Facebook & Instagram01Regardez ce que vos concurrents annoncent.
Rassemblez les publicités concurrentes. Comparez textes, offres et dates avant de préparer votre prochaine campagne.
Bibliothèque de contenus commerciaux02Trouvez des idées de vidéos à tester.
Collectez les annonces TikTok de 32 marchés dans l’UE/EEE, au Royaume-Uni et en Suisse. Conservez vidéos et dates de diffusion, puis examinez les créations qui vous intéressent.
Dites-moi ce que vous devez collecter ou comprendre. Je peux vous aider avec un extracteur sur mesure, un pipeline ou l’analyse.
Parlons de votre projet