‘Ad Traffic By Keywords’ Görevlerini Oluşturma
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
‘Ad Traffic By Keywords’ Görevlerini Oluşturma
keywords için verilen bid ve match türünde tıklama, gösterim ve harcama tahminini kuyruğa alır ve bir görev id değeri döndürür. search_partners Google'ın iş ortağı ağını içerir. DataForSEO zarfına sarılıdır: veriler tasks[0].result içinde, sonuç tasks[0].status_code içinde — reddedilen bir istek yine de HTTP 200 döndürür. Buradaki canlı varyantı olmayan tek Google Ads uç noktasıdır — tahmin her zaman kuyruğa alınır. get_dataforseo_keywords_gads_ad_traffic_fetch ile getirin.
Fiyatlandırma referansı
- Ölçümlendirme: bildirilen yanıt maliyeti.
- Referans istek tahmini: USD 0.09.
- Referans müşteri çarpanı: 1.0. Kesinleşmiş müşteri tutarına yeniden uygulamayın.
Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.
- Tür: array (object | null)[]
- bidTür: number
maksimum özel teklif
zorunlu alan
toplanan veriler bu değere dayalı olacaktır
bir reklam için ödemeye razı olduğunuz fiyatı ifade eder; burada belirttiğiniz değer ne kadar yüksekse döndürülen metriklerde o kadar yüksek değerler alırsınız
daha fazla bilgi için bu yardım merkezi makalesine bakın - dateTür: string
_from tahmin zaman aralığının başlangıç tarihi
date_tobelirtirseniz zorunlu alandate_fromvedate_tobelirtirsenizdate_intervalbelirtmeniz gerekmez
minimum değer yarının tarihidirdate_fromiçin belirttiğiniz değerdate_todeğerinden ileri olamaz
tarih biçimi:"yyyy-mm-dd"
örnek:"2021-10-30"Status uç noktasıactual_dataalanındafalsedöndürürse,date_fromevvelsi ay ve öncesi olarak ayarlanabilir;
Status uç noktasıactual_dataalanındatruedöndürürse,date_fromson ay ve öncesi olarak ayarlanabilir - dateTür: string | null
_interval tahmin tarih aralığı
isteğe bağlı alandate_intervalbelirtirsenizdate_fromvedate_tobelirtmeniz gerekmez
olası değerler:next_week,next_month,next_quarter
varsayılan değer:next_month - dateTür: string
_to tahmin zaman aralığının bitiş tarihi
date_frombelirtirseniz zorunlu alandate_fromvedate_tobelirtirsenizdate_intervalbelirtmeniz gerekmez
minimum değerdate_from+1 gündür
maksimum değer, gelecek yılın geçerli günü ve ayıdır
tarih biçimi:"yyyy-mm-dd"
örnek:"2022-10-30" - keywordsTür: array string[]
keywords
zorunlu alan
belirtebileceğiniz maksimum anahtar kelime sayısı: 1000
her anahtar kelime için maksimum karakter sayısı: 80
her anahtar kelime ifadesi için maksimum kelime sayısı: 10
belirttiğiniz anahtar kelimeler küçük harf biçimine dönüştürülür
Not #1: Google Ads belirli anahtar kelime grupları için veri döndürmeyebilir;
Not #2: Google Ads benzer anahtar kelime grupları için birleşik arama hacmi değerleri sağlar
benzer anahtar kelimeler için arama hacmi elde etmek üzere bu tür anahtar kelimeleri ayrı isteklerde göndermenizi öneririz;
Not #3: Google Ads belirli sembol ve karakterlerin (ör. UTF sembolleri, emoji) kullanılmasına izin vermez, bu nedenle görev ayarlarken bunları kullanamazsınız;
hangi sembol ve karakterlerin kullanılabileceği hakkında daha fazla bilgi için bu makaleye bakınDataForSEO API'lerinde
keywordvekeywordsalanlarının kural ve sınırlamaları hakkında daha fazla bilgi için bu Yardım Merkezi makalesine bakın - languageTür: string | null
_code arama motoru dil kodu
isteğe bağlı alan
arama motorunun mevcut dillerinin listesinilanguage_codedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
örnek:en - languageTür: string | null
_name arama motoru dilinin tam adı
isteğe bağlı alan
arama motorunun mevcut dillerinin listesinilanguage_namedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/keywords_data/google_ads/languages
örnek:English - locationTür: integer | null
_code arama motoru konum kodu
isteğe bağlı alan
konumu belirtmezseniz, tüm mevcut konumlar için yani dünya genelinde sonuçlar alırsınız;
bu alanı kullanırsanızlocation_nameveyalocation_coordinatebelirtmeniz gerekmez;
arama motorlarının mevcut konumlarının listesinilocation_codedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
örnek:2840 - locationTür: string | null
_coordinate bir konumun GPS koordinatları
isteğe bağlı alan
konumu belirtmezseniz, tüm mevcut konumlar için yani dünya genelinde sonuçlar alırsınız;
bu alanı kullanırsanızlocation_nameveyalocation_codebelirtmeniz gerekmez;location_coordinateparametresi "latitude,longitude" biçiminde belirtilmelidir;
veriler, belirtilen koordinatların ait olduğu ülke için sağlanır;
örnek:52.6178549,-155.352142 - locationTür: string | null
_name arama motoru konumunun tam adı
isteğe bağlı alan
konumu belirtmezseniz, tüm mevcut konumlar için yani dünya genelinde sonuçlar alırsınız;
bu alanı kullanırsanızlocation_codeveyalocation_coordinatebelirtmeniz gerekmez
arama motorunun mevcut konumlarının listesinilocation_namedeğerleriyle birlikte ayrı bir istek göndererek şu adresten alabilirsiniz:https://api.dataforseo.com/v3/keywords_data/google_ads/locations
örnek:London,England,United Kingdom - matchTür: string
anahtar kelime eşleme türü
zorunlu alan
şu değerleri alabilir:exact,broad,phrase - pingbackTür: string | null
_url tamamlanan görevin bildirim URL'si
isteğe bağlı alan
görev tamamlandığında belirttiğiniz URL'ye gönderilen GET isteğiyle sizi bilgilendireceğiz
‘$id’ dizesini$iddeğişkeni, ‘$tag’ dizesini ise URL kodlu$tagdeğişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
örnek:http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag
Not:pingback_urliçindeki özel karakterler URL kodlanır;
yani,#karakteri%23olarak kodlanır - postbackTür: string | null
_url görev sonuçlarını göndermek için URL
isteğe bağlı alan
görev tamamlandığında sonuçlarınıgzipbiçiminde sıkıştırarak belirttiğinizpostback_urladresine POST isteğiyle göndereceğiz
‘$id’ dizesini$iddeğişkeni, ‘$tag’ dizesini ise URL kodlu$tagdeğişkeni olarak kullanabilirsiniz. İsteği göndermeden önce gerekli değerleri ayarlayacağız.
örnek:http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag
Not:postback_urliçindeki özel karakterler URL kodlanır;
yani,#karakteri%23olarak kodlanır - sortTür: string | null
_by sonuç sıralama parametreleri
isteğe bağlı alan
sonuçlarırelevance,average_cpc,costveyaclicksdeğerlerine göre azalan düzende sıralamak için bu parametreleri kullanın
varsayılan değer:relevance - tagTür: string | null
kullanıcı tanımlı görev tanımlayıcısı
isteğe bağlı alan
karakter sınırı 255
bu parametreyi görevi tanımlamak ve sonuçla eşleştirmek için kullanabilirsiniz
belirtilentagdeğerini yanıtındatanesnesinde bulacaksınız
- Tür: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo200
- Tür: number | null Biçim: doublecost
toplam görev maliyeti, USD
- Tür: integer | nullstatus
_code genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz
- Tür: string | nullstatus
_message genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- Tür: array (object | null)[] | nulltasks
görev dizisi
- Tür: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
- costTür: number | null Biçim: double
toplam görev maliyeti, USD
- dataTür: object | null
POST isteğinde belirttiğiniz parametrelerin aynısını içerir
- propertyTür: object | null
Name
- idTür: string | null
görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı
- pathTür: array (string | null)[] | null
URL yolu
- resultTür: object | null
sonuç dizisi
bu durumda değernullolur - resultTür: integer | null Biçim: int64
_count result dizisindeki öğe sayısı
- statusTür: integer | null
_code görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz
- statusTür: string | null
_message görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz
- timeTür: string | null
yürütme süresi, saniye
- Tür: integer | null Biçim: int64tasks
_count tasks dizisindeki görev sayısı
- Tür: integer | null Biçim: int64tasks
_error tasks dizisinde hata ile dönen görev sayısı
- Tür: string | nulltime
toplam yürütme süresi, saniye
- Tür: string | nullversion
API'nin geçerli sürümü
application/json - 400
İstek işlenemedi. İstek parametrelerini kontrol edin.
- 401
Geçerli bir Felo API anahtarı gerekir.
- 402
Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
- 403
Hesabın bu işlemi gerçekleştirme izni yok.
- 429
İstek veya harcama sınırına ulaşıldı.
- 502
Hizmet isteği tamamlayamadı.
- 503
API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
- 504
İstek işlenirken hizmet zaman aşımına uğradı.
- default
Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir
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
}
]
}