สถิติ

ประกอบด้วยวิธีการเข้าถึงข้อมูลประสิทธิภาพของเอนทิตี

เมื่อต้องการรับข้อมูลประสิทธิภาพสําหรับเอนทิตี เช่น แคมเปญหรือคําสําคัญ ให้เรียกใช้เมธอดของgetStatsเอนทิตี แต่คุณจะสามารถเรียกใช้ได้ getStats ก็ต่อเมื่อ ตัวเลือกที่คุณใช้ เพื่อรับเอนทิตีมีเมธอดใดวิธีหนึ่งใน forDateRange สายโซ่อยู่เท่านั้น

ตัวเลือกแคมเปญต่อไปนี้ใช้เวอร์ชันforDateRangeที่ใช้ช่วงวันที่ที่กําหนดไว้ล่วงหน้า เช่น LAST_WEEK หรือ LAST_MONTH เวอร์ชันอื่นจะให้คุณระบุช่วงข้อมูลโดยใช้วันที่ที่เฉพาะเจาะจงได้

ตัวอย่างการใช้งาน:

    var campaign = AdsApp.campaigns()
        .forDateRange("LAST_WEEK")
        .get()
        .next();
    var stats = campaign.getStats();
    var conversionRate = stats.getConversionRate();
    var convertedClicks = stats.getConversions();
    // etc.

วิธีการ

ชื่อวิธี	ชนิดการส่งคืน	คำอธิบาย
getAbsoluteTopImpressionRate	สองเท่า	ได้รับเปอร์เซ็นต์อัตราการแสดงผลสูงสุดอย่างแท้จริง
getAverageCpc	สองเท่า	รับต้นทุนต่อการคลิกเฉลี่ย
getAverageCpm	สองเท่า	รับต้นทุนเฉลี่ยต่อการแสดงโฆษณาหนึ่งพันครั้ง
getAveragePosition	สองเท่า	วิธีนี้จะไม่สามารถใช้งานได้อีกต่อไปตั้งแต่วันที่ 31 มีนาคม 2021
getClickConversionRate	สองเท่า	(ใช้เมธอด getConversionRate() แทน)
getClicks	แบบยาว	รับจํานวนคลิก
getConversionRate	สองเท่า	รับอัตราการคลิกสําหรับการคลิก
getConversions	แบบยาว	รับจํานวนคลิกที่แปลง
getConvertedClicks	แบบยาว	(ใช้เมธอด getConversions() แทน)
getCost	สองเท่า	รับต้นทุน (การใช้จ่าย) ในสกุลเงินของบัญชี
getCtr	สองเท่า	รับอัตราการคลิกผ่าน
getImpressions	แบบยาว	รับจํานวนการแสดงผล
getReturnOnAdSpend	แบบยาว	รับผลตอบแทนจากค่าโฆษณา
getRevenue	แบบยาว	รับรายได้ตามที่ผู้ลงโฆษณารายงาน
getTopImpressionRate	สองเท่า	ได้รับเปอร์เซ็นต์อัตราการแสดงผลสูงสุด

getAbsoluteTopImpressionRate

รับความถี่ที่โฆษณาของคุณอยู่ในตําแหน่งแรกของผลลัพธ์ทั้งหมด เป็นเปอร์เซ็นต์ของการแสดงผลทั้งหมดของคุณ

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	ความถี่ที่โฆษณาของคุณอยู่ในอันดับแรกของผลลัพธ์ทั้งหมด คิดเป็นเปอร์เซ็นต์ของการแสดงผลทั้งหมดของคุณ

getAverageCpc

รับต้นทุนต่อการคลิกเฉลี่ย

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	ต้นทุนเฉลี่ยต่อการคลิก

getAverageCpm

รับต้นทุนเฉลี่ยต่อการแสดงโฆษณาหนึ่งพันครั้ง

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	ราคาเฉลี่ยต่อการแสดงโฆษณาหนึ่งพันครั้ง

getAveragePosition

รับตําแหน่งเฉลี่ยที่มีการวางโฆษณา

หมายเหตุ

วิธีนี้จะไม่สามารถใช้งานได้อีกต่อไปตั้งแต่วันที่ 31 มีนาคม 2021

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	ตําแหน่งเฉลี่ยที่มีการวางโฆษณา

getClickConversionRate

รับอัตราการคลิกสําหรับการคลิก

หมายเหตุ

เนื่องจากวิธีนี้อาจถูกเลิกใช้ในรุ่นในอนาคต ให้ใช้เมธอด getConversionRate แทน

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	อัตราการคลิกในช่วง 0..1

getClicks

รับจํานวนคลิก

ส่งกลับ

พิมพ์	คำอธิบาย
แบบยาว	จํานวนการคลิก

getConversionRate

รับอัตราการคลิกสําหรับการคลิก

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	อัตราการคลิกในช่วง 0..1

getConversions

รับจํานวนคลิกที่แปลง

ส่งกลับ

พิมพ์	คำอธิบาย
แบบยาว	จํานวนคลิกที่แปลง

getConvertedClicks

รับจํานวนคลิกที่แปลง

หมายเหตุ

เนื่องจากวิธีนี้อาจถูกเลิกใช้ในรุ่นต่อๆ ไป ให้ใช้วิธี getConversions แทน

ส่งกลับ

พิมพ์	คำอธิบาย
แบบยาว	จํานวนคลิกที่แปลง

getCost

รับต้นทุน (การใช้จ่าย) ในสกุลเงินของบัญชี

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	ต้นทุนในสกุลเงินของบัญชี

getCtr

รับอัตราการคลิกผ่าน

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	อัตราการคลิกผ่านในช่วง 0..1

getImpressions

รับจํานวนการแสดงผล

ส่งกลับ

พิมพ์	คำอธิบาย
แบบยาว	จํานวนการแสดงผล

getReturnOnAdSpend

รับผลตอบแทนจากค่าโฆษณา

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	ผลตอบแทนจากค่าโฆษณา ซึ่งคํานวณเป็น (รายได้/การใช้จ่าย) * 100

getRevenue

รับรายได้ตามที่ผู้ลงโฆษณารายงาน

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	รายได้ที่รายงานโดยผู้ลงโฆษณา

getTopImpressionRate

รับเปอร์เซ็นต์ของจํานวนครั้งที่โฆษณาของคุณแสดงในบรรทัดหลัก ซึ่งเป็นตําแหน่งด้านบนสุดที่โฆษณาปรากฏเหนือผลลัพธ์การค้นหา จากการแสดงผลทั้งหมดของคุณ

ส่งกลับ

พิมพ์	คำอธิบาย
สองเท่า	เปอร์เซ็นต์ของครั้งที่โฆษณาของคุณแสดงในบรรทัดหลัก ซึ่งเป็นตําแหน่งด้านบนสุดที่มีโฆษณาปรากฏเหนือผลลัพธ์การค้นหา จากการแสดงผลทั้งหมดของคุณ