上传自定义 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_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 针对插入请求的响应。