1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="dfareporting_v4.html">Campaign Manager 360 API</a> . <a href="dfareporting_v4.conversions.html">conversions</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#batchinsert">batchinsert(profileId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Inserts conversions.</p>
<p class="toc_element">
<code><a href="#batchupdate">batchupdate(profileId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates existing conversions.</p>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="batchinsert">batchinsert(profileId, body=None, x__xgafv=None)</code>
<pre>Inserts conversions.
Args:
profileId: string, User profile ID associated with this request. (required)
body: object, The request body.
The object takes the form of:
{ # Insert Conversions Request.
"conversions": [ # The set of conversions to insert.
{ # A Conversion represents when a user successfully performs a desired action after seeing an ad.
"adUserDataConsent": "A String", # This represents consent for ad user data.
"cartData": { # *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
"items": [ # Data of the items purchased.
{ # Contains data of the items purchased.
"itemId": "A String", # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
"quantity": 42, # Number of items sold. This is a required field.
"unitPrice": 3.14, # Unit price excluding tax, shipping, and any transaction level discounts. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
],
"merchantFeedLabel": "A String", # The feed labels associated with the feed where your items are uploaded. For more information, please refer to https://support.google.com/merchants/answer/12453549. Providing the feed label reduces ambiguity in identifying the right offer details.
"merchantFeedLanguage": "A String", # The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes. Providing the feed language reduces ambiguity in identifying the right offer details.
"merchantId": "A String", # The Merchant Center ID where the items are uploaded. Providing Merchant Center ID reduces ambiguity in identifying the right offer details.
},
"childDirectedTreatment": True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
"customVariables": [ # Custom floodlight variables.
{ # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customFloodlightVariable".
"type": "A String", # The type of custom floodlight variable to supply a value for. These map to the "u[1-100]=" in the tags.
"value": "A String", # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
},
],
"dclid": "A String", # The display click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or impressionId is a required field.
"encryptedUserId": "A String", # The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with INVALID_ARGUMENT error. When set, encryptionInfo should also be specified. This field may only be used when calling batchinsert; it is not supported by batchupdate. This field is mutually exclusive with encryptedUserId, matchId, mobileDeviceId, gclid dclid, and impressionId. This or encryptedUserId or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"A String",
],
"floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
"floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
"gclid": "A String", # The Google click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or dclid or impressionId is a required field.
"impressionId": "A String", # The impression ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, and gclid. One of these identifiers must be set.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversion".
"limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
"matchId": "A String", # The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[],mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserId orencryptedUserIdCandidates[] or mobileDeviceId or gclid or dclid or impressionIdis a required field.
"mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, gclid, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or gclid or dclid or impressionId is a required field.
"nonPersonalizedAd": True or False, # Whether the conversion was for a non personalized ad.
"ordinal": "A String", # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
"quantity": "A String", # The quantity of the conversion. This is a required field.
"sessionAttributesEncoded": "A String", # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
"timestampMicros": "A String", # The timestamp of conversion, in Unix epoch micros. This is a required field.
"treatmentForUnderage": True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union's General Data Protection Regulation (GDPR).
"userIdentifiers": [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.
{ # User identifying information. Exactly one type of identifier must be specified.
"addressInfo": { # Identify a user by name and address. # Address information.
"city": "A String", # City of the address.
"countryCode": "A String", # 2-letter country code in ISO-3166-1 alpha-2 of the user's address.
"hashedFirstName": "A String", # First name of the user, which is hashed as SHA-256 after normalized (Lowercase all characters; Remove any extra spaces before, after, and in between).
"hashedLastName": "A String", # Last name of the user, which is hashed as SHA-256 after normalized (lower case only and no punctuation).
"hashedStreetAddress": "A String", # The street address of the user hashed using SHA-256 hash function after normalization (lower case only).
"postalCode": "A String", # Postal code of the user's address.
"state": "A String", # State code of the address.
},
"hashedEmail": "A String", # Hashed email address using SHA-256 hash function after normalization.
"hashedPhoneNumber": "A String", # Hashed phone number using SHA-256 hash function after normalization (E164 standard).
},
],
"value": 3.14, # The value of the conversion. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
],
"encryptionInfo": { # A description of how user IDs are encrypted. # Describes how encryptedUserId or encryptedUserIdCandidates[] is encrypted. This is a required field if encryptedUserId or encryptedUserIdCandidates[] is used.
"encryptionEntityId": "A String", # The encryption entity ID. This should match the encryption configuration for ad serving or Data Transfer.
"encryptionEntityType": "A String", # The encryption entity type. This should match the encryption configuration for ad serving or Data Transfer.
"encryptionSource": "A String", # Describes whether the encrypted cookie was received from ad serving (the %m macro) or from Data Transfer.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#encryptionInfo".
},
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchInsertRequest".
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Insert Conversions Response.
"hasFailures": True or False, # Indicates that some or all conversions failed to insert.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchInsertResponse".
"status": [ # The insert status of each conversion. Statuses are returned in the same order that conversions are inserted.
{ # The original conversion that was inserted or updated and whether there were any errors.
"conversion": { # A Conversion represents when a user successfully performs a desired action after seeing an ad. # The original conversion that was inserted or updated.
"adUserDataConsent": "A String", # This represents consent for ad user data.
"cartData": { # *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
"items": [ # Data of the items purchased.
{ # Contains data of the items purchased.
"itemId": "A String", # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
"quantity": 42, # Number of items sold. This is a required field.
"unitPrice": 3.14, # Unit price excluding tax, shipping, and any transaction level discounts. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
],
"merchantFeedLabel": "A String", # The feed labels associated with the feed where your items are uploaded. For more information, please refer to https://support.google.com/merchants/answer/12453549. Providing the feed label reduces ambiguity in identifying the right offer details.
"merchantFeedLanguage": "A String", # The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes. Providing the feed language reduces ambiguity in identifying the right offer details.
"merchantId": "A String", # The Merchant Center ID where the items are uploaded. Providing Merchant Center ID reduces ambiguity in identifying the right offer details.
},
"childDirectedTreatment": True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
"customVariables": [ # Custom floodlight variables.
{ # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customFloodlightVariable".
"type": "A String", # The type of custom floodlight variable to supply a value for. These map to the "u[1-100]=" in the tags.
"value": "A String", # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
},
],
"dclid": "A String", # The display click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or impressionId is a required field.
"encryptedUserId": "A String", # The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with INVALID_ARGUMENT error. When set, encryptionInfo should also be specified. This field may only be used when calling batchinsert; it is not supported by batchupdate. This field is mutually exclusive with encryptedUserId, matchId, mobileDeviceId, gclid dclid, and impressionId. This or encryptedUserId or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"A String",
],
"floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
"floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
"gclid": "A String", # The Google click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or dclid or impressionId is a required field.
"impressionId": "A String", # The impression ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, and gclid. One of these identifiers must be set.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversion".
"limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
"matchId": "A String", # The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[],mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserId orencryptedUserIdCandidates[] or mobileDeviceId or gclid or dclid or impressionIdis a required field.
"mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, gclid, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or gclid or dclid or impressionId is a required field.
"nonPersonalizedAd": True or False, # Whether the conversion was for a non personalized ad.
"ordinal": "A String", # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
"quantity": "A String", # The quantity of the conversion. This is a required field.
"sessionAttributesEncoded": "A String", # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
"timestampMicros": "A String", # The timestamp of conversion, in Unix epoch micros. This is a required field.
"treatmentForUnderage": True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union's General Data Protection Regulation (GDPR).
"userIdentifiers": [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.
{ # User identifying information. Exactly one type of identifier must be specified.
"addressInfo": { # Identify a user by name and address. # Address information.
"city": "A String", # City of the address.
"countryCode": "A String", # 2-letter country code in ISO-3166-1 alpha-2 of the user's address.
"hashedFirstName": "A String", # First name of the user, which is hashed as SHA-256 after normalized (Lowercase all characters; Remove any extra spaces before, after, and in between).
"hashedLastName": "A String", # Last name of the user, which is hashed as SHA-256 after normalized (lower case only and no punctuation).
"hashedStreetAddress": "A String", # The street address of the user hashed using SHA-256 hash function after normalization (lower case only).
"postalCode": "A String", # Postal code of the user's address.
"state": "A String", # State code of the address.
},
"hashedEmail": "A String", # Hashed email address using SHA-256 hash function after normalization.
"hashedPhoneNumber": "A String", # Hashed phone number using SHA-256 hash function after normalization (E164 standard).
},
],
"value": 3.14, # The value of the conversion. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
"errors": [ # A list of errors related to this conversion.
{ # The error code and description for a conversion that failed to insert or update.
"code": "A String", # The error code.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionError".
"message": "A String", # A description of the error.
},
],
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionStatus".
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="batchupdate">batchupdate(profileId, body=None, x__xgafv=None)</code>
<pre>Updates existing conversions.
Args:
profileId: string, User profile ID associated with this request. (required)
body: object, The request body.
The object takes the form of:
{ # Update Conversions Request.
"conversions": [ # The set of conversions to update.
{ # A Conversion represents when a user successfully performs a desired action after seeing an ad.
"adUserDataConsent": "A String", # This represents consent for ad user data.
"cartData": { # *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
"items": [ # Data of the items purchased.
{ # Contains data of the items purchased.
"itemId": "A String", # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
"quantity": 42, # Number of items sold. This is a required field.
"unitPrice": 3.14, # Unit price excluding tax, shipping, and any transaction level discounts. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
],
"merchantFeedLabel": "A String", # The feed labels associated with the feed where your items are uploaded. For more information, please refer to https://support.google.com/merchants/answer/12453549. Providing the feed label reduces ambiguity in identifying the right offer details.
"merchantFeedLanguage": "A String", # The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes. Providing the feed language reduces ambiguity in identifying the right offer details.
"merchantId": "A String", # The Merchant Center ID where the items are uploaded. Providing Merchant Center ID reduces ambiguity in identifying the right offer details.
},
"childDirectedTreatment": True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
"customVariables": [ # Custom floodlight variables.
{ # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customFloodlightVariable".
"type": "A String", # The type of custom floodlight variable to supply a value for. These map to the "u[1-100]=" in the tags.
"value": "A String", # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
},
],
"dclid": "A String", # The display click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or impressionId is a required field.
"encryptedUserId": "A String", # The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with INVALID_ARGUMENT error. When set, encryptionInfo should also be specified. This field may only be used when calling batchinsert; it is not supported by batchupdate. This field is mutually exclusive with encryptedUserId, matchId, mobileDeviceId, gclid dclid, and impressionId. This or encryptedUserId or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"A String",
],
"floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
"floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
"gclid": "A String", # The Google click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or dclid or impressionId is a required field.
"impressionId": "A String", # The impression ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, and gclid. One of these identifiers must be set.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversion".
"limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
"matchId": "A String", # The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[],mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserId orencryptedUserIdCandidates[] or mobileDeviceId or gclid or dclid or impressionIdis a required field.
"mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, gclid, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or gclid or dclid or impressionId is a required field.
"nonPersonalizedAd": True or False, # Whether the conversion was for a non personalized ad.
"ordinal": "A String", # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
"quantity": "A String", # The quantity of the conversion. This is a required field.
"sessionAttributesEncoded": "A String", # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
"timestampMicros": "A String", # The timestamp of conversion, in Unix epoch micros. This is a required field.
"treatmentForUnderage": True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union's General Data Protection Regulation (GDPR).
"userIdentifiers": [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.
{ # User identifying information. Exactly one type of identifier must be specified.
"addressInfo": { # Identify a user by name and address. # Address information.
"city": "A String", # City of the address.
"countryCode": "A String", # 2-letter country code in ISO-3166-1 alpha-2 of the user's address.
"hashedFirstName": "A String", # First name of the user, which is hashed as SHA-256 after normalized (Lowercase all characters; Remove any extra spaces before, after, and in between).
"hashedLastName": "A String", # Last name of the user, which is hashed as SHA-256 after normalized (lower case only and no punctuation).
"hashedStreetAddress": "A String", # The street address of the user hashed using SHA-256 hash function after normalization (lower case only).
"postalCode": "A String", # Postal code of the user's address.
"state": "A String", # State code of the address.
},
"hashedEmail": "A String", # Hashed email address using SHA-256 hash function after normalization.
"hashedPhoneNumber": "A String", # Hashed phone number using SHA-256 hash function after normalization (E164 standard).
},
],
"value": 3.14, # The value of the conversion. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
],
"encryptionInfo": { # A description of how user IDs are encrypted. # Describes how encryptedUserId is encrypted. This is a required field if encryptedUserId is used.
"encryptionEntityId": "A String", # The encryption entity ID. This should match the encryption configuration for ad serving or Data Transfer.
"encryptionEntityType": "A String", # The encryption entity type. This should match the encryption configuration for ad serving or Data Transfer.
"encryptionSource": "A String", # Describes whether the encrypted cookie was received from ad serving (the %m macro) or from Data Transfer.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#encryptionInfo".
},
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchUpdateRequest".
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Update Conversions Response.
"hasFailures": True or False, # Indicates that some or all conversions failed to update.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchUpdateResponse".
"status": [ # The update status of each conversion. Statuses are returned in the same order that conversions are updated.
{ # The original conversion that was inserted or updated and whether there were any errors.
"conversion": { # A Conversion represents when a user successfully performs a desired action after seeing an ad. # The original conversion that was inserted or updated.
"adUserDataConsent": "A String", # This represents consent for ad user data.
"cartData": { # *Beta:* This feature is currently in beta. Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) # The cart data associated with this conversion.
"items": [ # Data of the items purchased.
{ # Contains data of the items purchased.
"itemId": "A String", # The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field.
"quantity": 42, # Number of items sold. This is a required field.
"unitPrice": 3.14, # Unit price excluding tax, shipping, and any transaction level discounts. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
],
"merchantFeedLabel": "A String", # The feed labels associated with the feed where your items are uploaded. For more information, please refer to https://support.google.com/merchants/answer/12453549. Providing the feed label reduces ambiguity in identifying the right offer details.
"merchantFeedLanguage": "A String", # The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes. Providing the feed language reduces ambiguity in identifying the right offer details.
"merchantId": "A String", # The Merchant Center ID where the items are uploaded. Providing Merchant Center ID reduces ambiguity in identifying the right offer details.
},
"childDirectedTreatment": True or False, # Whether this particular request may come from a user under the age of 13, under COPPA compliance.
"customVariables": [ # Custom floodlight variables.
{ # A custom floodlight variable. Can be used in both batchinsert and batchupdate. Adding this in batchupdate will update or append the variable to the existing list.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#customFloodlightVariable".
"type": "A String", # The type of custom floodlight variable to supply a value for. These map to the "u[1-100]=" in the tags.
"value": "A String", # The value of the custom floodlight variable. The length of string must not exceed 100 characters.
},
],
"dclid": "A String", # The display click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or impressionId is a required field.
"encryptedUserId": "A String", # The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"encryptedUserIdCandidates": [ # A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with INVALID_ARGUMENT error. When set, encryptionInfo should also be specified. This field may only be used when calling batchinsert; it is not supported by batchupdate. This field is mutually exclusive with encryptedUserId, matchId, mobileDeviceId, gclid dclid, and impressionId. This or encryptedUserId or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field.
"A String",
],
"floodlightActivityId": "A String", # Floodlight Activity ID of this conversion. This is a required field.
"floodlightConfigurationId": "A String", # Floodlight Configuration ID of this conversion. This is a required field.
"gclid": "A String", # The Google click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or dclid or impressionId is a required field.
"impressionId": "A String", # The impression ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, and gclid. One of these identifiers must be set.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversion".
"limitAdTracking": True or False, # Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing.
"matchId": "A String", # The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[],mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserId orencryptedUserIdCandidates[] or mobileDeviceId or gclid or dclid or impressionIdis a required field.
"mobileDeviceId": "A String", # The mobile device ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, gclid, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or gclid or dclid or impressionId is a required field.
"nonPersonalizedAd": True or False, # Whether the conversion was for a non personalized ad.
"ordinal": "A String", # The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field.
"quantity": "A String", # The quantity of the conversion. This is a required field.
"sessionAttributesEncoded": "A String", # Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate.
"timestampMicros": "A String", # The timestamp of conversion, in Unix epoch micros. This is a required field.
"treatmentForUnderage": True or False, # Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union's General Data Protection Regulation (GDPR).
"userIdentifiers": [ # The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5.
{ # User identifying information. Exactly one type of identifier must be specified.
"addressInfo": { # Identify a user by name and address. # Address information.
"city": "A String", # City of the address.
"countryCode": "A String", # 2-letter country code in ISO-3166-1 alpha-2 of the user's address.
"hashedFirstName": "A String", # First name of the user, which is hashed as SHA-256 after normalized (Lowercase all characters; Remove any extra spaces before, after, and in between).
"hashedLastName": "A String", # Last name of the user, which is hashed as SHA-256 after normalized (lower case only and no punctuation).
"hashedStreetAddress": "A String", # The street address of the user hashed using SHA-256 hash function after normalization (lower case only).
"postalCode": "A String", # Postal code of the user's address.
"state": "A String", # State code of the address.
},
"hashedEmail": "A String", # Hashed email address using SHA-256 hash function after normalization.
"hashedPhoneNumber": "A String", # Hashed phone number using SHA-256 hash function after normalization (E164 standard).
},
],
"value": 3.14, # The value of the conversion. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field.
},
"errors": [ # A list of errors related to this conversion.
{ # The error code and description for a conversion that failed to insert or update.
"code": "A String", # The error code.
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionError".
"message": "A String", # A description of the error.
},
],
"kind": "A String", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionStatus".
},
],
}</pre>
</div>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
</body></html>
|
