ภาษาคําค้นหาของ 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