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