รายงานที่แบ่งกลุ่ม

Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว โดย API ใหม่นี้จะช่วยเพิ่มความยืดหยุ่นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลเข้ากับแอปพลิเคชันและกระบวนการรายงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลรวมถึงการใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

Search Ads 360 API จะแสดงเฉพาะข้อมูลรวม เว้นแต่คุณจะขอข้อมูลที่แบ่งกลุ่มที่ละเอียดกว่า ตัวอย่างเช่น คอลัมน์จำนวนคลิกในรายงานคีย์เวิร์ดจะแสดงจำนวนคลิกทั้งหมดของคีย์เวิร์ดในช่วงเวลาที่คุณระบุ

keywordText	keywordLandingPage	จำนวนคลิก
วิดเจ็ต	http://www.example.com	6000

แต่หากคุณขอรายงานคีย์เวิร์ดที่แบ่งกลุ่มตามไตรมาส คุณจะเห็นแถว 1 แถวสำหรับแต่ละไตรมาส และคอลัมน์จำนวนคลิกจะแสดงรายการรวมรายไตรมาส

keywordText	keywordLandingPage	quarterStart	quarterEnd	จำนวนคลิก
วิดเจ็ต	http://www.example.com	2012-01-01	2012-03-31	1,000
วิดเจ็ต	http://www.example.com	2012-04-01	2012-06-30	1,000
วิดเจ็ต	http://www.example.com	2012-07-01	2012-09-30	1,000
วิดเจ็ต	http://www.example.com	2012-10-01	2012-12-31	3,000

โปรดทราบว่ารายงานที่แบ่งกลุ่มจะแสดงแถวก็ต่อเมื่อมีข้อมูลพร้อมให้กลุ่มเท่านั้น เช่น ในรายงานคีย์เวิร์ดที่มีคอลัมน์ floodlightActivity คู่คีย์เวิร์ดและกิจกรรม Floodlight จะไม่ปรากฏในรายงานหากไม่มีเมตริกที่มาจากคอลัมน์ดังกล่าวในช่วงวันที่ของรายงาน

บางกลุ่มใช้ร่วมกับคอลัมน์ที่เจาะจงไม่ได้

บางกลุ่มอาจทำให้บางคอลัมน์แสดงผลข้อมูลที่ไม่ถูกต้อง เช่น การแบ่งกลุ่มตาม floodlightActivity จะมีความหมายก็ต่อเมื่อคุณรวมคอลัมน์ที่รายงานข้อมูล Floodlight เช่น dfaActions, dfaRevenue, dfaTransactions และ dfaWeightedActions ไว้ด้วย คอลัมน์ Conversion ประเภทอื่นๆ (เช่น adWordsConversions) หรือคอลัมน์ที่รายงานเมตริกเครื่องมือค้นหา (เช่น จำนวนคลิกและการแสดงผล) จะไม่มีข้อมูลที่รายงานโดย Floodlight จึงแสดงผลลัพธ์ค่าที่ไม่ถูกต้องหากคุณแบ่งกลุ่มรายงานตาม floodlightActivity

วิธีขอรายงานที่แบ่งกลุ่ม

หากต้องการขอรายงานที่แบ่งกลุ่ม ให้ใส่คอลัมน์ที่ระบุว่า segment เป็นลักษณะการทำงานในข้อมูลอ้างอิงประเภทของรายงาน

คำขอแบบอะซิงโครนัสต่อไปนี้มีไว้สำหรับรายงานคีย์เวิร์ดที่แบ่งกลุ่มตามไตรมาส คอลัมน์จำนวนคลิกในแต่ละแถวจะมีจำนวนคลิกรวมสำหรับไตรมาสนั้น

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
  

หมายเหตุ: โปรดระวังวันที่ หากต้องการขอรายงานรายไตรมาส โปรดตรวจสอบว่า timeRange ของรายงานครอบคลุมทั้งไตรมาส ไม่เช่นนั้นคุณจะเห็นผลลัพธ์เพียงบางส่วน ซึ่งอาจทำให้ผู้ใช้คิดว่าจำนวนคลิก รายได้ และอื่นๆ ลดลงอย่างมาก

การขอกลุ่มหลายกลุ่ม

คุณจะรวมคอลัมน์กลุ่มในคำขอได้มากกว่า 1 คอลัมน์ โปรดทราบดังต่อไปนี้

• หากคุณแบ่งกลุ่มตามสัปดาห์ เดือน หรือไตรมาส เราขอแนะนำให้ใส่ทั้งคอลัมน์เริ่มต้นและคอลัมน์สิ้นสุดในคำขอ เช่น ในรายงานรายไตรมาส ให้ใส่ทั้งคอลัมน์ quarterStart และ quarterEnd การรวมทั้ง 2 คอลัมน์นี้จะแสดงวันที่เริ่มต้นและวันที่สิ้นสุดของช่วงเวลา ซึ่งจะช่วยยืนยันว่าคุณได้รวมข้อมูลสําหรับแต่ละช่วงเวลาทั้งหมดแล้ว

• คุณรวมกลุ่มที่เกี่ยวข้องกับเวลาประเภทต่างๆ ในคำขอเดียวกันไม่ได้ ตัวอย่างเช่น คุณไม่สามารถแบ่งกลุ่มตามไตรมาสและเดือนในคำขอเดียวกัน

• จำนวนแถวอาจเพิ่มขึ้นแบบทวีคูณเมื่อมีส่วนเพิ่มเติมแต่ละกลุ่ม