โครงสร้างการรายงาน 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 แต่ละคู่จะซ้ำกันไม่ได้ทั่วโลก
รหัส CampaignCriterion	แคมเปญ คู่ CampaignId / CriterionId แต่ละคู่จะซ้ำกันไม่ได้ทั่วโลก
ส่วนขยายโฆษณา	แคมเปญ คู่ CampaignId / AdExtensionId แต่ละคู่จะซ้ำกันไม่ได้ทั่วโลก
รหัสฟีด	ทั่วโลก
รหัสรายการฟีด	ทั่วโลก
รหัสแอตทริบิวต์ฟีด	ฟีด
รหัสการแมปฟีด	ทั่วโลก
รหัสป้ายกำกับ	ทั่วโลก
รหัส UserList	ทั่วโลก

กฎรหัสเหล่านี้มีประโยชน์เมื่อออกแบบพื้นที่เก็บข้อมูลในเครื่องสําหรับออบเจ็กต์ 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 ที่แสดงผลคอลัมน์ที่กำหนดเองที่ขออย่างละเอียด