Scala Common Enrich: add support for non-GA campaign attribution: phase 1

[alexanderdean]

Create a new enrichment in the config.yml like this - standard Google-style settings:

{
    "schema": "iglu:com.snowplowanalytics.snowplow/campaign_attribution/jsonschema/1-0-0",

    "data": {

        "name": "campaign_attribution",
        "vendor": "com.snowplowanalytics.snowplow",     
        "enabled": true,
        "properties": {
            "mapping": "static",
            "fields": {
                "mktMedium": ["utm_medium"],
                "mktSource": ["utm_source"],
                "mktTerm": ["utm_term"],
                "mktContent": ["utm_content"],
                "mktCampaign": ["utm_campaign"],
            }
        }
    }
}

To use it for standard Omniture:

{
    "schema": "iglu:com.snowplowanalytics.snowplow/campaign_attribution/jsonschema/1-0-0",

    "data": {

        "name": "campaign_attribution",
        "vendor": "com.snowplowanalytics.snowplow",     
        "enabled": true,
        "properties": {
            "mapping": "static",
            "fields": {
                "mktMedium": [],
                "mktSource": [],
                "mktTerm": [],
                "mktContent": [],
                "mktCampaign": ["cid"],
            }
        }
    }
}

Or to use in a heterogenous environment (different variables are used for different events):

{
    "schema": "iglu:com.snowplowanalytics.snowplow/campaign_attribution/jsonschema/1-0-0",

    "data": {

        "name": "campaign_attribution",
        "vendor": "com.snowplowanalytics.snowplow",     
        "enabled": true,
        "properties": {
            "mapping": "static",
            "fields": {
                "mktMedium": ["utm_medium", "medium"],
                "mktSource": ["utm_source", "source"],
                "mktTerm": ["utm_term", "legacy_term"],
                "mktContent": ["utm_content"],
                "mktCampaign": ["utm_campaign", "cid", "legacy_campaign"],
            }
        }
    }
}

In the case that multiple options are found in the same querystring (e.g. utm_campaign and cid), the first one listed in the YAML will take precedence.

See #435 for design discussion.

[alexanderdean]

To be followed eventually by #436 (but much lower priority)

[alexanderdean]

Note: this ticket covers the batch (Hadoop) flow only.

[alexanderdean]

Assigning this to Fred.

[alexanderdean]

Hi @fblundun! Can you update the YAMLs in this ticket to be JSONs? That would be helpful for me...

[fblundun]

The update has been made.

[alexanderdean]

Thanks Fred!