Search Ads 360 Reporting API 結構

Search Ads 360 Reporting API 的主要元件是「資源」和「服務」。資源代表一個 Search Ads 360 實體，且您可以使用服務擷取 Search Ads 360 實體。

物件階層

Search Ads 360 帳戶是物件階層，

  • 帳戶的頂層資源是「客戶」。

  • 每個帳戶都包含一或多個有效的廣告活動。

  • 每個 Campaign 都包含一或多個廣告群組，可將廣告按照邏輯集合分類。

  • 每個 AdGroup 包含一或多個廣告群組廣告。

  • 您可以將一或多個 AdGroupCriterion 或 CampaignCriterion 附加至廣告群組或廣告活動。條件定義廣告的觸發方式。

    • 條件類型有很多種，例如關鍵字、年齡層和地區。在廣告活動層級定義的條件會影響廣告活動中的所有其他資源。此外，您也可以指定廣告活動層級預算和日期。

資源

資源代表您 Search Ads 360 帳戶中的實體。資源範例包括 Customer、Campaign 和 AdGroup。

物件 ID

Search Ads 360 中的每個物件都能透過專屬編號識別。有些 ID 是全域唯一的 ID，也就是所有 Search Ads 360 帳戶都不重複，而其他 ID 則只在限定範圍內不重複。

物件 ID 不重複範圍範圍
預算 ID 全域
廣告活動 ID 全域
廣告群組 ID 全域
廣告 ID 廣告群組

每個 AdGroupId / AdId 組合在全域範圍內都不重複。
AdGroupCriterion 編號 廣告群組

每個 AdGroupId / CriterionId 組合在全域範圍內都不重複。
CampaignCriterion 編號 廣告活動

每個 CampaignId / CriterionId 組合在全域範圍內都不重複。
廣告額外資訊 廣告活動

每個 CampaignId / AdExtensionId 組合在全域範圍內都不重複。
動態饋給 ID 全域
資訊提供項目編號 全域
資訊提供屬性編號 動態消息
資訊提供對應編號 全域
標籤 ID 全域
使用者名單 ID 全域

設計 Search Ads 360 物件的本機儲存空間時，這些 ID 規則相當實用。

物件類型

部分物件可用於多個實體類型。在這種情況下，物件會包含用來說明其內容的 type 欄位。舉例來說，AdGroupAd 可以是文字廣告、飯店廣告或地區廣告。您可以透過 AdGroupAd.ad.type 欄位存取類型值。該值會在 AdType 列舉中傳回。

資源名稱

每個資源都有專屬識別的 resource_name 字串，用於將資源及其父項串連為路徑。

舉例來說，廣告活動資源名稱的格式如下所示：

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

Search Ads 360 帳戶中 ID 為 987654 的廣告活動 (客戶 ID 為 1234567) 含有 resource_name：

customers/1234567/campaigns/987654

服務

「服務」可讓您擷取 Search Ads 360 實體和中繼資料，服務類型分為三種：

搜尋服務
SearchAds360Service 是單一整合式服務，可擷取所有資源物件和效能統計資料。這提供 Search 和 SearchStream 這兩種方法。這兩種方法都需要查詢：指定要查詢的資源、資源屬性和效能指標、篩選要求的述詞，以及進一步細分效能統計資料的區段。詳情請參閱「建立搜尋報表」和「Search Ads 360 查詢語言」這兩篇文章。
現場服務
SearchAds360FieldService 會擷取資源的中繼資料，例如資源的可用屬性及其資料類型。您可以要求目錄，以顯示 SearchAds360Service 搜尋方法中可用的資源、資源欄位、區隔索引鍵和指標。詳情請參閱「擷取資源中繼資料」一文。
實體專屬服務

這些服務提供可擷取單一資源執行個體的 GET 要求方法。這有助於檢查資源結構。

實體特定服務的範例包括：