上传自定义 Floodlight 变量的数据

默认情况下,转化包含少量的描述性数据,例如 转化的来源以及货币价值(可选)。如果您 收集有关您的转化的其他数据,例如所购商品所在的国家/地区 商品 ID 还是通话时长,您可以使用自定义 Floodlight 变量跟踪 然后将其上传到 Search Ads 360

上传数据后,您可以:

  • 在 Search Ads 360 中创建报表列,以便显示数据或 过滤 Floodlight 列。

  • 使用公式列中的数据。

  • 使用这些数据对报告进行细分和分组。

  • 使用 Search Ads 360 API 实现以下目的: 下载包含相应数据的报表

详细了解如何使用 上传的数据。

设置自定义 Floodlight 变量

您最初设置自定义 Floodlight 变量是 配置 Floodlight Campaign Manager。然后,您的 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
      },
     ]

示例

例如,某广告客户为以下对象配置了以下自定义 Floodlight 变量: Search Ads 360:

  • 销售(指标)
  • 运费(指标)
  • 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' : [{
   'agencyId': '12300000000000456', // Replace with your ID
   'advertiserId': '78900000000000123', // Replace with your ID
   'engineAccountId': '101100000000000123', // Replace with your ID
   'campaignId': '13400000003156701', // Replace with your ID
   'adGroupId': '58700000128508001', // Replace with your ID
   'criterionId': '43700001095692142', // Replace with your ID
   'adId': '0',
   'conversionId': 'test_20140121_01',
   'state': 'ACTIVE',
   'type': 'TRANSACTION',
   'revenueMicros': 10000000, // To report $10 of revenue, specify 10 million revenueMicros
   'currencyCode': 'USD',
   'segmentationType': 'FLOODLIGHT',
   'segmentationId': '25700000001472562', // 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 响应