mixpanel-swift/docs/docsets/Mixpanel.docset/Contents/Resources/Documents/Classes/Mixpanel.html
2016-07-28 14:03:26 -07:00

368 lines
17 KiB
HTML

<!DOCTYPE html>
<html lang="en">
<head>
<title>Mixpanel Class Reference</title>
<link rel="stylesheet" type="text/css" href="../css/jazzy.css" />
<link rel="stylesheet" type="text/css" href="../css/highlight.css" />
<meta charset='utf-8'>
<script src="../js/jquery.min.js" defer></script>
<script src="../js/jazzy.js" defer></script>
</head>
<body>
<a name="//apple_ref/swift/Class/Mixpanel" class="dashAnchor"></a>
<a title="Mixpanel Class Reference"></a>
<header>
<div class="content-wrapper">
<p><a href="../index.html">Mixpanel Docs</a> (100% documented)</p>
<p class="header-right"><a href="https://github.com/mixpanel/mixpanel-swift"><img src="../img/gh.png"/>View on GitHub</a></p>
</div>
</header>
<div class="content-wrapper">
<p id="breadcrumbs">
<a href="../index.html">Mixpanel Reference</a>
<img id="carat" src="../img/carat.png" />
Mixpanel Class Reference
</p>
</div>
<div class="content-wrapper">
<nav class="sidebar">
<ul class="nav-groups">
<li class="nav-group-name">
<a href="../Classes.html">Classes</a>
<ul class="nav-group-tasks">
<li class="nav-group-task">
<a href="../Classes/Mixpanel.html">Mixpanel</a>
</li>
<li class="nav-group-task">
<a href="../Classes/MixpanelInstance.html">MixpanelInstance</a>
</li>
<li class="nav-group-task">
<a href="../Classes/People.html">People</a>
</li>
</ul>
</li>
<li class="nav-group-name">
<a href="../Protocols.html">Protocols</a>
<ul class="nav-group-tasks">
<li class="nav-group-task">
<a href="../Protocols/MixpanelDelegate.html">MixpanelDelegate</a>
</li>
</ul>
</li>
</ul>
</nav>
<article class="main-content">
<section>
<section class="section">
<h1>Mixpanel</h1>
<div class="declaration">
<div class="language">
<pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="kt">Mixpanel</span></code></pre>
</div>
</div>
<p>The primary class for integrating Mixpanel with your app.</p>
</section>
<section class="section task-group-section">
<div class="task-group">
<ul>
<li class="item">
<div>
<code>
<a name="/s:ZFC8Mixpanel8Mixpanel10initializeFT5tokenSS13launchOptionsGSqGVs10DictionaryCSo8NSObjectPs9AnyObject___13flushIntervalSd12instanceNameSS_CS_16MixpanelInstance"></a>
<a name="//apple_ref/swift/Method/initialize(token:launchOptions:flushInterval:instanceName:)" class="dashAnchor"></a>
<a class="token" href="#/s:ZFC8Mixpanel8Mixpanel10initializeFT5tokenSS13launchOptionsGSqGVs10DictionaryCSo8NSObjectPs9AnyObject___13flushIntervalSd12instanceNameSS_CS_16MixpanelInstance">initialize(token:launchOptions:flushInterval:instanceName:)</a>
</code>
</div>
<div class="height-container">
<div class="pointer-container"></div>
<section class="section">
<div class="pointer"></div>
<div class="abstract">
<p>Initializes an instance of the API with the given project token.</p>
<p>Returns a new Mixpanel instance API object. This allows you to create more than one instance
of the API object, which is convenient if you&rsquo;d like to send data to more than
one Mixpanel project from a single app.</p>
<div class="aside aside-important">
<p class="aside-title">Important</p>
<p>If you have more than one Mixpanel instance, it is beneficial to initialize
the instances with an instanceName. Then they can be reached by calling getInstance with name.</p>
</div>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="language">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="kd">func</span> <span class="nf">initialize</span><span class="p">(</span><span class="n">token</span> <span class="nv">apiToken</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span>
<span class="nv">launchOptions</span><span class="p">:</span> <span class="p">[</span><span class="kt">NSObject</span><span class="p">:</span> <span class="kt">AnyObject</span><span class="p">]?</span> <span class="o">=</span> <span class="kc">nil</span><span class="p">,</span>
<span class="nv">flushInterval</span><span class="p">:</span> <span class="kt">Double</span> <span class="o">=</span> <span class="mi">60</span><span class="p">,</span>
<span class="nv">instanceName</span><span class="p">:</span> <span class="kt">String</span> <span class="o">=</span> <span class="kt">UUID</span><span class="p">()</span><span class="o">.</span><span class="n">uuidString</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/MixpanelInstance.html">MixpanelInstance</a></span></code></pre>
</div>
</div>
<div>
<h4>Parameters</h4>
<table class="graybox">
<tbody>
<tr>
<td>
<code>
<em>token</em>
</code>
</td>
<td>
<div>
<p>your project token</p>
</div>
</td>
</tr>
<tr>
<td>
<code>
<em>launchOptions</em>
</code>
</td>
<td>
<div>
<p>Optional. App delegate launchOptions</p>
</div>
</td>
</tr>
<tr>
<td>
<code>
<em>flushInterval</em>
</code>
</td>
<td>
<div>
<p>Optional. Interval to run background flushing</p>
</div>
</td>
</tr>
<tr>
<td>
<code>
<em>instanceName</em>
</code>
</td>
<td>
<div>
<p>Optional. The name you want to call this instance</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<div>
<h4>Return Value</h4>
<p>returns a mixpanel instance if needed to keep throughout the project. You can always get the instance by calling getInstance(name)</p>
</div>
</section>
</div>
</li>
<li class="item">
<div>
<code>
<a name="/s:ZFC8Mixpanel8Mixpanel11getInstanceFT4nameSS_GSqCS_16MixpanelInstance_"></a>
<a name="//apple_ref/swift/Method/getInstance(name:)" class="dashAnchor"></a>
<a class="token" href="#/s:ZFC8Mixpanel8Mixpanel11getInstanceFT4nameSS_GSqCS_16MixpanelInstance_">getInstance(name:)</a>
</code>
</div>
<div class="height-container">
<div class="pointer-container"></div>
<section class="section">
<div class="pointer"></div>
<div class="abstract">
<p>Gets the mixpanel instance with the given name</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="language">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="kd">func</span> <span class="nf">getInstance</span><span class="p">(</span><span class="nv">name</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/MixpanelInstance.html">MixpanelInstance</a></span><span class="p">?</span></code></pre>
</div>
</div>
<div>
<h4>Parameters</h4>
<table class="graybox">
<tbody>
<tr>
<td>
<code>
<em>name</em>
</code>
</td>
<td>
<div>
<p>the instance name</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<div>
<h4>Return Value</h4>
<p>returns the mixpanel instance</p>
</div>
</section>
</div>
</li>
<li class="item">
<div>
<code>
<a name="/s:ZFC8Mixpanel8Mixpanel12mainInstanceFT_CS_16MixpanelInstance"></a>
<a name="//apple_ref/swift/Method/mainInstance()" class="dashAnchor"></a>
<a class="token" href="#/s:ZFC8Mixpanel8Mixpanel12mainInstanceFT_CS_16MixpanelInstance">mainInstance()</a>
</code>
</div>
<div class="height-container">
<div class="pointer-container"></div>
<section class="section">
<div class="pointer"></div>
<div class="abstract">
<p>Returns the main instance that was initialized.</p>
<p>If not specified explicitly, the main instance is always the last instance added</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="language">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="kd">func</span> <span class="nf">mainInstance</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kt"><a href="../Classes/MixpanelInstance.html">MixpanelInstance</a></span></code></pre>
</div>
</div>
<div>
<h4>Return Value</h4>
<p>returns the main Mixpanel instance</p>
</div>
</section>
</div>
</li>
<li class="item">
<div>
<code>
<a name="/s:ZFC8Mixpanel8Mixpanel15setMainInstanceFT4nameSS_T_"></a>
<a name="//apple_ref/swift/Method/setMainInstance(name:)" class="dashAnchor"></a>
<a class="token" href="#/s:ZFC8Mixpanel8Mixpanel15setMainInstanceFT4nameSS_T_">setMainInstance(name:)</a>
</code>
</div>
<div class="height-container">
<div class="pointer-container"></div>
<section class="section">
<div class="pointer"></div>
<div class="abstract">
<p>Sets the main instance based on the instance name</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="language">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="kd">func</span> <span class="nf">setMainInstance</span><span class="p">(</span><span class="nv">name</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span></code></pre>
</div>
</div>
<div>
<h4>Parameters</h4>
<table class="graybox">
<tbody>
<tr>
<td>
<code>
<em>name</em>
</code>
</td>
<td>
<div>
<p>the instance name</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</section>
</div>
</li>
<li class="item">
<div>
<code>
<a name="/s:ZFC8Mixpanel8Mixpanel14removeInstanceFT4nameSS_T_"></a>
<a name="//apple_ref/swift/Method/removeInstance(name:)" class="dashAnchor"></a>
<a class="token" href="#/s:ZFC8Mixpanel8Mixpanel14removeInstanceFT4nameSS_T_">removeInstance(name:)</a>
</code>
</div>
<div class="height-container">
<div class="pointer-container"></div>
<section class="section">
<div class="pointer"></div>
<div class="abstract">
<p>Removes an unneeded Mixpanel instance based on its name</p>
</div>
<div class="declaration">
<h4>Declaration</h4>
<div class="language">
<p class="aside-title">Swift</p>
<pre class="highlight"><code><span class="kd">public</span> <span class="kd">class</span> <span class="kd">func</span> <span class="nf">removeInstance</span><span class="p">(</span><span class="nv">name</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span></code></pre>
</div>
</div>
<div>
<h4>Parameters</h4>
<table class="graybox">
<tbody>
<tr>
<td>
<code>
<em>name</em>
</code>
</td>
<td>
<div>
<p>the instance name</p>
</div>
</td>
</tr>
</tbody>
</table>
</div>
</section>
</div>
</li>
</ul>
</div>
</section>
</section>
<section id="footer">
<p>&copy; 2016 <a class="link" href="http://mixpanel.com" target="_blank" rel="external">Mixpanel</a>. All rights reserved. (Last updated: 2016-07-28)</p>
<p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.7.0</a>, a <a class="link" href="http://realm.io" target="_blank" rel="external">Realm</a> project.</p>
</section>
</article>
</div>
</body>
</div>
</html>