Package google.ads.searchads360.v0.common

MinuteOfHour

這項排程開始的起始小時過後的幾分鐘。

這個欄位是建立作業的必要欄位，但禁止在更新作業中使用。

MinuteOfHour

這個時段結束時間的後續分鐘數。時間表不包含結束分鐘。

這個欄位是建立作業的必要欄位，但禁止在更新作業中使用。

DayOfWeek

適用於排程的星期幾。

這個欄位是建立作業的必要欄位，但禁止在更新作業中使用。

int32

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

這個欄位必須用於 CREATE 作業，而且無法用於 UPDATE 作業。

int32

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

這個欄位是建立作業的必要欄位，但禁止在更新作業中使用。

string

素材資源文字。

AgeRangeType

年齡層類型。

string

素材資源名稱。

bool

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

string

資產的資源名稱。

ServedAssetFieldType

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

string

目標對象資源名稱。

string

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

string

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

int64

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

CallToActionType

行動號召。

string

與參數代碼名稱相符的鍵。

string

要替換的值。

Device

裝置的類型。

GenderType

性別類型。

MimeType

圖片素材資源的 MIME 類型。

ImageDimension

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

int64

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

int64

圖片的高度。

int64

圖片的寬度。

string

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

KeywordInfo

關鍵字資訊。

string

AdGroupCriterion 資源名稱。

KeywordMatchType

關鍵字的比對類型。

string

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

string

語言常數資源名稱。

ListingGroupType

商家資訊群組的類型。

string

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

LocationGroupRadiusUnits

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

string

指定目標的動態饋給項目組合。如果指定多個 ID，系統會將至少出現在其中一個集合中的所有項目設為目標。這個欄位無法與 geo_target_constants 搭配使用。此為選用項目，只能在 CREATE 作業中設定。

int64

指定目標地區半徑範圍的距離單位。這是必要屬性，必須在 CREATE 作業中設定。

string

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

bool

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

int64

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

int64

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

double

目標廣告投資報酬率 (ROAS) 選項。設定後，出價策略會盡量提高收益，同時將目標廣告投資報酬率設為平均值。如果目標廣告投資報酬率過高，出價策略可能無法用盡預算。如果未設定目標廣告投資報酬率，出價策略會盡量以預算達成最高廣告投資報酬率。

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

歷來搜尋預測點閱率 (CTR)。

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

平均千次曝光出價 (CPM)。這個指標是金額值，預設會以消費者的幣別傳回。請參閱 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

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

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 美元。這筆訂單的交叉銷售銷貨成本為 NT $150 元。您必須將透過購物車資料回報的轉換列入報表，才能使用這項指標。這個指標是金額值，預設會以消費者的幣別傳回。請參閱 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 中的 metrics_currency 參數

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

int64

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

int64

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

int64

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

int64

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

int64

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

int64

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

double

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

double

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

string

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

MobileAppVendor

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

int64

出價策略可設定的最高出價上限。這是廣告客戶輸入的選填欄位，並在當地微型廣告中指定。注意：解讀零值的方式與未定義 bid_ limit 相同。

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 (含) 之間的數字時數。

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 年第二季的開始時間為 2018-04-01。格式為 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 Ads。

bool

是否要啟用來電追蹤功能。適用於 Microsoft Ads。

bool

是否以搜尋使用者的時區顯示來電額外資訊。適用於 Microsoft Ads。

string

這個素材資源生效並可以開始放送的開始日期，格式為 yyyy-MM-dd。

string

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

string

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

string

這個素材資源生效並可以開始放送的開始日期，格式為 yyyy-MM-dd。

string

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

AdScheduleInfo

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

bool

是否要以搜尋使用者的時區顯示素材資源。適用於 Microsoft Ads。

string

地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。此欄位在指定客戶 ID 和資產類型中是唯一的。請參閱 https://developers.google.com/places/web-service/place-id，進一步瞭解 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 Ads。

bool

是否偏好在行動裝置上顯示網站連結素材資源。適用於 Microsoft Ads。

string

使用者清單資源名稱。

bool

布林值。

int64

int64。

float

浮動值。

double

雙倍。

string

字串。

WebpageConditionOperand

網頁指定條件的運算元式。

WebpageConditionOperator

網頁指定條件的運算子。

string

網頁指定條件的引數。

WebpageConditionInfo

條件或邏輯運算式，適用於指定網頁。評估指定目標時，系統會將網頁指定條件清單以「且」運算結合。如果條件清單空白，代表已指定廣告活動網站的所有網頁。

這個欄位是建立作業的必要欄位，但禁止在更新作業中使用。

double

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

string

由此參數定義的條件名稱。名稱值會用於識別、排序及篩選這類參數的條件。

這個欄位是建立作業的必要欄位，但禁止在更新作業中使用。

string

YouTube 影片標題。

string

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