การตั้งงาน ‘Bing Ads Audience Estimation’ แบบ Live

Felo API Support

MIT

เซิร์ฟเวอร์

https://openapi.felo.ai

ไลบรารีไคลเอนต์

Shell Curl

DataForSEO

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

DataForSEO การดำเนินการ

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

การตั้งงาน ‘Bing Ads Audience Estimation’ แบบ Live

ประมาณขนาดผู้ชม Bing Ads ที่เข้าถึงได้ด้วย bid และ daily_budget ที่กำหนด โดยจำกัดด้วย location_code, age, อุตสาหกรรม และฟังก์ชันงาน ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน tasks[0].result ผลลัพธ์อยู่ใน tasks[0].status_code — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200 ค่าอุตสาหกรรมและฟังก์ชันงานมาจาก get_dataforseo_keywords_bing_audience_industries และ get_dataforseo_keywords_bing_audience_job_functions — ทั้งคู่ไม่มีค่าใช้จ่าย และควรอ่านก่อนสร้างคำขอ คู่แบบ submit และ fetch ของ endpoint นี้ทำงานเดียวกันแบบอะซิงโครนัส ในราคาเดียวกัน สำหรับชุดงานที่ใหญ่เกินกว่าจะรอผลได้

ข้อมูลอ้างอิงราคา

การวัดปริมาณการใช้งาน: ต้นทุนการตอบกลับที่รายงาน
ค่าประมาณคำขออ้างอิง: USD 0.09
ตัวคูณอ้างอิงสำหรับลูกค้า: 1.0 ห้ามนำไปใช้ซ้ำกับยอดที่เรียกเก็บจากลูกค้าแล้ว

เป็นข้อมูลเมตาอ้างอิงเท่านั้น ไม่ใช่ใบเสนอราคาสำหรับบัญชี ไม่ใช่ราคาที่รับประกัน และไม่ใช่เพดานการใช้จ่าย เครดิตของทรัพยากรไม่ใช่เครดิต Felo ยอดเรียกเก็บขั้นสุดท้ายเป็นไปตามบันทึกการเรียกเก็บเงินของ Felo

บอดี้

application/json

ประเภท: array (object | null)[]
- age
  ประเภท: array string[] | null
  
  การเลือกช่วงอายุสำหรับการกำหนดเป้าหมาย
  ค่าที่เป็นไปได้: 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
  ประเภท: number | null
  
  มูลค่าการเสนอราคาที่ต้องการในหน่วย USD
  ค่าสูงสุด: 1000
- daily_budget
  ประเภท: number | null
  
  มูลค่างบประมาณแคมเปญรายวันในหน่วย USD
  ค่าสูงสุด: 10000
- gender
  ประเภท: array string[] | null
  
  เพศเป้าหมาย
  ค่าที่เป็นไปได้: male, female, unknown
- industry
  ประเภท: array string[] | null
  
  อุตสาหกรรมของการกำหนดเป้าหมายโปรไฟล์ LinkedIn
  
  หากใช้ฟิลด์นี้ คุณจะได้รับรายการชื่ออุตสาหกรรมที่ใช้ได้พร้อม industry_id โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/industries
  
  ตัวอย่าง: 806301758
- job_function
  ประเภท: array string[] | null
  
  ฟังก์ชันงานของการกำหนดเป้าหมายโปรไฟล์ LinkedIn
  
  หากใช้ฟิลด์นี้ คุณจะได้รับรายการชื่อฟังก์ชันงานที่ใช้ได้พร้อม job_function_id โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/keywords_data/bing/audience_estimation/job_functions
  
  ตัวอย่าง: 806300451
- location_code
  ประเภท: integer
  
  รหัสสถานที่ของเครื่องมือค้นหา
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ location_name หรือ location_coordinate
  หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ location_name หรือ location_coordinate
  คุณสามารถรับรายการสถานที่ของเครื่องมือค้นหาที่ใช้ได้พร้อม location_code ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/keywords_data/bing/locations
  ตัวอย่าง:
  2840
- location_coordinate
  ประเภท: string
  
  พิกัด GPS ของสถานที่
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ location_name หรือ location_code
  หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ location_name หรือ location_code
  พารามิเตอร์ location_coordinate ต้องระบุในรูปแบบ "latitude,longitude,radius (in km)"
  ข้อมูลจะคืนสำหรับประเทศที่พิกัดที่ระบุตั้งอยู่
  ตัวอย่าง:
  29.6821525,-82.4098881,100
- location_name
  ประเภท: string
  
  ชื่อเต็มของสถานที่ของเครื่องมือค้นหา
  ฟิลด์ที่จำเป็นหากไม่ได้ระบุ location_code หรือ location_coordinate
  หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ location_code หรือ location_coordinate
  คุณสามารถรับรายการสถานที่ของเครื่องมือค้นหาที่ใช้ได้พร้อม location_name ได้โดยส่งคำขอแยกไปที่ https://api.dataforseo.com/v3/keywords_data/bing/locations
  ตัวอย่าง:
  London,England,United Kingdom

การตอบกลับ

200
ประเภท: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveResponseInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

status_code
ประเภท: integer | null

รหัสสถานะทั่วไป คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลทั่วไป คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

tasks
ประเภท: array (object | null)[] | null

อาร์เรย์ของงาน

ประเภท: object | null · Response36Afe1097B20_KeywordsDataBingAudienceEstimationLiveTaskInfo
cost
ประเภท: number | null รูปแบบ: double

ค่าใช้จ่ายรวมของงาน, USD

data
ประเภท: object | null

มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST

propertyName
ประเภท: object | null
id
ประเภท: string | null

ตัวระบุงาน ตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID

path
ประเภท: array (string | null)[] | null

พาธ URL

result
ประเภท: array (object | null)[] | null

อาร์เรย์ของผลลัพธ์

currency
ประเภท: string | null

ชื่อสกุลเงิน

ตัวอย่าง: USDollar

est_audience_size
ประเภท: object | null · Response36Afe1097B20_AudienceEstimationInfo

ช่วงจำนวนผู้เข้าถึงโดยประมาณรายเดือน

high
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตบนของผลลัพธ์ช่วง

low
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตล่างของผลลัพธ์ช่วง

est_clicks
ประเภท: object | null · Response36Afe1097B20_AudienceEstimationInfo

ช่วงจำนวนคลิกโดยประมาณรายเดือน

high
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตบนของผลลัพธ์ช่วง

low
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตล่างของผลลัพธ์ช่วง

est_cost_per_event
ประเภท: object | null · Response36Afe1097B20_AudienceEstimationInfo

ระบุต้นทุนโดยประมาณต่อเหตุการณ์พร้อมผลลัพธ์แบบช่วง

high
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตบนของผลลัพธ์ช่วง

low
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตล่างของผลลัพธ์ช่วง

est_ctr
ประเภท: object | null · Response36Afe1097B20_AudienceEstimationInfo

ช่วงอัตราการคลิกผ่านโดยประมาณ

high
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตบนของผลลัพธ์ช่วง

low
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตล่างของผลลัพธ์ช่วง

est_impressions
ประเภท: object | null · Response36Afe1097B20_AudienceEstimationInfo

ช่วงการแสดงผลโดยประมาณรายเดือน

high
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตบนของผลลัพธ์ช่วง

low
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตล่างของผลลัพธ์ช่วง

est_reach_audience_size
ประเภท: integer | null รูปแบบ: int64

จำนวนผู้ใช้โดยประมาณรายเดือน

est_reach_impressions
ประเภท: integer | null รูปแบบ: int64

การแสดงผลโดยประมาณรายเดือน

est_spend
ประเภท: object | null · Response36Afe1097B20_AudienceEstimationInfo

ช่วงการใช้จ่ายโดยประมาณรายเดือน

high
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตบนของผลลัพธ์ช่วง

low
ประเภท: number | null รูปแบบ: double

ระบุขอบเขตล่างของผลลัพธ์ช่วง

events_lost_to_bid
ประเภท: integer | null รูปแบบ: int64

ระบุจำนวนเหตุการณ์ที่สูญเสียเนื่องจากราคาเสนออินพุตไม่เพียงพอ

events_lost_to_budget
ประเภท: integer | null

ระบุจำนวนเหตุการณ์ที่สูญเสียเนื่องจากงบประมาณอินพุตไม่เพียงพอ

suggested_bid
ประเภท: number | null

มูลค่าราคาเสนอที่แนะนำภายใต้การกำหนดเป้าหมายปัจจุบัน

suggested_budget
ประเภท: number | null รูปแบบ: double

มูลค่างบประมาณรายวันที่แนะนำภายใต้การกำหนดเป้าหมายและราคาเสนอปัจจุบัน

result_count
ประเภท: integer | null รูปแบบ: int64

จำนวนองค์ประกอบในอาร์เรย์ result

status_code
ประเภท: integer | null

รหัสสถานะของงาน สร้างโดย DataForSEO โดยอยู่ในช่วงต่อไปนี้ได้: 10000-60000 คุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่

status_message
ประเภท: string | null

ข้อความข้อมูลของงาน คุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่

time
ประเภท: string | null

เวลาดำเนินการ, วินาที

tasks_count
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks

tasks_error
ประเภท: integer | null รูปแบบ: int64

จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด

time
ประเภท: string | null

เวลาดำเนินการทั้งหมด (วินาที)

version
ประเภท: string | null

เวอร์ชันปัจจุบันของ API
application/json
400

ไม่สามารถประมวลผลคำขอได้ ตรวจสอบพารามิเตอร์ของคำขอ
401

จำเป็นต้องใช้คีย์ API ของ Felo ที่ถูกต้อง
402

ไม่สามารถดำเนินการตามคำขอได้ เนื่องจากไม่เป็นไปตามข้อกำหนดด้านการเรียกเก็บเงิน
403

บัญชีไม่ได้รับอนุญาตให้ดำเนินการนี้
429

ถึงขีดจำกัดคำขอหรือการใช้จ่ายแล้ว
502

บริการไม่สามารถดำเนินการตามคำขอให้เสร็จสิ้นได้
503

API หรือบริการเรียกเก็บเงินไม่พร้อมใช้งานชั่วคราว
504

บริการหมดเวลาระหว่างประมวลผลคำขอ
default

การตอบกลับข้อผิดพลาด; การตอบกลับที่ส่งผ่านจากต้นทางอาจใช้รูปแบบของผู้ให้บริการ

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

แสดงสคีมา

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

ดำเนินการสำเร็จ

การตั้งงาน ‘Bing Ads Audience Estimation’ แบบ Live

การยืนยันตัวตนRequired

DataForSEO

การตั้งงาน ‘Bing Ads Audience Estimation’ แบบ Live

ข้อมูลอ้างอิงราคา