v0.2.0-beta

OpenAPI 3.1.0

Menyetel Tugas ‘Ad Traffic By Keywords’

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

Shell Curl

DataForSEO

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

DataForSEO Operasi

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

Menyetel Tugas ‘Ad Traffic By Keywords’

Mengantrekan ramalan klik, tayangan, dan perbelanjaan untuk keywords pada bid dan jenis match tertentu, sambil mengembalikan id tugas. search_partners merangkumi rangkaian rakan kongsi Google. Dibungkus dalam envelope DataForSEO: data di tasks[0].result, hasil di tasks[0].status_code - permintaan yang ditolak tetap mengembalikan HTTP 200. Ini satu-satunya endpoint Google Ads di sini tanpa varian langsung - ramalan sentiasa diantrekan. Ambil dengan get_dataforseo_keywords_gads_ad_traffic_fetch.

Referensi harga

Metering: Biaya respons yang dilaporkan.
Estimasi referensi per permintaan: USD 0.09.
Pengali pelanggan referensi: 1.0. Jangan terapkan lagi pada jumlah pelanggan yang telah diselesaikan.

Hanya metadata referensi, bukan penawaran akun, harga yang dijamin, atau batas pengeluaran. Kredit sumber daya bukanlah kredit Felo. Biaya akhir mengikuti catatan tagihan Felo.

Isi

application/json

Tipe: array (object | null)[]
- bid
  Tipe: number
  
  tawaran kustom maksimum
  field wajib
  data yang dikumpulkan akan didasarkan pada nilai ini
  nilai ini menunjukkan harga yang bersedia Anda bayar untuk sebuah iklan; semakin tinggi nilai yang Anda tentukan di sini, semakin tinggi nilai yang akan Anda terima dalam metrik yang dikembalikan
  pelajari lebih lanjut di artikel pusat bantuan ini
- date_from
  Tipe: string
  
  tanggal mulai rentang waktu peramalan
  field wajib jika Anda menentukan date_to
  jika Anda menentukan date_from dan date_to, Anda tidak perlu menentukan date_interval
  nilai minimum adalah tanggal besok
  nilai yang Anda tentukan di date_from tidak boleh lebih lambat dari date_to
  format tanggal: "yyyy-mm-dd"
  contoh:
  "2021-10-30"jika endpoint Status mengembalikan false di field actual_data, date_from dapat diatur ke bulan sebelum bulan lalu dan sebelumnya;
  jika endpoint Status mengembalikan true di field actual_data, date_from dapat diatur ke bulan lalu dan sebelumnya
- date_interval
  Tipe: string | null
  
  interval tanggal peramalan
  field opsional
  jika Anda menentukan date_interval, Anda tidak perlu menentukan date_from dan date_to
  nilai yang mungkin: next_week, next_month, next_quarter
  nilai default: next_month
- date_to
  Tipe: string
  
  tanggal akhir rentang waktu peramalan
  field wajib jika Anda menentukan date_from
  jika Anda menentukan date_from dan date_to, Anda tidak perlu menentukan date_interval
  nilai minimum adalah date_from +1 hari
  nilai maksimum adalah hari dan bulan saat ini pada tahun berikutnya
  format tanggal: "yyyy-mm-dd"
  contoh:
  "2022-10-30"
- keywords
  Tipe: array string[]
  
  kata kunci
  field wajib
  Jumlah maksimum kata kunci yang dapat Anda tentukan: 1000
  Jumlah maksimum karakter untuk setiap kata kunci: 80
  Jumlah maksimum kata untuk setiap frasa kata kunci: 10
  kata kunci yang Anda tentukan akan diubah ke format huruf kecil
  Catatan #1: Google Ads mungkin tidak mengembalikan data untuk kelompok kata kunci tertentu;
  Catatan #2: Google Ads memberikan nilai volume penelusuran gabungan untuk kelompok kata kunci serupa
  untuk memperoleh volume penelusuran bagi kata kunci serupa, kami menyarankan mengirimkan kata kunci tersebut dalam permintaan terpisah;
  Catatan #3: Google Ads tidak mengizinkan penggunaan simbol dan karakter tertentu (misalnya: simbol UTF, emoji), sehingga Anda tidak dapat menggunakannya saat menetapkan tugas;
  untuk mempelajari lebih lanjut simbol dan karakter yang dapat digunakan, silakan merujuk ke artikel ini
  
  pelajari lebih lanjut tentang aturan dan batasan field keyword dan keywords di API DataForSEO di artikel Pusat Bantuan
- language_code
  Tipe: string | null
  
  kode bahasa mesin pencari
  field opsional
  Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  contoh:
  en
- language_name
  Tipe: string | null
  
  nama lengkap bahasa mesin pencari
  field opsional
  Anda dapat memperoleh daftar bahasa mesin pencari yang tersedia beserta language_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/languages
  contoh:
  English
- location_code
  Tipe: integer | null
  
  kode lokasi mesin pencari
  field opsional
  jika Anda tidak menentukan lokasi, Anda akan menerima hasil seluruh dunia, yaitu untuk semua lokasi yang tersedia;
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_coordinate;
  Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_code-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  contoh:
  2840
- location_coordinate
  Tipe: string | null
  
  koordinat GPS suatu lokasi
  field opsional
  jika Anda tidak menentukan lokasi, Anda akan menerima hasil seluruh dunia, yaitu untuk semua lokasi yang tersedia;
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_name atau location_code;
  parameter location_coordinate harus ditentukan dalam format "latitude,longitude";
  data akan diberikan untuk negara tempat koordinat yang ditentukan berada;
  contoh:
  52.6178549,-155.352142
- location_name
  Tipe: string | null
  
  nama lengkap lokasi mesin pencari
  field opsional
  jika Anda tidak menentukan lokasi, Anda akan menerima hasil seluruh dunia, yaitu untuk semua lokasi yang tersedia;
  jika Anda menggunakan field ini, Anda tidak perlu menentukan location_code atau location_coordinate
  Anda dapat memperoleh daftar lokasi mesin pencari yang tersedia beserta location_name-nya dengan membuat permintaan terpisah ke https://api.dataforseo.com/v3/keywords_data/google_ads/locations
  contoh:
  London,England,United Kingdom
- match
  Tipe: string
  
  jenis pencocokan kata kunci
  field wajib
  dapat bernilai sebagai berikut: exact, broad, phrase
- pingback_url
  Tipe: string | null
  
  URL notifikasi tugas yang selesai
  field opsional
  saat tugas selesai, kami akan memberi tahu Anda melalui permintaan GET yang dikirim ke URL yang Anda tentukan
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
  contoh:
  http://your-server.com/pingscript?id=$id
  http://your-server.com/pingscript?id=$id&tag=$tag
  Catatan: karakter khusus dalam pingback_url akan dienkode URL;
  yaitu, karakter # akan dienkode menjadi %23
  
  pelajari lebih lanjut di Pusat Bantuan kami
- postback_url
  Tipe: string | null
  
  URL untuk mengirim hasil tugas
  field opsional
  setelah tugas selesai, kami akan mengirim permintaan POST dengan hasilnya yang dikompresi dalam format gzip ke postback_url yang Anda tentukan
  Anda dapat menggunakan string ‘$id’ sebagai variabel $id dan ‘$tag’ sebagai variabel $tag berenkode URL. Kami akan menyetel nilai yang diperlukan sebelum mengirim permintaan.
  contoh:
  http://your-server.com/postbackscript?id=$id
  http://your-server.com/postbackscript?id=$id&tag=$tag
  Catatan: karakter khusus dalam postback_url akan dienkode URL;
  yaitu, karakter # akan dienkode menjadi %23
  
  pelajari lebih lanjut di Pusat Bantuan kami
- sort_by
  Tipe: string | null
  
  parameter pengurutan hasil
  field opsional
  gunakan parameter ini untuk mengurutkan hasil berdasarkan relevance, average_cpc, cost, atau clicks dalam urutan menurun
  nilai default: relevance
- tag
  Tipe: string | null
  
  pengenal tugas yang ditentukan pengguna
  field opsional
  batas karakter adalah 255
  Anda dapat menggunakan parameter ini untuk mengidentifikasi tugas dan mencocokkannya dengan hasil
  Anda akan menemukan nilai tag yang ditentukan di objek data pada respons

Respons

200
Tipe: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

status_code
Tipe: integer | null

kode status umum; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi umum; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

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

array tugas

Tipe: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo
cost
Tipe: number | null Format: double

total biaya tugas, USD

data
Tipe: object | null

berisi parameter yang sama dengan yang Anda tentukan dalam permintaan POST

propertyName
Tipe: object | null
id
Tipe: string | null

pengenal tugas; pengenal tugas unik di sistem kami dalam format UUID

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

Jalur URL

result
Tipe: object | null

array hasil
dalam kasus ini, nilainya akan menjadi null

result_count
Tipe: integer | null Format: int64

jumlah elemen dalam array hasil

status_code
Tipe: integer | null

kode status tugas yang dihasilkan oleh DataForSEO; dapat berada dalam rentang berikut: 10000-60000; Anda dapat menemukan daftar lengkap kode respons di sini

status_message
Tipe: string | null

pesan informasi tugas; Anda dapat menemukan daftar lengkap pesan informasi umum di sini

time
Tipe: string | null

waktu eksekusi, detik

tasks_count
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks

tasks_error
Tipe: integer | null Format: int64

jumlah tugas dalam array tasks yang dikembalikan dengan error

time
Tipe: string | null

total waktu eksekusi, detik

version
Tipe: string | null

versi API saat ini
application/json
400

Permintaan tidak dapat diproses. Periksa parameter permintaan.
401

Kunci API Felo yang valid diperlukan.
402

Permintaan tidak dapat dilanjutkan karena persyaratan penagihan belum terpenuhi.
403

Akun tidak diizinkan melakukan operasi ini.
429

Batas permintaan atau batas pengeluaran telah tercapai.
502

Layanan tidak dapat menyelesaikan permintaan.
503

API atau layanan penagihan untuk sementara tidak tersedia.
504

Layanan kehabisan waktu saat memproses permintaan.
default

Respons error; respons passthrough upstream dapat menggunakan format penyedia

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"
    ]
  }
]'

Tampilkan Skema

{
  "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
    }
  ]
}

Operasi berhasil

Menyetel Tugas ‘Ad Traffic By Keywords’

AutentikasiRequired

DataForSEO

Menyetel Tugas ‘Ad Traffic By Keywords’

Referensi harga