Campaign Manager 360 API v3.3 已被弃用,并将于 2021 年 6 月 30 日停用。所有用户都必须在该截止日期之前迁移到新版 API。

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 变量的值。此字符串的长度不得超过 100 个字符。
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
用于更新现有的转化数据。