โครงสร้างการรายงาน API ของ Search Ads 360

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

ลำดับชั้นของออบเจ็กต์

บัญชี Search Ads 360 คือลําดับชั้นของออบเจ็กต์

• ทรัพยากรระดับบนสุดของบัญชีคือลูกค้า

• แต่ละบัญชีมีแคมเปญที่ใช้งานอยู่อย่างน้อย 1 รายการ

• แต่ละCampaignประกอบด้วยกลุ่มโฆษณาอย่างน้อย 1 กลุ่มที่จัดกลุ่มโฆษณาเป็นคอลเล็กชันเชิงตรรกะ

• แต่ละAdGroupประกอบด้วยโฆษณากลุ่มโฆษณาอย่างน้อย 1 รายการ

• คุณแนบAdGroupCriterionหรือ CampaignCriterionอย่างน้อย 1 รายการกับกลุ่มโฆษณาหรือ แคมเปญได้ เกณฑ์จะกำหนดวิธีทริกเกอร์โฆษณา

  • ประเภทเกณฑ์มีอยู่ด้วยกันหลายประเภท เช่น คีย์เวิร์ด ช่วงอายุ และ สถานที่ เกณฑ์ที่กำหนดที่ระดับแคมเปญจะส่งผลต่อทรัพยากรอื่นๆ ทั้งหมด ภายในแคมเปญ นอกจากนี้ คุณยังระบุงบประมาณและวันที่ระดับแคมเปญได้ด้วย

แหล่งข้อมูล

ทรัพยากรแสดงถึงเอนทิตีในบัญชี Search Ads 360 ตัวอย่าง แหล่งข้อมูล ได้แก่ Customer Campaign และ AdGroup

รหัสออบเจ็กต์

ออบเจ็กต์ทุกรายการใน Search Ads 360 จะระบุด้วยรหัสของตัวเอง รหัสบางรายการจะไม่ซ้ำกันทั่วโลก ซึ่งหมายถึงในบัญชี Search Ads 360 ทั้งหมด ในขณะที่รหัสอื่นๆ จะไม่ซ้ำกันภายในขอบเขตที่จำกัดเท่านั้น

กฎรหัสเหล่านี้มีประโยชน์เมื่อออกแบบที่เก็บข้อมูลในเครื่องสำหรับออบเจ็กต์ Search Ads 360

ประเภทออบเจ็กต์

ออบเจ็กต์บางอย่างใช้กับเอนทิตีได้หลายประเภท ในกรณีนี้ ออบเจ็กต์จะมีฟิลด์ type ที่อธิบายเนื้อหาของออบเจ็กต์ เช่น AdGroupAd อาจหมายถึงโฆษณาแบบข้อความ, โฆษณาโรงแรม หรือโฆษณาท้องถิ่น คุณเข้าถึงค่าประเภทได้ผ่านช่อง AdGroupAd.ad.type ระบบจะแสดงค่าของ พารามิเตอร์นี้ใน Enum AdType

ชื่อทรัพยากร

ทรัพยากรแต่ละรายการจะระบุโดยสตริง resource_name ที่ เชื่อมต่อทรัพยากรและทรัพยากรหลักเป็นเส้นทาง

ชื่อทรัพยากรแคมเปญ เช่น มีรูปแบบดังนี้

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

แคมเปญที่มีรหัส 987654 ในบัญชี Search Ads 360 ที่มีรหัสลูกค้า 1234567 มีresource_name ดังนี้

customers/1234567/campaigns/987654

บริการ

บริการช่วยให้คุณดึงข้อมูลเอนทิตีและข้อมูลเมตาของ Search Ads 360 ได้ บริการมี 3 ประเภท ได้แก่

บริการค้นหา

SearchAds360Service เป็นบริการแบบรวมที่เดียวสำหรับการดึงข้อมูลออบเจ็กต์ทรัพยากรทั้งหมดและ สถิติประสิทธิภาพ โดยมี 2 วิธี ได้แก่ Search และ SearchStream ทั้ง 2 วิธีต้องใช้การค้นหาที่ระบุทรัพยากร ที่จะค้นหา แอตทริบิวต์ของทรัพยากรและเมตริกประสิทธิภาพที่จะดึง ข้อมูล เพรดิเคตที่จะใช้ในการกรองคำขอ และกลุ่มที่จะใช้เพื่อ แบ่งสถิติประสิทธิภาพเพิ่มเติม ดูข้อมูลเพิ่มเติมได้ที่ สร้างรายงานการค้นหาและ ภาษาการค้นหาของ Search Ads 360

บริการภาคสนาม

SearchAds360FieldService ดึงข้อมูลเมตาเกี่ยวกับทรัพยากร เช่น แอตทริบิวต์ที่ใช้ได้สำหรับ ทรัพยากรและประเภทข้อมูลของทรัพยากร คุณขอแคตตาล็อกสำหรับทรัพยากร ฟิลด์ทรัพยากร คีย์การแบ่งกลุ่ม และเมตริกที่ใช้ได้ใน SearchAds360Serviceวิธีการค้นหา ดูข้อมูลเพิ่มเติมได้ที่ ดึงข้อมูลเมตาของทรัพยากร

บริการเฉพาะเอนทิตี

บริการเหล่านี้มีGETวิธีการส่งคำขอที่ดึงข้อมูลอินสแตนซ์ทรัพยากรเดียว ซึ่งมีประโยชน์ในการตรวจสอบโครงสร้างของทรัพยากร

ตัวอย่างบริการเฉพาะเอนทิตี ได้แก่

• CustomColumnService ซึ่งแสดงผลคอลัมน์ที่กำหนดเองที่ขอพร้อมรายละเอียดทั้งหมด