Conversions

有关此类资源的方法列表,请参阅本页面的结尾部分。

资源表示形式

转化表示的是用户看到广告后成功执行了符合您预期的操作的情况。

{
  "kind": "dfareporting#conversion",
  "floodlightConfigurationId": long,
  "floodlightActivityId": long,
  "encryptedUserId": string,
  "encryptedUserIdCandidates": [
    string
  ],
  "matchId": string,
  "mobileDeviceId": string,
  "gclid": string,
  "dclid": string,
  "limitAdTracking": boolean,
  "childDirectedTreatment": boolean,
  "nonPersonalizedAd": boolean,
  "treatmentForUnderage": boolean,
  "timestampMicros": long,
  "value": double,
  "quantity": long,
  "ordinal": string,
  "customVariables": [
    {
      "kind": "dfareporting#customFloodlightVariable",
      "type": string,
      "value": string
    }
  ]
}
属性名称 说明 备注
childDirectedTreatment boolean 此特定请求是否可能由未满 13 周岁的用户发出(根据《儿童在线隐私保护法》(COPPA) 规定)。
customVariables[] list 自定义 Floodlight 变量。
customVariables[].kind string 标识所属资源种类。值:固定字符串 "dfareporting#customFloodlightVariable"
customVariables[].type string 要为哪些类型的自定义 Floodlight 变量提供相应的值。这些类型在代码中会映射到“u[1-20]=”。

可接受的值包括:
  • U1
  • U10
  • U100
  • U11
  • U12
  • U13
  • U14
  • U15
  • U16
  • U17
  • U18
  • U19
  • U2
  • U20
  • U21
  • U22
  • U23
  • U24
  • U25
  • U26
  • U27
  • U28
  • U29
  • U3
  • U30
  • U31
  • U32
  • U33
  • U34
  • U35
  • U36
  • U37
  • U38
  • U39
  • U4
  • U40
  • U41
  • U42
  • U43
  • U44
  • U45
  • U46
  • U47
  • U48
  • U49
  • U5
  • U50
  • U51
  • U52
  • U53
  • U54
  • U55
  • U56
  • U57
  • U58
  • U59
  • U6
  • U60
  • U61
  • U62
  • U63
  • U64
  • U65
  • U66
  • U67
  • U68
  • U69
  • U7
  • U70
  • U71
  • U72
  • U73
  • U74
  • U75
  • U76
  • U77
  • U78
  • U79
  • U8
  • U80
  • U81
  • U82
  • U83
  • U84
  • U85
  • U86
  • U87
  • U88
  • U89
  • U9
  • U90
  • U91
  • U92
  • U93
  • U94
  • U95
  • U96
  • U97
  • U98
  • U99
customVariables[].value string 自定义 Floodlight 变量的值。此字符串的长度不得超过 50 个字符。
dclid string 展示广告点击 ID。该字段与 encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIdgclid 互斥。该字段、encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIdgclid 为必填字段。
encryptedUserId string 经过加密的用户 ID(采用的是字母数字格式)。设置该字段后,还应指定 encryptionInfo。该字段与 encryptedUserIdCandidates[]matchIdmobileDeviceIdgcliddclid 互斥。该字段、encryptedUserIdCandidates[]matchIdmobileDeviceIdgcliddclid 为必填字段。
encryptedUserIdCandidates[] list 经过加密的用户 ID(采用的是字母数字格式)列表。任何在转化时间戳之前曝光的用户 ID 都将用于插入的转化数据之中。如果未找到此类用户 ID,系统就会拒绝相应转化,并显示“INVALID_ARGUMENT”错误。设置该字段后,还应指定 encryptionInfo。只有在调用 batchinsert 时,该字段才可用;batchupdate 不支持该字段。该字段与 encryptedUserIdmatchIdmobileDeviceIdgcliddclid 互斥。该字段、encryptedUserIdmatchIdmobileDeviceIdgcliddclid 为必填字段。
floodlightActivityId long 此转化的 Floodlight 活动 ID。该字段是必填字段。
floodlightConfigurationId long 此转化的 Floodlight 配置 ID。该字段是必填字段。
gclid string Google 点击 ID。该字段与 encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIddclid 互斥。该字段、encryptedUserIdencryptedUserIdCandidates[]matchIdmobileDeviceIddclid 为必填字段。
kind string 标识所属资源种类。值:固定字符串 "dfareporting#conversion"
limitAdTracking boolean “限制广告跟踪”是否已启用。如果设为 true,相应转化数据将用于报告,而非定位。这会导致再营销功能不可用。
matchId string 匹配 ID 字段。匹配 ID 是您的第一方标识符,该标识符已通过 Floodlight 中的匹配 ID 功能与 Google 同步。该字段与 encryptedUserIdencryptedUserIdCandidates[]mobileDeviceIdgcliddclid 互斥。该字段、encryptedUserIdencryptedUserIdCandidates[]mobileDeviceIdgcliddclid 为必填字段
mobileDeviceId string 移动设备 ID。该字段与 encryptedUserIdencryptedUserIdCandidates[]matchIdgcliddclid 互斥。该字段、encryptedUserIdencryptedUserIdCandidates[]matchIdgcliddclid 为必填字段。
nonPersonalizedAd boolean 转化是否由非个性化广告促成。
ordinal string 转化的序数。该字段可用于控制如何去掉同一用户在同一天完成的重复转化。该字段是必填字段。
quantity long 转化次数。
timestampMicros long 转化的时间戳(自 Unix 新纪元至今的时间,以微单位表示)。该字段是必填字段。
treatmentForUnderage boolean 这一特定请求是否可能由未满 16(这一数据可能会因国家/地区不同而有所不同)周岁的用户发出(根据欧盟的《一般数据保护条例》 (GDPR) 规定)。
value double 转化的价值。

方法

batchinsert
插入转化数据。
batchupdate
更新现有转化数据。