Package google.ads.searchads360.v0.common

MinuteOfHour

這項排程在開始時間後幾分鐘開始。

建立作業必須填寫這個欄位，更新作業則不得填寫。

MinuteOfHour

這個時間表結束的小時過後幾分鐘。排定時間不含最後一分鐘。

建立作業必須填寫這個欄位，更新作業則不得填寫。

DayOfWeek

時間表適用的星期幾。

建立作業必須填寫這個欄位，更新作業則不得填寫。

int32

開始時間 (24 小時制)。這個欄位必須介於 0 到 23 之間 (含首尾)。

建立作業必須填寫這個欄位，更新作業則不得填寫。

int32

結束時間 (24 小時制)，24 代表一天結束。這個欄位的值必須介於 0 到 24 之間 (含首尾)。

建立作業必須填寫這個欄位，更新作業則不得填寫。

string

素材資源文字。

AgeRangeType

年齡層類型。

string

素材資源名稱。

bool

僅適用於 CustomerAsset、CampaignAsset 和 AdGroupAsset 指標。指出互動指標是發生在素材資源本身，還是其他素材資源或廣告單元。

string

資產的資源名稱。

ServedAssetFieldType

所放送素材資源的欄位類型。

string

目標對象資源名稱。

string

廣告主為商家檔案帳戶中的地點指定的標籤。這項資訊會從商家檔案帳戶同步。

string

這個地點的商家檔案商店代碼。這項資訊會從商家檔案帳戶同步。

int64

這個商家檔案地點的商家資訊 ID。這項資訊會從已連結的商家檔案帳戶同步處理。

CallToActionType

行動號召。

string

與參數標記名稱相符的鍵。

string

要替換的值。

Device

裝置的類型。

AppUrlOperatingSystemType

這個網址指定的作業系統。必填。

string

應用程式深層連結網址。深層連結會指定應用程式中與您想顯示內容相應的位置，格式應為 {scheme}://{host_path}。架構會識別要開啟的應用程式。您可以為應用程式使用以應用程式名稱開頭的自訂配置。主機和路徑會指定應用程式中內容所在的唯一位置。例如：「exampleapp://productid_1234」。必填。

GenderType

性別類型。

MimeType

圖片素材資源的 MIME 類型。

ImageDimension

這張圖片原始大小的中繼資料。

int64

圖片素材資源的檔案大小 (以位元組為單位)。

int64

圖片高度。

int64

圖片寬度。

string

傳回具有此高度和寬度的圖片的網址。

KeywordInfo

關鍵字資訊。

string

AdGroupCriterion 資源名稱。

KeywordMatchType

關鍵字的比對類型。

string

關鍵字的文字 (最多 80 個字元和 10 個字)。

string

語言常數資源名稱。

ListingGroupType

商家資訊群組類型。

string

限制動態饋給中地理區域範圍的指定地理區域常數。目前只允許一個地理位置目標常數。

LocationGroupRadiusUnits

半徑單位。地理位置指定目標常數支援英里和公尺。動態饋給項目組合支援毫英里和公尺。這是必要欄位，必須在 CREATE 作業中設定。

string

指定 FeedItem 的 FeedItemSet。如果指定多個 ID，則至少出現在一組 ID 中的所有項目都會成為指定目標。這個欄位無法與 geo_target_constants 搭配使用。這是選用設定，只能在 CREATE 作業中設定。

int64

以指定單位表示目標地區附近的半徑範圍。這是必要欄位，必須在 CREATE 作業中設定。

string

地理目標常數資源名稱。

bool

是否要根據轉換最佳化工具資料調整出價。

int64

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。

int64

出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。

double

目標廣告投資報酬率選項。如果設定了目標廣告投資報酬率，出價策略會盡量提高收益，同時將目標廣告投資報酬率設為平均值。如果目標廣告投資報酬率很高，出價策略可能無法用完預算。如未設定目標廣告投資報酬率，出價策略會盡量提高預算的廣告投資報酬率。

int64

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。

int64

出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。僅適用於組合出價策略。

int64

目標單次動作出價選項。這是指您願意為出價策略貨幣的微單位中指定的每個轉換動作支付的平均金額。如果設定了目標單次動作出價，出價策略會以不超出目標單次動作出價為前提，盡量爭取轉換。如未設定目標單次動作出價，出價策略會盡量在預算範圍內爭取最低單次動作出價。

double

所有轉換的價值。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。如要瞭解 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。

double

轉換總次數。包括所有轉換，不論 include_in_conversions_metric 的值為何。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。如要瞭解 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。

Value

轉換自訂指標。

double

可出價轉換的價值總和 (依轉換日期)。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。

double

可出價轉換類型的轉換次數總和 (依轉換日期)。由於歸因模式的關係，這項指標可能會出現小數。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。

QualityScoreBucket

廣告素材歷來品質分數。

QualityScoreBucket

歷來到達網頁體驗的品質。

QualityScoreBucket

歷來搜尋預測點閱率。

InteractionEventType

可付費和免費互動的類型。

Value

原始事件轉換指標。

double

「搜尋絕對頂端曝光比重」是指有多少百分比的搜尋廣告曝光位於最顯眼的搜尋廣告刊登位置。

double

所有來自互動的轉換 (與瀏覽後轉換相對) 除以廣告互動次數。

double

所有轉換的價值。

double

轉換總次數。包括所有轉換，不論 include_in_conversions_metric 的值為何。

double

所有轉換的價值除以廣告互動的總費用 (例如點擊文字廣告或觀看影片廣告)。

double

使用者點按廣告當下或之後，點選「通話」按鈕致電給商家的次數。電話接通與否或通話持續時間等因素，不會納入計算。

這項指標僅適用於動態饋給項目。

double

使用者點按廣告後，點選「取得路線」按鈕導航前往商家的次數。

這項指標僅適用於動態饋給項目。

double

所有互動帶來的轉換價值除以互動總數。

double

使用者點按廣告後，點選連結查看商家選單的次數。

這項指標僅適用於動態饋給項目。

double

使用者點擊廣告後下單的次數。

這項指標僅適用於動態饋給項目。

double

使用者點擊廣告後，發生其他轉換的次數 (例如：張貼評論或儲存商家地點)。

這項指標僅適用於動態饋給項目。

double

使用者點擊廣告後親臨門市的預估次數。

這項指標僅適用於動態饋給項目。

double

Search Ads 360 成功記錄並轉送至廣告主到達網頁的點擊次數。

double

使用者點按廣告後，前往商家網址的次數。

這項指標僅適用於動態饋給項目。

double

您為每次互動支付的平均金額。計算方式是將廣告總費用除以互動總次數。

double

所有點擊的總費用除以獲得的點擊總次數。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

double

平均千次曝光出價。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

點擊次數。

double

廣告符合在多媒體廣告聯播網上顯示的資格，但因為預算過低而錯失顯示機會的預估百分比。注意：內容預算錯失的曝光比重會回報在 0 到 0.9 的範圍內。如果值大於 0.9，系統會回報為 0.9001。

double

將您在多媒體廣告聯播網上獲得的曝光次數，除以預估可獲得的曝光次數後所得出的百分比。注意：內容曝光比重的範圍為 0.1 至 1。如果值低於 0.1，系統會回報為 0.0999。

double

廣告因為廣告評級偏低，而無法在多媒體廣告聯播網上獲得的預估曝光次數百分比。注意：內容排名錯失的曝光比重會回報在 0 到 0.9 的範圍內。如果值大於 0.9，系統會回報為 0.9001。

double

每項符合轉換資格的互動，可爭取轉換的平均次數 (來自互動)。顯示廣告互動促成可出價轉換的平均頻率。

double

客戶帳戶轉換的價值。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略，系統會調整出價策略來爭取這些轉換。

double

可出價轉換的價值除以符合轉換資格的互動總費用。

double

互動促成的轉換價值除以廣告互動次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略，系統會調整出價策略來爭取這些轉換。

double

客戶帳戶轉換次數。這項指標只會納入 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略，系統會調整出價策略來爭取這些轉換。

int64

這段期間的單次點擊出價和千次曝光出價費用總和。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

double

廣告互動費用除以所有轉換次數。

double

每個可出價轉換的平均單次轉換費用 (符合資格)。

double

廣告互動費用除以目前模式歸因的轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略，系統會調整出價策略來爭取這些轉換。

double

顧客在某裝置上點按廣告，然後使用其他裝置或瀏覽器完成轉換。「所有轉換」欄已納入跨裝置轉換。

double

依轉換日期計算的跨裝置轉換次數。如要瞭解 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。

double

跨裝置轉換價值的總和。

double

依轉換日期計算的跨裝置轉換價值總和。如要瞭解 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。

double

廣告獲得的點擊次數 (點擊) 除以廣告顯示次數 (曝光)。

double

轉換次數。這項指標只會納入 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用以轉換為主的出價策略，系統會調整出價策略來爭取這些轉換。

double

「轉換」欄內所含轉換的價值總和。您為轉換動作輸入價值後，這項指標才能派上用場。

double

平均品質分數。

int64

歷來品質分數。

int64

廣告顯示在搜尋結果網頁或 Google 聯播網網站上的次數。

double

使用者看到廣告後與廣告互動的頻率。計算方式為互動次數除以廣告顯示次數。

int64

互動次數。「互動」是指與特定廣告格式相關聯的主要使用者動作，例如文字和購物廣告的「點擊」，以及影片廣告的「觀看」等。

double

報表統計期內，從點擊總數 (已篩除的點擊次數 + 未篩除的點擊次數) 中篩除的點擊次數百分比。

int64

Google 認為不合理的點擊次數，這類點擊不會向您收費。

double

從點擊總數 (已篩除的點擊次數 + 未篩除的點擊次數) 中篩除一般無效點擊的百分比。這些點擊是經由例行篩除方式偵測到，且 Google 認為不符合規定的點擊，例如已知的無效資料中心流量、機器人和自動尋檢程式或其他檢索器、反常模式等。這類點擊不算廣告費，也不會影響您的帳戶統計資料。詳情請參閱說明頁面：https://support.google.com/campaignmanager/answer/6076504。

int64

一般無效點擊次數。這些點擊是透過例行篩除方式偵測到的無效點擊，例如已知的無效資料中心流量、機器人和自動尋檢程式或其他檢索器、反常模式等。這類點擊不算廣告費，也不會影響您的帳戶統計資料。詳情請參閱說明頁面：https://support.google.com/campaignmanager/answer/6076504。

double

點擊行動廣告後連到的網頁中，經判定為「行動裝置友善」的網頁所佔的比例。

double

有多少百分比的購物或搜尋廣告曝光位於最顯眼的購物廣告刊登位置。詳情請參閱 https://support.google.com/sa360/answer/9566729。如果值低於 0.1，系統會回報為 0.0999。

double

這項預估值表示廣告有多常因為預算偏低，無法成為搜尋結果中排序第一的頂端廣告。注意：搜尋聯播網錯失的絕對頂端曝光比重 (預算) 的報表範圍為 0 到 0.9。如果值大於 0.9，系統會回報為 0.9001。

double

廣告符合在搜尋聯播網上顯示的資格，但因預算過低而未顯示的次數百分比 (估計值)。注意：搜尋預算錯失的曝光比重會以 0 到 0.9 的範圍回報。如果值大於 0.9，系統會回報為 0.9001。

double

這項估算值代表廣告因預算偏低，而無法在頂端自然搜尋結果旁顯示的頻率。注意：搜尋聯播網錯失的頂端曝光比重 (預算) 的報表範圍為 0 到 0.9。如果值大於 0.9，系統會回報為 0.9001。

double

將廣告在搜尋聯播網上實際獲得的點擊次數，除以預估可獲得的點擊次數後所得出的百分比。注意：搜尋點擊比重的範圍為 0.1 到 1。如果值低於 0.1，系統會回報為 0.0999。

double

這是將廣告在搜尋聯播網上實際獲得的曝光次數，除以與您關鍵字完全相符或近似變體的搜尋字詞所帶來的預估廣告曝光次數後得出的百分比，與關鍵字比對類型無關。注意：搜尋聯播網完全比對曝光比重的回報範圍為 0.1 至 1。如果值低於 0.1，系統會回報為 0.0999。

double

此欄是將您在搜尋聯播網上獲得的曝光次數，除以預估可獲得的曝光次數後，所得到的百分比。注意：搜尋曝光比重的報表範圍為 0.1 至 1。如果值低於 0.1，系統會回報為 0.0999。

double

這項估算值代表廣告有多常因為評級不佳，無法成為搜尋結果中排序第一的頂端廣告。注意：搜尋聯播網錯失的絕對頂端曝光比重 (評級) 的報表範圍為 0 到 0.9。如果值大於 0.9，系統會回報為 0.9001。

double

廣告因為廣告評級偏低，而錯失的搜尋聯播網曝光次數預估百分比。注意：搜尋聯播網錯失的曝光比重 (排名) 範圍為 0 到 0.9。如果值大於 0.9，系統會回報為 0.9001。

double

這項估算值表示廣告有多常因為廣告評級不佳，無法在頂端自然搜尋結果旁顯示。注意：搜尋聯播網錯失的頂端曝光比重 (排名) 的報表範圍為 0 到 0.9。如果值大於 0.9，系統會回報為 0.9001。

double

相較於您有資格獲得的頂端廣告曝光預估次數，您實際獲得的頂端廣告曝光次數。注意：搜尋聯播網頂端曝光比重的報表範圍為 0.1 到 1。如果值低於 0.1，系統會回報為 0.0999。

頂端廣告通常刊登在頂端自然搜尋結果上方，但視查詢而定，也可能出現在這類搜尋結果底下。

double

廣告曝光顯示於頂端自然搜尋結果旁的百分比。

double

所有轉換的價值除以所有轉換的次數。

double

所有轉換的價值除以所有轉換的次數。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。如要瞭解 by_conversion_date 欄的詳細資料，請參閱 https://support.google.com/sa360/answer/9250611。

double

可出價轉換價值除以可出價轉換次數。顯示每個可出價轉換的平均價值。

double

可出價的轉換價值 (依轉換日期) 除以可出價的轉換次數 (依轉換日期)。顯示每個可出價轉換的平均價值 (依轉換日期)。如果選取這個資料欄和日期，日期資料欄中的值即為轉換日期。

int64

瀏覽後轉換總次數。如果消費者看到圖片或多媒體廣告，但未與其他廣告互動 (例如點擊)，之後在您的網站上完成轉換，就會計為瀏覽後轉換。

int64

「客戶帳戶交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總成本。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 $5 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「交叉銷售銷貨成本」(COGS) 是指因廣告宣傳某項產品而售出其他產品所產生的總成本。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售銷貨成本」是指所售出非宣傳產品的總成本。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的交叉銷售銷貨成本為 $5 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「客戶帳戶交叉銷售毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳某項產品而售出其他產品所產生的利潤。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後，廣告中交叉銷售所帶來的收益。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。上衣的售價是 NT$600 元，銷貨成本價值則是 NT$150 元。這筆訂單的交叉銷售毛利計算方式為 $20 美元 - $5 美元 = $15 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「交叉銷售毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳某項產品而售出其他產品所產生的利潤。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。購買清單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售毛利」是指扣除銷貨成本後，廣告中交叉銷售所帶來的收益。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。上衣的售價是 NT$600 元，銷貨成本價值則是 NT$150 元。這筆訂單的交叉銷售毛利計算方式為 $20 美元 - $5 美元 = $15 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「客戶帳戶交叉銷售收益」是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的交叉銷售收益為 $20 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「交叉銷售收益」是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的交叉銷售收益為 $20 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

double

「客戶帳戶交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。

double

「交叉銷售商品售出數量」是指因廣告宣傳某項產品而售出的其他產品總數。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售商品售出數量」是指廣告的所有訂單帶來的交叉銷售產品總數。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的交叉銷售商品售出數量為 2。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。

int64

「客戶帳戶廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，這些商品的成本就會計入廣告產品銷貨成本。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 $3 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「廣告產品銷貨成本」(COGS) 是指因廣告宣傳產品而售出該產品的總成本。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，這些商品的成本就會計入廣告產品銷貨成本。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的銷貨成本價值是 $3 美元，上衣則是 $5 美元。這筆訂單的廣告產品銷貨成本為 $3 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「客戶帳戶廣告產品毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳產品而售出該產品所產生的利潤。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，產生的銷售收益扣除銷貨成本，就是廣告產品毛利。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元，銷貨成本價值則是 NT$90 元。這筆訂單的廣告產品毛利計算方式為 $10 美元 - $3 美元 = $7 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「廣告產品毛利」是指扣除銷貨成本 (COGS) 後，因廣告宣傳產品而售出該產品所產生的利潤。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，產生的銷售收益扣除銷貨成本，就是廣告產品毛利。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 NT$300 元，銷貨成本價值則是 NT$90 元。這筆訂單的廣告產品毛利計算方式為 $10 美元 - $3 美元 = $7 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「客戶帳戶廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告產品收益中就會顯示這些產品的銷售總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的廣告產品收益為 $10 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

int64

「廣告產品收益」是指因廣告宣傳產品而售出該產品所賺取的總金額。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告產品收益中就會顯示這些產品的銷售總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $10 美元，上衣則是 $20 美元。這筆訂單的廣告產品收益為 $10 美元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這項指標是金額值，預設會以顧客的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 的 metrics_currency 參數。

double

「客戶帳戶廣告商品售出數量」是指因廣告宣傳產品而售出的該產品總數。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告商品售出數量中就會顯示售出產品總數。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。

double

「廣告商品售出數量」是指因廣告宣傳產品而售出的該產品總數。運作方式：使用者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果使用者在購買前互動的廣告含有相關產品 (請參閱「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品相符，廣告商品售出數量中就會顯示售出產品總數。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子、一件上衣和一件夾克。這筆訂單的廣告商品售出數量為 1。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。

int64

在指定時間範圍內看過您廣告的不重複使用者人數。這項指標無法匯總，且只能要求日期範圍在 92 天以下的資料。這項指標適用於下列廣告活動類型：多媒體、影片、探索和應用程式。

double

在所選時間範圍內，不重複使用者看到您廣告的平均次數。這項指標無法匯總，且只能要求日期範圍在 92 天以下的資料。這項指標適用於下列廣告活動類型：多媒體、影片、探索和應用程式。

string

必要欄位。可唯一識別行動應用程式的字串。只要包含平台原生 ID 即可，例如 Android 的「com.android.ebay」或 iOS 的「12345689」。

MobileAppVendor

必要欄位。發布這個特定應用程式的應用程式商店。

int64

出價策略可設定的最高出價上限。這是廣告主輸入的選填欄位，並在當地微觀轉換中指定。注意：系統會將零值解讀為未定義 bid_ceiling。

bool

根據轉換可能性，在每次競價中調高或調低出價。個別出價可能會超過 cpc_bid_ceiling_micros，但廣告活動的平均出價金額不應超過。

bool

廣告活動是否已啟用即時出價。

string

廣告說明的第一行。

string

廣告說明的第二行。

int64

廣告的追蹤 ID。

string

廣告標題。

string

廣告的第二個標題。

string

廣告的第三個標題。

string

廣告說明的第一行。

string

廣告說明的第二行。

string

附加至自動產生的可見網址的文字，並以分隔符號分隔。

string

以分隔符號附加至 path1 的文字。

int64

廣告的追蹤 ID。

AdTextAsset

廣告標題的文字素材資源清單。廣告放送時，系統會從這個清單中選取廣告標題。

AdTextAsset

說明的文字素材資源清單。廣告放送時，系統會從這份清單中選取說明。

string

附加至自動產生的可見網址的文字，並以分隔符號分隔。

string

以分隔符號附加至 path1 的文字。

int64

廣告的追蹤 ID。

string

廣告標題。

string

廣告說明的第一行。

string

廣告說明的第二行。

string

廣告顯示的網址。

string

廣告顯示的行動版網址。

int64

廣告的追蹤 ID。

AdNetworkType

廣告聯播網類型。

ConversionActionCategory

轉換動作類別。

Value

轉換自訂維度。

DayOfWeek

星期幾，例如 MONDAY。

Device

指標適用的裝置。

Keyword

關鍵字條件。

ProductChannel

產品管道。

ProductChannelExclusivity

產品的管道獨佔性。

ProductCondition

產品狀況。

ProductCondition

售出產品的狀況。

Value

原始事件轉換維度。

string

轉換動作的資源名稱。

string

轉換動作名稱。

string

指標適用的日期。格式為 yyyy-MM-dd，例如 2018-04-17。

string

代表城市的地理區域指定目標常數資源名稱。

string

代表國家/地區的地理位置目標常數資源名稱。

string

代表都會區的地理區域常數資源名稱。

string

代表區域的地理目標常數資源名稱。

int32

一天中的小時數，介於 0 到 23 之間 (含 0 和 23)。

string

月份，以該月第一天的日期表示。格式為 yyyy-MM-dd。

string

產品的競價類別 (第 1 層)。

string

產品的競價類別 (第 2 層)。

string

產品的競價類別 (第 3 層)。

string

產品的競價類別 (第 4 級)。

string

產品的競價類別 (第 5 層)。

string

產品品牌。

string

產品銷售國家/地區的地理區域目標常數資源名稱。

string

產品的自訂屬性 0。

string

產品的自訂屬性 1。

string

產品的自訂屬性 2。

string

產品的自訂屬性 3。

string

產品的自訂屬性 4。

string

產品的商品 ID。

string

產品語言的語言常數資源名稱。

string

售出產品的競價類別 (第 1 層)。

string

售出產品的競價類別 (第 2 層)。

string

售出產品的競價類別 (第 3 級)。

string

售出產品的競價類別 (第 4 層)。

string

售出產品的競價類別 (第 5 層)。

string

售出產品的品牌。

string

售出產品的自訂屬性 0。

string

售出產品的自訂屬性 1。

string

售出產品的自訂屬性 2。

string

售出產品的自訂屬性 3。

string

售出產品的自訂屬性 4。

string

售出產品的商品 ID。

string

售出產品的名稱。

string

售出產品的類型 (第 1 層)。

string

售出產品的類型 (第 2 層)。

string

售出產品的類型 (第 3 層)。

string

售出產品的類型 (第 4 層)。

string

售出產品的類型 (第 5 層)。

string

產品的商店 ID。

string

產品的標題。

string

產品類型 (第 1 層)。

string

產品類型 (第 2 層)。

string

產品類型 (第 3 層)。

string

產品類型 (第 4 層)。

string

產品類型 (第 5 層)。

string

以季的第一天日期表示的季。以日曆年為準，例如 2018 年第 2 季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。

string

週一到週日為一週，以週一的日期表示。格式為 yyyy-MM-dd。

int32

年份，格式為 yyyy。

AssetInteractionTarget

僅適用於 CustomerAsset、CampaignAsset 和 AdGroupAsset 指標。指出互動指標是發生在素材資源本身，還是其他素材資源或廣告單元。如果廣告連同其他元件 (例如網站連結) 一起放送，系統會將所有部分的互動 (例如點擊) 納入計算。如果 interaction_on_this_asset 為 true，表示互動發生在這個特定素材資源上；如果 interaction_on_this_asset 為 false，表示互動並非發生在這個特定素材資源上，而是發生在放送廣告的其他部分，而這個素材資源也一併放送。

int64

平均單次動作出價目標。這個目標應大於或等於帳戶幣別的最低計費單位。

int64

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。

int64

出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。

TargetImpressionShareLocation

搜尋結果網頁上的目標位置。

int64

以微秒為單位，指定廣告在目標地區放送的比例。舉例來說，1% 等於 10,000。

int64

自動出價系統可指定的最高單次點擊出價。這是廣告主輸入的必填欄位，用於設定上限，並在當地微觀區域中指定。

Int64Value

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。

TargetingDimension

這些設定適用的指定目標維度。

bool

指出是否要限制廣告只根據您為這個 targeting_dimension 選取的條件放送，或是要指定這個 targeting_dimension 的所有值，並根據其他 TargetingDimensions 中的指定目標放送廣告。值為 true 表示這些條件只會套用出價調整幅度，不會影響指定目標。如果值為 false，表示這些條件會限制指定目標，並套用出價調整幅度。

double

必要欄位。根據轉換資料計算，每單位支出的收益。值必須介於 0.01 至 1000.0 之間 (含)。

int64

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。

int64

出價策略可設定的最低出價限制。這項限制適用於策略管理的所有關鍵字。這項設定僅適用於組合出價策略。

int64

已淘汰：盡量爭取點擊的支出目標。出價工具會嘗試支出這個值或自然節流支出金額中較小的值。如未指定，系統會將預算做為支出目標。這個欄位已淘汰，不應再使用。詳情請參閱 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。

int64

出價策略可設定的最高出價上限。這項限制適用於策略管理的所有關鍵字。

TargetRestriction

限制廣告活動或廣告群組觸及範圍的指定維度設定。

string

文字素材資源的文字內容。

string

標籤的背景顏色，格式為十六進位。這個字串必須符合規則運算式「^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$」。注意：管理員帳戶可能無法顯示背景顏色。

string

標籤的簡短說明。長度不得超過 200 個字元。

string

電話號碼的雙字母國家/地區代碼。例如「US」、「us」。

string

廣告主的原始電話號碼。範例：「1234567890」、「(123)456-7890」

CallConversionReportingState

指出這個 CallAsset 應使用自己的來電轉換設定、遵循帳戶層級設定，還是停用來電轉換。

string

要將來電轉換歸因於哪個轉換動作。如未設定，系統會使用預設轉換動作。只有在 call_conversion_reporting_state 設為 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 時，這個欄位才會生效。

AdScheduleInfo

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。

bool

僅限來電廣告是否只顯示電話號碼，而不提供網站連結。適用於 Microsoft Advertising。

bool

是否應啟用來電追蹤功能。適用於 Microsoft Advertising。

bool

是否要在搜尋使用者的時區中顯示通話額外資訊。適用於 Microsoft Advertising。

string

這個素材資源的生效日期，格式為 yyyy-MM-dd。

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。

string

摘要文字。這個字串的長度應介於 1 到 25 之間 (含首尾)。

string

這個素材資源的生效日期，格式為 yyyy-MM-dd。

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。

AdScheduleInfo

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。

bool

是否要在搜尋使用者的時區中顯示資產。適用於 Microsoft Advertising。

string

地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。這個欄位是特定客戶 ID 和資產類型的專屬欄位。如要進一步瞭解地點 ID，請參閱 https://developers.google.com/places/web-service/place-id。

BusinessProfileLocation

客戶的商家所在地點清單。只有在地點素材資源是從商家檔案帳戶同步時，才會傳回這項資訊。同一個帳戶下可能有多個商家檔案資訊，但都指向同一個地點 ID。

LocationOwnershipType

地點擁有權類型。如果類型為 BUSINESS_OWNER，系統會將其做為地點額外資訊放送。如果類型為 AFFILIATE，系統會將其做為聯盟地點放送。

string

廣告主想指定的網頁。

string

用來將網頁網址分組的標籤。

string

網站連結的網址顯示文字。這個字串的長度應介於 1 到 25 之間 (含首尾)。

string

網站連結說明的第一行。如要設定，長度應介於 1 至 35 之間 (含首尾)，且必須同時設定 description2。

string

網站連結的第二行說明。如要設定，長度應介於 1 到 35 之間 (含首尾)，且必須同時設定 description1。

string

這個素材資源的生效日期，格式為 yyyy-MM-dd。

string

這個素材資源有效且仍在放送的最後日期，格式為 yyyy-MM-dd。

AdScheduleInfo

不重疊的排程清單，指定資產可放送的所有時間間隔。每天最多可設定 6 個時段，總共 42 個。

int64

用於追蹤網站連結素材資源點擊的 ID。這是 Yahoo! 僅限日本的欄位。

bool

是否要在搜尋使用者的時區中顯示網站連結素材資源。適用於 Microsoft Advertising。

bool

網站連結素材資源是否優先顯示在行動裝置上。適用於 Microsoft Advertising。

string

使用者名單資源名稱。

bool

布林值。

int64

int64。

float

浮點數。

double

雙精度浮點數。

string

字串。

WebpageConditionOperand

網頁指定目標條件的運算元。

WebpageConditionOperator

網頁指定目標條件的運算子。

string

網頁指定條件的引數。

WebpageConditionInfo

網頁指定目標的條件或邏輯運算式。評估網頁指定目標時，系統會將網頁指定目標條件清單以 AND 運算子合併。如果條件清單為空白，表示廣告活動網站的所有網頁都會成為指定目標。

建立作業必須填寫這個欄位，更新作業則不得填寫。

double

網站條件涵蓋率百分比。這是根據廣告群組和廣告活動中的網站目標、排除網站目標和排除關鍵字，計算出的網站涵蓋率百分比。舉例來說，如果涵蓋範圍傳回 1，表示涵蓋範圍為 100%。這是唯讀欄位。

string

這個參數定義的條件名稱。系統會使用名稱值，識別、排序及篩選這類參數的條件。

建立作業必須填寫這個欄位，更新作業則不得填寫。

string

YouTube 影片標題。

string

YouTube 影片 ID。這是 YouTube 影片網址中使用的 11 個字元字串值。