ภาษาของคำค้นหาใน Google Ads

คำศัพท์สำคัญ

ทรัพยากร

เอนทิตีใน Google Ads เช่น campaign หรือ ad_group

กลุ่ม

มิติข้อมูลที่ใช้จัดกลุ่มข้อมูล เช่น segments.date หรือ segments.device เมื่อรวมกลุ่มไว้ในอนุประโยค SELECT พร้อมกับเมตริก ระบบจะแยกเมตริกตามกลุ่ม

เมตริก

การวัดประสิทธิภาพ เช่น metrics.impressions หรือ metrics.clicks

ทรัพยากรที่มีการระบุแหล่งที่มา

ทรัพยากรที่รวมกับทรัพยากรหลักในอนุประโยค FROM โดยนัย ซึ่งช่วยให้คุณเลือกแอตทริบิวต์ของทรัพยากรดังกล่าวพร้อมกับแอตทริบิวต์ของทรัพยากรหลักได้

ค้นหาข้อมูลทรัพยากรหรือข้อมูลเมตา

ภาษาของคำค้นหาของ Google Ads สามารถค้นหา Google Ads API เพื่อหาข้อมูลประเภทต่อไปนี้ได้

• ทรัพยากรและแอตทริบิวต์ กลุ่ม และเมตริกที่เกี่ยวข้องโดยใช้ GoogleAdsService Search หรือ SearchStream: ผลลัพธ์จากการค้นหา GoogleAdsService คือรายการ GoogleAdsRow อินสแตนซ์ โดยที่ GoogleAdsRow แต่ละรายการแสดงทรัพยากร

  หากมีการขอแอตทริบิวต์หรือเมตริกใดๆ แถวจะรวมช่องเหล่านั้นด้วย หากมีการขอกลุ่มใดๆ การตอบกลับจะแสดงแถวเพิ่มเติมสำหรับทูเพิลกลุ่ม-ทรัพยากรแต่ละรายการด้วย

• ข้อมูลเมตาเกี่ยวกับช่องและทรัพยากรที่มีอยู่ใน GoogleAdsFieldService: บริการนี้มีแคตตาล็อกช่องที่ค้นหาได้พร้อมรายละเอียดเกี่ยวกับ ความเข้ากันได้และประเภท

  ผลลัพธ์จากการค้นหา GoogleAdsFieldService คือ รายการอินสแตนซ์ GoogleAdsField โดยที่แต่ละรายการ GoogleAdsField มีรายละเอียดเกี่ยวกับช่องที่ขอ

ดูรายละเอียดเพิ่มเติมเกี่ยวกับโครงสร้างคำค้นหาได้ที่โครงสร้าง คำค้นหาและไวยากรณ์ ภาษาของคำค้นหาของ Google Ads

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

ตัวอย่างคำค้นหาพื้นฐานสำหรับแอตทริบิวต์ของทรัพยากรแคมเปญที่แสดงวิธีแสดงผลรหัส ชื่อ และสถานะของแคมเปญมีดังนี้

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

คำค้นหานี้จะจัดเรียงตามรหัสแคมเปญ GoogleAdsRow แต่ละรายการที่ได้จะเป็นออบเจ็กต์ campaign ที่มีข้อมูลในช่องที่เลือก รวมถึง resource_name ของแคมเปญ

หากต้องการดูช่องอื่นๆ ที่ใช้ได้สำหรับการค้นหาแคมเปญ โปรดดูเอกสารอ้างอิง 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 ครั้ง ขณะเดียวกันก็จัดเรียงตามรหัสแคมเปญ GoogleAdsRow แต่ละรายการที่ได้จะมีช่อง metrics ที่มีข้อมูลเมตริกที่เลือก

ดูรายการเมตริกที่ค้นหาได้ในMetrics เอกสารประกอบ

ค้นหากลุ่ม

นอกจากแอตทริบิวต์ที่เลือกสำหรับทรัพยากรที่กำหนดแล้ว คุณยังค้นหากลุ่มที่เกี่ยวข้องได้ด้วย

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 ครั้ง ซึ่งคล้ายกับการค้นหาเมตริก อย่างไรก็ตาม คำค้นหานี้จะแบ่งข้อมูลตามวันที่ ซึ่งจะทำให้ GoogleAdsRow แต่ละรายการที่ได้แสดงทูเพิลของแคมเปญและ Segment วันที่ การแบ่งกลุ่มจะแยกเมตริกที่เลือก โดยจัดกลุ่มตามแต่ละกลุ่มในอนุประโยค SELECT

ดูรายการกลุ่มที่ค้นหาได้ในเอกสารประกอบ Segments

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

ในการค้นหาทรัพยากรที่กำหนด คุณอาจรวมกับทรัพยากรอื่นๆ ที่เกี่ยวข้องได้หากมี ทรัพยากรที่เกี่ยวข้องเหล่านี้เรียกว่า "ทรัพยากรที่มีการระบุแหล่งที่มา" คุณสามารถรวมกับทรัพยากรที่มีการระบุแหล่งที่มาโดยนัยได้โดยเลือกแอตทริบิวต์ในการค้นหา

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

คำค้นหานี้ไม่เพียงแต่เลือกแอตทริบิวต์ของแคมเปญเท่านั้น แต่ยังดึงแอตทริบิวต์ที่เกี่ยวข้องจากแต่ละแคมเปญที่เลือกด้วย GoogleAdsRow แต่ละรายการที่ได้จะเป็นออบเจ็กต์ campaign ที่มีข้อมูลแอตทริบิวต์ของแคมเปญที่เลือก รวมถึงแอตทริบิวต์กลยุทธ์การเสนอราคาที่เลือก bidding_strategy.name

หากต้องการดูทรัพยากรที่มีการระบุแหล่งที่มาที่ใช้ได้สำหรับการค้นหาแคมเปญ โปรดดูเอกสารอ้างอิง Campaign

แนวทางปฏิบัติแนะนำ

• เลือกเฉพาะช่องที่คุณต้องการเพื่อหลีกเลี่ยงเวลาตอบสนองที่นานและการหมดเวลา
• ใช้ LIMIT ระหว่างการพัฒนาและการทดสอบเพื่อหลีกเลี่ยงการประมวลผลชุดผลลัพธ์ขนาดใหญ่
• ใช้ตัวกรองในอนุประโยค WHERE เพื่อลดการโอนข้อมูลและขนาดการตอบกลับ
• ใช้ GoogleAdsFieldService เพื่อตรวจสอบ ความเข้ากันได้ของช่องและประเภทข้อมูลก่อนสร้างคำค้นหาที่ซับซ้อน
• โปรดทราบว่าช่องบางช่อง โดยเฉพาะช่องที่เกี่ยวข้องกับข้อมูลจำนวนมากหรือการคำนวณที่ซับซ้อน อาจเพิ่มค่าใช้จ่ายในการค้นหา

เปลี่ยนแปลงตามผลการค้นหา

เมื่อค้นหาทรัพยากรที่กำหนด คุณสามารถใช้ผลลัพธ์ที่แสดงเป็นออบเจ็กต์ แก้ไข และส่งกลับไปยังเมธอด mutate ในบริการของทรัพยากรนั้นได้ทันที ตัวอย่างเวิร์กโฟลว์มีดังนี้ 1. เรียกใช้คำค้นหาสำหรับแคมเปญทั้งหมดที่ PAUSED อยู่ในปัจจุบันและมีการแสดงผลมากกว่า 1,000 ครั้ง 1. รับออบเจ็กต์ Campaign จากช่อง campaign ของ GoogleAdsRow แต่ละรายการในการตอบกลับ 1. เปลี่ยนสถานะของแต่ละแคมเปญจาก PAUSED เป็น ENABLED 1. เรียก CampaignService.MutateCampaigns ด้วยแคมเปญที่แก้ไขแล้วเพื่ออัปเดต

ข้อมูลเมตาของช่อง

คำค้นหาที่ส่งไปยัง GoogleAdsFieldService มีไว้เพื่อดึงข้อมูลเมตาของช่อง คุณสามารถใช้ข้อมูลนี้เพื่อทำความเข้าใจวิธีใช้ช่องร่วมกันในการค้นหา เนื่องจาก API มีข้อมูลและข้อมูลเมตาที่จำเป็นสำหรับการตรวจสอบหรือสร้างคำค้นหา นักพัฒนาจึงสามารถดำเนินการดังกล่าวแบบเป็นโปรแกรมได้ ตัวอย่างคำค้นหาข้อมูลเมตาโดยทั่วไปมีดังนี้

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

คุณสามารถแทนที่ <INSERT_RESOURCE_OR_FIELD> ในคำค้นหานี้ด้วย ทรัพยากร (เช่น customer หรือ campaign) หรือช่อง (เช่น campaign.id, metrics.impressions หรือ ad_group.id)

ดูรายการช่องที่ค้นหาได้ในเอกสารประกอบ GoogleAdsField

ตัวอย่างโค้ด

ไลบรารีของไคลเอ็นต์มีตัวอย่างการใช้ ภาษาของคำค้นหาของ Google Ads ใน GoogleAdsService โฟลเดอร์การดำเนินการพื้นฐาน มีตัวอย่างเช่น GetCampaigns, GetKeywords และ SearchForGoogleAdsFields