Search Ads 360 Reporting API ทำงานโดยอิงตามแพลตฟอร์มที่ทันสมัยและนำเสนอแนวคิดใหม่หลายประการ ซึ่งจะอธิบายในส่วนต่อไปนี้
แหล่งข้อมูล
ออบเจ็กต์ทรัพยากรจะแทนที่ประเภทรายงาน ตอนนี้คุณสามารถค้นหาแหล่งข้อมูลทั้งหมดโดยใช้ภาษาการค้นหาแบบใหม่ซึ่งคล้ายกับ SQL แทนที่จะต้องขอประเภทรายงานที่กําหนดไว้ล่วงหน้า โปรดดูข้อมูลเพิ่มเติมที่โครงสร้างของ Search Ads 360 Reporting API
การรายงานการค้นหา
Search มีบริการของตัวเองใน API ใหม่ บริการ Search จะแทนที่บริการรายงานเดิม การค้นหาทั้งหมดจะผ่าน 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
รับคำขอ
ใน 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 ดูข้อมูลเพิ่มเติมที่การกำหนดเวอร์ชัน