Google Ad Library Advertiser Search
Il Google Ads Transparency Center può esporre più record di inserzionisti per un brand, un’organizzazione o un termine di ricerca di un sito web, comprese entità regionali o con nomi simili. Esaminare ID, nomi, siti web, loghi, regioni e numero di annunci disponibili aiuta a scegliere il record pubblico dell’inserzionista giusto prima di raccoglierne i creativi.
Funzionalità della Google Ad Library Advertiser Search API
- Scoperta degli inserzionisti a partire dal nomeCerca con un solo termine non vuoto tra brand, organizzazione, inserzionista o sito web e ricevi candidati inserzionisti normalizzati invece dei creativi degli annunci.
- Contesto regionale facoltativoPassa una regione come US per dare contesto alla ricerca a monte, mantenendo la regione distinta dalla geografia di pubblicazione degli annunci.
- Campi di identità dei candidatiConfronta ID pubblico dell’inserzionista, nome, URL, sito web, logo, regione e numero di annunci indicato dalla fonte, quando disponibile, senza arricchimenti dedotti.
- Salvataggio completo di una singola rispostaSalva tutti gli inserzionisti utilizzabili restituiti dall’unica risposta di ricerca a monte; non viene applicato alcun limite di risultati controllato da chi chiama né alcun ciclo di paginazione del provider.
Parametri della Google Ad Library Advertiser Search API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | Termine di ricerca obbligatorio e non vuoto di inserzionista, brand, organizzazione o sito web. Il comportamento della corrispondenza dipende dalla fonte e non è garantito che sia esatto, per prefisso o approssimato. |
region | Facoltativo | Stringa di regione facoltativa e non vuota, come US, inoltrata come contesto geografico della ricerca. Non dimostra dove siano stati pubblicati gli annunci di un inserzionista. |
Come usare la Google Ad Library Advertiser Search API
Invia un termine di ricerca, segui l’attività asincrona e rivedi ogni candidato inserzionista normalizzato prima di usarne l’identità nelle ricerche successive.
- Scegli un termine specifico tra inserzionista, brand, organizzazione o sito web; se vuoi, aggiungi una regione come US.
- Invia con POST query e region facoltativa a /v1/google-ad-library/advertiser-search, poi salva il task_id.
- Interroga /v1/tasks/{task_id} finché l’attività ha successo o fallisce.
- Leggi data.results.items e verifica l’identità dei candidati con più elementi della sola somiglianza del nome, prima di scegliere l’ID di un inserzionista.
curl -X POST "https://api.socq.ai/v1/google-ad-library/advertiser-search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"Nike","region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Review data.results.items as advertiser candidatesCasi d’uso della Google Ad Library Advertiser Search API
- Risolvere un brand in ID di inserzionisti: Crea un elenco di candidati a partire da un nome o da un termine di sito web, prima di scegliere l’ID di un inserzionista per una richiesta separata sull’inventario pubblico degli annunci.
- Distinguere entità regionali o giuridiche: Confronta nomi, regioni, siti web e pagine pubbliche degli inserzionisti quando più record simili possono rappresentare filiali, rivenditori o organizzazioni non correlate.
- Creare una coda di revisione: Salva le identità dei candidati e i timestamp di raccolta per la verifica manuale, senza attribuire la proprietà in base alla sola somiglianza del nome.
Consigli degli esperti per la Google Ad Library Advertiser Search API
- Usa una ragione sociale, un brand o un termine simile a un dominio specifici; una formulazione generica può produrre candidati ambigui e le regole di corrispondenza non sono garantite.
- Considera la regione come contesto di ricerca e non come prova che ogni annuncio dell’inserzionista sia stato pubblicato in quella zona geografica.
- Verifica i candidati con ID, nome, sito web, regione e la loro pagina pubblica dell’inserzionista prima di unire i record o raccogliere i creativi.
- Non inviare results_limit: questa operazione salva l’array di inserzionisti utilizzabili restituito da una sola risposta a monte e non pagina la fonte.
API correlate
Oltre alla Google Ad Library Advertiser Search API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Ad Library.
- Google Ad Library Ad API — Recupera una creatività pubblica nota del Transparency Center tramite URL, con inserzionista, testo, media, diffusione, regione, formato, destinazione e impression.
- Google Ad Library Company Ads API — Raccoglie le creatività pubbliche del Transparency Center per dominio dell’azienda o ID dell’inserzionista con controlli su argomento, regione, data, superficie, formato e numero massimo di risultati.