Configurer les tâches ‘Ad Traffic By Keywords’
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Configurer les tâches ‘Ad Traffic By Keywords’
Met en file d'attente une prévision de clics, d'impressions et de dépenses pour des keywords à un bid et un type de match donnés, et renvoie un id de tâche. search_partners inclut le réseau de partenaires de Google. Enveloppé dans l'enveloppe DataForSEO : les données dans tasks[0].result, l'issue dans tasks[0].status_code — une requête rejetée renvoie tout de même HTTP 200. C'est le seul point de terminaison Google Ads ici sans variante en temps réel — la prévision passe toujours par la file. Récupérez avec get_dataforseo_keywords_gads_ad_traffic_fetch.
Référence tarifaire
- Mesure : coût de réponse déclaré.
- Estimation de référence par requête : USD 0.09.
- Multiplicateur de référence client : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.
Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.
- Type: array (object | null)[]
- bidType: number
l'enchère personnalisée maximale
champ obligatoire
les données collectées seront basées sur cette valeur
elle correspond au prix que vous êtes prêt à payer pour une annonce ; plus la valeur indiquée ici est élevée, plus les valeurs des métriques renvoyées seront élevées
en savoir plus dans cet article du centre d'aide - dateType: string
_from date de début de la plage de prévision
champ obligatoire si vous indiquezdate_to
si vous indiquezdate_frometdate_to, vous n'avez pas besoin de spécifierdate_interval
la valeur minimale est la date de demain
la valeur indiquée dansdate_fromne doit pas être postérieure àdate_to
format de date :"yyyy-mm-dd"
exemple :"2021-10-30"si le point de terminaison Status renvoiefalsedans le champactual_data,date_frompeut être défini au mois d'avant-dernier et avant ;
si le point de terminaison Status renvoietruedans le champactual_data,date_frompeut être défini au mois dernier et avant - dateType: string | null
_interval intervalle de dates de la prévision
champ facultatif
si vous indiquezdate_interval, vous n'avez pas besoin d'indiquerdate_frometdate_to
valeurs possibles :next_week,next_month,next_quarter
valeur par défaut :next_month - dateType: string
_to date de fin de la plage de prévision
champ obligatoire si vous indiquezdate_from
si vous indiquezdate_frometdate_to, vous n'avez pas besoin de spécifierdate_interval
la valeur minimale estdate_from+1 jour
la valeur maximale est le jour et le mois actuels de l'année suivante
format de date :"yyyy-mm-dd"
exemple :"2022-10-30" - keywordsType: array string[]
mots-clés
champ obligatoire
Le nombre maximal de mots-clés que vous pouvez indiquer : 1000
Le nombre maximal de caractères par mot-clé : 80
Le nombre maximal de mots par expression de mot-clé : 10
les mots-clés que vous indiquez seront convertis en minuscules
Remarque n° 1 : Google Ads peut ne renvoyer aucune donnée pour certains groupes de mots-clés ;
Remarque n° 2 : Google Ads fournit des valeurs de volume de recherche combinées pour des groupes de mots-clés similaires
pour obtenir le volume de recherche de mots-clés similaires, nous recommandons d'envoyer ces mots-clés dans des requêtes distinctes ;
Remarque n° 3 : Google Ads n'autorise pas l'utilisation de certains symboles et caractères (par exemple, symboles UTF, emojis), vous ne pouvez donc pas les utiliser lors de la définition d'une tâche ;
pour en savoir plus sur les symboles et caractères utilisables, consultez cet articleen savoir plus sur les règles et limites des champs
keywordetkeywordsdans les API DataForSEO dans cet article du centre d'aide - languageType: string | null
_code code de langue du moteur de recherche
champ facultatif
vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leurlanguage_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/keywords_data/google_ads/languages
exemple :en - languageType: string | null
_name nom complet de la langue du moteur de recherche
champ facultatif
vous pouvez obtenir la liste des langues disponibles du moteur de recherche avec leurlanguage_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/keywords_data/google_ads/languages
exemple :English - locationType: integer | null
_code code d'emplacement du moteur de recherche
champ facultatif
si vous n'indiquez pas l'emplacement, vous recevrez des résultats mondiaux, c'est-à-dire pour tous les emplacements disponibles ;
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_namenilocation_coordinate;
vous pouvez obtenir la liste des emplacements disponibles des moteurs de recherche avec leurlocation_codeen effectuant une requête distincte surhttps://api.dataforseo.com/v3/keywords_data/google_ads/locations
exemple :2840 - locationType: string | null
_coordinate coordonnées GPS d'un emplacement
champ facultatif
si vous n'indiquez pas l'emplacement, vous recevrez des résultats mondiaux, c'est-à-dire pour tous les emplacements disponibles ;
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_namenilocation_code;
le paramètrelocation_coordinatedoit être indiqué au format "latitude,longitude" ;
les données seront fournies pour le pays auquel appartiennent les coordonnées indiquées ;
exemple :52.6178549,-155.352142 - locationType: string | null
_name nom complet de l'emplacement du moteur de recherche
champ facultatif
si vous n'indiquez pas l'emplacement, vous recevrez des résultats mondiaux, c'est-à-dire pour tous les emplacements disponibles ;
si vous utilisez ce champ, vous n'avez pas besoin de spécifierlocation_codenilocation_coordinate
vous pouvez obtenir la liste des emplacements disponibles du moteur de recherche avec leurlocation_nameen effectuant une requête distincte surhttps://api.dataforseo.com/v3/keywords_data/google_ads/locations
exemple :London,England,United Kingdom - matchType: string
type de correspondance des mots-clés
champ obligatoire
peut prendre les valeurs suivantes :exact,broad,phrase - pingbackType: string | null
_url URL de notification d'une tâche terminée
champ facultatif
lorsqu'une tâche est terminée, nous vous en informons par une requête GET envoyée à l'URL que vous avez spécifiée
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depingback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - postbackType: string | null
_url URL d'envoi des résultats de la tâche
champ facultatif
une fois la tâche terminée, nous enverrons une requête POST avec ses résultats compressés au formatgzipà l'adressepostback_urlque vous avez spécifiée
vous pouvez utiliser la chaîne ‘$id’ comme variable$idet ‘$tag’ comme variable$tagencodée pour URL. Nous définirons les valeurs nécessaires avant d'envoyer la requête.
exemple :http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Remarque : les caractères spéciaux depostback_urlseront encodés pour URL ;
notamment, le caractère#sera encodé en%23 - sortType: string | null
_by paramètres de tri des résultats
champ facultatif
Utilisez ces paramètres pour trier les résultats parrelevance,average_cpc,costouclickspar ordre décroissant
valeur par défaut :relevance - tagType: string | null
identifiant de tâche défini par l'utilisateur
champ facultatif
la limite est de 255 caractères
vous pouvez utiliser ce paramètre pour identifier la tâche et l'associer au résultat
vous trouverez la valeurtagspécifiée dans l'objetdatade la réponse
- Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo200
- Type: number | null Format: doublecost
coût total des tâches, USD
- Type: integer | nullstatus
_code code d'état général vous pouvez trouver la liste complète des codes de réponse ici
- Type: string | nullstatus
_message message d'information général vous pouvez trouver la liste complète des messages d'information généraux ici
- Type: array (object | null)[] | nulltasks
tableau de tâches
- Type: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
- costType: number | null Format: double
coût total des tâches, USD
- dataType: object | null
contient les mêmes paramètres que ceux spécifiés dans la requête POST
- propertyType: object | null
Name
- idType: string | null
identifiant de la tâche identifiant unique de la tâche dans notre système au format UUID
- pathType: array (string | null)[] | null
chemin de l'URL
- resultType: object | null
tableau de résultats
dans ce cas, la valeur seranull - resultType: integer | null Format: int64
_count nombre d'éléments dans le tableau de résultats
- statusType: integer | null
_code code d'état de la tâche généré par DataForSEO ; peut être compris dans la plage suivante : 10000-60000 vous pouvez trouver la liste complète des codes de réponse ici
- statusType: string | null
_message message d'information de la tâche vous pouvez trouver la liste complète des messages d'information généraux ici
- timeType: string | null
temps d'exécution, en secondes
- Type: integer | null Format: int64tasks
_count le nombre de tâches dans le tableau de tâches
- Type: integer | null Format: int64tasks
_error le nombre de tâches dans le tableau de tâches renvoyées avec une erreur
- Type: string | nulltime
temps d'exécution total, en secondes
- Type: string | nullversion
la version actuelle de l'API
application/json - 400
La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.
- 401
Une clé API Felo valide est requise.
- 402
La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.
- 403
Le compte n'est pas autorisé à effectuer cette opération.
- 429
Une limite de requêtes ou de dépenses a été atteinte.
- 502
Le service n'a pas pu terminer la requête.
- 503
L'API ou le service de facturation est temporairement indisponible.
- 504
Le service a expiré lors du traitement de la requête.
- default
Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur
application/json
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"
]
}
]'
{
"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
}
]
}