v0.2.0-beta

OpenAPI 3.1.0

Canlı ‘Bing Ads Audience Estimation’ Görevlerini Oluşturma

Felo API Support

MIT

Sunucu

https://openapi.felo.ai

İstemci Kitaplıkları

Shell Curl

DataForSEO

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

DataForSEO İşlemler

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

Canlı ‘Bing Ads Audience Estimation’ Görevlerini Oluşturma

Verilen bid ve daily_budget ile ulaşılabilen Bing Ads hedef kitlesini, location_code, age, sektör ve meslek fonksiyonu ile daraltarak tahmin eder. 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. Sektör ve meslek fonksiyonu değerleri get_dataforseo_keywords_bing_audience_industries ve get_dataforseo_keywords_bing_audience_job_functions içinden gelir — ikisi de ücretsizdir ve ikisini de istek oluşturmadan önce okumaya değer. Bu uç noktanın gönderme ve getirme ikizleri, beklenemeyecek kadar büyük partiler için aynı işi eşzamansız olarak ve aynı fiyata yapar.

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.

Gövde

application/json

Tür: array (object | null)[]
- age
  Tür: array string[] | null
  
  hedefleme için yaş aralığı seçimi
  olası değerler: eighteen_to_twenty_four, fifty_to_sixty_four, sixty_five_and_above, thirteen_to_seventeen, thirty_five_to_forty_nine, twenty_five_to_thirty_four, unknown, zero_to_twelve
- bid
  Tür: number | null
  
  USD cinsinden istenen teklif değeri
  maksimum değer: 1000
- daily_budget
  Tür: number | null
  
  USD cinsinden günlük kampanya bütçesi değeri
  maksimum değer: 10000
- gender
  Tür: array string[] | null
  
  hedeflenecek cinsiyet
  olası değerler: male, female, unknown
- industry
  Tür: array string[] | null
  
  LinkedIn profil hedeflemesi sektörü
  
  bu alanı kullanırsanız, kullanılabilir sektör adlarının ve industry_id değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries adresine ayrı bir istek göndererek alabilirsiniz
  
  örnek: 806301758
- job_function
  Tür: array string[] | null
  
  LinkedIn profil hedeflemesi iş işlevi
  
  bu alanı kullanırsanız, kullanılabilir iş işlevi adlarının ve job_function_id değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions adresine ayrı bir istek göndererek alabilirsiniz
  
  örnek: 806300451
- location_code
  Tür: integer
  
  arama motoru konum kodu
  location_name veya location_coordinate belirtmezseniz zorunlu alan
  bu alanı kullanırsanız location_name veya location_coordinate belirtmeniz gerekmez
  kullanılabilir arama motoru konumlarının ve location_code değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/bing/locations adresine ayrı bir istek göndererek alabilirsiniz
  örnek:
  2840
- location_coordinate
  Tür: string
  
  bir konumun GPS koordinatları
  location_name veya location_code belirtmezseniz zorunlu alan
  bu alanı kullanırsanız location_name veya location_code belirtmeniz gerekmez
  location_coordinate parametresi "latitude,longitude,radius (in km)" biçiminde belirtilmelidir
  veriler, belirtilen koordinatların ait olduğu ülke için sağlanır
  örnek:
  29.6821525,-82.4098881,100
- location_name
  Tür: string
  
  arama motoru konumunun tam adı
  location_code veya location_coordinate belirtmezseniz zorunlu alan
  bu alanı kullanırsanız location_code veya location_coordinate belirtmeniz gerekmez
  kullanılabilir arama motoru konumlarının ve location_name değerlerinin listesini https://api.dataforseo.com/v3/keywords_data/bing/locations adresine ayrı bir istek göndererek alabilirsiniz
  örnek:
  London,England,United Kingdom

Yanıtlar

200
Tür: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

status_code
Tür: integer | null

genel durum kodu yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

genel bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

tasks
Tür: array (object | null)[] | null

görev dizisi

Tür: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
cost
Tür: number | null Biçim: double

toplam görev maliyeti, USD

data
Tür: object | null

POST isteğinde belirttiğiniz parametrelerin aynısını içerir

propertyName
Tür: object | null
id
Tür: string | null

görev tanımlayıcısı sistemimizde UUID biçiminde benzersiz görev tanımlayıcısı

path
Tür: array (string | null)[] | null

URL yolu

result
Tür: array (object | null)[] | null

sonuç dizisi

currency
Tür: string | null

para birimi adı

örnek: USDollar

est_audience_size
Tür: object | null · Response36Afe1097B20_AudienceEstimationInfo

tahmini aylık erişim kullanıcı sayısı aralığı

high
Tür: number | null Biçim: double

aralık sonucunun üst sınırını belirtir

low
Tür: number | null Biçim: double

aralık sonucunun alt sınırını belirtir

est_clicks
Tür: object | null · Response36Afe1097B20_AudienceEstimationInfo

tahmini aylık tıklama sayısı aralığı

high
Tür: number | null Biçim: double

aralık sonucunun üst sınırını belirtir

low
Tür: number | null Biçim: double

aralık sonucunun alt sınırını belirtir

est_cost_per_event
Tür: object | null · Response36Afe1097B20_AudienceEstimationInfo

etkinlik başına aralık sonuçlu tahmini maliyeti belirtir

high
Tür: number | null Biçim: double

aralık sonucunun üst sınırını belirtir

low
Tür: number | null Biçim: double

aralık sonucunun alt sınırını belirtir

est_ctr
Tür: object | null · Response36Afe1097B20_AudienceEstimationInfo

tahmini tıklama oranı aralığı

high
Tür: number | null Biçim: double

aralık sonucunun üst sınırını belirtir

low
Tür: number | null Biçim: double

aralık sonucunun alt sınırını belirtir

est_impressions
Tür: object | null · Response36Afe1097B20_AudienceEstimationInfo

tahmini aylık gösterim aralığı

high
Tür: number | null Biçim: double

aralık sonucunun üst sınırını belirtir

low
Tür: number | null Biçim: double

aralık sonucunun alt sınırını belirtir

est_reach_audience_size
Tür: integer | null Biçim: int64

tahmini aylık kullanıcı sayısı

est_reach_impressions
Tür: integer | null Biçim: int64

tahmini aylık gösterim sayısı

est_spend
Tür: object | null · Response36Afe1097B20_AudienceEstimationInfo

tahmini aylık harcama aralığı

high
Tür: number | null Biçim: double

aralık sonucunun üst sınırını belirtir

low
Tür: number | null Biçim: double

aralık sonucunun alt sınırını belirtir

events_lost_to_bid
Tür: integer | null Biçim: int64

yetersiz giriş teklifi nedeniyle kaybedilen etkinlik sayısını belirtir

events_lost_to_budget
Tür: integer | null

yetersiz giriş bütçesi nedeniyle kaybedilen etkinlik sayısını belirtir

suggested_bid
Tür: number | null

mevcut hedefleme altında önerilen teklif değeri

suggested_budget
Tür: number | null Biçim: double

mevcut hedefleme ve teklif altında önerilen günlük bütçe değeri

result_count
Tür: integer | null Biçim: int64

result dizisindeki öğe sayısı

status_code
Tür: integer | null

görevin durum kodu DataForSEO tarafından oluşturulur; şu aralıkta olabilir: 10000-60000 yanıt kodlarının tam listesini burada bulabilirsiniz

status_message
Tür: string | null

görevin bilgilendirme mesajı genel bilgilendirme mesajlarının tam listesini burada bulabilirsiniz

time
Tür: string | null

yürütme süresi, saniye

tasks_count
Tür: integer | null Biçim: int64

tasks dizisindeki görev sayısı

tasks_error
Tür: integer | null Biçim: int64

tasks dizisinde hata ile dönen görev sayısı

time
Tür: string | null

toplam yürütme süresi, saniye

version
Tür: string | null

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

post/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/bing/audience_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "location_coordinate": "29.6821525,-82.4098881,100",
    "age": [
      "twenty_five_to_thirty_four",
      "eighteen_to_twenty_four",
      "unknown"
    ],
    "bid": 1,
    "daily_budget": 24,
    "gender": [
      "male"
    ],
    "industry": [
      "806303407",
      "806301758"
    ],
    "job_function": [
      "806298607"
    ]
  }
]'

Şemayı göster

{
  "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": [
        {
          "est_impressions": {
            "high": null,
            "low": null
          },
          "est_audience_size": {
            "high": null,
            "low": null
          },
          "est_clicks": {
            "high": null,
            "low": null
          },
          "est_spend": {
            "high": null,
            "low": null
          },
          "est_cost_per_event": {
            "high": null,
            "low": null
          },
          "est_ctr": {
            "high": null,
            "low": null
          },
          "suggested_bid": null,
          "suggested_budget": null,
          "events_lost_to_bid": null,
          "events_lost_to_budget": null,
          "est_reach_audience_size": null,
          "est_reach_impressions": null,
          "currency": null
        }
      ]
    }
  ]
}

Başarılı işlem

Canlı ‘Bing Ads Audience Estimation’ Görevlerini Oluşturma

Kimlik doğrulamaRequired

DataForSEO

Canlı ‘Bing Ads Audience Estimation’ Görevlerini Oluşturma

Fiyatlandırma referansı