# ตั้งงาน ‘Ad Traffic By Keywords’

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/keywords_data/google_ads/ad_traffic_by_keywords/task_post`

**Tags:** DataForSEO

เข้าคิวการพยากรณ์คลิก การแสดงผล และค่าใช้จ่ายสำหรับ `keywords` ตาม `bid` และประเภท `match` ที่กำหนด และคืน `id` ของงาน `search_partners` รวมเครือข่ายพาร์ตเนอร์ของ Google ห่อด้วย envelope ของ DataForSEO: ข้อมูลอยู่ใน `tasks[0].result` ผลลัพธ์อยู่ใน `tasks[0].status_code` — คำขอที่ถูกปฏิเสธยังคงคืน HTTP 200 นี่เป็น endpoint เดียวของ Google Ads ที่นี่ที่ไม่มีรูปแบบเรียลไทม์ — การพยากรณ์เข้าคิวเสมอ ดึงผลด้วย `get_dataforseo_keywords_gads_ad_traffic_fetch`

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

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

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

## Related links

- [Google Ads อาจไม่คืนข้อมูลสำหรับคีย์เวิร์ดบางกลุ่ม](<https://dataforseo.com/help-center/no-search-volume-data-for-some-keywords>)
- [Google Ads ให้ค่าปริมาณการค้นหารวมสำหรับกลุ่มคีย์เวิร์ดที่คล้ายกัน](<https://dataforseo.com/help-center/sv-broad-exact-phrase-match>)
- [บทความนี้](<https://dataforseo.com/help-center/using-symbols-in-keywords-when-setting-a-google-ads-task>)
- [บทความ Help Center](<https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis>)
- [บทความ Help Center นี้](<https://dataforseo.com/help-center/configuring-bid>)
- [endpoint สถานะ](<https://docs.dataforseo.com/v3/keywords_data/google_ads/status/>)
- [Help Center](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "keywords": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "<em>คีย์เวิร์ด</em><br><strong>ฟิลด์ที่จำเป็น</strong><br>จำนวนคีย์เวิร์ดสูงสุดที่ระบุได้: 1000<br>จำนวนอักขระสูงสุดสำหรับแต่ละคีย์เวิร์ด: 80<br>จำนวนคำสูงสุดสำหรับแต่ละวลีคีย์เวิร์ด: 10<br>คีย์เวิร์ดที่ระบุจะถูกแปลงเป็นตัวพิมพ์เล็ก<br><strong>หมายเหตุ #1:</strong> Google Ads อาจไม่คืนข้อมูลสำหรับคีย์เวิร์ดบางกลุ่ม;<br><strong>หมายเหตุ #2:</strong> Google Ads ให้ค่าปริมาณการค้นหารวมสำหรับกลุ่มคีย์เวิร์ดที่คล้ายกัน<br>เพื่อให้ได้ปริมาณการค้นหาสำหรับคีย์เวิร์ดที่คล้ายกัน เราแนะนำให้ส่งคีย์เวิร์ดดังกล่าวในคำขอแยกกัน<br><strong>หมายเหตุ #3:</strong> Google Ads ไม่อนุญาตให้ใช้สัญลักษณ์และอักขระบางประเภท (เช่น สัญลักษณ์ UTF, อีโมจิ) จึงใช้ไม่ได้เมื่อตั้งงาน<br>ดูข้อมูลเพิ่มเติมว่าสามารถใช้สัญลักษณ์และอักขระใดได้บ้างได้ในบทความนี้<p>ดูรายละเอียดกฎและข้อจำกัดของฟิลด์ <code>keyword</code> และ <code>keywords</code> ใน DataForSEO API ได้ในบทความ Help Center"
          },
          "bid": {
            "type": "number",
            "description": "<em>ราคาเสนอสูงสุดที่กำหนดเอง</em><br><strong>ฟิลด์ที่จำเป็น</strong><br>ข้อมูลที่เก็บรวบรวมจะอ้างอิงจากค่านี้<br>ค่านี้หมายถึงราคาที่คุณยินดีจ่ายสำหรับโฆษณา ยิ่งระบุค่าสูงขึ้น ค่าที่ได้ในเมตริกที่ส่งคืนก็จะยิ่งสูงขึ้น<br>ดูข้อมูลเพิ่มเติมได้ในบทความ Help Center นี้"
          },
          "match": {
            "type": "string",
            "description": "<em>ประเภทการจับคู่คีย์เวิร์ด</em><br><strong>ฟิลด์ที่จำเป็น</strong><br>รับค่าต่อไปนี้ได้: <code>exact</code>, <code>broad</code>, <code>phrase</code>"
          },
          "location_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>ชื่อเต็มของสถานที่ของเครื่องมือค้นหา</em><br>ฟิลด์ที่ไม่บังคับ<br>หากไม่ระบุสถานที่ คุณจะได้รับผลลัพธ์ทั่วโลก กล่าวคือ สำหรับสถานที่ที่มีให้บริการทั้งหมด;<br><strong>หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ <code>location_code</code> หรือ <code>location_coordinate</code></strong><br>คุณสามารถรับรายการสถานที่ของเครื่องมือค้นหาที่ใช้ได้พร้อม <code>location_name</code> ได้โดยส่งคำขอแยกไปที่ <code>https://api.dataforseo.com/v3/keywords_data/google_ads/locations</code><br>ตัวอย่าง:<br><code class=\"long-string\">London,England,United Kingdom</code>"
          },
          "location_code": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>รหัสสถานที่ของเครื่องมือค้นหา</em><br>ฟิลด์ที่ไม่บังคับ<br>หากไม่ระบุสถานที่ คุณจะได้รับผลลัพธ์ทั่วโลก กล่าวคือ สำหรับสถานที่ที่มีให้บริการทั้งหมด;<br><strong>หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ <code>location_name</code> หรือ <code>location_coordinate</code></strong>;<br>คุณสามารถรับรายการสถานที่ของเครื่องมือค้นหาที่ใช้ได้พร้อม <code>location_code</code> ได้โดยส่งคำขอแยกไปที่ <code>https://api.dataforseo.com/v3/keywords_data/google_ads/locations</code><br>ตัวอย่าง:<br><code class=\"long-string\">2840</code>"
          },
          "location_coordinate": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>พิกัด GPS ของสถานที่</em><br>ฟิลด์ที่ไม่บังคับ<br>หากไม่ระบุสถานที่ คุณจะได้รับผลลัพธ์ทั่วโลก กล่าวคือ สำหรับสถานที่ที่มีให้บริการทั้งหมด;<br><strong>หากใช้ฟิลด์นี้ ไม่จำเป็นต้องระบุ <code>location_name</code> หรือ <code>location_code</code></strong>;<br>ต้องระบุพารามิเตอร์ <code>location_coordinate</code> ในรูปแบบ <em>\"latitude,longitude\"</em>;<br><strong>ข้อมูลจะถูกให้สำหรับประเทศที่พิกัดที่ระบุตั้งอยู่</strong>;<br>ตัวอย่าง:<br><code class=\"long-string\">52.6178549,-155.352142</code>"
          },
          "language_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>ชื่อเต็มของภาษาของเครื่องมือค้นหา</em><br>ฟิลด์ที่ไม่บังคับ<br>คุณสามารถรับรายการภาษาของเครื่องมือค้นหาที่ใช้ได้พร้อม <code>language_name</code> ได้โดยส่งคำขอแยกไปที่ <code>https://api.dataforseo.com/v3/keywords_data/google_ads/languages</code><br>ตัวอย่าง:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>รหัสภาษาของเครื่องมือค้นหา</em><br>ฟิลด์ที่ไม่บังคับ<br>คุณสามารถรับรายการภาษาของเครื่องมือค้นหาที่ใช้ได้พร้อม <code>language_code</code> ได้โดยส่งคำขอแยกไปที่ <code>https://api.dataforseo.com/v3/keywords_data/google_ads/languages</code><br>ตัวอย่าง:<br><code class=\"long-string\">en</code>"
          },
          "date_from": {
            "type": "string",
            "description": "<em>วันที่เริ่มต้นของช่วงเวลาคาดการณ์</em><br><strong>ฟิลด์ที่จำเป็นหากระบุ <code>date_to</code></strong><br><strong>หากระบุ <code>date_from</code> และ <code>date_to</code> ไม่จำเป็นต้องระบุ <code>date_interval</code></strong><br>ค่าต่ำสุดคือวันที่พรุ่งนี้<br>ค่าที่ระบุใน <code>date_from</code> ต้องไม่เกิน <code>date_to</code><br>รูปแบบวันที่: <code>\"yyyy-mm-dd\"</code><br>ตัวอย่าง:<br><code>\"2021-10-30\"</code>หากendpoint สถานะคืนค่า <code>false</code> ในฟิลด์ <code>actual_data</code> จะตั้ง <code>date_from</code> เป็นเดือนก่อนหน้าเดือนที่แล้วหรือก่อนหน้านั้นได้<br>หากendpoint สถานะคืนค่า <code>true</code> ในฟิลด์ <code>actual_data</code> จะตั้ง <code>date_from</code> เป็นเดือนที่แล้วหรือก่อนหน้านั้นได้"
          },
          "date_to": {
            "type": "string",
            "description": "<em>วันที่สิ้นสุดของช่วงเวลาคาดการณ์</em><br><strong>ฟิลด์ที่จำเป็นหากระบุ <code>date_from</code></strong><br><strong>หากระบุ <code>date_from</code> และ <code>date_to</code> ไม่จำเป็นต้องระบุ <code>date_interval</code></strong><br>ค่าต่ำสุดคือ <code>date_from</code> +1 วัน<br>ค่าสูงสุดคือวันและเดือนปัจจุบันของปีถัดไป<br>รูปแบบวันที่: <code>\"yyyy-mm-dd\"</code><br>ตัวอย่าง:<br><code>\"2022-10-30\"</code>"
          },
          "date_interval": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>ช่วงวันที่คาดการณ์</em><br>ฟิลด์ที่ไม่บังคับ<br><strong>หากระบุ <code>date_interval</code> ไม่จำเป็นต้องระบุ <code>date_from</code> และ <code>date_to</code></strong><br>ค่าที่เป็นไปได้: <code>next_week</code>, <code>next_month</code>, <code>next_quarter</code><br>ค่าเริ่มต้น: <code>next_month</code>"
          },
          "sort_by": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>พารามิเตอร์การเรียงลำดับผลลัพธ์</em><br>ฟิลด์ที่ไม่บังคับ<br>ใช้พารามิเตอร์เหล่านี้เพื่อเรียงลำดับผลลัพธ์ตาม <code>relevance</code>, <code>average_cpc</code>, <code>cost</code> หรือ <code>clicks</code> จากมากไปน้อย<br>ค่าเริ่มต้น: <code>relevance</code>"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL สำหรับส่งผลลัพธ์ของงาน</em><br>ฟิลด์ไม่บังคับ<br>เมื่องานเสร็จสิ้น เราจะส่งคำขอ POST พร้อมผลลัพธ์ที่บีบอัดในรูปแบบ <code>gzip</code> ไปยัง <code>postback_url</code> ที่คุณระบุ<br>คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร <code>$id</code> และ ‘$tag’ เป็นตัวแปร <code>$tag</code> ที่เข้ารหัส URL ได้ เราจะตั้งค่าที่จำเป็นก่อนส่งคำขอ<br>ตัวอย่าง:<br><code>http://your-server.com/postbackscript?id=$id</code><br><code>http://your-server.com/postbackscript?id=$id&amp;tag=$tag</code><br><strong>หมายเหตุ:</strong> อักขระพิเศษใน <code>postback_url</code> จะถูกเข้ารหัส URL;<br>กล่าวคือ อักขระ <code>#</code> จะถูกเข้ารหัสเป็น <code>%23</code><p>ดูข้อมูลเพิ่มเติมได้ที่Help Center ของเรา"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>URL แจ้งเตือนเมื่องานเสร็จสิ้น</em><br>ฟิลด์ไม่บังคับ<br>เมื่องานเสร็จสิ้น เราจะแจ้งให้คุณทราบผ่านคำขอ GET ที่ส่งไปยัง URL ที่คุณระบุ<br>คุณสามารถใช้สตริง ‘$id’ เป็นตัวแปร <code>$id</code> และ ‘$tag’ เป็นตัวแปร <code>$tag</code> ที่เข้ารหัส URL ได้ เราจะตั้งค่าที่จำเป็นก่อนส่งคำขอ<br>ตัวอย่าง:<br><code>http://your-server.com/pingscript?id=$id</code><br><code>http://your-server.com/pingscript?id=$id&amp;tag=$tag</code><br><strong>หมายเหตุ:</strong> อักขระพิเศษใน <code>pingback_url</code> จะถูกเข้ารหัส URL;<br>กล่าวคือ อักขระ <code>#</code> จะถูกเข้ารหัสเป็น <code>%23</code><p>ดูข้อมูลเพิ่มเติมได้ที่Help Center ของเรา"
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>ตัวระบุงานที่ผู้ใช้กำหนด</em><br>ฟิลด์ไม่บังคับ<br><em>จำกัด 255 อักขระ</em><br>ใช้พารามิเตอร์นี้เพื่อระบุงานและจับคู่กับผลลัพธ์<br>คุณจะพบค่า <code>tag</code> ที่ระบุในออบเจ็กต์ <code>data</code> ของการตอบกลับ"
          }
        },
        "example": [
          {
            "language_code": "en",
            "location_code": 2840,
            "bid": 999,
            "match": "exact",
            "keywords": [
              "seo marketing"
            ]
          }
        ]
      }
    ]
  },
  "example": [
    {
      "language_code": "en",
      "location_code": 2840,
      "bid": 999,
      "match": "exact",
      "keywords": [
        "seo marketing"
      ]
    }
  ]
}
```

## Responses

### 200 — ดำเนินการสำเร็จ

Headers:
- `X-Request-Id` (string) — ตัวระบุคำขอที่ต้องระบุเมื่อติดต่อฝ่ายสนับสนุนของ Felo

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo"
    }
  ]
}
```

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

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

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

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

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

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

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

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

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

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "เวอร์ชันปัจจุบันของ API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "รหัสสถานะทั่วไป\nคุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "ข้อความข้อมูลทั่วไป\nคุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "เวลาดำเนินการทั้งหมด (วินาที)"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "ค่าใช้จ่ายรวมของงาน, USD",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "จำนวนงานในอาร์เรย์ tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "จำนวนงานในอาร์เรย์ tasks ที่ส่งคืนพร้อมข้อผิดพลาด",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "ตัวระบุงาน\nตัวระบุงานที่ไม่ซ้ำกันในระบบของเราในรูปแบบ UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "รหัสสถานะของงาน\nสร้างโดย DataForSEO โดยอยู่ในช่วงต่อไปนี้ได้: 10000-60000\nคุณสามารถดูรายการรหัสการตอบกลับทั้งหมดได้ที่นี่"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "ข้อความข้อมูลของงาน\nคุณสามารถดูรายการข้อความข้อมูลทั่วไปทั้งหมดได้ที่นี่"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "เวลาดำเนินการ, วินาที"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "ค่าใช้จ่ายรวมของงาน, USD",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "จำนวนองค์ประกอบในอาร์เรย์ result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "พาธ URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "มีพารามิเตอร์เดียวกับที่คุณระบุในคำขอ POST"
    }
  }
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>อาร์เรย์ของงาน</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_KeywordsDataGoogleAdsAdTrafficByKeywordsTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>อาร์เรย์ของผลลัพธ์</em><br>ในกรณีนี้ ค่าจะเป็น <code>null</code>"
        }
      }
    }
  ]
}
```
