與轉換相關的原始事件資料。
這份報表只能透過非同步要求傳回 (也就是透過 Reports.request() 方法)。
由於事件會在特定日期發生,因此針對這份報表的要求必須指定 timeRange。您可以指定下列其中一項:
要求摘錄
傳送一般的 Reports.request() 要求主體,但指定 "reportType": "conversion"
。
{ ... "reportType": "conversion", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
針對您要在報表中傳回或篩選的每個資料欄,指定下表中列出的 columnName
。您也可以視需要指定 headerText、startDate 和 endDate。請注意,部分欄無法篩選;請參閱下表中的「可篩選」。
columnName | 說明 | 行為 | 類型 | 可篩選 |
---|---|---|---|---|
status |
轉換狀態:Active 或 Removed 。 |
屬性 | Status |
相容 |
deviceSegment |
轉換帶來轉換的裝置區隔:Desktop 、Mobile 、Tablet 或 Other 。 |
屬性 | Device segment |
相容 |
floodlightGroup |
Floodlight 群組名稱。 | 屬性 | String |
相容 |
floodlightGroupConversionType |
這個群組中由 Floodlight 活動產生的轉換類型:Action 或 Transaction 。 |
屬性 | Conversion type |
相容 |
floodlightGroupId |
DS Floodlight 群組 ID。 | 屬性 | ID |
相容 |
floodlightGroupTag |
Floodlight 群組代碼。 | 屬性 | String |
相容 |
floodlightActivity |
Floodlight 活動名稱。 | 屬性 | String |
相容 |
floodlightActivityId |
DS Floodlight 活動 ID。 | 屬性 | ID |
相容 |
floodlightActivityTag |
Floodlight 活動代碼。 | 屬性 | String |
相容 |
agency |
代理商名稱。 | 屬性 | String |
相容 |
agencyId |
DS 代理商 ID。 | 屬性 | ID |
相容 |
advertiser |
廣告客戶名稱。 | 屬性 | String |
相容 |
advertiserId |
DS 廣告客戶 ID。 | 屬性 | ID |
相容 |
account |
引擎帳戶名稱。 | 屬性 | String |
相容 |
accountId |
DS 引擎帳戶 ID。 | 屬性 | ID |
相容 |
accountEngineId |
外部引擎帳戶內的帳戶 ID。 | 屬性 | String |
相容 |
accountType |
引擎帳戶類型:Google AdWords 、Bing Ads 、Yahoo Japan Listing Ads 、Yahoo Search Marketing 、Yahoo Gemini 、Baidu 或 Comparison Shopping 。 |
屬性 | Engine type |
相容 |
campaign |
廣告活動名稱: | 屬性 | String |
相容 |
campaignId |
DS 廣告活動編號。 | 屬性 | ID |
相容 |
campaignStatus |
包含此項目的廣告活動狀態。 | 屬性 | Status |
相容 |
adGroup |
廣告群組名稱: | 屬性 | String |
相容 |
adGroupId |
DS 廣告群組編號。 | 屬性 | ID |
相容 |
adGroupStatus |
包含這個項目的廣告群組狀態。 | 屬性 | Status |
相容 |
keywordId |
DS 關鍵字編號。如果值為 0,表示關鍵字未歸功。 | 屬性 | ID |
相容 |
keywordMatchType |
關鍵字比對類型:Broad 、Exact 、Phrase 或 Content 。 |
屬性 | Match type |
相容 |
keywordText |
關鍵字文字。 | 屬性 | String |
相容 |
productTargetId |
DS 商品目標編號。 | 屬性 | ID |
相容 |
productGroupId |
與這個轉換相關聯的產品群組 ID。只有購物廣告活動所帶來的轉換含有產品群組 ID。加入產品群組時不應使用產品群組 ID。 | 屬性 | ID |
相容 |
ad |
廣告名稱。 | 屬性 | String |
相容 |
adId |
DS 廣告 ID。如果這個值為 0,表示廣告未經歸因。 | 屬性 | ID |
相容 |
isUnattributedAd |
指出此列中的指標無法歸因於特定廣告。舉例來說,如果廣告使用了不支援的格式或錯誤的 Clickserver 網址,DS 就無法將指標歸因於廣告。 | 屬性 | Boolean |
相容 |
inventoryAccountId |
與轉換相關聯的產品所屬的 DS 商品型錄帳戶 ID。當您在 DS 中連結商品型錄帳戶時,DS 會產生這個 ID。 | 屬性 | ID |
相容 |
productId |
與這個轉換相關聯的產品編號。 | 屬性 | String |
相容 |
productCountry |
針對與這項轉換相關聯的產品,在商品目錄動態饋給中註冊的國家/地區 (ISO 3166 格式)。 | 屬性 | String |
相容 |
productLanguage |
與這個轉換相關聯的產品所使用的語言 (ISO 639-1)。 | 屬性 | String |
相容 |
productStoreId |
與轉換相關聯的店面商品目錄廣告所屬的商店。這組 ID 應與店面產品動態饋給中使用的商店 ID 一致。 | 屬性 | String |
相容 |
productChannel |
與轉換相關聯的產品銷售通路:Online 或 Local 。 |
屬性 | Product channel |
相容 |
conversionId |
Search Ads 360 為每次轉換產生的 ID, | 屬性 | ID |
相容 |
advertiserConversionId |
如果是離線轉換,這是指廣告客戶提供的 ID。如果廣告客戶未指定這類 ID,Search Ads 360 就會產生一組 ID。視線上的 Floodlight 指示而定,如果是線上轉換,則等於 ConversionId 欄或 FloodlightOrderId 欄。 | 屬性 | String |
相容 |
conversionType |
轉換類型:Action 或 Transaction 。 |
屬性 | Conversion type |
相容 |
conversionRevenue |
轉換總金額。 | 屬性 | Money |
相容 |
conversionQuantity |
由轉換記錄的項目數量,由 qty 參數決定。廣告客戶必須負責動態填入參數 (例如轉換中銷售的商品數量),否則預設值為 1。 | 屬性 | Number |
相容 |
conversionDate |
Campaign Manager 聯播網時區,發生轉換的日期。這個日期會用來匯總轉換指標。舉例來說,當 DS 匯總 5 月 1 日的動作時,就會計算 conversionDate 為 5 月 1 日的所有動作轉換。 |
屬性 | Date |
相容 |
conversionTimestamp |
轉換發生時的世界標準時間時間戳記。 | 屬性 | Timestamp |
相容 |
conversionLastModifiedTimestamp |
轉換最近修改的 UTC 時間戳記。 | 屬性 | Timestamp |
相容 |
conversionAttributionType |
轉換的歸因依據:Visit 或 Keyword+Ad 。 |
屬性 | Conversion attribution type |
相容 |
conversionVisitId |
轉換的 DS 造訪 ID。 | 屬性 | ID |
相容 |
conversionVisitTimestamp |
轉換所屬的造訪 (世界標準時間) 時間戳記。 | 屬性 | Timestamp |
相容 |
conversionVisitExternalClickId |
做為轉換的造訪的不重複字串,並以 gclid 網址參數的形式傳送至到達網頁。只適用於已啟用 Conversion API 整合或 Google Analytics (分析) 整合的廣告客戶。 | 屬性 | String |
相容 |
conversionSearchTerm |
促成轉換的搜尋字詞。 | 屬性 | String |
相容 |
floodlightOriginalRevenue |
與 Floodlight 事件相關的未變更原始收益 (以目前報表的幣別為準),然後再修改 Floodlight 貨幣指示。 | 屬性 | Money |
相容 |
floodlightEventRequestString |
轉換的 Floodlight 要求字串。 | 屬性 | String |
相容 |
floodlightReferrer |
轉換的 Floodlight 參照網址網站。 | 屬性 | String |
相容 |
floodlightOrderId |
廣告客戶為轉換提供的 Floodlight 訂單 ID。 | 屬性 | String |
相容 |
feedItemId |
與這個轉換相關聯的動態饋給項目列 ID。 | 屬性 | ID |
相容 |
feedId |
與這個轉換相關聯的動態饋給表格 ID。 | 屬性 | ID |
相容 |
feedType |
與這個轉換相關聯的動態饋給類型。 | 屬性 | Feed type |
相容 |