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

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

หมายเหตุ: คำขอเหล่านี้ไม่ใช่อนุประโยค FROM ในการค้นหาข้อมูลเมตาของช่อง

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกข้อมูลข้อมูลเมตาของช่องได้ที่เรียกข้อมูลข้อมูลเมตาของทรัพยากร

ดูข้อมูลเพิ่มเติม

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างการค้นหาใน Search Ads 360 Reporting API

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