Package google.ads.searchads360.v0.common

索引

AdScheduleInfo

代表 AdSchedule 條件。

AdSchedule 可指定為星期幾,以及在哪個時段顯示廣告。

同一天最多只能新增 6 個廣告時段。

欄位
start_minute

MinuteOfHour

此排程開始時的分鐘數。

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

end_minute

MinuteOfHour

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

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

day_of_week

DayOfWeek

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

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

start_hour

int32

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

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

end_hour

int32

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

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

AdTextAsset

廣告中使用的文字素材資源。

欄位
text

string

素材資源文字。

AgeRangeInfo

年齡層條件。

欄位
type

AgeRangeType

年齡層類型。

AssetInteractionTarget

AssetInteractionTarget 區隔。

欄位
asset

string

資產資源名稱。

interaction_on_this_asset

bool

只能搭配 CustomerAsset、CampaignAsset 和 AdGroupAsset 指標使用。指出互動指標是發生在素材資源本身,還是其他素材資源或廣告單元。

AssetUsage

內含資產的使用資訊。

欄位
asset

string

資產的資源名稱。

served_asset_field_type

ServedAssetFieldType

資產放送的欄位類型。

AudienceInfo

目標對象條件。

欄位
audience

string

目標對象資源名稱。

BusinessProfileLocation

從已連結的商家檔案帳戶同步處理的商家檔案位置資料。

欄位
labels[]

string

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

store_code

string

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

listing_id

int64

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

CallToActionAsset

行動號召素材資源。

欄位
call_to_action

CallToActionType

行動號召。

CustomParameter

tracking_url_templatefinal_urlsmobile_final_urls 中可由自訂參數標記使用的對應。

欄位
key

string

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

value

string

要替換的值。

DeviceInfo

裝置條件。

欄位
type

Device

裝置的類型。

EnhancedCpc

這個類型沒有任何欄位。

自動出價策略會根據點擊促成轉換的機率調整出價,

這項出價策略已淘汰,無法再建立。將 ManualCpc 設為 true,並將後者設為 true。

FrequencyCapEntry

這個類型沒有任何欄位。

此規則可指定廣告 (或某組廣告) 在特定時間範圍內,向使用者顯示的次數上限。

GenderInfo

性別條件。

欄位
type

GenderType

性別類型。

ImageAsset

圖片素材資源。

欄位
mime_type

MimeType

圖片素材資源的 MIME 類型。

full_size

ImageDimension

這張圖片的原始大小。

file_size

int64

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

ImageDimension

特定大小圖片的中繼資料 (原始或已調整大小)。

欄位
height_pixels

int64

圖片的高度。

width_pixels

int64

圖片的寬度。

url

string

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

關鍵字

關鍵字條件區隔。

欄位
info

KeywordInfo

關鍵字資訊。

ad_group_criterion

string

AdGroupCriterion 資源名稱。

KeywordInfo

關鍵字條件。

欄位
match_type

KeywordMatchType

關鍵字的比對類型。

text

string

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

LanguageInfo

語言條件。

欄位
language_constant

string

語言常數資源名稱。

ListingGroupInfo

商家資訊群組條件。

欄位
type

ListingGroupType

商家資訊群組的類型。

LocationGroupInfo

透過動態饋給指定的地點清單周圍的半徑範圍。

欄位
geo_target_constants[]

string

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

radius_units

LocationGroupRadiusUnits

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

feed_item_sets[]

string

已指定 FeedItems 的 FeedItemSet。如果指定多個 ID,系統會指定出現在至少一個組合中的所有項目。這個欄位無法與 geo_target_ 常數搭配使用。此為選用項目,只能在 CREATE 作業中設定。

radius

int64

以指定指定地區周圍半徑為單位的距離。這是必要項目,必須在 CREATE 作業中設定。

地點資訊

位置條件。

欄位
geo_target_constant

string

指定地理區域常數資源名稱。

ManualCpa

這個類型沒有任何欄位。

手動出價策略,讓廣告主可以依據廣告主指定的操作設定出價。

ManualCpc

手動單次點擊出價,表示使用者必須按每次點擊付費。

欄位
enhanced_cpc_enabled

bool

是否根據「轉換最佳化工具」資料改善出價。

ManualCpm

這個類型沒有任何欄位。

這種手動出價方式,表示使用者每千次曝光付費。

MaximizeConversionValue

自動出價策略,善用你的預算為廣告活動爭取最高轉換價值。

欄位
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_roas

double

「目標廣告投資報酬率」選項。如果設定這項策略,出價策略會在計算目標廣告投資報酬率的同時,盡可能提高收益。如果目標廣告投資報酬率偏高,出價策略可能無法支出所有預算。如未設定目標廣告投資報酬率,出價策略會在預算範圍內盡可能爭取最高的廣告投資報酬率。

MaximizeConversions

一種自動出價策略,可善用你的預算為廣告活動爭取最多轉換。

欄位
cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

目標單次操作出價選項。這是指您願意為每個轉換動作支付的平均金額 (以採用出價策略幣別的微量單位計算)。如果設定這項功能,出價策略會以您指定或更低的單次動作出價,盡可能爭取最多轉換。如未設定目標單次轉換出價,出價策略將盡力在預算範圍內盡可能達到最低單次轉換出價。

指標

指標資料。

欄位
all_conversions_value_by_conversion_date

double

所有轉換的價值。如果選取這個欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/sa360/answer/9250611

all_conversions_by_conversion_date

double

轉換總數。這包含所有轉換,不論 include_in_conversions_metric 的值為何。如果選取這個欄和日期,日期欄中的值代表轉換日期。如需 by_conversion_date 欄的詳細資料,請參閱 https://support.google.com/sa360/answer/9250611

conversion_custom_metrics[]

Value

轉換自訂指標。

conversions_value_by_conversion_date

double

按轉換日期列出的可出價轉換價值總和。如果選取這個欄和日期,日期欄中的值代表轉換日期。

conversions_by_conversion_date

double

可出價轉換類型的轉換次數總和 (按轉換日期劃分)。可能受到歸因模式影響。如果選取這個欄和日期,日期欄中的值代表轉換日期。

historical_creative_quality_score

QualityScoreBucket

廣告素材歷來品質分數。

historical_landing_page_quality_score

QualityScoreBucket

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

historical_search_predicted_ctr

QualityScoreBucket

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

interaction_event_types[]

InteractionEventType

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

raw_event_conversion_metrics[]

Value

原始事件轉換指標。

absolute_top_impression_percentage

double

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

all_conversions_from_interactions_rate

double

互動帶來的所有轉換 (而不是瀏覽後轉換) 除以廣告互動次數。

all_conversions_value

double

所有轉換的價值。

all_conversions

double

轉換總數。這包含所有轉換,不論 include_in_conversions_metric 的值為何。

all_conversions_value_per_cost

double

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

all_conversions_from_click_to_call

double

使用者點擊「通話」的次數按鈕,在點擊廣告期間或之後致電商家。電話接通與否或通話持續時間等因素,不會列入計算。

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

all_conversions_from_directions

double

使用者點按「規劃路線」的次數按鈕,前往商店。

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

all_conversions_from_interactions_value_per_interaction

double

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

all_conversions_from_menu

double

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

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

all_conversions_from_order

double

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

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

all_conversions_from_other_engagement

double

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

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

all_conversions_from_store_visit

double

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

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

visits

double

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

all_conversions_from_store_website

double

使用者點擊廣告後,造訪商家網址的次數。

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

average_cost

double

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

average_cpc

double

所有點擊的總費用除以獲得的點擊總數。這項指標是一個金額價值,預設會以客戶的貨幣傳回。請前往 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看指標_currency 參數。

average_cpm

double

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

clicks

int64

點擊次數。

content_budget_lost_impression_share

double

廣告因為預算過低而無法在多媒體廣告聯播網上顯示的次數百分比。注意:內容聯播網預算錯失的曝光比重必須介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

content_impression_share

double

將廣告在多媒體廣告聯播網上實際獲得的曝光次數除以預估曝光次數後,所得到的百分比。注意:內容曝光比重會以 0.1 到 1 的範圍表示。小於 0.1 的值都會回報為 0.0999。

content_rank_lost_impression_share

double

廣告因為廣告評級偏低而無法在多媒體廣告聯播網上獲得的預估曝光百分比。注意:記錄中錯失的曝光比重介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

conversions_from_interactions_rate

double

單次轉換有效互動的平均可出價轉換 (來自互動)。顯示廣告互動促成可出價轉換的平均頻率。

client_account_conversions_value

double

客戶帳戶轉換價值。只包含將 include_in_client_account_conversions_metric 屬性設為 true 的轉換動作。如果您使用轉換型出價,系統會調整您的出價策略來爭取這些轉換。

conversions_value_per_cost

double

可出價轉換價值除以有效轉換互動的總費用。

conversions_from_interactions_value_per_interaction

double

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

client_account_conversions

double

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

cost_micros

int64

這段期間的單次點擊出價和千次曝光出價總和。這項指標是一個金額價值,預設會以客戶的貨幣傳回。請前往 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause 查看指標_currency 參數。

cost_per_all_conversions

double

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

cost_per_conversion

double

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

cost_per_current_model_attributed_conversion

double

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

cross_device_conversions

double

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

cross_device_conversions_value

double

跨裝置轉換價值總和。

ctr

double

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

conversions

double

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

conversions_value

double

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

average_quality_score

double

平均品質分數。

historical_quality_score

int64

歷來品質分數。

impressions

int64

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

interaction_rate

double

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

interactions

int64

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

invalid_click_rate

double

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

invalid_clicks

int64

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

mobile_friendly_clicks_percentage

double

前往適合透過行動裝置瀏覽的網頁的行動點擊百分比。

search_absolute_top_impression_share

double

消費者的購物或搜尋廣告曝光中,位於最顯眼的購物廣告刊登位置的百分比。詳情請參閱 https://support.google.com/sa360/answer/9566729。小於 0.1 的值都會回報為 0.0999。

search_budget_lost_absolute_top_impression_share

double

這個數字代表廣告因預算偏低,而無法成為搜尋結果頂端廣告的頻率。注意:搜尋聯播網預算錯失的絕對頂端曝光比重,介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

search_budget_lost_impression_share

double

廣告因預算過低而無法在搜尋聯播網上顯示的次數預估百分比。注意:系統記錄的搜尋聯播網預算錯失曝光比重,介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

search_budget_lost_top_impression_share

double

這個數字代表廣告因為預算偏低,而無法顯示於頂端自然搜尋結果旁的頻率。注意:搜尋聯播網預算錯失的頂端曝光比重,介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

search_click_share

double

將廣告在搜尋聯播網上實際獲得的點擊次數,除以預估點擊次數後所得出的百分比。注意:所記錄的搜尋點擊比重介於 0.1 到 1 之間。小於 0.1 的值都會回報為 0.0999。

search_exact_match_impression_share

double

廣告在搜尋聯播網上實際獲得的曝光次數,是將與關鍵字完全相符 (或是關鍵字的近似變體) 相符 (無論關鍵字比對類型為何) 相近。注意:所記錄的搜尋聯播網完全比對曝光比重介於 0.1 到 1 之間。小於 0.1 的值都會回報為 0.0999。

search_impression_share

double

將廣告在搜尋聯播網上實際獲得的曝光次數,除以預估曝光次數後所得出的百分比。注意:系統記錄的搜尋聯播網曝光比重介於 0.1 到 1 之間。小於 0.1 的值都會回報為 0.0999。

search_rank_lost_absolute_top_impression_share

double

這個數字代表廣告因為廣告評級不佳,而無法成為搜尋結果頂端廣告的頻率。注意:搜尋聯播網排名錯失的絕對頂端曝光比重,介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

search_rank_lost_impression_share

double

您的廣告因為廣告評級偏低而無法在搜尋聯播網上獲得的預估曝光百分比。注意:「搜尋聯播網排名錯失的曝光比重」的範圍介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

search_rank_lost_top_impression_share

double

這個數字代表廣告因為廣告評級不佳,而無法在頂端自然搜尋結果旁顯示的頻率。注意:「搜尋聯播網:錯失的頂端曝光比重」的範圍介於 0 到 0.9 之間。超過 0.9 的值會回報為 0.9001。

search_top_impression_share

double

相較於廣告預估有資格獲得的曝光次數,廣告在頂端廣告中實際獲得的曝光次數。注意:「搜尋聯播網頂端曝光比重」的範圍介於 0.1 到 1 之間。小於 0.1 的值都會回報為 0.0999。

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

top_impression_percentage

double

這是指在頂端自然搜尋結果旁,廣告曝光次數所佔的百分比。

value_per_all_conversions

double

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

value_per_all_conversions_by_conversion_date

double

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

value_per_conversion

double

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

value_per_conversions_by_conversion_date

double

可出價轉換價值 (按轉換日期劃分) 除以可出價轉換 (按轉換日期)。顯示每項可出價轉換的平均價值 (依轉換日期)。如果選取這個欄和日期,日期欄中的值代表轉換日期。

client_account_view_through_conversions

int64

瀏覽後轉換總次數。當客戶觀看圖像或互動式多媒體廣告後,在您的網站上完成轉換 (例如點擊) 其他廣告,就可能會發生這種情況。

client_account_cross_sell_cost_of_goods_sold_micros

int64

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

cross_sell_cost_of_goods_sold_micros

int64

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

client_account_cross_sell_gross_profit_micros

int64

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

cross_sell_gross_profit_micros

int64

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

client_account_cross_sell_revenue_micros

int64

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

cross_sell_revenue_micros

int64

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

client_account_cross_sell_units_sold

double

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

cross_sell_units_sold

double

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

client_account_lead_cost_of_goods_sold_micros

int64

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

lead_cost_of_goods_sold_micros

int64

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

client_account_lead_gross_profit_micros

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 參數。

lead_gross_profit_micros

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 參數。

client_account_lead_revenue_micros

int64

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

lead_revenue_micros

int64

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

client_account_lead_units_sold

double

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

lead_units_sold

double

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

MobileAppAsset

代表行動應用程式的素材資源。

欄位
app_id

string

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

app_store

MobileAppVendor

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

PercentCpc

出價策略,出價僅為部分商品或服務的廣告價格的一部分。

欄位
cpc_bid_ceiling_micros

int64

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

enhanced_cpc_enabled

bool

根據轉換發生的機率,向上或向下調整每次競價的出價。個別出價可能會超過 cpc_bid_floor_micros,但廣告活動的平均出價金額不應超過這個金額。

RealTimeBiddingSetting

即時出價設定;只有指定 Ad Exchange 聯播網的廣告活動才能使用這項功能。

欄位
opt_in

bool

指出廣告活動是否選擇採用即時出價。

SearchAds360ExpandedDynamicSearchAdInfo

延展型動態搜尋廣告。

欄位
description1

string

廣告說明的第一行。

description2

string

廣告說明的第二行。

ad_tracking_id

int64

廣告的追蹤 ID。

SearchAds360ExpandedTextAdInfo

Search Ads 360 延展型文字廣告。

欄位
headline

string

廣告標題。

headline2

string

廣告的第二個標題。

headline3

string

廣告的第三個標題。

description1

string

廣告說明的第一行。

description2

string

廣告說明的第二行。

path1

string

附加至自動產生的顯示網址的文字,並加上分隔符號。

path2

string

文字已附加至 path1 (使用分隔符號)。

ad_tracking_id

int64

廣告的追蹤 ID。

SearchAds360ProductAdInfo

這個類型沒有任何欄位。

Search Ads 360 產品廣告。

SearchAds360ResponsiveSearchAdInfo

Search Ads 360 回應式搜尋廣告。

欄位
headlines[]

AdTextAsset

廣告標題的文字素材資源清單。當廣告放送時,系統會從這份清單中選取所需標題。

descriptions[]

AdTextAsset

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

path1

string

附加至自動產生的顯示網址的文字,並加上分隔符號。

path2

string

文字已附加至 path1 (使用分隔符號)。

ad_tracking_id

int64

廣告的追蹤 ID。

SearchAds360TextAdInfo

Search Ads 360 文字廣告。

欄位
headline

string

廣告標題。

description1

string

廣告說明的第一行。

description2

string

廣告說明的第二行。

display_url

string

廣告的顯示網址。

display_mobile_url

string

廣告的行動版網址。

ad_tracking_id

int64

廣告的追蹤 ID。

路段

「僅限區隔」欄位。

欄位
ad_network_type

AdNetworkType

廣告聯播網類型。

conversion_action_category

ConversionActionCategory

轉換動作類別。

conversion_custom_dimensions[]

Value

轉換自訂維度。

day_of_week

DayOfWeek

星期幾,例如 MONDAY。

device

Device

指標適用的裝置。

keyword

Keyword

關鍵字條件。

product_channel

ProductChannel

產品的通路。

product_channel_exclusivity

ProductChannelExclusivity

產品的通路獨佔性。

product_condition

ProductCondition

產品的狀況。

product_sold_condition

ProductCondition

售出產品的狀況。

raw_event_conversion_dimensions[]

Value

原始事件轉換維度。

conversion_action

string

轉換動作的資源名稱。

conversion_action_name

string

轉換動作名稱。

date

string

指標的套用日期。yyyy-MM-dd 格式,例如 2018-04-17。

geo_target_city

string

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

geo_target_country

string

代表國家/地區的指定地理區域常數資源名稱。

geo_target_metro

string

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

geo_target_region

string

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

hour

int32

以 0 到 23 (含) 之間的數字時數。

month

string

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

product_bidding_category_level1

string

產品的出價類別 (層級 1)。

product_bidding_category_level2

string

產品的出價類別 (層級 2)。

product_bidding_category_level3

string

產品的出價類別 (層級 3)。

product_bidding_category_level4

string

產品的出價類別 (層級 4)。

product_bidding_category_level5

string

產品的出價類別 (層級 5)。

product_brand

string

產品的品牌。

product_country

string

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

product_custom_attribute0

string

產品的自訂屬性 0。

product_custom_attribute1

string

產品的自訂屬性 1。

product_custom_attribute2

string

產品的自訂屬性 2。

product_custom_attribute3

string

產品的自訂屬性 3。

product_custom_attribute4

string

產品的自訂屬性 4。

product_item_id

string

產品的項目 ID。

product_language

string

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

product_sold_bidding_category_level1

string

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

product_sold_bidding_category_level2

string

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

product_sold_bidding_category_level3

string

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

product_sold_bidding_category_level4

string

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

product_sold_bidding_category_level5

string

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

product_sold_brand

string

售出產品的品牌。

product_sold_custom_attribute0

string

售出產品的自訂屬性 0。

product_sold_custom_attribute1

string

售出產品的自訂屬性 1。

product_sold_custom_attribute2

string

售出產品的自訂屬性 2。

product_sold_custom_attribute3

string

售出產品的自訂屬性 3。

product_sold_custom_attribute4

string

售出產品的自訂屬性 4。

product_sold_item_id

string

售出產品的項目 ID。

product_sold_title

string

售出產品的名稱。

product_sold_type_l1

string

售出產品類型 (層級 1)。

product_sold_type_l2

string

售出產品類型 (層級 2)。

product_sold_type_l3

string

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

product_sold_type_l4

string

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

product_sold_type_l5

string

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

product_store_id

string

產品的商店 ID。

product_title

string

產品的標題。

product_type_l1

string

產品的類型 (層級 1)。

product_type_l2

string

產品類型 (層級 2)。

product_type_l3

string

產品的類型 (層級 3)。

product_type_l4

string

產品的類型 (層級 4)。

product_type_l5

string

產品的類型 (層級 5)。

quarter

string

以季度第一天的日期表示的季度。採用當季日曆的年份,例如 2018 年第二季從 2018 年 4 月 1 日開始。格式為 yyyy-MM-dd。

week

string

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

year

int32

年份,格式為 yyyy。

asset_interaction_target

AssetInteractionTarget

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

TargetCpa

這是一種自動出價策略,可根據您指定的目標單次轉換出價盡量爭取轉換。

欄位
target_cpa_micros

int64

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetCpm

這個類型沒有任何欄位。

目標千次曝光出價是一種自動出價策略,可根據您設定的目標千次曝光出價設定出價,爭取最佳成效。

TargetImpressionShare

這種自動出價策略可設定出價,讓一定百分比的搜尋廣告顯示在第一頁 (或其他目標地區) 的頂端。

欄位
location

TargetImpressionShareLocation

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

location_fraction_micros

int64

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

cpc_bid_ceiling_micros

int64

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

TargetOutrankShare

這是一種自動出價策略,可根據競價目標比例設定出價,且廣告客戶應超越特定競爭對手。這項策略已淘汰。

欄位
cpc_bid_ceiling_micros

Int64Value

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

TargetRestriction

依指定維度指定的清單。

欄位
targeting_dimension

TargetingDimension

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

bid_only

bool

指出是否要限制廣告僅根據您為這個指定維度選取的條件來顯示,或是指定這個 target_dimension 的所有值,並依據您在其他 TargetingDimensions 中的指定目標顯示廣告。如果值為 true,表示這些條件只會套用出價調節係數,不會影響指定目標。如果值為 false,表示這些條件會限制指定目標,並套用出價調節係數。

TargetRoas

一種自動出價策略,可盡量提升收益,同時計算指定的目標廣告投資報酬率。

欄位
target_roas

double

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

cpc_bid_ceiling_micros

int64

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

cpc_bid_floor_micros

int64

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

TargetSpend

這是一種自動出價策略,可為您設定出價,在您的預算範圍內儘可能爭取點擊。

欄位
target_spend_micros
(deprecated)

int64

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

cpc_bid_ceiling_micros

int64

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

TargetingSetting

廣告活動和廣告群組層級的指定目標相關功能設定。如要進一步瞭解指定目標設定,請參閱:https://support.google.com/google-ads/answer/7365594

欄位
target_restrictions[]

TargetRestriction

以個別指定目標的維度設定,用來限制廣告活動或廣告群組的觸及率。

TextAsset

文字素材資源。

欄位
text

string

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

TextLabel

一種標籤類型會在彩色背景上顯示文字。

欄位
background_color

string

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

description

string

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

UnifiedCallAsset

統一的電話素材資源。

欄位
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

指出此 CallAsset 應使用專屬的來電轉換設定、遵循帳戶層級設定或停用來電轉換。

call_conversion_action

string

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

ad_schedule_targets[]

AdScheduleInfo

不重疊的時間表清單,用於指定素材資源可放送的所有時間間隔。每天最多可以設定 6 個排程,總共 42 個。

call_only

bool

是否僅顯示電話號碼,但不會顯示網站連結。適用於 Microsoft Ads。

call_tracking_enabled

bool

是否應為通話追蹤啟用通話。適用於 Microsoft Ads。

use_searcher_time_zone

bool

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

start_date

string

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

end_date

string

這個素材資源生效且仍在放送的日期 (格式為 yyyy-MM-dd)。

UnifiedCalloutAsset

統一的摘要素材資源。

欄位
callout_text

string

摘要文字。此字串長度必須介於 1 到 25 (含) 個字元之間。

start_date

string

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

end_date

string

這個素材資源生效且仍在放送的日期 (格式為 yyyy-MM-dd)。

ad_schedule_targets[]

AdScheduleInfo

不重疊的時間表清單,用於指定素材資源可放送的所有時間間隔。每天最多可以設定 6 個排程,總共 42 個。

use_searcher_time_zone

bool

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

UnifiedLocationAsset

統一的地點素材資源。

欄位
place_id

string

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

business_profile_locations[]

BusinessProfileLocation

客戶的商家所在地點清單。只有從商家檔案帳戶同步處理地點素材資源時,系統才會傳回這項資訊。你可以在同一個帳戶下有多個商家檔案資訊指向同一個地點 ID。

location_ownership_type

LocationOwnershipType

地點擁有權的類型。如果類型為「BUSINESS_OWNER」,就會以地點額外資訊的形式放送。如果類型為「AFFILIATE」,則會以經銷地點的形式放送。

UnifiedPageFeedAsset

統合網頁動態饋給素材資源。

欄位
page_url

string

廣告客戶想要指定的網頁。

labels[]

string

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

UnifiedSitelinkAsset

統一的網站連結素材資源。

欄位
description1

string

網站連結說明的第一行。如果設定此屬性,長度必須介於 1 到 35 (含) 和 description2 之間。

description2

string

網站連結說明的第二行。設定後,長度應介於 1 到 35 (含) 和 description1 之間。

start_date

string

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

end_date

string

這個素材資源生效且仍在放送的日期 (格式為 yyyy-MM-dd)。

ad_schedule_targets[]

AdScheduleInfo

不重疊的時間表清單,用於指定素材資源可放送的所有時間間隔。每天最多可以設定 6 個排程,總共 42 個。

tracking_id

int64

用於追蹤網站連結素材資源點擊次數的 ID。這是 Yahoo!欄位。

use_searcher_time_zone

bool

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

mobile_preferred

bool

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

UserListInfo

使用者名單條件。代表由廣告客戶定義的目標使用者名單。

欄位
user_list

string

使用者清單資源名稱。

一般資料容器。

欄位
聯集欄位 value。值。value 只能是下列其中一項:
boolean_value

bool

布林值。

int64_value

int64

int64。

float_value

float

浮點值。

double_value

double

雙倍。

string_value

string

字串。

WebpageConditionInfo

用來指定廣告客戶網站網頁的邏輯運算式。

欄位
operand

WebpageConditionOperand

網頁指定條件的運算元。

operator

WebpageConditionOperator

網頁指定條件的運算子。

argument

string

網頁指定條件的引數。

WebpageInfo

代表廣告客戶網站網頁的指定條件。

欄位
conditions[]

WebpageConditionInfo

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

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

coverage_percentage

double

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

criterion_name

string

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

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

YoutubeVideoAsset

YouTube 資產。

欄位
youtube_video_title

string

YouTube 影片標題。

youtube_video_id

string

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