Details of events tracked by Donorbox for Enhanced Ecommerce Tracking

As part of enhanced ecommerce tracking, we trigger several events sending data to "Google Analytics (ga)" and its new version "Global Site Tag (GTag)". Donorbox automatically detects whether to use "Google Analytics" or "GTag" version based on the campaign's analytics tracking code. For details on adding analytics tracking code to your campaign, please refer to our guide "How to set up Google Analytics tracking for the donation form"

For GTag, the following events are generated. See "Enhanced ecommerce with gtag.js" for reference.

1. begin_checkout - triggers on donation form load. The data sent looks like

{
  'items': [
    'id': <campaign id>,
    'name': '<campaign name>',
    'brand': '<org name>',
    'category': 'Donation',
    'quantity': 1
  ]
}

2. set_checkout_option - triggered when the donor navigates to the next/previous step within the donation form. The data sent:

​{
  checkout_step: <tab_number>
}

Where the tab_number could be 1, 2, or 3, referring to the amount, information or payment tabs respectively.

3. purchase - triggers on donation completion. The data sent:

{
  'transaction_id': <donation id>,
  'affiliation': 'Donorbox',
  'value': <donation amount>,
  'currency': '<donation currency>',
  'items': [
    'id': <campaign id>,
    'name': '<campaign name>',
    'category': 'Donation',
    'price': <donation amount>,
    'brand': '<org name>',
    'quantity': 1
  ]
}

For ga version, we trigger following events and actions. See Google's Enhanced Ecommerce for reference.

1. On donation form load 

ga('ec:addImpression', {
  'id': <campaign id>,
  'name': '<campaign name>',
  'brand': '<org name>',
  'category': 'Donation',
  'quantity': 1
});

ga('ec:setAction', 'checkout', {step: 1});

ga('send', 'pageview');

2. On form tab change

ga('ec:setAction', 'checkout', {step: <tab_number>});

ga('send', 'pageview');

Where the tab_number could be 1, 2 or 3, meaning amount, information or payment tabs respectively.

3. On donation completion

ga('set', 'currencyCode', '<donation currency>');

ga('ec:addProduct', {
  'id': '<campaign id>',
  'name': '<campaign name>',
  'category': 'Donation',
  'price': <donation amount>,
  'brand': '<org name>',
  'quantity': 1
});

ga('ec:setAction', 'purchase', {
  'id': <donation id>,
  'affiliation': 'Donorbox',
  'revenue': <donation amount>
});

ga('send', 'pageview');