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