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

Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมใช้งานแล้ว โดย API ใหม่จะมี ความยืดหยุ่นที่เพิ่มขึ้นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลไว้ในแอปพลิเคชันการรายงานของคุณ และกระบวนการต่างๆ ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลไปยังและการใช้การรายงาน Search Ads 360 เวอร์ชันใหม่ 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 1000
วิดเจ็ต http://www.example.com 2012-04-01 2012-06-30 1000
วิดเจ็ต http://www.example.com 2012-07-01 2012-09-30 1000
วิดเจ็ต http://www.example.com 2012-10-01 2012-12-31 3000

โปรดทราบว่ารายงานที่มีการแบ่งกลุ่มจะแสดงแถวต่อเมื่อมีข้อมูลสำหรับกลุ่มเท่านั้น ตัวอย่างเช่น ในรายงานคีย์เวิร์ดที่มีคอลัมน์ 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 อย่างนี้ จะแสดงวันที่เริ่มต้นและวันที่สิ้นสุดของช่วงเวลา ซึ่งช่วยยืนยันว่าคุณได้ ที่รวมข้อมูลสำหรับช่วงเวลาทั้งหมดแต่ละช่วง

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

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