ประเภทรายงาน: 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	ใช่