รายงานส่วนเพิ่ม

Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว โดย API ใหม่นี้จะช่วยเพิ่มความยืดหยุ่นในการสร้างรายงานที่กำหนดเองและผสานรวมข้อมูลเข้ากับแอปพลิเคชันและกระบวนการรายงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับการย้ายข้อมูลรวมถึงการใช้ Search Ads 360 Reporting API เวอร์ชันใหม่

แทนที่จะต้องรับข้อมูลทั้งหมดทุกครั้งที่ขอรายงาน คุณสามารถขอเฉพาะข้อมูลที่มีการเปลี่ยนแปลงนับตั้งแต่รายงานครั้งล่าสุดของคุณได้เป็นระยะๆ รายงานที่เพิ่มขึ้นเหล่านี้มีแนวโน้มที่จะน้อยกว่ารายงานฉบับเต็มอย่างมาก

หากคุณขอรายงานเพิ่มเติม คุณควรทราบข้อมูลต่อไปนี้

  • ยังคงเป็นความคิดที่ดีที่จะขอรายงานฉบับเต็มทุกๆ ครั้งเผื่อไว้ในกรณีที่การเปลี่ยนแปลงบางอย่างหายไป ตัวอย่างเช่น หากคุณขอรายงานที่เพิ่มขึ้นรายสัปดาห์ในช่วงเดือนมกราคม เมื่อถึงสิ้นเดือนกุมภาพันธ์ คุณควรขอรายงานฉบับเต็มของเดือนมกราคมเพื่อให้ได้รับข้อมูลทั้งหมดของเดือนมกราคม
  • เนื่องจากไม่สามารถระบุได้ว่าเอนทิตีบางรายการมีการเปลี่ยนแปลงหรือไม่ รายงานส่วนเพิ่มจะมีเอนทิตีหาก Search Ads 360 ยังสงสัยว่าเอนทิตีมีการเปลี่ยนแปลง ซึ่งหมายความว่ารายงานส่วนเพิ่มอาจมีข้อมูลที่ไม่มีการเปลี่ยนแปลง

หากต้องการขอรายงานส่วนเพิ่ม ให้ระบุพร็อพเพอร์ตี้ Reports.request.timeRange อย่างใดอย่างหนึ่งต่อไปนี้

changedMetricsSinceTimestamp=timestamp

เมตริกคำขอที่มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลาที่ระบุ เนื่องจากเมตริกจะได้รับการจัดเก็บแบบละเอียดในแต่ละวันและอาจเปลี่ยนแปลงเป็นเวลา 1 วันแต่ไม่เปลี่ยนแปลง คำขอดังกล่าวจึงต้องแบ่งกลุ่มตามวัน (ต้องมีคอลัมน์ date) ตัวอย่างเช่น รายงาน keyword ที่มีคอลัมน์ clicks, actions และ date จะแสดงแถวของคีย์เวิร์ดแต่ละรายการและวันที่ซึ่งจำนวนคลิกหรือการกระทำที่บันทึกไว้มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลาที่ระบุ

การประทับเวลาต้องไม่อยู่ก่อนเวลาส่งคำขอมากกว่า 8 วัน หากต้องการบันทึกเมตริกที่เปลี่ยนแปลงทั้งหมด โปรดส่งคำขอ changedMetricsSinceTimestamp อย่างน้อย 1 ครั้งในทุกๆ 7 วัน และสร้างรายงานฉบับเต็มสำหรับแต่ละวันที่เมื่อเมตริกคงที่แล้ว (จะปลอดภัยกว่าที่จะรออย่างน้อย 7 วัน) รูปแบบตัวอย่างคือการสร้างรายงาน 2 ฉบับทุกวัน ได้แก่ รายงานที่เพิ่มขึ้นสำหรับเมตริกที่มีการเปลี่ยนแปลงในช่วง 36 ชั่วโมงที่ผ่านมา และรายงานฉบับเต็มสำหรับเมตริกที่เกิดขึ้นเมื่อ 8 วันที่ผ่านมา

changedAttributesSinceTimestamp=timestamp

แอตทริบิวต์คำขอที่มีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลาที่ระบุ คำขอ changedAttributesSinceTimestamp มีได้เฉพาะคอลัมน์แอตทริบิวต์ (ไม่มีคอลัมน์เมตริกหรือคอลัมน์กลุ่ม) และใช้ไม่ได้กับรายงานเหตุการณ์ดิบ เช่น รายงาน conversion เช่น รายงาน campaign ที่มีคอลัมน์ dailyBudget และ campaignStartDate จะแสดงแถวสำหรับแต่ละแคมเปญที่งบประมาณรายวันหรือวันที่เริ่มต้นมีการเปลี่ยนแปลงนับตั้งแต่การประทับเวลาที่ระบุ

โปรดทราบว่ารายงาน changedAttributesSinceTimestamp จะไม่มีการบันทึกการเปลี่ยนแปลงแอตทริบิวต์ระดับบนสุด เช่น คีย์เวิร์ดอาจรับค่ากลยุทธ์การเสนอราคามาจากกลุ่มโฆษณาหลัก แม้ว่ากลุ่มโฆษณาจะได้รับการกำหนดกลยุทธ์การเสนอราคาใหม่ แต่คีย์เวิร์ดนี้อาจไม่ปรากฏในรายงาน คอลัมน์แอตทริบิวต์ที่มีค่าขึ้นอยู่กับเอนทิตีหลัก (ซึ่งจึงอาจเปลี่ยนแปลงได้โดยไม่ต้องได้รับรายงานจาก changedAttributesSinceTimestamp) มักจะมีคำนำหน้าว่า "มีผล" เช่น effectiveLabelIds หรือ effectiveBidStartegy