ประเภทรายงาน: คีย์เวิร์ด

เมตริกประสิทธิภาพและแอตทริบิวต์การกําหนดค่าสําหรับคีย์เวิร์ด

รายงานนี้สามารถแสดงผ่านคําขอแบบไม่พร้อมกันเท่านั้น (กล่าวคือ ผ่านเมธอด Reports.request())

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

ส่งเนื้อหาคําขอ Reports.request() ปกติ แต่ระบุ "reportType": "keyword"

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

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

columnName	คำอธิบาย	ลักษณะการทำงาน	ประเภท	กรองได้
status	สถานะของคีย์เวิร์ด: Active Paused หรือ Removed โปรดทราบว่าแคมเปญ กลุ่มโฆษณา คีย์เวิร์ด และโฆษณาแต่ละรายการมีสถานะของตนเอง ดูสถานะ	แอตทริบิวต์	Status	ได้
engineStatus	สถานะเพิ่มเติมของคีย์เวิร์ดในบัญชีเครื่องมือค้นหาภายนอก สถานะที่เป็นไปได้ (ขึ้นอยู่กับประเภทบัญชีภายนอก) ได้แก่ criterion rarely served, criterion below first page bid, criterion low quality score, review, campaign paused ฯลฯ	แอตทริบิวต์	String	ได้
creationTimestamp	การประทับเวลาการสร้างคีย์เวิร์ด ซึ่งอยู่ในรูปแบบ ISO 8601	แอตทริบิวต์	Timestamp	ได้
lastModifiedTimestamp	การประทับเวลาของการแก้ไขล่าสุดของคีย์เวิร์ด ซึ่งอยู่ในรูปแบบ ISO 8601	แอตทริบิวต์	Timestamp	ได้
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	ได้
campaign	ชื่อแคมเปญ	แอตทริบิวต์	String	ได้
campaignId	รหัสแคมเปญ DS	แอตทริบิวต์	ID	ได้
campaignStatus	สถานะของแคมเปญที่มีรายการนี้	แอตทริบิวต์	Status	ได้
adGroup	ชื่อกลุ่มโฆษณา	แอตทริบิวต์	String	ได้
adGroupId	รหัสกลุ่มโฆษณา DS	แอตทริบิวต์	ID	ได้
adGroupStatus	สถานะของกลุ่มโฆษณาที่มีรายการนี้	แอตทริบิวต์	Status	ได้
keywordId	รหัสคีย์เวิร์ด DS ค่า 0 หมายความว่าคีย์เวิร์ดนี้ไม่มีการระบุแหล่งที่มา	แอตทริบิวต์	ID	ได้
keywordMatchType	ประเภทการทํางานของคีย์เวิร์ด: Broad, Exact, Phrase หรือ Content	แอตทริบิวต์	Match type	ได้
keywordText	ข้อความคีย์เวิร์ด	แอตทริบิวต์	String	ได้
keywordEngineId	รหัสของคีย์เวิร์ดในบัญชีเครื่องมือค้นหาภายนอก	แอตทริบิวต์	ID	ได้
keywordMaxCpc	ลบล้าง CPC สูงสุดของกลุ่มโฆษณา และตั้งจํานวนเงินสูงสุดที่คุณยินดีจ่ายเมื่อมีคนคลิกโฆษณาสําหรับคีย์เวิร์ดนี้ หากเว้นช่องนี้ว่างไว้ คีย์เวิร์ดจะใช้ CPC สูงสุดของกลุ่มโฆษณา	แอตทริบิวต์	Money	ได้
effectiveKeywordMaxCpc	CPC สูงสุด (ต้นทุนต่อคลิกสูงสุด) ที่ใช้กับคีย์เวิร์ดนี้ ค่านี้จะเป็นค่าเดียวกับ CPC สูงสุดของกลุ่มโฆษณา หรือหากคีย์เวิร์ดลบล้างการตั้งค่าของกลุ่มโฆษณา คือ CPC สูงสุดของคีย์เวิร์ดนั้น	แอตทริบิวต์	Money	ได้
keywordLandingPage	URL สุดท้ายที่ผู้ใช้จะเข้าชมหลังจากคลิกโฆษณา โปรดดูหน้า Landing Page และ URL ของเซิร์ฟเวอร์คลิก	แอตทริบิวต์	String	ได้
keywordClickserverUrl	URL ที่ DS ใช้ในการติดตามกิจกรรม ผู้ใช้ที่คลิกโฆษณาจะไปที่ URL ของเซิร์ฟเวอร์คลิกก่อน แล้วจะเปลี่ยนเส้นทางไปยังหน้า Landing Page สุดท้าย โปรดดูหน้า Landing Page และ URL ของเซิร์ฟเวอร์คลิก	แอตทริบิวต์	String	ได้
isDisplayKeyword	ระบุว่าเป็นคีย์เวิร์ดตัวยึดตําแหน่งที่ใช้สําหรับการรายงานการแสดงผลและตําแหน่ง	แอตทริบิวต์	Boolean	ได้
keywordMaxBid	หากคีย์เวิร์ดนี้จัดการโดยกลยุทธ์การเสนอราคา DS กลยุทธ์การเสนอราคาจะไม่เพิ่มราคาเสนอที่สูงกว่าขีดจํากัดนี้ ดูใช้กลยุทธ์การเสนอราคากับคีย์เวิร์ด	แอตทริบิวต์	Money	ได้
keywordMinBid	หากคีย์เวิร์ดนี้จัดการโดยกลยุทธ์การเสนอราคา DS กลยุทธ์การเสนอราคาจะไม่ลดราคาเสนอที่ต่ํากว่าขีดจํากัดนี้ ดูใช้กลยุทธ์การเสนอราคากับคีย์เวิร์ด	แอตทริบิวต์	Money	ได้
keywordUrlParams	เพิ่มพารามิเตอร์ของ URL เพิ่มเติมลงในหน้า Landing Page ดูเพิ่มพารามิเตอร์ของ URL	แอตทริบิวต์	String	ได้
bingKeywordParam2	พารามิเตอร์ 2 ของคีย์เวิร์ดสําหรับโฆษณา Bing	แอตทริบิวต์	String	ได้
bingKeywordParam3	พารามิเตอร์ 3 ของคีย์เวิร์ดสําหรับโฆษณา Bing	แอตทริบิวต์	String	ได้
keywordLabels	ชื่อของป้ายกํากับที่กําหนดให้กับคีย์เวิร์ดนี้โดยตรง แต่ไม่รวมป้ายกํากับที่รับช่วงมา	แอตทริบิวต์	String list	ได้
qualityScoreCurrent	เฉพาะ Google Ads และ Bing Ads ค่าล่าสุดของคะแนนคุณภาพ (QS) ของเครื่องมือสําหรับคีย์เวิร์ด โปรดทราบว่าคอลัมน์นี้รายงาน QS ล่าสุดของคีย์เวิร์ดเสมอโดยไม่คํานึงถึงช่วงเวลาของรายงาน	แอตทริบิวต์	Integer	ได้
topOfPageBidCurrent	Google Ads เท่านั้น ราคาเสนอ CPC โดยประมาณโดยประมาณเพื่อให้โฆษณาของคุณปรากฏในตําแหน่งบนสุดเหนือผลการค้นหาเป็นประจํา โปรดทราบว่าคอลัมน์นี้รายงาน CPC ที่ต้องการเสมอโดยไม่คํานึงถึงช่วงเวลาของรายงาน	แอตทริบิวต์	Money	ได้
effectiveBidStrategyId	รหัส DS ของกลยุทธ์การเสนอราคาที่กําหนดให้กับเอนทิตีนี้ หรือรับค่าโดยเอนทิตีนี้	แอตทริบิวต์	ID	ได้
effectiveBidStrategy	ชื่อของกลยุทธ์การเสนอราคาที่กําหนดให้กับเอนทิตีนี้ หรือรับค่าโดยเอนทิตีนี้	แอตทริบิวต์	String	ได้
bidStrategyInherited	ระบุว่าจะรับช่วงกลยุทธ์การเสนอราคาของเอนทิตีนี้อยู่หรือไม่	แอตทริบิวต์	Boolean	ได้
effectiveLabels	ชื่อของป้ายกํากับทั้งหมดที่รับช่วงหรือกําหนดให้กับคีย์เวิร์ดนี้โดยตรง	แอตทริบิวต์	String list	ได้
dfaActions	จํานวนการกระทําทั้งหมดของ Campaign Manager	เมตริก	Integer	ได้
dfaRevenue	รายได้รวมที่เกิดจากธุรกรรมใน Campaign Manager	เมตริก	Money	ได้
dfaTransactions	จํานวนธุรกรรมทั้งหมดของ Campaign Manager	เมตริก	Integer	ได้
dfaWeightedActions	ผลรวมที่ถ่วงน้ําหนักของการดําเนินการใน Campaign Manager	เมตริก	Number	ได้
dfaActionsCrossEnv	จํานวนการกระทําทั้งหมดของผู้จัดการแคมเปญข้ามสภาพแวดล้อม	เมตริก	Number	ได้
dfaRevenueCrossEnv	รายได้รวมที่เกิดจากธุรกรรมของผู้จัดการแคมเปญข้ามสภาพแวดล้อม	เมตริก	Money	ได้
dfaTransactionsCrossEnv	จํานวนธุรกรรมทั้งหมดของ Campaign Manager ข้ามสภาพแวดล้อม	เมตริก	Number	ได้
dfaWeightedActionsCrossEnv	ผลรวมของการถ่วงน้ําหนักของการดําเนินการของผู้จัดการแคมเปญข้ามสภาพแวดล้อม	เมตริก	Number	ได้
avgCpc	ต้นทุนต่อคลิกโดยเฉลี่ย	เมตริก	Money	ได้
avgCpm	ต้นทุนต่อการแสดงผลพันครั้งโดยเฉลี่ย	เมตริก	Money	ได้
avgPos	อันดับเฉลี่ย	เมตริก	Number	ได้
clicks	จํานวนคลิกรวม	เมตริก	Integer	ได้
cost	ต้นทุนรวมที่ชําระไปยังบัญชีเครื่องมือค้นหา	เมตริก	Money	ได้
ctr	อัตราการคลิกผ่านโดยเฉลี่ย	เมตริก	Number	ได้
impr	จํานวนการแสดงผลทั้งหมด	เมตริก	Integer	ได้
adWordsConversions	ข้อมูลที่ผู้ลงโฆษณาตั้งค่าไว้ให้รายงานในคอลัมน์ Conversion ของ Google Ads เมื่อสร้างการกระทําที่ถือเป็น Conversion ของ Google Ads แล้ว ผู้ลงโฆษณาจะเลือกว่าจะนับ Conversion เหล่านั้นในคอลัมน์การรายงาน Conversion ได้หรือไม่	เมตริก	Number	ได้
adWordsConversionValue	มูลค่ารวมของ Conversion ของ Google Ads	เมตริก	Number	ได้
adWordsViewThroughConversions	จํานวน Conversion การดูผ่านของ Google Ads ทั้งหมด	เมตริก	Integer	ได้
visits	จํานวนการเข้าชม DS ทั้งหมด	เมตริก	Integer	ได้
qualityScoreAvg	เฉพาะ Google Ads และ Bing Ads ค่าเฉลี่ยถ่วงน้ําหนักการแสดงผลของคะแนนคุณภาพของเครื่องมือ (QS) ตลอดทั้งวันและคีย์เวิร์ดในขอบเขตรายงาน	เมตริก	Number	ได้
topOfPageBidAvg	Google Ads เท่านั้น ราคาเสนอ CPC เฉลี่ยโดยประมาณในช่วงเวลาของรายงานเพื่อให้โฆษณาของคุณแสดงในตําแหน่งบนสุดเหนือผลการค้นหาเป็นประจํา	เมตริก	Money	ได้
date	แบ่งกลุ่มรายงานตามวัน แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว วันละแถว คอลัมน์นี้จะแสดงผลวันที่ของแต่ละแถว	กลุ่ม	Date	ได้
monthStart	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว เดือนละ 1 แถว คอลัมน์นี้จะแสดงผลวันแรกของเดือนของแต่ละแถว	กลุ่ม	Date	ได้
monthEnd	แบ่งกลุ่มรายงานตามเดือน แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว เดือนละ 1 แถว คอลัมน์นี้จะแสดงผลวันสุดท้ายของเดือนของแต่ละแถว	กลุ่ม	Date	ได้
quarterStart	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว แต่ละแถวสําหรับแต่ละไตรมาส คอลัมน์นี้จะแสดงผลวันแรกของไตรมาสของแต่ละแถว	กลุ่ม	Date	ได้
quarterEnd	แบ่งกลุ่มรายงานตามไตรมาส แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว แต่ละแถวสําหรับแต่ละไตรมาส คอลัมน์นี้จะแสดงผลวันสุดท้ายของไตรมาสของแต่ละแถว	กลุ่ม	Date	ได้
weekStart	แบ่งกลุ่มรายงานตามสัปดาห์ (อาทิตย์-เสาร์) แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว คนละแถว คอลัมน์นี้จะแสดงผลวันแรก (วันอาทิตย์) ของแต่ละแถว	กลุ่ม	Date	ได้
weekEnd	แบ่งกลุ่มรายงานตามสัปดาห์ (อาทิตย์-เสาร์) แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว คนละแถว คอลัมน์นี้จะแสดงผลวันสุดท้าย (วันเสาร์) ของแต่ละแถว	กลุ่ม	Date	ได้
yearStart	แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นแถวๆ แถวละ 1 แถว คอลัมน์นี้จะแสดงผลวันแรกของปีของแต่ละแถว	กลุ่ม	Date	ได้
yearEnd	แบ่งกลุ่มรายงานตามปี แต่ละแถวและเมตริกรวมจะแบ่งออกเป็นแถวๆ แถวละ 1 แถว คอลัมน์นี้จะแสดงผลวันสุดท้ายของปีของแต่ละแถว	กลุ่ม	Date	ได้
deviceSegment	แบ่งกลุ่มรายงานตามอุปกรณ์ โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว โดยสูงสุด 1 แถวต่ออุปกรณ์แต่ละกลุ่ม คอลัมน์นี้จะแสดงผลกลุ่มอุปกรณ์ของแต่ละแถว	กลุ่ม	Device segment	ได้
floodlightGroup	แบ่งกลุ่มรายงานตามกลุ่ม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 กลุ่มสําหรับกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงชื่อกลุ่ม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ได้
floodlightGroupId	แบ่งกลุ่มรายงานตามกลุ่ม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 กลุ่มสําหรับกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงผลรหัสกลุ่ม Floodlight ของ DS ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ได้
floodlightGroupTag	แบ่งกลุ่มรายงานตามกลุ่ม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 กลุ่มสําหรับกลุ่ม Floodlight แต่ละกลุ่ม คอลัมน์นี้จะแสดงผลแท็กกลุ่ม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ได้
floodlightActivity	แบ่งกลุ่มรายงานตามกิจกรรม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว โดยสูงสุด 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงผลชื่อกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ได้
floodlightActivityId	แบ่งกลุ่มรายงานตามกิจกรรม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว โดยสูงสุด 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงผลรหัสกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	ID	ได้
floodlightActivityTag	แบ่งกลุ่มรายงานตามกิจกรรม Floodlight โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว โดยสูงสุด 1 แถวสําหรับกิจกรรม Floodlight แต่ละรายการ คอลัมน์นี้จะแสดงผลแท็กกิจกรรม Floodlight ของแต่ละแถว โปรดทราบว่าเมตริกบางรายการไม่มีค่าที่แบ่งกลุ่มของ Floodlight เช่น การคลิกและการเข้าชม	กลุ่ม	String	ได้
ad	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลชื่อโฆษณาในแต่ละแถว	กลุ่ม	String	ได้
adId	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลรหัส DS ของโฆษณาในแต่ละแถว	กลุ่ม	ID	ได้
isUnattributedAd	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้บ่งบอกว่าเมตริกในแถวนี้ไม่สามารถระบุแหล่งที่มาในโฆษณาหนึ่งๆ ได้หรือไม่	กลุ่ม	Boolean	ได้
adHeadline	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลบรรทัดแรกของโฆษณาในแต่ละแถว	กลุ่ม	String	ได้
adHeadline2	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลบรรทัดแรก 2 ของโฆษณาในแต่ละแถว ใช้ไม่ได้กับเครื่องมือบางรุ่น	กลุ่ม	String	ได้
adHeadline3	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลบรรทัดแรก 3 ของโฆษณาในแต่ละแถว ใช้ไม่ได้กับเครื่องมือบางรุ่น	กลุ่ม	String	ได้
adDescription1	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลบรรทัดรายละเอียด 1 ของโฆษณาในแต่ละแถว	กลุ่ม	String	ได้
adDescription2	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลบรรทัดรายละเอียด 2 ของโฆษณาในแต่ละแถว	กลุ่ม	String	ได้
adDisplayUrl	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผล URL ที่แสดงของโฆษณาในแต่ละแถว	กลุ่ม	String	ได้
adLandingPage	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลหน้า Landing Page ของโฆษณาในแต่ละแถว	กลุ่ม	String	ได้
adType	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้แสดงประเภทของโฆษณาในแต่ละแถว: Text หรือ Product	กลุ่ม	Ad type	ได้
adPromotionLine	แบ่งกลุ่มรายงานตามโฆษณา โดยแต่ละแถวและเมตริกรวมจะแบ่งออกเป็นหลายแถว สูงสุด 1 รายการต่อแถว คอลัมน์นี้จะแสดงผลบรรทัดโปรโมชันของโฆษณาผลิตภัณฑ์ในแต่ละแถว	กลุ่ม	String	ได้