Felo API PlatformFelo API Platform
Tất cả endpoint của DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Lấy kết quả ‘Ads Traffic By Keywords’ theo id

Felo API Support
MIT
Máy chủ:https://openapi.felo.ai
Thư viện client
Shell Curl

DataForSEO

​

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

DataForSEO Thao tác

Lấy kết quả ‘Ads Traffic By Keywords’ theo id

​

Truy xuất dự báo lưu lượng Google Ads đang xếp hàng theo id: số lần hiển thị, nhấp, chi phí và vị trí trung bình dự kiến cho mức giá thầu bạn đã chỉ định. Được bọc trong phong bì của DataForSEO: dữ liệu ở tasks[0].result, kết quả ở tasks[0].status_code - yêu cầu bị từ chối vẫn trả về HTTP 200. Khác với các endpoint khối lượng, đây là dự báo chứ không phải đo lường - các con số thay đổi theo bid và match.

Tham chiếu giá

  • Đo lường: Chi phí phản hồi được báo cáo.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.012.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Tham số đường dẫn
  • id
    Kiểu: string
    bắt buộc

    mã định danh tác vụ
    mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID
    bạn có thể dùng nó trong vòng 30 ngày để yêu cầu kết quả của tác vụ bất kỳ lúc nào

Phản hồi
  • 200
    Kiểu: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetResponseInfo
    • cost
      Kiểu: number | null Định dạng: double

      tổng chi phí tác vụ, USD

    • status_code
      Kiểu: integer | null

      mã trạng thái chung; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây

    • status_message
      Kiểu: string | null

      thông điệp thông tin chung; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

    • tasks
      Kiểu: array (object | null)[] | null

      mảng tác vụ

      • Kiểu: object | null · Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskGetTaskInfo
        • cost
          Kiểu: number | null Định dạng: double

          tổng chi phí tác vụ, USD

        • data
          Kiểu: object | null

          chứa các tham số giống như bạn đã chỉ định trong yêu cầu POST

          • propertyName
            Kiểu: object | null
        • id
          Kiểu: string | null

          mã định danh tác vụ; mã định danh tác vụ duy nhất trong hệ thống của chúng tôi ở định dạng UUID

        • path
          Kiểu: array (string | null)[] | null

          Đường dẫn URL

        • result
          Kiểu: array (object | null)[] | null

          mảng kết quả

          • average_cpc
            Kiểu: number | null Định dạng: double

            giá trị chi phí mỗi lần nhấp trung bình
            biểu thị chi phí mỗi lần nhấp (USD) ước tính cho một từ khóa dựa trên khoảng thời gian đã chỉ định và dữ liệu lịch sử;
            nếu không có dữ liệu, giá trị là null

          • bid
            Kiểu: number | null

            giá thầu tùy chỉnh tối đa
            giá thầu bạn đã chỉ định khi tạo tác vụ
            biểu thị mức giá bạn sẵn sàng trả cho một quảng cáo
            giá trị bạn chỉ định càng cao, bạn càng nhận được nhiều chỉ số và chi phí hơn trong phản hồi
            tìm hiểu thêm trong bài viết trung tâm trợ giúp này

          • clicks
            Kiểu: number | null

            số lần nhấp vào quảng cáo
            số lần nhấp mà quảng cáo dự kiến nhận được trong khoảng thời gian đã chỉ định
            nếu không có dữ liệu, giá trị là null

          • cost
            Kiểu: number | null

            chi phí cho quảng cáo
            số tiền sẽ bị tính khi chạy quảng cáo trong khoảng thời gian đã chỉ định
            nếu không có dữ liệu, giá trị là null

          • ctr
            Kiểu: number | null Định dạng: double

            tỷ lệ nhấp (CTR) dự kiến của quảng cáo
            số lần nhấp mà quảng cáo dự kiến nhận được chia cho số lượt hiển thị quảng cáo;
            Lưu ý: tham số đã ngừng dùng, giá trị luôn là null

          • date_interval
            Kiểu: string | null

            khoảng thời gian dự báo trong mảng POST

          • impressions
            Kiểu: integer | null

            số lượt hiển thị quảng cáo dự kiến
            số lượt hiển thị mà quảng cáo dự kiến nhận được trong khoảng thời gian đã chỉ định
            Lưu ý: tham số đã ngừng dùng, giá trị luôn là null

          • keyword
            Kiểu: string | null

            từ khóa trong mảng POST
            chỉ số được cung cấp cho tất cả các từ khóa đã chỉ định trong mảng POST

          • language_code
            Kiểu: string | null

            mã ngôn ngữ trong một mảng POST
            nếu không có dữ liệu, giá trị là_nulln

          • location_code
            Kiểu: integer | null

            mã vị trí trong một mảng POST
            nếu không có dữ liệu, giá trị là_nulln

          • match
            Kiểu: string | null

            kiểu đối sánh từ khóa
            có thể nhận các giá trị sau: exact, broad, phrase

          • search_partners
            Kiểu: boolean | null

            bao gồm các đối tác tìm kiếm Google
            giá trị luôn là false

        • result_count
          Kiểu: integer | null Định dạng: int64

          số phần tử trong mảng kết quả

        • status_code
          Kiểu: integer | null

          mã trạng thái của tác vụ do DataForSEO tạo; có thể nằm trong khoảng sau: 10000-60000; bạn có thể tìm danh sách đầy đủ các mã phản hồi tại đây

        • status_message
          Kiểu: string | null

          thông điệp thông tin của tác vụ; bạn có thể tìm danh sách đầy đủ các thông điệp thông tin chung tại đây

        • time
          Kiểu: string | null

          thời gian thực thi, giây

    • tasks_count
      Kiểu: integer | null Định dạng: int64

      số lượng tác vụ trong mảng tasks

    • tasks_error
      Kiểu: integer | null Định dạng: int64

      số lượng tác vụ trong mảng tasks được trả về kèm lỗi

    • time
      Kiểu: string | null

      tổng thời gian thực thi, giây

    • version
      Kiểu: string | null

      phiên bản hiện tại của API

    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    application/json
Request Example for get/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "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": [
        {
          "keyword": null,
          "location_code": null,
          "language_code": null,
          "date_interval": null,
          "search_partners": null,
          "bid": null,
          "match": null,
          "impressions": null,
          "ctr": null,
          "average_cpc": null,
          "cost": null,
          "clicks": null
        }
      ]
    }
  ]
}

Thao tác thành công

Get ‘Ads Traffic By Keywords’ Results by id