โครงสร้างการรายงาน 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 ทั้งหมด ขณะที่รหัสอื่นๆ จะไม่เหมือนใครเฉพาะภายในขอบเขตที่จำกัดเท่านั้น

ขอบเขตความไม่ซ้ำกันของรหัสออบเจ็กต์
รหัสงบประมาณ	ทั่วโลก
รหัสแคมเปญ	ทั่วโลก
รหัส AdGroup	ทั่วโลก
รหัสโฆษณา	กลุ่มโฆษณา คู่ AdGroupId / AdId แต่ละคู่จะซ้ำกันไม่ได้ทั่วโลก
รหัส AdGroupCriterion	กลุ่มโฆษณา คู่ AdGroupId / CriterionId แต่ละคู่ไม่ซ้ำกันทั่วโลก
รหัสเกณฑ์แคมเปญ	แคมเปญ คู่ CampaignId / CriterionId แต่ละคู่จะซ้ำกันไม่ได้ทั่วโลก
ส่วนขยายโฆษณา	แคมเปญ คู่ CampaignId / AdExtensionId แต่ละคู่จะซ้ำกันไม่ได้ทั่วโลก
รหัสฟีด	ทั่วโลก
รหัสรายการฟีด	ทั่วโลก
รหัสแอตทริบิวต์ฟีด	ฟีด
รหัสการแมปฟีด	ทั่วโลก
รหัสป้ายกำกับ	ทั่วโลก
รหัส UserList	ทั่วโลก

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

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

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

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

ทรัพยากรแต่ละรายการจะได้รับการระบุโดยไม่ซ้ำกันด้วยสตริง 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 ที่แสดงผลคอลัมน์ที่กำหนดเองที่ขออย่างละเอียด