Search Ads 360 Reporting API เวอร์ชันใหม่พร้อมให้ใช้งานแล้ว เข้าร่วมกลุ่ม Google searchads-api-announcements เพื่อติดตามการปรับปรุงและรุ่นที่กำลังจะเปิดตัว

หน้านี้ได้รับการแปลโดย Cloud Translation API

ข้อมูลเมตาของทรัพยากร

คุณใช้ SearchAds360FieldService ได้ เพื่อขอแคตตาล็อกแบบไดนามิกสำหรับทรัพยากร ช่องของทรัพยากร คีย์และเมตริกการแบ่งกลุ่มลูกค้าที่มีอยู่ใน SearchAds360Service Search และ SearchStream แคตตาล็อกมีข้อมูลเมตาที่สามารถ ที่ไคลเอ็นต์ Search Ads 360 Reporting API ใช้เพื่อตรวจสอบความถูกต้องและสร้าง Search Ads 360 คำสั่งภาษาในการค้นหา

ตัวอย่างคำขอ HTTP และการตอบกลับ

คำขอประกอบด้วย HTTP GET ไปยังเซิร์ฟเวอร์ Search Ads 360 Reporting API ที่ URL ต่อไปนี้:

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

ต่อไปนี้เป็นตัวอย่างของคำขอ ตามด้วยการตอบกลับจาก SearchAds360FieldServiceสำหรับทรัพยากรad_group:

ส่งคำขอ

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

คำตอบ

{
  "resourceName": "searchAds360Fields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device",
    ...
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],

  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks",
    ...
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device",
    ...
  ]
}

ในตัวอย่างนี้ อาร์เรย์ที่สำคัญคือ

attributeResources: ทรัพยากรที่เข้าร่วมทรัพยากรโดยปริยายใน FROM วรรค
metrics: เมตริกที่มีให้เลือกพร้อมกับแหล่งข้อมูลใน FROM วรรค ระบบจะป้อนข้อมูลในช่องที่มี category เป็น RESOURCE เท่านั้น
segments: แบ่งกลุ่มคีย์ที่เลือกได้ด้วยทรัพยากรในวรรคเงื่อนไข FROM จัดกลุ่มเมตริกที่ระบุไว้ใน Query เหล่านี้ จะมีการป้อนข้อมูลสำหรับช่องเท่านั้น โดยที่ category คือ RESOURCE
selectableWith: ช่องที่จะเลือกควบคู่ไปกับช่องที่กำหนดได้ แต่ไม่ได้อยู่ใน FROM ก็ได้ วรรค แอตทริบิวต์นี้มีความเกี่ยวข้องเมื่อระบุทรัพยากรหรือกลุ่มเท่านั้น ที่สามารถเลือกได้ในคำค้นหาที่ไม่ได้ระบุอยู่ใน ในวรรคเงื่อนไข FROM ตัวอย่างเช่น หากคุณเลือก ad_group.id และ segments.date จาก ad_group และคุณต้องการรวมแอตทริบิวต์จาก campaign คุณต้องตรวจสอบว่า segments.date อยู่ใน selectableWith ของแคมเปญ เนื่องจากการเลือกแอตทริบิวต์นี้ไว้กับ ฟิลด์ segments.date ที่มีอยู่

รายละเอียดข้อมูลเมตา

คุณสามารถขอแคตตาล็อกโดยใช้ SearchAds360FieldService ได้ที่ ระดับ:

ทรัพยากร: เช่น searchAds360Fields/campaign
ช่องของแหล่งข้อมูล: เช่น searchAds360Fields/campaign.name
ฟิลด์การแบ่งกลุ่ม: เช่น searchAds360Fields/segments.ad_network_type
เมตริก: เช่น searchAds360Fields/metrics.clicks

ใช้คำค้นหาเพื่อรับรายละเอียดของช่อง

คุณสามารถรับรายละเอียดฟิลด์ได้โดยส่งข้อความค้นหาไปยัง

https://searchads360.googleapis.com/v0/searchAds360Fields:search

ตัวอย่างที่ 1: การใช้นิพจน์ทั่วไป

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

ตัวอย่างที่ 2: การค้นหาช่อง เมตริก หรือกลุ่มที่เฉพาะเจาะจง

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )