Search Ads 360 Reporting API 結構

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

物件階層

Search Ads 360 帳戶是物件的階層。

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

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

  • 每個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 全球
UserList ID 全球

設計 Search Ads 360 物件的本機儲存空間時，這些 ID 規則會很有幫助。

物件類型

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

資源名稱

每個資源都有專屬 resource_name 字串，可將資源及其父項串連成路徑。

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

customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID

客戶 ID 為 1234567 的 Search Ads 360 帳戶中，ID 為 987654 的廣告活動具有 resource_name：

customers/1234567/campaigns/987654

服務

您可以使用服務擷取 Search Ads 360 實體和中繼資料。服務類型有三種：

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

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

實體專屬服務的範例包括：