v0.2.0-beta

OpenAPI 3.1.0

Impostare le attività ‘Ad Traffic By Keywords’

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operazioni

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

Impostare le attività ‘Ad Traffic By Keywords’

Accoda una previsione di clic, impressioni e spesa per keywords con un dato bid e tipo match e restituisce un id attività. search_partners include la rete partner di Google. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200. Questo è l'unico endpoint Google Ads qui senza variante live: le previsioni passano sempre dalla coda. Recuperare con get_dataforseo_keywords_gads_ad_traffic_fetch.

Riferimento prezzi

Misurazione: costo della risposta riportato.
Stima di riferimento per richiesta: USD 0.09.
Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.

Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Corpo

application/json

Tipo: array (object | null)[]
- bid
  Tipo: number
  
  offerta personalizzata massima
  campo obbligatorio
  i dati raccolti si baseranno su questo valore
  rappresenta il prezzo che si è disposti a pagare per un annuncio; maggiore è il valore specificato qui, maggiori saranno i valori nelle metriche restituite
  scopri di più in questo articolo del Help Center
- date_from
  Tipo: string
  
  data di inizio dell'intervallo di previsione
  campo obbligatorio se si specifica date_to
  se si indicano date_from e date_to, non è necessario specificare date_interval
  il valore minimo è la data di domani
  il valore specificato in date_from non deve essere successivo a date_to
  formato data: "yyyy-mm-dd"
  esempio:
  "2021-10-30"se l'endpoint Status restituisce false nel campo actual_data, date_from può essere impostato al mese precedente a quello scorso e precedenti;
  se l'endpoint Status restituisce true nel campo actual_data, date_from può essere impostato al mese scorso e precedenti
- date_interval
  Tipo: string | null
  
  intervallo di date della previsione
  campo facoltativo
  se si specifica date_interval, non è necessario indicare date_from e date_to
  possibili valori: next_week, next_month, next_quarter
  valore predefinito: next_month
- date_to
  Tipo: string
  
  data di fine dell'intervallo di previsione
  campo obbligatorio se si specifica date_from
  se si indicano date_from e date_to, non è necessario specificare date_interval
  il valore minimo è date_from +1 giorno
  il valore massimo è il giorno e il mese correnti dell'anno successivo
  formato data: "yyyy-mm-dd"
  esempio:
  "2022-10-30"
- keywords
  Tipo: array string[]
  
  keywords
  campo obbligatorio
  numero massimo di keywords specificabili: 1000
  numero massimo di caratteri per keyword: 80
  numero massimo di parole per frase keyword: 10
  le keywords specificate verranno convertite in minuscolo
  Nota n. 1: Google Ads potrebbe non restituire dati per determinati gruppi di keywords;
  Nota n. 2: Google Ads fornisce valori di volume di ricerca combinati per gruppi di keywords simili
  per ottenere il volume di ricerca di keywords simili, si consiglia di inviare tali keywords in richieste separate;
  Nota n. 3: Google Ads non consente l'uso di determinati simboli e caratteri (ad es. simboli UTF, emoji), pertanto non è possibile usarli durante l'impostazione di un'attività;
  per scoprire quali simboli e caratteri è possibile usare, consultare questo articolo
  
  scopri di più su regole e limitazioni dei campi keyword e keywords nelle API DataForSEO in questo articolo del Help Center
- language_code
  Tipo: string | null
  
  codice lingua del motore di ricerca
  campo facoltativo
  è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_code effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  esempio:
  en
- language_name
  Tipo: string | null
  
  nome completo della lingua del motore di ricerca
  campo facoltativo
  è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_name effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  esempio:
  English
- location_code
  Tipo: integer | null
  
  codice località del motore di ricerca
  campo facoltativo
  se non si indica la località, si riceveranno risultati mondiali, ovvero per tutte le località disponibili;
  se si usa questo campo, non è necessario specificare location_name o location_coordinate;
  è possibile ricevere l'elenco delle località disponibili dei motori di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  esempio:
  2840
- location_coordinate
  Tipo: string | null
  
  coordinate GPS di una località
  campo facoltativo
  se non si indica la località, si riceveranno risultati mondiali, ovvero per tutte le località disponibili;
  se si usa questo campo, non è necessario specificare location_name o location_code;
  il parametro location_coordinate deve essere specificato nel formato "latitude,longitude";
  i dati verranno forniti per il paese a cui appartengono le coordinate specificate;
  esempio:
  52.6178549,-155.352142
- location_name
  Tipo: string | null
  
  nome completo della località del motore di ricerca
  campo facoltativo
  se non si indica la località, si riceveranno risultati mondiali, ovvero per tutte le località disponibili;
  se si usa questo campo, non è necessario specificare location_code o location_coordinate
  è possibile ricevere l'elenco delle località disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  esempio:
  London,England,United Kingdom
- match
  Tipo: string
  
  tipo di corrispondenza delle keyword
  campo obbligatorio
  può assumere i seguenti valori: exact, broad, phrase
- pingback_url
  Tipo: string | null
  
  URL di notifica di un'attività completata
  campo facoltativo
  al completamento di un'attività ti invieremo una notifica tramite una richiesta GET all'URL specificato
  puoi usare la stringa ‘$id’ come variabile $id e ‘$tag’ come variabile $tag codificata per URL. Imposteremo i valori necessari prima di inviare la richiesta.
  esempio:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Nota: i caratteri speciali in pingback_url vengono codificati per URL;
  ad es. il carattere # viene codificato in %23
  
  per saperne di più, consulta il nostro Help Center
- postback_url
  Tipo: string | null
  
  URL per l'invio dei risultati dell'attività
  campo facoltativo
  una volta completata l'attività, invieremo una richiesta POST con i risultati compressi in formato gzip al postback_url specificato
  puoi usare la stringa ‘$id’ come variabile $id e ‘$tag’ come variabile $tag codificata per URL. Imposteremo i valori necessari prima di inviare la richiesta.
  esempio:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Nota: i caratteri speciali in postback_url vengono codificati per URL;
  ad es. il carattere # viene codificato in %23
  
  per saperne di più, consulta il nostro Help Center
- sort_by
  Tipo: string | null
  
  parametri di ordinamento dei risultati
  campo facoltativo
  usare questi parametri per ordinare i risultati per relevance, average_cpc, cost o clicks in ordine decrescente
  valore predefinito: relevance
- tag
  Tipo: string | null
  
  identificatore dell'attività definito dall'utente
  campo facoltativo
  il limite di caratteri è 255
  puoi usare questo parametro per identificare l'attività e associarla al risultato
  il valore tag specificato si trova nell'oggetto data della risposta

Risposte

200
Tipo: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

status_code
Tipo: integer | null

codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

tasks
Tipo: array (object | null)[] | null

array di attività

Tipo: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

data
Tipo: object | null

Contiene gli stessi parametri specificati nella richiesta POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

path
Tipo: array (string | null)[] | null

Percorso URL

result
Tipo: object | null

array di risultati
in questo caso il valore sarà null

result_count
Tipo: integer | null Formato: int64

Numero di elementi nell'array dei risultati

status_code
Tipo: integer | null

codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

time
Tipo: string | null

Tempo di esecuzione in secondi

tasks_count
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks

tasks_error
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks restituite con un errore

time
Tipo: string | null

tempo di esecuzione totale, secondi

version
Tipo: string | null

La versione corrente dell'API
application/json
400

Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
401

È richiesta una chiave API Felo valida.
402

Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
403

L'account non è autorizzato a eseguire questa operazione.
429

È stato raggiunto un limite di richieste o di spesa.
502

Il servizio non è riuscito a completare la richiesta.
503

L'API o il servizio di fatturazione è temporaneamente non disponibile.
504

Si è verificato un timeout durante l'elaborazione della richiesta.
default

Risposta di errore; le risposte passthrough upstream possono usare formati del provider

application/json

post/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "bid": 999,
    "match": "exact",
    "keywords": [
      "seo marketing"
    ]
  }
]'

Mostra schema

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": null
    }
  ]
}

Operazione riuscita

Impostare le attività ‘Ad Traffic By Keywords’

AutenticazioneRequired

DataForSEO

Impostare le attività ‘Ad Traffic By Keywords’

Riferimento prezzi