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

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