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