ภาษาสำหรับการค้นหาของ Search Ads 360

ภาษาการค้นหาของ Search Ads 360 ช่วยให้คุณสร้างการค้นหาเพื่อดึงข้อมูลการรายงานและข้อมูลเมตาของทรัพยากรโดยใช้ Search Ads 360 Reporting API ได้

บริการ Search

คุณสามารถใช้ภาษาการค้นหาของ 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 และดูข้อมูลเพิ่มเติมเกี่ยวกับการแบ่งกลุ่มรายงานได้ที่Segmentation

ค้นหาแอตทริบิวต์ของทรัพยากรที่เกี่ยวข้อง

นี่คือการค้นหาพื้นฐานในทรัพยากร 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 ได้ที่หัวข้อต่อไปนี้

• โครงสร้างและการใช้คําสั่งในการค้นหา
• ช่วงวันที่
• เมตริกเป็น 0
• การค้นหาตัวอย่าง
• ไวยากรณ์การค้นหา