上傳 Floodlight 自訂變數資料

根據預設,轉換包含的描述性資料有限,例如轉換發生時間、轉換來源,以及選用的金額價值。如果您收集了其他轉換相關資料,例如購買商品的運送國家/地區、產品 ID,甚至是通話時間長度,可以使用 Floodlight 自訂變數追蹤這類資料,並上傳至 Search Ads 360。

上傳資料後,您可以:

  • 在 Search Ads 360 中建立報表欄,以顯示資料或用來篩選 Floodlight 欄。

  • 在公式欄中使用資料。

  • 使用資料區隔及分組報表。

  • 使用新版 Search Ads 360 Reporting API 擷取內含相關資料的報表。

進一步瞭解如何使用上傳的資料。

設定 Floodlight 自訂變數

您一開始在 Campaign Manager 中設定 Floodlight 時,會一併設定 Floodlight 自訂變數。接著,Search Ads 360 客服聯絡人會在 Search Ads 360 中設定自訂變數。完成這些步驟後,您就可以在新增或修改轉換時,為變數指定資料。

變數名稱和類型

每個變數都會指派一個易記名稱,該名稱在特定廣告主中是唯一的,且屬於下列其中一種資料類型:

  • 指標:Search Ads 360 在轉換報表中匯總的數值資料。舉例來說,指標變數可用來追蹤整體運費,或計算購買的商品數量。

  • 維度:可用來篩選報表資料的數字或文字資料。舉例來說,維度變數可以追蹤商店名稱或數值產品 ID,然後用於 Floodlight 報表欄,其中只包含特定商店或特定產品的資料。

上傳自訂資料

如要上傳指標 Floodlight 自訂變數的資料,請在 Conversion.insert() 或 Conversion.update() 要求中加入下列欄位:

   'customMetric': [
      {
        'name': 'friendly-name',
        'value': Number
      },
     ]

如要上傳維度 Floodlight 自訂變數的資料,請在 Conversion.insert() 或 Conversion.update() 要求中加入下列欄位:

   'customDimension': [
      {
        'name': 'friendly-name',
        'value': String
      },
     ]

範例

舉例來說,廣告主為 Search Ads 360 設定了下列 Floodlight 自訂變數:

  • 銷售 (指標)
  • shipping (指標)
  • product_type (維度)
  • product_id (維度)

如果顧客透過電話完成購買,您可以提出下列 Conversion.insert() 要求,上傳轉換資料並加入自訂指標資料:

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json

{
 'kind': 'doubleclicksearch#conversionList',
 'conversion' : [{
   'customerId': '123-456-7890', // Replace with your ID
   'campaignId': '14660344555', // Replace with your ID
   'adGroupId': '105138634255', // Replace with your ID
   'criterionId': '948710340465', // Replace with your ID
   'conversionId': 'test_20140121_01',
   'state': 'ACTIVE',
   'type': 'TRANSACTION',
   'revenueMicros': 10000000, // To report $10 of revenue, specify 10 million revenueMicros
   'currencyCode': 'USD',
   'segmentationType': 'FLOODLIGHT',
   'segmentationId': '1472562', // Replace with your ID
   'conversionTimestamp': '1390073000011',
   'floodlightOrderId': 'test',
   'customMetric': [
    {
      'name': 'sales',
      'value': 2.0
    },
    {
      'name': 'shipping',
      'value': 3.0
    }
   ],
   'customDimension': [
    {
      'name': 'product_type',
      'value': 'shoes'
    },
    {
      'name': 'product_id',
      'value': 'shoe 2'
    }
   ]
 }]
}

處理 Search Ads 360 回應

與其他 Conversion.insert() 或 Conversion.update() 要求一樣,如果要求成功,回應會包含每個上傳轉換的完整 Search Ads 360 內部表示法。

如果要求無法驗證或上傳,回應會包含失敗訊息。 如要進一步瞭解這些失敗訊息,請參閱插入要求的處理 Search Ads 360 回應。