Package google.ads.searchads360.v0.common

MinuteOfHour

此排程開始時的分鐘數。

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

MinuteOfHour

此排程結束時間後的分鐘數。此時間表不包含結束時間。

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

DayOfWeek

要對星期幾套用時段設定。

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

int32

以 24 小時製表示的開始時間。此欄位必須介於 0 到 23 之間 (含首尾)。

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

int32

結束小時，以 24 小時製表示；24 代表當天結束。這個欄位必須介於 0 到 24 (含) 之間。

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

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

已指定 FeedItems 的 FeedItemSet。如果指定多個 ID，系統會指定出現在至少一個組合中的所有項目。這個欄位無法與 geo_target_ 常數搭配使用。此為選用項目，只能在 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

歷來搜尋預測點閱率 (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 查看指標_currency 參數。

double

平均千次曝光出價。這項指標是一個金額價值，預設會以客戶的貨幣傳回。請前往 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看指標_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 查看指標_currency 參數。

double

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

double

符合單次可出價轉換條件的平均轉換費用。

double

廣告互動費用除以目前的歸因轉換。只包含將 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價，系統會調整您的出價策略來爭取這些轉換。

double

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

double

跨裝置轉換價值總和。

double

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

double

轉換次數。只包含將 include_in_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價，系統會調整您的出價策略來爭取這些轉換。

double

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

double

平均品質分數。

int64

歷來品質分數。

int64

廣告在搜尋結果網頁或 Google 聯播網網站上出現的頻率。

double

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

int64

互動次數。「互動」是指與文字廣告和購物廣告的廣告格式點擊、影片廣告的觀看次數等主要的使用者動作。

double

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

int64

Google 認為不合理，因此沒有向您收費的點擊次數。

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 查看指標_currency 參數。

int64

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

客戶帳戶交叉銷售收益是指因廣告宣傳某項產品而售出其他產品所賺取的總金額。運作方式：消費者在網站上完成購物後，由您將透過購物車資料回報的轉換列入報表。如果消費者在購買前互動的廣告含有相關產品 (請見「購物廣告」)，系統就會將這項產品視為宣傳的產品。顧客訂單中列出的所有產品都是售出產品。如果宣傳的產品和售出產品不相符，就屬於交叉銷售。「交叉銷售收益」是指廣告中交叉銷售所產生的總價值。範例：使用者按下了帽子的購物廣告，隨後購買了同一款帽子和一件上衣。帽子的售價是 $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 查看指標_currency 參數。

double

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

double

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

int64

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

int64

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

double

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

double

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

string

必要欄位。專門用來識別行動應用程式的字串。其中應包含平台原生 ID，例如「com.android.ebay」Android 或「12345689」iOS 版。

MobileAppVendor

必要欄位。發行該應用程式的應用程式商店。

int64

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

bool

根據轉換發生的機率，向上或向下調整每次競價的出價。個別出價可能會超過 cpc_bid_floor_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 年 4 月 1 日開始。格式為 yyyy-MM-dd。

string

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

int32

年份，格式為 yyyy。

AssetInteractionTarget

只能搭配 CustomerAsset、CampaignAsset 和 AdGroupAsset 指標使用。指出互動指標是發生在素材資源本身，還是其他素材資源或廣告單元。所有廣告放送部分 (例如廣告本身和「網站連結」等元件) 一起放送時，系統都會計算兩者的互動 (例如點擊)。如果 Interact_on_this_asset 為 true，表示互動只存在於這項特定素材資源中，而互動_on_this_asset 為 false 時，表示互動不在這項特定素材資源上，而是與放送這項素材資源的其他部分互動。

int64

平均單次轉換出價目標。這個目標必須大於或等於可計費單位的最低金額 (視帳戶貨幣而定)。

int64

出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。只有組合出價策略需要設定這個選項。

int64

出價策略可設定的出價下限。這項限制會套用至策略管理的所有關鍵字。只有組合出價策略需要設定這個選項。

TargetImpressionShareLocation

搜尋結果網頁上的目標地區。

int64

選擇要在目標地區顯示的廣告部分 (以微量為單位)。例如，1% 等於 10,000。

int64

自動出價系統可以指定的最高單次點擊出價。這是廣告客戶輸入的必填欄位，用於設定上限值，並指定以當地微量為單位。

Int64Value

出價策略可設定的出價上限。這項限制會套用至策略管理的所有關鍵字。

TargetingDimension

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

bool

指出是否要限制廣告僅根據您為這個指定維度選取的條件來顯示，或是指定這個 target_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，進一步瞭解地點 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

條件或邏輯運算式，適用於指定網頁。評估指定時，系統會一併評估網頁指定條件清單。如果條件清單空白，代表已指定廣告活動網站的所有網頁。

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

double

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

string

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

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

string

YouTube 影片標題。

string

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