ประเภทรายงาน: payAndorganic

รายงาน payAndOrganic แสดงข้อความค้นหาที่เรียกให้โฆษณาของคุณปรากฏบน Google หรือเรียกให้ Google แสดงผลการค้นหาที่ไม่เสียค่าใช้จ่าย (ทั่วไป) สำหรับเว็บไซต์ของคุณ หรือทั้ง 2 อย่าง รายงานจะแสดงผลลัพธ์ก็ต่อเมื่อคุณตั้งค่ารายงานการค้นหาทั่วไปและเสียค่าใช้จ่ายสำหรับบัญชีเครื่องมือค้นหาที่จะรายงานแล้วเท่านั้น

รายงานนี้สามารถส่งคืนได้โดยคำขอแบบอะซิงโครนัสเท่านั้น (นั่นคือผ่านทาง Reports.request())

ขอข้อความที่ตัดตอนมา

ส่ง Reports.request() เนื้อหาของคำขอ แต่ระบุ "reportType": "paidAndOrganic"

{
...
  "reportType": "paidAndOrganic",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

สำหรับแต่ละคอลัมน์ที่คุณต้องการให้ส่งคืนหรือกรองในรายงาน ให้ระบุ columnName ที่แสดงในตารางด้านล่าง นอกจากนี้คุณยังสามารถเลือกระบุ headerText startDate, และ endDate โปรดทราบว่าบางคอลัมน์ไม่สามารถกรองได้ ดูที่ "กรองได้" ในตารางด้านล่าง

columnNameคำอธิบายลักษณะการทำงานประเภทกรองได้
agency ชื่อเอเจนซี แอตทริบิวต์ String ใช่
agencyId รหัสเอเจนซี DS แอตทริบิวต์ ID ใช่
advertiser ชื่อผู้ลงโฆษณา แอตทริบิวต์ String ใช่
advertiserId รหัสผู้ลงโฆษณา DS แอตทริบิวต์ ID ใช่
account ชื่อบัญชีเครื่องมือค้นหา แอตทริบิวต์ String ใช่
accountId รหัสบัญชีเครื่องมือค้นหา DS แอตทริบิวต์ ID ใช่
accountEngineId รหัสบัญชีในบัญชีเครื่องมือค้นหาภายนอก แอตทริบิวต์ String ใช่
accountType ประเภทบัญชีเครื่องมือค้นหา: Google AdWords, Bing Ads, Yahoo Japan Listing Ads, Yahoo Search Marketing, Yahoo Gemini, Baidu หรือ Comparison Shopping แอตทริบิวต์ Engine type ใช่
searchQuery ข้อความค้นหาที่ผู้ใช้ Google ป้อน แอตทริบิวต์ String ใช่
serpType

ประเภทผลการค้นหาที่ผู้ใช้ Google คลิก

โดยค่าที่เป็นไปได้มีดังนี้

  • การค้นหาทั่วไปเท่านั้น: ผู้ใช้ที่ป้อนคำค้นหานี้คลิกเฉพาะผลการค้นหาที่ไม่เสียค่าใช้จ่ายเท่านั้น
  • เสียค่าใช้จ่ายเท่านั้น: ผู้ใช้ที่ป้อนคำค้นหานี้คลิกโฆษณาเท่านั้น
  • แบบเสียค่าใช้จ่ายและแบบทั่วไป: ผู้ใช้บางรายที่ป้อนคำค้นหานี้คลิกผลการค้นหาที่ไม่เสียค่าใช้จ่าย ขณะที่คนอื่นๆ คลิกโฆษณา (และบางคนอาจคลิกทั้ง 2 แบบ)
แอตทริบิวต์ SERP type ใช่
paidClicks จำนวนครั้งที่มีคนคลิกโฆษณาหลังจากป้อนข้อความค้นหา เมตริก Integer ใช่
organicClicks จำนวนการคลิกในผลการค้นหาที่ไม่เสียค่าใช้จ่ายสำหรับเว็บไซต์ของคุณหลังจากมีผู้ป้อนคำค้นหา เมตริก Integer ใช่
paidAndOrganicClicks จำนวนคลิกบนโฆษณารายการใดรายการหนึ่งของคุณ หรือผลการค้นหาที่ไม่เสียค่าใช้จ่ายสำหรับเว็บไซต์ของคุณหลังจากที่มีผู้ป้อนคำค้นหา เมตริก Integer ใช่
paidImpressions จำนวนครั้งที่โฆษณาปรากฏบนหน้าผลการค้นหาหรือเว็บไซต์ในเครือข่ายของ Google หลังจากที่มีผู้ป้อนคำค้นหา เมตริก Integer ใช่
organicQueries จำนวนครั้งทั้งหมดที่ผู้ใช้ป้อนข้อความค้นหาและเห็นผลการค้นหาทั่วไปอย่างน้อย 1 รายการจากเว็บไซต์ของคุณ เมตริก Integer ใช่
paidAndOrganicQueries จำนวนครั้งทั้งหมดที่ผู้ใช้ป้อนข้อความค้นหา และเห็นโฆษณาของคุณอย่างน้อย 1 รายการ หรือผลการค้นหาทั่วไปอย่างน้อย 1 รายการจากเว็บไซต์ของคุณ เมตริก Integer ใช่
paidCtr อัตราการคลิกผ่านของโฆษณา ซึ่งเป็นความถี่ที่ผู้ที่เห็นโฆษณาของคุณคลิกโฆษณาหลังจากป้อนข้อความค้นหา เมตริก Number ใช่
organicCtr อัตราที่ผู้ที่เห็นผลการค้นหาที่ไม่เสียค่าใช้จ่ายสำหรับเว็บไซต์ของคุณจบลงด้วยการคลิกผลการค้นหาที่ไม่เสียค่าใช้จ่ายและไปที่เว็บไซต์ของคุณ เมตริก Number ใช่
paidAndOrganicCtr อัตราที่ผู้ที่เห็นโฆษณารายการใดรายการหนึ่งของคุณหรือผลการค้นหาที่ไม่เสียค่าใช้จ่ายสำหรับเว็บไซต์ของคุณคลิกเข้าไปชมที่เว็บไซต์ของคุณ เมตริก Number ใช่
paidAvgPos อันดับเฉลี่ยที่โฆษณาปรากฏหลังจากมีผู้ป้อนคำค้นหา เมตริก Number ใช่
organicAvgPos ตำแหน่งบนสุดเฉลี่ยของผลการค้นหาที่ไม่เสียค่าใช้จ่ายสำหรับเว็บไซต์ของคุณ เมตริก Number ใช่
paidCostPerClick ต้นทุนต่อคลิกโดยเฉลี่ยสำหรับโฆษณา นี่คือจำนวนเฉลี่ยที่คุณจ่ายแต่ละครั้งที่มีคนคลิกโฆษณาของคุณ เมตริก Money ใช่
date แบ่งกลุ่มรายงานตามวัน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละวัน คอลัมน์นี้แสดงวันที่ของแต่ละแถว กลุ่ม Date ใช่
monthStart แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละเดือน คอลัมน์นี้แสดงผลวันแรกของเดือนของแต่ละแถว กลุ่ม Date ใช่
monthEnd แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละเดือน คอลัมน์นี้แสดงวันสุดท้ายของเดือนของแต่ละแถว กลุ่ม Date ใช่
quarterStart แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อไตรมาส คอลัมน์นี้แสดงผลวันแรกของไตรมาสของแต่ละแถว กลุ่ม Date ใช่
quarterEnd แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อไตรมาส คอลัมน์นี้แสดงวันสุดท้ายของไตรมาสของแต่ละแถว กลุ่ม Date ใช่
weekStart แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว แต่ละแถวสำหรับแต่ละสัปดาห์ คอลัมน์นี้แสดงผลวันแรก (วันอาทิตย์) ของแต่ละแถว กลุ่ม Date ใช่
weekEnd แบ่งกลุ่มรายงานตามสัปดาห์ (วันอาทิตย์ถึงวันเสาร์) แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว แต่ละแถวสำหรับแต่ละสัปดาห์ คอลัมน์นี้แสดงวันสุดท้าย (วันเสาร์) ของแต่ละแถว กลุ่ม Date ใช่
yearStart แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละปี คอลัมน์นี้แสดงวันแรกของปีของแต่ละแถว กลุ่ม Date ใช่
yearEnd แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวสำหรับแต่ละปี คอลัมน์นี้แสดงวันสุดท้ายของปีของแต่ละแถว กลุ่ม Date ใช่
campaign จัดกลุ่มรายงานตามแคมเปญ แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อ 1 แคมเปญในขอบเขตรายงาน คอลัมน์นี้แสดงชื่อแคมเปญ กลุ่ม String ใช่
campaignId จัดกลุ่มรายงานตามแคมเปญ แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว 1 แถวต่อ 1 แคมเปญในขอบเขตรายงาน คอลัมน์นี้จะแสดงรหัสแคมเปญ DS กลุ่ม ID ใช่
adGroup จัดกลุ่มรายงานตามกลุ่มโฆษณา แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อ 1 กลุ่มโฆษณาในขอบเขตรายงาน คอลัมน์นี้แสดงชื่อกลุ่มโฆษณา กลุ่ม String ใช่
adGroupId จัดกลุ่มรายงานตามกลุ่มโฆษณา แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายๆ แถว โดยแบ่งเป็น 1 แถวต่อ 1 กลุ่มโฆษณาในขอบเขตรายงาน คอลัมน์นี้จะแสดงรหัสกลุ่มโฆษณา DS กลุ่ม ID ใช่
keywordId จัดกลุ่มรายงานตามคีย์เวิร์ด แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยแต่ละแถวสำหรับคีย์เวิร์ดแต่ละคำในขอบเขตรายงาน คอลัมน์นี้จะแสดงรหัสคีย์เวิร์ด DS กลุ่ม ID ใช่
keywordMatchType จัดกลุ่มรายงานตามคีย์เวิร์ด แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยแต่ละแถวสำหรับคีย์เวิร์ดแต่ละคำในขอบเขตรายงาน คอลัมน์นี้แสดงประเภทการทำงานของคีย์เวิร์ด กลุ่ม Match type ใช่
keywordText จัดกลุ่มรายงานตามคีย์เวิร์ด แต่ละแถวและเมตริกรวมของแถวจะแบ่งออกเป็นหลายแถว โดยแต่ละแถวสำหรับคีย์เวิร์ดแต่ละคำในขอบเขตรายงาน คอลัมน์นี้แสดงข้อความคีย์เวิร์ด กลุ่ม String ใช่