ฟังก์ชันหลักของแอปพลิเคชัน Google Ads จำนวนมากคือการเรียกข้อมูลบัญชีสำหรับกรณีการใช้งาน เช่น การวิเคราะห์ข้อมูล การค้นหาของลูกค้า และการตรวจสอบการปฏิบัติตามนโยบาย ขณะดึงข้อมูล คุณควรเพิ่มประสิทธิภาพการใช้งานเพื่อไม่ให้เซิร์ฟเวอร์ Google ทำงานหนักเกินไป ดูรายละเอียดเพิ่มเติมได้ในคู่มือเกี่ยวกับการจำกัดราคาและการดูแลอีเมลติดต่อล่าสุด
ทำความเข้าใจนโยบายการใช้งานทรัพยากรสำหรับรายงานของ Google
Google Ads API จะควบคุมรูปแบบคำค้นหา GoogleAdsService.Search
และ GoogleAdsService.SearchStream
ที่ใช้ทรัพยากร API มากเกินไปเพื่อรักษาความเสถียรของเซิร์ฟเวอร์ หากมีการควบคุมรูปแบบคำค้นหาหนึ่ง บริการ เมธอด และรูปแบบคำค้นหาอื่นๆ จะยังคงทำงานโดยไม่ได้รับผลกระทบ ระบบจะแสดงข้อผิดพลาดต่อไปนี้สำหรับคำขอที่มีการควบคุม
เวอร์ชัน API | รหัสข้อผิดพลาด |
---|---|
<= เวอร์ชัน 16 | QuotaError.RESOURCE_EXHAUSTED |
มากกว่า 17 | QuotaError.EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION หรือ QuotaError.EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION ขึ้นอยู่กับระยะเวลาของการใช้งานทรัพยากรสูง |
นอกจากนี้ เราจะแสดงผลเมตริกค่าใช้จ่ายสำหรับรายงานแต่ละรายการด้วย เพื่อช่วยให้คุณระบุและตรวจสอบรายงานที่มีค่าใช้จ่ายสูงได้
วิธีการ | ช่องค่าใช้จ่าย |
---|---|
GoogleAdsService.Search |
SearchGoogleAdsResponse.query_resource_consumption |
GoogleAdsService.SearchStream |
SearchGoogleAdsStreamResponse.query_resource_consumption |
เมตริกค่าใช้จ่ายที่ช่องเหล่านี้แสดงผลจะขึ้นอยู่กับปัจจัยต่างๆ เช่น
- ขนาดของบัญชี
- ข้อมูลพร็อพเพอร์ตี้และคอลัมน์ที่คุณดึงข้อมูลในรายงาน
- ภาระงานในเซิร์ฟเวอร์ Google Ads API
เราจะเผยแพร่สถิติรวมขั้นต้นเกี่ยวกับการใช้ทรัพยากรของรูปแบบการค้นหาต่างๆ ที่เราเห็นในเซิร์ฟเวอร์ของเรา เพื่อช่วยให้คุณติดตามการค้นหาที่มีค่าใช้จ่ายสูงได้ เราจะเผยแพร่ตัวเลขที่อัปเดตเป็นระยะเพื่อช่วยคุณปรับแต่งคำค้นหา
กรอบเวลา | ปานกลาง (p50) | P70 (สูงปานกลาง) | P95 (สูงมาก) |
---|---|---|---|
ระยะสั้น (5 นาที) | 6000 | 30000 | 1800000 |
ระยะยาว (24 ชม.) | 16000 | 90000 | 8400000 |
ตัวอย่างเช่น สมมติว่าคุณเรียกใช้รูปแบบประโยคต่อไปนี้ ซึ่งใช้ทรัพยากร 600 หน่วยต่อรายงาน
SELECT campaign.id, campaign.name, metrics.cost_micros FROM campaign WHERE
segments.date = "YYYY-MM-DD"
คุณเรียกใช้การค้นหานี้กับบัญชีลูกค้าหลายบัญชีเป็นเวลาหลายวันได้โดยแก้ไขการค้นหาเพื่อแทนที่ค่าที่แตกต่างกันสำหรับตัวกรอง segments.date
ตารางต่อไปนี้แสดงจำนวนรายงานที่คุณเรียกใช้ได้ในกรอบเวลาที่กำหนด เพื่อให้การใช้งานทรัพยากรพอดีกับที่เก็บข้อมูลการใช้งานทรัพยากรต่างๆ
กรอบเวลา | เฉยๆ | ค่อนข้างสูง | สูงมาก |
---|---|---|---|
ระยะสั้น (5 นาที) | 10 | 50 | 3,000 |
ระยะยาว (24 ชม.) | 26 | 150 | 14000 |
การเรียกใช้รูปแบบข้อความค้นหานี้ 10 ครั้งใน 5 นาทีจะนับเป็นการใช้งานเฉลี่ย ส่วนการเรียกใช้รายงาน 3, 000 รายการใน 5 นาทีจะนับเป็นการใช้งานสูงมาก
มีกลยุทธ์หลายวิธีในการเพิ่มประสิทธิภาพการใช้ทรัพยากรของรายงาน ส่วนที่เหลือของคู่มือนี้จะครอบคลุมกลยุทธ์บางส่วนเหล่านี้
แคชข้อมูลของคุณ
คุณควรแคชรายละเอียดเอนทิตีที่ดึงจากเซิร์ฟเวอร์ API ในฐานข้อมูลในเครื่องแทนที่จะเรียกใช้เซิร์ฟเวอร์ทุกครั้งที่ต้องการข้อมูล โดยเฉพาะอย่างยิ่งสำหรับเอนทิตีที่มีการเข้าถึงบ่อยหรือซึ่งมีการเปลี่ยนแปลงไม่บ่อย ใช้ change-event และ change-status เพื่อตรวจหาออบเจ็กต์ที่เปลี่ยนแปลงไปตั้งแต่ซิงค์ผลลัพธ์ครั้งล่าสุด
เพิ่มประสิทธิภาพความถี่ในการเรียกใช้รายงาน
Google Ads มีหลักเกณฑ์ที่เผยแพร่เกี่ยวกับความใหม่ของข้อมูลและความถี่ในการอัปเดตข้อมูล คุณจึงควรใช้คำแนะนำนี้เพื่อดูว่า จะดึงข้อมูลรายงานบ่อยเพียงใด
หากคุณจำเป็นต้องอัปเดตบัญชีเป็นประจำ เราขอแนะนำให้จำกัดจำนวนบัญชีดังกล่าวให้เหลือเพียงบัญชีเดียว เช่น เฉพาะบัญชี Google Ads 20 อันดับแรก คุณสามารถอัปเดตแคมเปญที่เหลือด้วยความถี่ที่ต่ำลง เช่น 1 หรือ 2 ครั้งต่อวัน
เพิ่มประสิทธิภาพขนาดของรายงาน
แอปพลิเคชันของคุณควรดึงข้อมูลจำนวนมากแทนที่จะเรียกใช้รายงานขนาดเล็กจำนวนมาก ปัจจัยที่ส่งผลต่อตัวเลือกนี้คือขีดจำกัดของบัญชี
เช่น ลองพิจารณาโค้ดต่อไปนี้ซึ่งจะดึงสถิติของกลุ่มโฆษณาหนึ่งๆ และอัปเดตตารางฐานข้อมูลสถิติ
List<long> adGroupIds = FetchAdGroupIdsFromLocalDatabase();
foreach (long adGroupId in adGroupIds)
{
string query = "SELECT ad_group.id, ad_group.name, metrics.clicks, " +
"metrics.cost_micros, metrics.impressions, segments.date FROM " +
"ad_group WHERE segments.date DURING LAST_7_DAYS AND " +
"ad_group.id = ${adGroupId}";
List<GoogleAdsRow> rows = RunGoogleAdsReport(customerId, query);
InsertRowsIntoStatsTable(adGroupId, rows);
}
โค้ดนี้ทำงานได้ดีในบัญชีทดสอบขนาดเล็ก อย่างไรก็ตาม Google Ads รองรับกลุ่มโฆษณาได้สูงสุด 20,000 กลุ่มต่อแคมเปญ และ 10,000 แคมเปญต่อบัญชี ดังนั้นหากโค้ดนี้ทำงานกับบัญชี Google Ads ขนาดใหญ่ อาจทำให้เซิร์ฟเวอร์ Google Ads API ทำงานหนักเกินไป ซึ่งนำไปสู่การจำกัดอัตราและการควบคุม
วิธีที่ดีที่สุดคือการเรียกใช้รายงานฉบับเดียว แล้วประมวลผลในเครื่อง วิธีการหนึ่งที่ใช้แผนที่ในหน่วยความจำจะแสดงขึ้น
Hashset<long> adGroupIds = FetchAdGroupIdsFromLocalDatabase();
string query = "SELECT ad_group.id, ad_group.name, metrics.clicks, " +
"metrics.cost_micros, metrics.impressions, segments.date FROM " +
"ad_group WHERE segments.date DURING LAST_7_DAYS";
List<GoogleAdsRow> rows = RunGoogleAdsReport(customer_id, query);
var memoryMap = new Dictionary<long, List<GoogleAdsRow>>();
for each (GoogleAdsRow row in rows)
{
var adGroupId = row.AdGroup.Id;
if (adGroupIds.Contains(adGroupId))
{
CheckAndAddRowIntoMemoryMap(row, adGroupId, memoryMap);
}
}
foreach (long adGroupId in memoryMap.Keys())
{
InsertRowsIntoStatsTable(adGroupId, rows);
}
ซึ่งจะช่วยลดภาระงานของเซิร์ฟเวอร์ Google Ads API เนื่องจากมีการเรียกใช้รายงานน้อยลง
หากพบว่ารายงานมีขนาดใหญ่เกินกว่าที่จะเก็บไว้ในหน่วยความจำ คุณอาจแบ่งการค้นหาออกเป็นกลุ่มเล็กๆ ได้โดยการเพิ่มอนุประโยค LIMIT
ดังนี้
SELECT
ad_group.id,
ad_group.name,
metrics.clicks,
metrics.cost_micros,
metrics.impressions,
segments.date
FROM ad_group
WHERE segments.date DURING LAST_7_DAYS
AND ad_group.id IN (id1, id2, ...)
LIMIT 100000
ป้ายกำกับเป็นอีกวิธีหนึ่งในการจัดกลุ่มเอนทิตีและลดจำนวนคำค้นหาการรายงาน ดูคู่มือป้ายกำกับเพื่อเรียนรู้เพิ่มเติม
เพิ่มประสิทธิภาพข้อมูลที่คุณดึงข้อมูล
เมื่อเรียกใช้รายงาน คุณควรคำนึงถึงคอลัมน์ที่รวมอยู่ในข้อความค้นหา ลองดูตัวอย่างต่อไปนี้ซึ่งกำหนดให้ทำงานทุกชั่วโมง
SELECT
customer.id,
customer.currency_code,
campaign.id,
campaign.name,
ad_group.id,
ad_group.name,
ad_group_criterion.keyword.match_type,
ad_group_criterion.keyword.text,
ad_group_criterion.criterion_id,
ad_group_criterion.quality_info.creative_quality_score,
ad_group_criterion.system_serving_status,
ad_group_criterion.negative,
ad_group_criterion.quality_info.quality_score,
ad_group_criterion.quality_info.search_predicted_ctr,
ad_group_criterion.quality_info.post_click_quality_score,
metrics.historical_landing_page_quality_score,
metrics.search_click_share,
metrics.historical_creative_quality_score,
metrics.clicks,
metrics.impressions
FROM keyword_view
WHERE segments.date DURING LAST_7_DAYS
คอลัมน์เดียวที่มีแนวโน้มจะเปลี่ยนแปลงทุกชั่วโมงคือ metrics.clicks
และ metrics.impressions
คอลัมน์อื่นๆ ทั้งหมดมีการอัปเดตไม่บ่อยนักหรือไม่ได้อัปเดตเลย การดึงข้อมูลรายชั่วโมงจึงไม่มีประสิทธิภาพอย่างมาก คุณสามารถจัดเก็บค่าเหล่านี้ในฐานข้อมูลของเครื่องและเรียกใช้รายงานเหตุการณ์การเปลี่ยนแปลงหรือการเปลี่ยนแปลงสถานะเพื่อดาวน์โหลดการเปลี่ยนแปลง 1-2 ครั้งต่อวัน
ในบางกรณี คุณสามารถลดจำนวนแถวที่ดาวน์โหลดได้โดยใช้ตัวกรองที่เหมาะสม
ล้างบัญชีที่ไม่ได้ใช้
หากแอปพลิเคชันของคุณจัดการบัญชีผู้ลงโฆษณาบุคคลที่สาม คุณต้องพัฒนาแอปพลิเคชันโดยคำนึงถึงการเลิกใช้งานของลูกค้า คุณควรล้างกระบวนการและที่เก็บข้อมูลเป็นระยะๆ เพื่อลบบัญชีสำหรับลูกค้าที่ไม่ได้ใช้แอปพลิเคชันของคุณแล้ว โปรดคำนึงถึงคำแนะนำต่อไปนี้เมื่อลบบัญชี Google Ads ที่ไม่ได้ใช้
- เพิกถอนการให้สิทธิ์ที่ลูกค้าให้แอปพลิเคชันเพื่อจัดการ บัญชีของผู้ใช้
- หยุดเรียก API ไปยังบัญชี Google Ads ของลูกค้า โดยเฉพาะอย่างยิ่งกับงานแบบออฟไลน์ เช่น งาน cron และไปป์ไลน์ข้อมูลที่ออกแบบมาเพื่อเรียกใช้โดยไม่ต้องให้ผู้ใช้จัดการ
- หากลูกค้าเพิกถอนการให้สิทธิ์ แอปพลิเคชันของคุณควรจัดการกับสถานการณ์อย่างเหมาะสมและหลีกเลี่ยงการส่งการเรียก API ที่ไม่ถูกต้องไปยังเซิร์ฟเวอร์ API ของ Google
- หากลูกค้ายกเลิกบัญชี Google Ads ของตน คุณควรตรวจหาและหลีกเลี่ยงการส่งการเรียก API ที่ไม่ถูกต้องไปยังเซิร์ฟเวอร์ API ของ Google
- ลบข้อมูลที่คุณดาวน์โหลดจากบัญชี Google Ads ของลูกค้าออกจากฐานข้อมูลของเครื่องหลังจากผ่านไประยะหนึ่ง