feat(config): id accepts a function, promise or a function that returns promise

Author: MatteoGabriele

README.md

@@ -43,7 +43,6 @@ npm install vue-analytics
 * [Set](/docs/set.md)
 * [Social interactions](/docs/social-interactions.md)
 * [User explorer report](/docs/user-explorer.md)
-* [Track multiple accounts](/docs/track-multiple-accounts.md)
 * [On Analaytics script ready](/docs/when-google-analytics-is-loaded.md)
 * [Custom methods](/docs/custom-methods.md)
 * [Ecommerce](/docs/ecommerce.md)

SUMMARY.md

@@ -13,7 +13,6 @@
 * [Set](/docs/set.md)
 * [Social interactions](/docs/social-interactions.md)
 * [User explorer report](/docs/user-explorer.md)
-* [Track multiple accounts](/docs/track-multiple-accounts.md)
 * [On Analaytics script ready](/docs/when-google-analytics-is-loaded.md)
 * [Custom methods](/docs/custom-methods.md)
 * [Ecommerce](/docs/ecommerce.md)

docs/installation.md

@@ -14,3 +14,47 @@ Vue.use(VueAnalytics, {
   id: 'UA-XXX-X'
 })
 ```
+
+## Track multiple accounts
+
+Pass an array of strings for a multiple tracking system. Every hit will be fired twice: each time with a different tracker name
+
+```js
+import Vue from 'vue'
+import VueAnalytics from 'vue-analytics'
+
+Vue.use(VueAnalytics, {
+  id: ['UA-XXX-A', 'UA-XXX-B']
+})
+```
+
+## Use functions or/and Promises
+
+It is also possible to pass a function, a Promise or a function that returns a Promise: as soon as it returns always a string or an array of strings
+
+```js
+import Vue from 'vue'
+import VueAnalytics from 'vue-analytics'
+import axios from 'axios'
+
+// a function
+Vue.use(VueAnalytics, {
+  id () {
+    return 'UA-XXX-A'
+  }
+})
+
+// a Promise
+Vue.use(VueAnalytics, {
+  id: axios.get('/api/foo').then(response => {
+    return response.data
+  })
+})
+
+// a function that returns a Promise
+Vue.use(VueAnalytics, {
+  id: () => axios.get('/api/foo').then(response => {
+    return response.data
+  })
+})
+```

docs/track-multiple-accounts.md

@@ -38,6 +38,21 @@ export default function bootstrap () {
     return onAnalyticsReady()
   })
   .then(() => {
+    let newId = id
+
+    if (typeof newId === 'function') {
+      newId = newId()
+    }
+
+    if (typeof newId.then === 'function') {
+      return newId.then(response => {
+        config.id = response
+      })
+    }
+
+    return newId
+  })
+  .then(response => {
     // Create analytics trackers first    
     createTrackers()
     // Add all collectors

src/bootstrap.js

@@ -6,7 +6,7 @@ export default {
       let fn = typeof value === 'string' 
         ? config.commands[value]
         : value
-      
+
       if (!fn) {
         throw new Error('[vue-analytics] The value passed to v-ga is not defined in the commands list.')
       }

src/directives/ga.js

@@ -3,7 +3,7 @@ import { getMethod } from '../helpers'
 
 export default function query (method, ...args) {
   getId().forEach(function (id) {
-    if (typeof window.ga === 'undefined') {
+    if (typeof window.ga === 'undefined' || typeof id !== 'string') {
       config.untracked.push({
         method: getMethod(method, id),
         arguments: [...args]