blob: ca8078c6fd79bd055f66e3419193ec6caaf3d506 [file] [log] [blame]
John Asmuth614db982014-04-24 15:46:26 -04001<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="analytics_v3.html">Google Analytics API</a> . <a href="analytics_v3.data.html">data</a> . <a href="analytics_v3.data.mcf.html">mcf</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070078 <code><a href="#close">close()</a></code></p>
79<p class="firstline">Close httplib2 connections.</p>
80<p class="toc_element">
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -080081 <code><a href="#get">get(ids, start_date, end_date, metrics, max_results=None, dimensions=None, start_index=None, samplingLevel=None, sort=None, filters=None)</a></code></p>
John Asmuth614db982014-04-24 15:46:26 -040082<p class="firstline">Returns Analytics Multi-Channel Funnels data for a view (profile).</p>
83<h3>Method Details</h3>
84<div class="method">
Dmitry Frenkel3e17f892020-10-06 16:46:05 -070085 <code class="details" id="close">close()</code>
86 <pre>Close httplib2 connections.</pre>
87</div>
88
89<div class="method">
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -080090 <code class="details" id="get">get(ids, start_date, end_date, metrics, max_results=None, dimensions=None, start_index=None, samplingLevel=None, sort=None, filters=None)</code>
John Asmuth614db982014-04-24 15:46:26 -040091 <pre>Returns Analytics Multi-Channel Funnels data for a view (profile).
92
93Args:
94 ids: string, Unique table ID for retrieving Analytics data. Table ID is of the form ga:XXXX, where XXXX is the Analytics view (profile) ID. (required)
95 start_date: string, Start date for fetching Analytics data. Requests can specify a start date formatted as YYYY-MM-DD, or as a relative date (e.g., today, yesterday, or 7daysAgo). The default value is 7daysAgo. (required)
96 end_date: string, End date for fetching Analytics data. Requests can specify a start date formatted as YYYY-MM-DD, or as a relative date (e.g., today, yesterday, or 7daysAgo). The default value is 7daysAgo. (required)
Bu Sun Kim65020912020-05-20 12:08:20 -070097 metrics: string, A comma-separated list of Multi-Channel Funnels metrics. E.g., &#x27;mcf:totalConversions,mcf:totalConversionValue&#x27;. At least one metric must be specified. (required)
Yoshi Automation Botc2228be2020-11-24 15:48:03 -080098 max_results: integer, The maximum number of entries to include in this feed.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -080099 dimensions: string, A comma-separated list of Multi-Channel Funnels dimensions. E.g., &#x27;mcf:source,mcf:medium&#x27;.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800100 start_index: integer, An index of the first entity to retrieve. Use this parameter as a pagination mechanism along with the max-results parameter.
John Asmuth614db982014-04-24 15:46:26 -0400101 samplingLevel: string, The desired sampling level.
102 Allowed values
103 DEFAULT - Returns response with a sample size that balances speed and accuracy.
104 FASTER - Returns a fast response with a smaller sample size.
105 HIGHER_PRECISION - Returns a more accurate response using a large sample size, but this may result in the response being slower.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800106 sort: string, A comma-separated list of dimensions or metrics that determine the sort order for the Analytics data.
107 filters: string, A comma-separated list of dimension or metric filters to be applied to the Analytics data.
John Asmuth614db982014-04-24 15:46:26 -0400108
109Returns:
110 An object of the form:
111
112 { # Multi-Channel Funnels data for a given view (profile).
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800113 &quot;itemsPerPage&quot;: 42, # The maximum number of rows the response can contain, regardless of the actual number of rows returned. Its value ranges from 1 to 10,000 with a value of 1000 by default, or otherwise specified by the max-results query parameter.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800114 &quot;query&quot;: { # Analytics data request query parameters.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800115 &quot;start-date&quot;: &quot;A String&quot;, # Start date.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800116 &quot;ids&quot;: &quot;A String&quot;, # Unique table ID.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800117 &quot;end-date&quot;: &quot;A String&quot;, # End date.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800118 &quot;metrics&quot;: [ # List of analytics metrics.
119 &quot;A String&quot;,
120 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800121 &quot;max-results&quot;: 42, # Maximum results per page.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800122 &quot;filters&quot;: &quot;A String&quot;, # Comma-separated list of dimension or metric filters.
123 &quot;dimensions&quot;: &quot;A String&quot;, # List of analytics dimensions.
124 &quot;samplingLevel&quot;: &quot;A String&quot;, # Desired sampling level
125 &quot;start-index&quot;: 42, # Start index.
126 &quot;segment&quot;: &quot;A String&quot;, # Analytics advanced segment.
127 &quot;sort&quot;: [ # List of dimensions or metrics based on which Analytics data is sorted.
128 &quot;A String&quot;,
129 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800130 },
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800131 &quot;containsSampledData&quot;: True or False, # Determines if the Analytics data contains sampled data.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700132 &quot;rows&quot;: [ # Analytics data rows, where each row contains a list of dimension values followed by the metric values. The order of dimensions and metrics is same as specified in the request.
133 [
134 { # A union object representing a dimension or metric value. Only one of &quot;primitiveValue&quot; or &quot;conversionPathValue&quot; attribute will be populated.
Bu Sun Kim673ec5c2020-11-16 11:05:03 -0700135 &quot;primitiveValue&quot;: &quot;A String&quot;, # A primitive dimension value. A primitive metric value.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700136 &quot;conversionPathValue&quot;: [ # A conversion path dimension value, containing a list of interactions with their attributes.
137 {
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700138 &quot;interactionType&quot;: &quot;A String&quot;, # Type of an interaction on conversion path. Such as CLICK, IMPRESSION etc.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800139 &quot;nodeValue&quot;: &quot;A String&quot;, # Node value of an interaction on conversion path. Such as source, medium etc.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700140 },
141 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700142 },
143 ],
144 ],
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800145 &quot;sampleSize&quot;: &quot;A String&quot;, # The number of samples used to calculate the result.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800146 &quot;totalResults&quot;: 42, # The total number of rows for the query, regardless of the number of rows in the response.
147 &quot;profileInfo&quot;: { # Information for the view (profile), for which the Analytics data was requested.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800148 &quot;internalWebPropertyId&quot;: &quot;A String&quot;, # Internal ID for the web property to which this view (profile) belongs.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800149 &quot;profileId&quot;: &quot;A String&quot;, # View (Profile) ID.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800150 &quot;accountId&quot;: &quot;A String&quot;, # Account ID to which this view (profile) belongs.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800151 &quot;webPropertyId&quot;: &quot;A String&quot;, # Web Property ID to which this view (profile) belongs.
152 &quot;tableId&quot;: &quot;A String&quot;, # Table ID for view (profile).
153 &quot;profileName&quot;: &quot;A String&quot;, # View (Profile) name.
154 },
155 &quot;totalsForAllResults&quot;: { # Total values for the requested metrics over all the results, not just the results returned in this response. The order of the metric totals is same as the metric order specified in the request.
156 &quot;a_key&quot;: &quot;A String&quot;, # Key-value pair for the total value of a metric. Key is the metric name and the value is the total value for that metric.
Yoshi Automation Botc2228be2020-11-24 15:48:03 -0800157 },
158 &quot;sampleSpace&quot;: &quot;A String&quot;, # Total size of the sample space from which the samples were selected.
Yoshi Automation Bot0d561ef2020-11-25 07:50:41 -0800159 &quot;id&quot;: &quot;A String&quot;, # Unique ID for this data response.
160 &quot;nextLink&quot;: &quot;A String&quot;, # Link to next page for this Analytics data query.
161 &quot;previousLink&quot;: &quot;A String&quot;, # Link to previous page for this Analytics data query.
162 &quot;columnHeaders&quot;: [ # Column headers that list dimension names followed by the metric names. The order of dimensions and metrics is same as specified in the request.
163 {
164 &quot;dataType&quot;: &quot;A String&quot;, # Data type. Dimension and metric values data types such as INTEGER, DOUBLE, CURRENCY, MCF_SEQUENCE etc.
165 &quot;columnType&quot;: &quot;A String&quot;, # Column Type. Either DIMENSION or METRIC.
166 &quot;name&quot;: &quot;A String&quot;, # Column name.
167 },
168 ],
169 &quot;selfLink&quot;: &quot;A String&quot;, # Link to this page.
170 &quot;kind&quot;: &quot;analytics#mcfData&quot;, # Resource type.
John Asmuth614db982014-04-24 15:46:26 -0400171 }</pre>
172</div>
173
174</body></html>