• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html><body>
2<style>
3
4body, h1, h2, h3, div, span, p, pre, a {
5  margin: 0;
6  padding: 0;
7  border: 0;
8  font-weight: inherit;
9  font-style: inherit;
10  font-size: 100%;
11  font-family: inherit;
12  vertical-align: baseline;
13}
14
15body {
16  font-size: 13px;
17  padding: 1em;
18}
19
20h1 {
21  font-size: 26px;
22  margin-bottom: 1em;
23}
24
25h2 {
26  font-size: 24px;
27  margin-bottom: 1em;
28}
29
30h3 {
31  font-size: 20px;
32  margin-bottom: 1em;
33  margin-top: 1em;
34}
35
36pre, code {
37  line-height: 1.5;
38  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42  margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46  font-family: Arial, sans serif;
47}
48
49h1, h2, h3 {
50  border-bottom: solid #CCC 1px;
51}
52
53.toc_element {
54  margin-top: 0.5em;
55}
56
57.firstline {
58  margin-left: 2 em;
59}
60
61.method  {
62  margin-top: 1em;
63  border: solid 1px #CCC;
64  padding: 1em;
65  background: #EEE;
66}
67
68.details {
69  font-weight: bold;
70  font-size: 14px;
71}
72
73</style>
74
75<h1><a href="dfareporting_v2_7.html">DCM/DFA Reporting And Trafficking API</a> . <a href="dfareporting_v2_7.floodlightConfigurations.html">floodlightConfigurations</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78  <code><a href="#get">get(profileId, id)</a></code></p>
79<p class="firstline">Gets one floodlight configuration by ID.</p>
80<p class="toc_element">
81  <code><a href="#list">list(profileId, ids=None)</a></code></p>
82<p class="firstline">Retrieves a list of floodlight configurations, possibly filtered.</p>
83<p class="toc_element">
84  <code><a href="#patch">patch(profileId, id, body)</a></code></p>
85<p class="firstline">Updates an existing floodlight configuration. This method supports patch semantics.</p>
86<p class="toc_element">
87  <code><a href="#update">update(profileId, body)</a></code></p>
88<p class="firstline">Updates an existing floodlight configuration.</p>
89<h3>Method Details</h3>
90<div class="method">
91    <code class="details" id="get">get(profileId, id)</code>
92  <pre>Gets one floodlight configuration by ID.
93
94Args:
95  profileId: string, User profile ID associated with this request. (required)
96  id: string, Floodlight configuration ID. (required)
97
98Returns:
99  An object of the form:
100
101    { # Contains properties of a Floodlight configuration.
102      "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
103      "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
104      "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
105      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
106        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
107        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
108      },
109      "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
110        "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
111        "imageTagEnabled": True or False, # Whether image tags are enabled.
112      },
113      "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
114      "standardVariableTypes": [ # List of standard variables enabled for this configuration.
115          #
116          # Acceptable values are:
117          # - "ORD"
118          # - "NUM"
119        "A String",
120      ],
121      "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
122        "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
123        "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
124      },
125      "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
126      "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
127      "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
128      "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
129      "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
130        { # Third Party Authentication Token
131          "name": "A String", # Name of the third-party authentication token.
132          "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
133        },
134      ],
135      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
136        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
137        "value": "A String", # The value of the dimension.
138        "dimensionName": "A String", # The name of the dimension.
139        "etag": "A String", # The eTag of this response for caching purposes.
140        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
141        "id": "A String", # The ID associated with the value if available.
142      },
143      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
144        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
145        "value": "A String", # The value of the dimension.
146        "dimensionName": "A String", # The name of the dimension.
147        "etag": "A String", # The eTag of this response for caching purposes.
148        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
149        "id": "A String", # The ID associated with the value if available.
150      },
151      "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
152      "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
153        { # User Defined Variable configuration.
154          "dataType": "A String", # Data type for the variable. This is a required field.
155          "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
156          "variableType": "A String", # Variable name in the tag. This is a required field.
157        },
158      ],
159      "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
160    }</pre>
161</div>
162
163<div class="method">
164    <code class="details" id="list">list(profileId, ids=None)</code>
165  <pre>Retrieves a list of floodlight configurations, possibly filtered.
166
167Args:
168  profileId: string, User profile ID associated with this request. (required)
169  ids: string, Set of IDs of floodlight configurations to retrieve. Required field; otherwise an empty list will be returned. (repeated)
170
171Returns:
172  An object of the form:
173
174    { # Floodlight Configuration List Response
175    "floodlightConfigurations": [ # Floodlight configuration collection.
176      { # Contains properties of a Floodlight configuration.
177          "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
178          "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
179          "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
180          "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
181            "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
182            "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
183          },
184          "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
185            "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
186            "imageTagEnabled": True or False, # Whether image tags are enabled.
187          },
188          "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
189          "standardVariableTypes": [ # List of standard variables enabled for this configuration.
190              #
191              # Acceptable values are:
192              # - "ORD"
193              # - "NUM"
194            "A String",
195          ],
196          "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
197            "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
198            "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
199          },
200          "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
201          "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
202          "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
203          "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
204          "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
205            { # Third Party Authentication Token
206              "name": "A String", # Name of the third-party authentication token.
207              "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
208            },
209          ],
210          "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
211            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
212            "value": "A String", # The value of the dimension.
213            "dimensionName": "A String", # The name of the dimension.
214            "etag": "A String", # The eTag of this response for caching purposes.
215            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
216            "id": "A String", # The ID associated with the value if available.
217          },
218          "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
219            "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
220            "value": "A String", # The value of the dimension.
221            "dimensionName": "A String", # The name of the dimension.
222            "etag": "A String", # The eTag of this response for caching purposes.
223            "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
224            "id": "A String", # The ID associated with the value if available.
225          },
226          "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
227          "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
228            { # User Defined Variable configuration.
229              "dataType": "A String", # Data type for the variable. This is a required field.
230              "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
231              "variableType": "A String", # Variable name in the tag. This is a required field.
232            },
233          ],
234          "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
235        },
236    ],
237    "kind": "dfareporting#floodlightConfigurationsListResponse", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfigurationsListResponse".
238  }</pre>
239</div>
240
241<div class="method">
242    <code class="details" id="patch">patch(profileId, id, body)</code>
243  <pre>Updates an existing floodlight configuration. This method supports patch semantics.
244
245Args:
246  profileId: string, User profile ID associated with this request. (required)
247  id: string, Floodlight configuration ID. (required)
248  body: object, The request body. (required)
249    The object takes the form of:
250
251{ # Contains properties of a Floodlight configuration.
252    "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
253    "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
254    "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
255    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
256      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
257      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
258    },
259    "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
260      "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
261      "imageTagEnabled": True or False, # Whether image tags are enabled.
262    },
263    "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
264    "standardVariableTypes": [ # List of standard variables enabled for this configuration.
265        #
266        # Acceptable values are:
267        # - "ORD"
268        # - "NUM"
269      "A String",
270    ],
271    "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
272      "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
273      "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
274    },
275    "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
276    "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
277    "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
278    "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
279    "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
280      { # Third Party Authentication Token
281        "name": "A String", # Name of the third-party authentication token.
282        "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
283      },
284    ],
285    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
286      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
287      "value": "A String", # The value of the dimension.
288      "dimensionName": "A String", # The name of the dimension.
289      "etag": "A String", # The eTag of this response for caching purposes.
290      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
291      "id": "A String", # The ID associated with the value if available.
292    },
293    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
294      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
295      "value": "A String", # The value of the dimension.
296      "dimensionName": "A String", # The name of the dimension.
297      "etag": "A String", # The eTag of this response for caching purposes.
298      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
299      "id": "A String", # The ID associated with the value if available.
300    },
301    "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
302    "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
303      { # User Defined Variable configuration.
304        "dataType": "A String", # Data type for the variable. This is a required field.
305        "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
306        "variableType": "A String", # Variable name in the tag. This is a required field.
307      },
308    ],
309    "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
310  }
311
312
313Returns:
314  An object of the form:
315
316    { # Contains properties of a Floodlight configuration.
317      "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
318      "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
319      "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
320      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
321        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
322        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
323      },
324      "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
325        "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
326        "imageTagEnabled": True or False, # Whether image tags are enabled.
327      },
328      "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
329      "standardVariableTypes": [ # List of standard variables enabled for this configuration.
330          #
331          # Acceptable values are:
332          # - "ORD"
333          # - "NUM"
334        "A String",
335      ],
336      "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
337        "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
338        "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
339      },
340      "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
341      "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
342      "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
343      "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
344      "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
345        { # Third Party Authentication Token
346          "name": "A String", # Name of the third-party authentication token.
347          "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
348        },
349      ],
350      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
351        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
352        "value": "A String", # The value of the dimension.
353        "dimensionName": "A String", # The name of the dimension.
354        "etag": "A String", # The eTag of this response for caching purposes.
355        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
356        "id": "A String", # The ID associated with the value if available.
357      },
358      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
359        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
360        "value": "A String", # The value of the dimension.
361        "dimensionName": "A String", # The name of the dimension.
362        "etag": "A String", # The eTag of this response for caching purposes.
363        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
364        "id": "A String", # The ID associated with the value if available.
365      },
366      "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
367      "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
368        { # User Defined Variable configuration.
369          "dataType": "A String", # Data type for the variable. This is a required field.
370          "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
371          "variableType": "A String", # Variable name in the tag. This is a required field.
372        },
373      ],
374      "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
375    }</pre>
376</div>
377
378<div class="method">
379    <code class="details" id="update">update(profileId, body)</code>
380  <pre>Updates an existing floodlight configuration.
381
382Args:
383  profileId: string, User profile ID associated with this request. (required)
384  body: object, The request body. (required)
385    The object takes the form of:
386
387{ # Contains properties of a Floodlight configuration.
388    "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
389    "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
390    "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
391    "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
392      "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
393      "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
394    },
395    "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
396      "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
397      "imageTagEnabled": True or False, # Whether image tags are enabled.
398    },
399    "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
400    "standardVariableTypes": [ # List of standard variables enabled for this configuration.
401        #
402        # Acceptable values are:
403        # - "ORD"
404        # - "NUM"
405      "A String",
406    ],
407    "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
408      "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
409      "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
410    },
411    "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
412    "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
413    "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
414    "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
415    "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
416      { # Third Party Authentication Token
417        "name": "A String", # Name of the third-party authentication token.
418        "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
419      },
420    ],
421    "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
422      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
423      "value": "A String", # The value of the dimension.
424      "dimensionName": "A String", # The name of the dimension.
425      "etag": "A String", # The eTag of this response for caching purposes.
426      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
427      "id": "A String", # The ID associated with the value if available.
428    },
429    "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
430      "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
431      "value": "A String", # The value of the dimension.
432      "dimensionName": "A String", # The name of the dimension.
433      "etag": "A String", # The eTag of this response for caching purposes.
434      "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
435      "id": "A String", # The ID associated with the value if available.
436    },
437    "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
438    "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
439      { # User Defined Variable configuration.
440        "dataType": "A String", # Data type for the variable. This is a required field.
441        "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
442        "variableType": "A String", # Variable name in the tag. This is a required field.
443      },
444    ],
445    "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
446  }
447
448
449Returns:
450  An object of the form:
451
452    { # Contains properties of a Floodlight configuration.
453      "naturalSearchConversionAttributionOption": "A String", # Types of attribution options for natural search conversions.
454      "kind": "dfareporting#floodlightConfiguration", # Identifies what kind of resource this is. Value: the fixed string "dfareporting#floodlightConfiguration".
455      "exposureToConversionEnabled": True or False, # Whether the exposure-to-conversion report is enabled. This report shows detailed pathway information on up to 10 of the most recent ad exposures seen by a user before converting.
456      "lookbackConfiguration": { # Lookback configuration settings. # Lookback window settings for this floodlight configuration.
457        "clickDuration": 42, # Lookback window, in days, from the last time a given user clicked on one of your ads. If you enter 0, clicks will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
458        "postImpressionActivitiesDuration": 42, # Lookback window, in days, from the last time a given user viewed one of your ads. If you enter 0, impressions will not be considered as triggering events for floodlight tracking. If you leave this field blank, the default value for your account will be used. Acceptable values are 0 to 90, inclusive.
459      },
460      "tagSettings": { # Dynamic and Image Tag Settings. # Configuration settings for dynamic and image floodlight tags.
461        "dynamicTagEnabled": True or False, # Whether dynamic floodlight tags are enabled.
462        "imageTagEnabled": True or False, # Whether image tags are enabled.
463      },
464      "firstDayOfWeek": "A String", # Day that will be counted as the first day of the week in reports. This is a required field.
465      "standardVariableTypes": [ # List of standard variables enabled for this configuration.
466          #
467          # Acceptable values are:
468          # - "ORD"
469          # - "NUM"
470        "A String",
471      ],
472      "omnitureSettings": { # Omniture Integration Settings. # Settings for DCM Omniture integration.
473        "omnitureCostDataEnabled": True or False, # Whether placement cost data will be sent to Omniture. This property can be enabled only if omnitureIntegrationEnabled is true.
474        "omnitureIntegrationEnabled": True or False, # Whether Omniture integration is enabled. This property can be enabled only when the "Advanced Ad Serving" account setting is enabled.
475      },
476      "subaccountId": "A String", # Subaccount ID of this floodlight configuration. This is a read-only field that can be left blank.
477      "advertiserId": "A String", # Advertiser ID of the parent advertiser of this floodlight configuration.
478      "analyticsDataSharingEnabled": True or False, # Whether advertiser data is shared with Google Analytics.
479      "inAppAttributionTrackingEnabled": True or False, # Whether in-app attribution tracking is enabled.
480      "thirdPartyAuthenticationTokens": [ # List of third-party authentication tokens enabled for this configuration.
481        { # Third Party Authentication Token
482          "name": "A String", # Name of the third-party authentication token.
483          "value": "A String", # Value of the third-party authentication token. This is a read-only, auto-generated field.
484        },
485      ],
486      "idDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of this floodlight configuration. This is a read-only, auto-generated field.
487        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
488        "value": "A String", # The value of the dimension.
489        "dimensionName": "A String", # The name of the dimension.
490        "etag": "A String", # The eTag of this response for caching purposes.
491        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
492        "id": "A String", # The ID associated with the value if available.
493      },
494      "advertiserIdDimensionValue": { # Represents a DimensionValue resource. # Dimension value for the ID of the advertiser. This is a read-only, auto-generated field.
495        "kind": "dfareporting#dimensionValue", # The kind of resource this is, in this case dfareporting#dimensionValue.
496        "value": "A String", # The value of the dimension.
497        "dimensionName": "A String", # The name of the dimension.
498        "etag": "A String", # The eTag of this response for caching purposes.
499        "matchType": "A String", # Determines how the 'value' field is matched when filtering. If not specified, defaults to EXACT. If set to WILDCARD_EXPRESSION, '*' is allowed as a placeholder for variable length character sequences, and it can be escaped with a backslash. Note, only paid search dimensions ('dfa:paidSearch*') allow a matchType other than EXACT.
500        "id": "A String", # The ID associated with the value if available.
501      },
502      "id": "A String", # ID of this floodlight configuration. This is a read-only, auto-generated field.
503      "userDefinedVariableConfigurations": [ # List of user defined variables enabled for this configuration.
504        { # User Defined Variable configuration.
505          "dataType": "A String", # Data type for the variable. This is a required field.
506          "reportName": "A String", # User-friendly name for the variable which will appear in reports. This is a required field, must be less than 64 characters long, and cannot contain the following characters: ""<>".
507          "variableType": "A String", # Variable name in the tag. This is a required field.
508        },
509      ],
510      "accountId": "A String", # Account ID of this floodlight configuration. This is a read-only field that can be left blank.
511    }</pre>
512</div>
513
514</body></html>