You are here

Home » API reference » GA Push 7

ga_push.utmp.php.inc in GA Push 7

Same filename and directory in other branches
  1. 8 inc/ga_push.utmp.php.inc

UTMP: method and functions for Universal Tracking Measure Protocol.

See also

https://developers.google.com/analytics/devguides/collection/protocol/v1...

File

inc/ga_push.utmp.php.inc
View source 
<?php

/**
 * @file
 * UTMP: method and functions for Universal Tracking Measure Protocol.
 *
 * @see https://developers.google.com/analytics/devguides/collection/protocol/v1/devguide
 */

// Google UTMP Endpoint URL.
define('GA_PUSH_METHOD_UTMP_HOST_ENDPOINT', 'ssl.google-analytics.com/collect');

/**
 * GA Push Method callback: UTMP (php).
 */
function ga_push_method_utmp_php($push, $type, $options) {
  switch ($type) {
    case GA_PUSH_TYPE_EVENT:
      $event_data = ga_push_method_php_utmp_construct_event_request_data($push);

      // @TODO: Check response.
      ga_push_method_utmp_php_request($event_data, $options);
      break;
    case GA_PUSH_TYPE_ECOMMERCE:
      if (isset($push['trans']) && isset($push['items']) && count($push['items'])) {

        // Construct arrays.
        $ecommerce_data = ga_push_method_utmp_php_construct_ecommerce_request_data($push);

        // @TODO: Check request response.
        // Sending the transaction:
        ga_push_method_utmp_php_request($ecommerce_data['transaction'], $options);

        // Sending the items:
        foreach ($ecommerce_data['items'] as $item_data) {
          ga_push_method_utmp_php_request($item_data, $options);
        }
      }
      break;
    case GA_PUSH_TYPE_ENHANCED_ECOMMERCE_PURCHASE:
      if (isset($push['trans']) && isset($push['items']) && count($push['items'])) {

        // Construct arrays.
        $ecommerce_data = ga_push_method_utmp_php_construct_enhanced_ecommerce_request_data($push);

        // @TODO: Check request response.
        ga_push_method_utmp_php_request($ecommerce_data['purchase'], $options);
      }
      break;
    case GA_PUSH_TYPE_EXCEPTION:
      $exception_data = ga_push_method_php_utmp_construct_exception_request_data($push);

      // @TODO: Check response.
      ga_push_method_utmp_php_request($exception_data, $options);
      break;
    case GA_PUSH_TYPE_PAGEVIEW:
      $pageview_data = ga_push_method_php_utmp_construct_pageview_request_data($push);

      // @TODO: Check response.
      ga_push_method_utmp_php_request($pageview_data, $options);
      break;
    case GA_PUSH_TYPE_SOCIAL:
      $social_data = ga_push_method_php_utmp_construct_social_request_data($push);

      // @TODO: Check response.
      ga_push_method_utmp_php_request($social_data, $options);
      break;
  }
}

/**
 * Returns data array for a event tacking.
 *
 * @param array $push
 *   Array with event data.
 *
 * @return array
 *   Array with the event data preparad to be sent to GA.
 */
function ga_push_method_php_utmp_construct_event_request_data($push) {
  $push['t'] = 'event';
  return ga_push_analyticsjs_measurement_protocol_mapping($push);
}

/**
 * Returns data arrays for a eCommerce tacking.
 *
 * @param array $push
 *   Array with transaction and items data.
 *
 * @return array
 *   Array with two keys with eCommerce data preparad to be sent to GA:
 *     - transaction: transaction data to send to GA.
 *     - items: Array with data to send to GA for each item.
 */
function ga_push_method_utmp_php_construct_ecommerce_request_data($push) {
  $data = array();

  // Transaction data.
  $tdata = array(
    't' => 'transaction',
  );
  $tdata += ga_push_analyticsjs_measurement_protocol_mapping($push['trans']);
  $data['transaction'] = $tdata;

  // Items data.
  $data['items'] = array();
  foreach ($push['items'] as $value) {
    $idata = array(
      't' => 'item',
    );
    $idata += ga_push_analyticsjs_measurement_protocol_mapping($value);
    $data['items'][] = $idata;
  }
  return $data;
}

/**
 * Returns data arrays for a enhanced eCommerce tracking.
 *
 * @param array $push
 *   Array with transaction and items data.
 *
 * @return array
 *   Array with two keys with eCommerce data preparad to be sent to GA:
 *     - transaction: transaction data to send to GA.
 *     - items: Array with data to send to GA for each item.
 */
function ga_push_method_utmp_php_construct_enhanced_ecommerce_request_data($push) {
  $data = array();

  // Transaction data.
  $tdata = array(
    't' => 'pageview',
    'pa' => 'purchase',
  );
  $tdata += ga_push_analyticsjs_measurement_protocol_mapping($push['trans']);
  $data['purchase'] = $tdata;

  // Items data.
  foreach ($push['items'] as $index => $product) {
    $product_number = $index + 1;
    $data['purchase'] += ga_push_analyticsjs_measurement_protocol_mapping_enhanced_ecommerce_item($product, $product_number, GA_PUSH_ENHANCED_ECOMMERCE_PRODUCT_KEY);
  }
  return $data;
}

/**
 * Returns data array for a exception tracking.
 *
 * @param array $push
 *   Array with pageview data.
 *
 * @return array
 *   Array with the pageview data ready to be sent to GA.
 */
function ga_push_method_php_utmp_construct_exception_request_data($push) {
  $push['t'] = 'exception';
  return ga_push_analyticsjs_measurement_protocol_mapping($push);
}

/**
 * Returns data array for a pageview tracking.
 *
 * @param array $push
 *   Array with pageview data.
 *
 * @return array
 *   Array with the pageview data ready to be sent to GA.
 */
function ga_push_method_php_utmp_construct_pageview_request_data($push) {
  $push['t'] = 'pageview';
  return ga_push_analyticsjs_measurement_protocol_mapping($push);
}

/**
 * Returns data array for a social tracking.
 *
 * @param array $push
 *   Array with pageview data.
 *
 * @return array
 *   Array with the pageview data ready to be sent to GA.
 */
function ga_push_method_php_utmp_construct_social_request_data($push) {
  $push['t'] = 'social';
  return ga_push_analyticsjs_measurement_protocol_mapping($push);
}

/**
 * Sends tracking data to GA.
 *
 * @param array $data
 *   Data prepared for GA.
 * @param array $options
 *   Custom options from ga_push_add().
 * @param string $method
 *   Method to use (GET or POST).
 *
 * @see ga_push_add()
 * @see https://developers.google.com/analytics/devguides/collection/protocol/v1/devguide
 */
function ga_push_method_utmp_php_request($data = array(), $options = array(), $method = 'POST') {
  $data['v'] = 1;

  // Options variables:
  $data['tid'] = !empty($options['tid']) ? $options['tid'] : variable_get('googleanalytics_account', '');
  $data['cid'] = !empty($options['cid']) ? $options['cid'] : ga_push_method_php_utmp_get_uuid();

  // Optional values:
  $optional = array(
    'ua',
    'uip',
  );
  foreach ($optional as $value) {
    if (array_key_exists($value, $options)) {
      $data[$value] = $options[$value];
    }
  }

  // @NOTE: Proxy Server:
  // Some environments are not able to send hits to Google Analytics directly.
  // To collect the IP and user agent from the client device and not the proxy
  // server, you can specify both values in the measurement protocol, and they
  // will override the values Google Analytics normally obtains from the
  // request headers.
  $user_agent = !empty($_SERVER['HTTP_USER_AGENT']) ? $_SERVER['HTTP_USER_AGENT'] : NULL;
  if (!empty($user_agent)) {
    $data += array(
      'ua' => $user_agent,
    );
  }
  $ip = ip_address();
  if (!empty($ip)) {
    $data += array(
      'uip' => $ip,
    );
  }
  $url = 'https://' . GA_PUSH_METHOD_UTMP_HOST_ENDPOINT;
  $httpr_options = array(
    'method' => $method,
    'data' => drupal_http_build_query($data),
  );

  // @NOTE: log the request/response. We do it in different watchdogs on purpose
  // to detect non response requests.
  $debug = variable_get('ga_push_debug', FALSE);

  // LOG the request:
  if ($debug) {
    watchdog('ga_push', 'GA PUSH UTMP @type request with: @data', array(
      '@type' => $data['t'],
      '@data' => print_r($httpr_options, TRUE),
    ), WATCHDOG_DEBUG);
  }

  // @TODO: Check errors here so caller doesn't have to do it.
  $response = drupal_http_request($url, $httpr_options);

  // LOG the response:
  if ($debug) {

    // Cast object to array:
    $response_log = (array) $response;

    // Ignore data as it is a GIF.
    unset($response_log['data']);
    watchdog('ga_push', 'GA PUSH UTMP @type response with: @data', array(
      '@type' => $data['t'],
      '@data' => print_r($response_log, TRUE),
    ), WATCHDOG_DEBUG);
  }
}

/**
 * Get an UUID ver 4 identifier form cookie or generates one on fallback.
 *
 * @return string
 *   UUID ver 4 identifier
 */
function ga_push_method_php_utmp_get_uuid() {
  if (isset($_COOKIE['_ga'])) {
    list($version, $domain_depth, $cid1, $cid2) = explode('.', $_COOKIE["_ga"], 4);
    return $cid1 . '.' . $cid2;
  }
  return ga_push_method_php_utmp_gen_uuid();
}

/**
 * Generates an UUID ver 4 identifier.
 *
 * Thanks to Andrew Mooer at php.net.
 * http://www.php.net/manual/en/function.uniqid.php#94959
 *
 * @return string
 *   UUID.
 */
function ga_push_method_php_utmp_gen_uuid() {
  return sprintf('%04x%04x-%04x-%04x-%04x-%04x%04x%04x', mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xfff) | 0x4000, mt_rand(0, 0x3fff) | 0x8000, mt_rand(0, 0xffff), mt_rand(0, 0xffff), mt_rand(0, 0xffff));
}

Functions

Namesort descending Description
ga_push_method_php_utmp_construct_event_request_data Returns data array for a event tacking.
ga_push_method_php_utmp_construct_exception_request_data Returns data array for a exception tracking.
ga_push_method_php_utmp_construct_pageview_request_data Returns data array for a pageview tracking.
ga_push_method_php_utmp_construct_social_request_data Returns data array for a social tracking.
ga_push_method_php_utmp_gen_uuid Generates an UUID ver 4 identifier.
ga_push_method_php_utmp_get_uuid Get an UUID ver 4 identifier form cookie or generates one on fallback.
ga_push_method_utmp_php GA Push Method callback: UTMP (php).
ga_push_method_utmp_php_construct_ecommerce_request_data Returns data arrays for a eCommerce tacking.
ga_push_method_utmp_php_construct_enhanced_ecommerce_request_data Returns data arrays for a enhanced eCommerce tracking.
ga_push_method_utmp_php_request Sends tracking data to GA.

Constants

Namesort descending Description
GA_PUSH_METHOD_UTMP_HOST_ENDPOINT