โครงสร้างการรายงาน 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 แต่ละคู่ไม่ซ้ำกันทั่วโลก
รหัสเกณฑ์ของกลุ่มโฆษณา กลุ่มโฆษณา

คู่ AdGroupId / CriterionId แต่ละคู่ไม่ซ้ำกันทั่วโลก
รหัสเกณฑ์แคมเปญ แคมเปญ

คู่ CampaignId / CriterionId แต่ละคู่ไม่ซ้ำกันทั่วโลก
ส่วนขยายโฆษณา แคมเปญ

คู่ CampaignId / AdExtensionId แต่ละคู่ไม่ซ้ำกันทั่วโลก
รหัสฟีด ประเทศทั่วโลก
รหัสรายการฟีด ประเทศทั่วโลก
รหัสแอตทริบิวต์ฟีด ฟีด
รหัสการแมปฟีด ประเทศทั่วโลก
รหัสป้ายกำกับ ประเทศทั่วโลก
รหัสรายชื่อผู้ใช้ ประเทศทั่วโลก

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