Search Ads 360 Reporting API ทำงานโดยอิงตามแพลตฟอร์มที่ทันสมัยและนำเสนอแนวคิดใหม่หลายประการ ซึ่งอธิบายไว้ในส่วนต่อไปนี้
แหล่งข้อมูล
ออบเจ็กต์ทรัพยากรจะมาแทนที่ประเภทรายงาน ตอนนี้คุณสามารถค้นหาทรัพยากรทั้งหมดโดยใช้ภาษาในการค้นหาแบบ SQL ใหม่แทนการขอประเภทรายงานที่กำหนดไว้ล่วงหน้า ดูข้อมูลเพิ่มเติมได้ที่ โครงสร้าง Search Ads 360 Reporting API
การรายงานการค้นหา
การค้นหามีบริการของตัวเองใน API ใหม่ บริการ Search จะมาแทนที่บริการ Reports แบบเดิม คำค้นหาทั้งหมดจะผ่าน
SearchAds360Service
ซึ่งมี 2 วิธี ได้แก่ SearchStream และ Search สำหรับการค้นหาและ
ดึงข้อมูลการรายงานและเมตริก วิธีการค้นหาทั้ง 2 วิธีจะแสดงผลออบเจ็กต์ SearchAds360Row ทั้งหมดที่ตรงกับคำค้นหา ดูข้อมูลเพิ่มเติมได้ที่
สร้างรายงานการค้นหา
ข้อมูลเมตาของทรัพยากร
SearchAds360FieldService
ช่วยให้คุณขอแคตตาล็อกสำหรับทรัพยากร, ฟิลด์ทรัพยากร, คีย์การแบ่งกลุ่ม และเมตริกที่พร้อมใช้งานในวิธีการค้นหา SearchAds360Service ได้แบบไดนามิก ดูข้อมูลเพิ่มเติมได้ที่ ดึงข้อมูลเมตาของทรัพยากร เพื่อเรียนรู้
เพิ่มเติม
ชื่อฟิลด์
API จะแนะนำชื่อฟิลด์ที่ซ้อนกันซึ่งคั่นด้วยสัญกรณ์จุด เช่น campaign.id และ ad_group.id นอกจากนี้ คุณยังซ้อนได้อีก เช่น ad_group.campaign.id ดูข้อมูลเพิ่มเติมได้ที่
โครงสร้าง Search Ads 360 Reporting API
การรายงานใน Search Ads 360 API เวอร์ชันก่อนหน้าอิงตามฟิลด์ที่แยกกันในเอนทิตีต่างๆ สำหรับแนวคิดที่คล้ายกัน เช่น ทั้งรายงาน
campaign และ
adgroup มีฟิลด์
campaignId แยกกัน
ภาษาในการค้นหา
API จะแนะนำภาษาในการค้นหาของ Search Ads 360 ซึ่งเป็นภาษาที่ยืดหยุ่นและคล้ายกับ SQL ที่ช่วยให้คุณกำหนดคำค้นหาเพื่อดึงข้อมูลการรายงานที่เฉพาะเจาะจงซึ่งเหมาะกับธุรกิจของคุณมากที่สุด ดูข้อมูลเพิ่มเติมได้ที่ ภาษาในการค้นหาของ Search Ads 360
คำขอ GET
ใน API ใหม่ การค้นหามีบริการของตัวเอง (SearchAds360Service) แต่คำขอ GET ยังคงอยู่ในบริการเฉพาะของแต่ละเอนทิตี เช่น คุณสามารถรับ
ข้อมูลคอลัมน์ที่กำหนดเองจาก
CustomColumnService
ดูข้อมูลเพิ่มเติมได้ที่
การเปลี่ยนแปลงรูปแบบใน Search Ads 360 Reporting API
คอลัมน์ที่กำหนดเอง
ใน Search Ads 360 เวอร์ชันใหม่ คอลัมน์สูตรและ Conversion ที่กำหนดเองจะมีชื่อว่า คอลัมน์ที่กำหนดเอง
ดูข้อมูลเพิ่มเติมเกี่ยวกับคอลัมน์ที่กำหนดเอง
ใหม่
CustomColumnService
จะเปิดใช้คอลัมน์ที่กำหนดเอง หากคุณมีสิทธิ์ที่จำเป็น คุณสามารถขอทรัพยากร CustomColumn ที่เป็นของบัญชีใดก็ได้ในแผนผังบัญชี
การจัดการบัญชี
Search Ads 360 เวอร์ชันใหม่จะจัดระเบียบบัญชีเป็นลำดับชั้น ได้แก่ บัญชีดูแลจัดการ บัญชีดูแลจัดการย่อย และบัญชีลูกค้า บัญชีดูแลจัดการเปรียบได้กับบัญชีเอเจนซี และบัญชีดูแลจัดการย่อยเปรียบได้กับบัญชีผู้ลงโฆษณาใน Search Ads 360 เวอร์ชันเก่า ดูข้อมูลเพิ่มเติมได้ที่ เกี่ยวกับบัญชีดูแลจัดการของ Search Ads 360
คุณสามารถ ค้นหาแผนผังบัญชี แล้วส่งคำขอสำหรับแต่ละบัญชีที่คุณต้องการข้อมูลการรายงาน
เนื่องจากการเปลี่ยนแปลงลำดับชั้นบัญชี ฟิลด์ที่เกี่ยวข้องกับแนวคิดผู้ลงโฆษณา/เอเจนซีจึงถูกแทนที่ด้วยตัวเลือกที่เหมาะสมเพื่อให้ฟังก์ชันการทำงานเทียบเท่ากันทุกที่ที่เป็นไปได้ ดูรายการฟิลด์ที่ได้รับผลกระทบและฟิลด์ที่ใช้แทนได้ที่ การแมปฟิลด์
ส่วนหัวรหัสลูกค้าที่เข้าสู่ระบบ
login-customer-id เป็นส่วนหัวใหม่ที่จำเป็นเมื่อใช้บัญชีดูแลจัดการเพื่อเข้าถึงบัญชีดูแลจัดการย่อยหรือบัญชีลูกค้า ดูข้อมูลเพิ่มเติมได้ที่
ส่วนหัวรหัสลูกค้าที่เข้าสู่ระบบ
การกำหนดเวอร์ชัน
Search Ads 360 Reporting API ใช้
การกำหนดเวอร์ชันเชิงความหมาย โดยมีเวอร์ชันหลักและเวอร์ชันย่อย
ซึ่งจัดรูปแบบเป็น vMAJOR_MINOR ดูข้อมูลเพิ่มเติมได้ที่
การกำหนดเวอร์ชัน