ภาษาคําค้นหาของ Search Ads 360 ช่วยให้คุณสร้างคําค้นหาเพื่อดึงข้อมูลการรายงานและข้อมูลเมตาของแหล่งข้อมูลได้โดยใช้ Search Ads 360 Reporting API
ค้นหาบริการ
คุณสามารถใช้ภาษาคําค้นหาของ Search Ads 360 เพื่อค้นหา API โดยใช้สิ่งต่อไปนี้
SearchAds360Serviceใช้บริการนี้เพื่อค้นหาทรัพยากรและแอตทริบิวต์ กลุ่ม และเมตริกที่เกี่ยวข้อง ซึ่งทำได้ 2 วิธี ได้แก่
SearchและSearchStreamการค้นหา
SearchAds360Serviceจะแสดงรายการอินสแตนซ์SearchAds360Row- แต่ละแถวแสดงทรัพยากร
- แถวจะมีแอตทริบิวต์และฟิลด์เมตริกหากมีการร้องขอ
- หากคุณขอกลุ่ม ระบบจะรวมแถวเพิ่มเติมสําหรับแต่ละคู่กลุ่มทรัพยากร
ดูข้อมูลเพิ่มเติมได้ในสร้างรายงานการค้นหา
SearchAds360FieldServiceใช้บริการนี้เพื่อค้นหาข้อมูลเมตาเกี่ยวกับช่องและทรัพยากรที่ใช้ได้ บริการนี้มีแคตตาล็อกของช่องที่สืบค้นได้ที่มีข้อมูลที่เฉพาะเจาะจงเกี่ยวกับความเข้ากันได้และประเภทของช่อง
SearchAds360FieldServiceแสดงรายการอินสแตนซ์SearchAds360Fieldดังนี้- โดยแต่ละช่องจะมีรายละเอียดเกี่ยวกับช่องที่ขอ
ดูเรียกข้อมูลข้อมูลเมตาของทรัพยากรเพื่อดูข้อมูลเพิ่มเติม
ตัวอย่างการค้นหาพื้นฐาน
ส่วนต่อไปนี้แสดงตัวอย่างการค้นหาพื้นฐานที่คุณสามารถนำไปปรับใช้เพื่อสร้างการค้นหาของคุณเอง
ค้นหาแอตทริบิวต์ของทรัพยากร
นี่คือการค้นหาพื้นฐานสําหรับแอตทริบิวต์ของทรัพยากร campaign ซึ่งแสดงรหัส ชื่อ และสถานะแคมเปญ
SELECT
campaign.id,
campaign.name,
campaign.status
FROM campaign
ORDER BY campaign.id
SearchAds360Rowที่แสดงผลแต่ละรายการแสดงถึงออบเจ็กต์campaign- ระบบจะป้อนข้อมูลในแถวด้วยฟิลด์ที่เลือก (รวมถึง
resource_nameของแคมเปญที่ระบุ) - คำสั่งค้นหาจะจัดเรียงตามรหัสแคมเปญ
ดูช่องอื่นๆ ที่มีให้ใช้งานในการค้นหาได้ที่ campaign
ค้นหาเมตริก
การค้นหาพื้นฐานสําหรับเมตริกที่เกี่ยวข้องกับแอตทริบิวต์ของcampaign
ทรัพยากร
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
ORDER BY campaign.id
- การค้นหาจะแสดงแคมเปญที่มีสถานะ
PAUSEDและการแสดงผลมากกว่า 1,000 ครั้ง SearchAds360Rowที่แสดงผลแต่ละรายการจะมีช่องmetricsที่สร้างขึ้นจากเมตริกที่เลือก- คำสั่งค้นหาจะจัดเรียงตามรหัสแคมเปญ
โปรดดู metrics สำหรับเมตริกอื่นๆ ที่ใช้ได้ซึ่งคุณใช้ในการค้นหาได้
ค้นหากลุ่ม
นี่คือการค้นหาพื้นฐานสำหรับกลุ่มที่เกี่ยวข้องกับแอตทริบิวต์ของcampaignแหล่งข้อมูล
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
AND metrics.impressions > 1000
AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
- การค้นหาจะแสดงแคมเปญที่มีสถานะ
PAUSEDและการแสดงผลมากกว่า 1,000 ครั้ง - แบ่งกลุ่มข้อมูลตามวันที่
SearchAds360Rowแต่ละรายการจึงแสดงถึงทูเปิลของแคมเปญและกลุ่มวันที่ตามการแบ่งกลุ่ม- คำสั่งค้นหาจะจัดเรียงตามรหัสแคมเปญ
ดู segments สำหรับรายการกลุ่มที่คุณสามารถใช้ในการค้นหาและการแบ่งกลุ่มสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการแบ่งกลุ่มรายงาน
การค้นหาแอตทริบิวต์ของทรัพยากรที่เกี่ยวข้อง
นี่เป็นคําค้นหาพื้นฐานในทรัพยากร campaign ที่รวมแอตทริบิวต์ของทรัพยากร
bidding_strategy หากมี ทรัพยากรที่เกี่ยวข้องประเภทนี้เรียกว่าทรัพยากรที่มีการระบุแหล่งที่มา
SELECT
campaign.id,
campaign.name,
campaign.status,
bidding_strategy.name
FROM campaign
ORDER BY campaign.id
- คําค้นหาจะเลือกแอตทริบิวต์แคมเปญและแอตทริบิวต์ที่เกี่ยวข้องจากแคมเปญแต่ละรายการที่เลือก
SearchAds360Rowที่แสดงผลแต่ละรายการแสดงถึงออบเจ็กต์campaignซึ่งมีแอตทริบิวต์แคมเปญที่เลือก รวมถึงแอตทริบิวต์กลยุทธ์การเสนอราคาที่เลือกbidding_strategy.name
ดู campaign
เพื่อดูแหล่งข้อมูลที่ระบุแหล่งที่มาซึ่งพร้อมใช้งานสําหรับการค้นหาแคมเปญ
ค้นหาข้อมูลเมตาของช่อง
คุณสามารถใช้ SearchAds360FieldService เพื่อเรียกข้อมูลเมตาของช่อง
นี่คือการค้นหาพื้นฐานสําหรับข้อมูลเมตาของช่อง
SELECT name, category, selectable, filterable, sortable, selectable_with, data_type, is_repeated WHERE name = RESOURCE/FIELD
- แทนที่ RESOURCE OR FIELD ด้วยทรัพยากร (เช่น
customerหรือcampaign) หรือฟิลด์ (เช่นcampaign.id,metrics.impressionsหรือad_group.id)
ดูข้อมูลเพิ่มเติมเกี่ยวกับการดึงข้อมูลข้อมูลเมตาของช่องได้ในเรียกข้อมูลข้อมูลเมตาของทรัพยากร
ดูข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างการค้นหาใน Search Ads 360 Reporting API