องค์ประกอบหลักของ 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 ซึ่งแสดงผลคอลัมน์ที่กำหนดเองที่ขอโดยละเอียด