ภาษาการค้นหาของ Search Ads 360 ช่วยให้คุณสร้างคำค้นหาเพื่อดึงข้อมูลการรายงานและข้อมูลเมตาของทรัพยากรโดยใช้ Search Ads 360 Reporting API
ค้นหาบริการ
คุณใช้ภาษาการค้นหาของ Search Ads 360 เพื่อค้นหา API ได้โดยใช้สิ่งต่อไปนี้
SearchAds360Service
ใช้บริการนี้เพื่อค้นหาทรัพยากรและแอตทริบิวต์ กลุ่ม และเมตริกที่เกี่ยวข้อง มี 2 วิธี ได้แก่
Search
และSearchStream
การค้นหา
SearchAds360Service
รายการจะแสดงรายการอินสแตนซ์ของSearchAds360Row
ดังนี้- แต่ละแถวแสดงทรัพยากร
- หากมีคำขอ แถวจะมีช่องแอตทริบิวต์และเมตริก
- หากคุณขอกลุ่ม ระบบจะรวมแถวเพิ่มเติมสำหรับ Tuple ของทรัพยากรแต่ละกลุ่ม
ดูข้อมูลเพิ่มเติมได้ในสร้างรายงานการค้นหา
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
- แทนที่แหล่งข้อมูลหรือฟิลด์ด้วยทรัพยากร (เช่น
customer
หรือcampaign
) หรือช่อง (เช่นcampaign.id
,metrics.impressions
หรือad_group.id
)
ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกข้อมูลข้อมูลเมตาของช่องได้ที่เรียกข้อมูลข้อมูลเมตาของทรัพยากร
ดูข้อมูลเพิ่มเติม
ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างการค้นหาใน Search Ads 360 Reporting API