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

在客戶 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 要求方法，可擷取單一資源例項。這有助於檢查資源的結構。

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