Google Ad Library Ad
Les publicités du Google Ads Transparency Center sont des enregistrements publicitaires publics, avec l’identité de l’annonceur, le texte et les médias visibles, les liens de destination, les formats, les dates de diffusion, les régions et les données d’impressions disponibles. Ces informations servent à vérifier une création, à enrichir des publicités sélectionnées, à étudier le contexte de diffusion et à comparer des archives à un instant donné.
Fonctionnalités de la Google Ad Library Ad API
- Résolution d’une publicité exacteTransforme une URL adstransparency.google.com contenant /creative/ en un enregistrement de publicité public normalisé, au plus, sans élargir la requête à une recherche.
- Champs de l’annonceur et de la créationRenvoie l’identifiant de la création, l’URL source publique, le texte disponible, la référence de l’annonceur, la destination et le format dans un schéma de publicité stable.
- Contexte de diffusionConserve les dates de début et de fin, les pays, les emplacements et une valeur scalaire d’impressions disponibles, uniquement lorsque les données sources peuvent être normalisées sans risque.
- Médias normalisésExpose les références d’images ou de vidéos disponibles avec miniatures, dimensions et durée, et omet les valeurs facultatives absentes.
Paramètres de la Google Ad Library Ad API
| Paramètres | Obligatoire | Description |
|---|---|---|
url | Obligatoire | URL obligatoire d’une publicité publique du Google Ads Transparency Center. Le schéma doit être http ou https, l’hôte doit se terminer par adstransparency.google.com et le chemin doit contenir /creative/. |
Comment utiliser la Google Ad Library Ad API
Envoyez l’URL exacte d’une publicité publique, suivez la tâche asynchrone, puis lisez l’enregistrement de publicité normalisé dans l’enveloppe de résultats standard.
- Préparez une URL http ou https sur adstransparency.google.com dont le chemin contient /creative/.
- Envoyez url en POST à /v1/google-ad-library/ad et conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue.
- Lisez data.results.items ; l’opération de détail renvoie au plus un élément, de sorte que has_more vaut normalement false et next_cursor normalement null.
curl -X POST "https://api.socq.ai/v1/google-ad-library/ad" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; this detail operation returns at most one itemCas d’usage de la Google Ad Library Ad API
- Compléter une publicité sélectionnée : Utilisez l’ID de la création, la référence de l’annonceur, le texte, la destination, le format, les médias et l’URL source pour compléter un enregistrement de publicité déjà repéré.
- Documenter la diffusion publique : Comparez dates, pays, emplacements et impressions disponibles pour établir où et quand une publicité connue a été observée publiquement.
- Archiver des instantanés de publicités : Stockez le texte, les médias, l’annonceur, la diffusion, la destination et collected_at normalisés pour une comparaison ultérieure à un instant donné.
Conseils d’expert pour la Google Ad Library Ad API
- Envoyez l’URL complète de la publicité plutôt qu’un identifiant CR seul ou l’URL d’un annonceur, pour que l’hôte et le chemin /creative/ passent la validation.
- Distinguez une tâche en succès sans élément d’un échec du fournisseur : une publicité supprimée, restreinte ou indisponible peut ne donner aucun enregistrement exploitable.
- Conservez les champs de diffusion, de texte, de destination, d’annonceur, d’impressions et de médias comme nullables au lieu de convertir des valeurs publiques manquantes en zéro ou en affirmations vides.
- Passez par la recherche d’annonceurs et par les publicités d’une entreprise pour la découverte ou l’inventaire ; cette opération de détail ne résout volontairement que la publicité envoyée.
API associées
En complément de la Google Ad Library Ad API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Ad Library.
- Google Ad Library Advertiser Search API — Repérez des annonceurs publics du Transparency Center par requête et région facultative avec identité, site web, logo, région et nombre de publicités disponible.
- Google Ad Library Company Ads API — Collectez les créations publiques du Transparency Center par domaine d’entreprise ou ID d’annonceur avec contrôle du thème, de la région, de la date, de la surface, du format et du nombre de résultats.