1  

                                           

       

                                   

Fiksu Integration Guide This Integration Guide explains how to enable the Fiksu data connector within the Adobe Marketing Cloud.

2  

Intended Audience This document is intended for professionals and online marketers who are familiar with configuring Adobe Analytics, including Adobe Analytics variables (eVars, events, and props), and are familiar with the Fiksu platform.

INTEGRATION OVERVIEW

This Adobe Marketing Cloud integration combines the power of Fiksu’s mobile marketing platform through mobile-first data, extensive reach into mobile ad channels and advanced optimizations with the behavioral tracking, targeting and reporting of the Adobe Marketing Cloud to create powerful analytics and optimization opportunities for your organization.

I. Key Benefits and Features Key Benefits of the Adobe-Fiksu integration include:

• Simple integration configuration and monitoring • Consolidated mobile marketing and analytics data into one reporting interface • Automated daily sync of Fiksu mobile marketing measurement data within Adobe Analytics • Optimization of mobile user acquisition and branding campaigns by combining mobile attribution

and tracking with usage data

Mobile Marketing and Analytics Data The Fiksu-Adobe integration can be configured to (a) automatically import Fiksu mobile campaign performance data, and (b) optionally, device level attribution so you can further maximize returns from your mobile marketing spends.

• Fiksu Performance Reporting: Once integrated Fiksu automatically uploads campaign performance metrics (impressions, clicks, spend and conversions or actions), broken down by date and source for Fiksu campaigns. User acquisition and Re-engagement performance data are reported separately.

• Fiksu Device Attribution: You can optionally enable Fiksu device attribution to analyze the full value of Fiksu-driven users against all the events tracked by Adobe. Both attributed and organic data is uploaded to Adobe Analytics. Uploaded data includes acquisition date and source (network) information on a per device level. *Note: Due to data policy contracts, no Facebook or Twitter attribution data will be passed to Adobe. These devices will show as Organic.

What You Should Know Before Activating This Integration Before activating this integration, review the following items against your deployments of Adobe Analytics and your Fiksu account. Doing so will ensure the appropriate best practices and prerequisites are in place prior to activation, resulting in an optimal and successful integration. Optional Step: Please be advised that you might need to modify your Adobe and Fiksu SDK integrations in order to take advantage of Fiksu device attribution data.

3  

Adobe Analytics Review the following information about this integration as it relates to Adobe Analytics:

• Report-Suite Specific: Be advised this integration is report-suite specific. Ensure that you have selected the desired report suite prior to activating the integration.

• Prerequisites for Fiksu Device Attribution: In order to receive Fiksu Device Attribution data you must have the Marketing Cloud Visitor Service active in your app and Customer Attributes Service active in the Marketing Cloud. The integration requires that you sync the Customer Attributes Alias ID with the Adobe Marketing Cloud Visitor ID. The Alias ID for this integration is “FiksuCustID”. This unique ID should also be sent to Fiksu using the ClientID capability in the Fiksu SDK.

Fiksu-Adobe Integration Review the following information about this integration as it relates to Fiksu:

• Current Customer of Fiksu: This integration requires you to be a customer of Fiksu. If you are not currently a Fiksu customer, and do not have an active account, you will not have the information necessary to complete the integration wizard. If you are a Fiksu customer, your Fiksu Account Manager will be able to provide you with the following information necessary to complete the integration wizard:

o Fiksu Customer ID: In order to complete the integration setup you will need to have your Fiksu Customer ID. Please contact your Fiksu Account Manager if you have questions.

o Fiksu App Key: You will also need a Fiksu App ID for each app you intend to integrate with your Adobe Analytics report suite. Please contact your Fiksu Account Manager if you have questions.

Adobe Pricing Considerations Please note, there may be implementation fees associated with this integration in accordance with your Adobe contract. Please contact your Adobe Account Representative for pricing details.

Fiksu Pricing Considerations This is integration is provided to Fiksu customers at no additional cost. Please contact your Fiksu Account Manager for further details.

Adobe Analytics Integration Variables This integration uses Adobe Analytics variables to track various Fiksu metrics. After identifying or creating the Success events, Classifications and eVars to use with the Fiksu integration, use Adobe Analytics’ Admin Console to enable them. The following table describes the Adobe Analytics variables needed for this Fiksu integration. NOTE: Each Fiksu integration will require an independent set of variables, classifications and success events to accurately import and merge Fiksu data. An overlap of variables, events or classifications will result in an incorrect consolidation and aggregation of your campaign results.  

4  

II. Adobe Analytics Variables

A. Required Variables

Variable Type

Variable Properties

Name Population Method

Description

eVar Type: String Expire After: Never Status: Enabled Allocation: Most Recent

fiksu_ua_campaign_key Automatically imported from Fiksu

Key created by Fiksu unique to Ad network/event type combination for User Acquisition campaigns

event Type: Numeric Unique Event Recording: Always Record Event Participation: Enabled

fiksu_ua_impressions Automatically imported from Fiksu

Number of impressions served by Fiksu campaigns

event Type: Numeric Unique Event Recording: Always Record Event Participation: Enabled

fiksu_ua_clicks Automatically imported from Fiksu

Number of clicks served by Fiksu campaigns

event Type: Currency Unique Event Recording: Always Record Event Participation: Enabled

fiksu_ua_cost Automatically imported from Fiksu

Spend on Fiksu Campaigns

event Type: Numeric Unique Event Recording: Always Record Event Participation: Enabled

fiksu_ua_conversions Automatically imported from Fiksu

Number of conversions reported for a User Acquisition campaign

B. Optional Variables Variable Type

Variable Properties

Name Population Method

Description

eVar Type: String Expire After: Never Status: Enabled

fiksu_reng_campaign_key Automatically imported from Fiksu

Key created by Fiksu unique to Ad network/event type combination for Re-engagement Campaigns

5  

Allocation: Most Recent

event Type: Numeric Unique Event Recording: Always Record Event Participation: Enabled

fiksu_reng_impressions Automatically imported from Fiksu

Number of impressions served by Fiksu campaigns

event Type: Numeric Unique Event Recording: Always Record Event Participation: Enabled

fiksu_reng_clicks Automatically imported from Fiksu

Number of clicks served by Fiksu campaigns

event Type: Currency Unique Event Recording: Always Record Event Participation: Enabled

fiksu_reng_cost Automatically imported from Fiksu

Spend on Fiksu Campaigns

event Type: Numeric Unique Event Recording: Always Record Event Participation: Enabled

fiksu_reng_actions Automatically imported from Fiksu

Number of post install actions resulting from Fiksu re-engagement campaign

   

III. Integration Procedure The Adobe Integration Wizard walks you through the integration process. (Optional) Prerequisite for Fiksu Device Attribution data:

1. Download the Customer Attribute FTP template from the Data Connectors Showcase under “Fiksu Resources"

2. In the Adobe Marketing Cloud, create a Customer Attribute utilizing “FiksuCustID” as the Alias ID and the downloaded template as the FTP schema

To configure the integration: 1. In the Adobe Marketing Cloud, select Data Connector from the product drop-down list. 2. Click ‘Add New’ and select ‘By Name’ in the ‘Show’ drop down list. 3. Find the Fiksu icon and drag it to an empty plug-in slot in your Adobe Analytics report suite to launch the

Integration Wizard. 4. On the Fiksu Integration introduction page, review the text, then review Adobe’s Terms & Conditions

associated with the integration. 5. Select the Report Suite that you want to use for this integration.

6  

6. Provide a user-friendly name to identify this integration, then click ‘Create and Configure this Integration.’ This page provides an overview of the integration, along with helpful links for more information. Contact your appropriate Account Managers at both organizations for further details.

7. On each page of the Integration Wizard, provide the information, as described in the following table:

Field Configuration Section Description

Integration Name

(1) Integration Settings

Integration name that Analytics displays in the report suite’s Active Integration List

Name (1) Integration Settings

Name of the person who is responsible for this integration

Email (1) Integration Settings

Email address that receives all notifications related to this integration

Description (1) Integration Settings

Description of the organization-specific purpose for the integration

Fiksu App Key (1) Integration Settings

Unique key for each app registered with Fiksu. Your Fiksu contact will provide this key

Fiksu Customer ID

(1) Integration Settings

Unique Key for your account with Fiksu. Your Fiksu contact will provide this key

Customer Attribute FTP Host

(1) Integration Settings

Host address for Fiksu Customer Attribute

Customer Attribute FTP Password

(1) Integration Settings

Password for the FTP Account created for Fiksu Customer Attributes

Customer Attribute FTP User Name

(1) Integration Settings

User Name for the FTP Account created for Fiksu Customer Attributes

Fiksu UA Campaign Key

(2) Variable Mappings

Appropriate eVar dedicated to Fiksu User Acquisition performance reporting (Required)

Fiksu Reng Campaign Key

(2) Variable Mappings

Appropriate eVar dedicated to Fiksu Re-engagement performance reporting (Optional)

Fiksu UA Impressions

(2) Variable Mappings

Adobe Analytics event that stores the impressions metric imported from Fiksu (Required)

Fiksu UA Clicks (2) Variable Adobe Analytics event that stores the clicks metric imported from

7  

Mappings Fiksu (Required)

Fiksu UA Cost (2) Variable Mappings

Adobe Analytics event that stores the cost metric imported from Fiksu (Required)

Fiksu UA Conversions

(2) Variable Mappings

Adobe Analytics event that stores the Conversion metric associated to User Acquisition Campaigns imported from Fiksu (Required)

Fiksu Reng Impressions

(2) Variable Mappings

Adobe Analytics event that stores the impressions metric imported from Fiksu (Optional)

Fiksu Reng Clicks

(2) Variable Mappings

Adobe Analytics event that stores the clicks metric imported from Fiksu (Optional)

Fiksu Reng Cost (2) Variable Mappings

Adobe Analytics event that stores the cost metric imported from Fiksu (Optional)

Fiksu Reng Actions

(2) Variable Mappings

Adobe Analytics event that stores the Actions metric associated to Re-engagement Campaigns imported from Fiksu (Optional)

Select Calculated Metrics

(3) Data Settings Appropriate calculated metrics to make accessible in reporting

**API Access Requests

(3) Data Settings Allow Fiksu to access your reports. Fiksu will use this API call to synchronize and upload accurate performance data. Note: This step is extremely important to keep Fiksu performance data up to date.

 

After Integration Please give 24 hours for Fiksu data to start automatically populating into Adobe Analytics. You should be able to view all of your Fiksu campaign data in the default Fiksu dashboard provided with this integration.

IV. Verifying the Integration

In addition to the verification that will be done by your implementation consultant, you can ensure that Fiksu data is successfully arriving in Adobe Analytics by performing the following checks. Validate the Fiksu imports:

• Verify if you have an active campaign running with Fiksu • In Adobe Analytics, navigate to the Fiksu Dashboard related to your Fiksu App Key. Depending on your

configuration, one of below actions should indicate a successful integration: o View the UA performance report for the past 2 days to ensure that you see one of the selected

metrics in the report. o View the Re-engagement performance report for the past 2 days to ensure that you see one of

the selected metrics in the report. o View your reports associated with the DeviceID eVar and associated Fiksu classification for the

past 2 days to ensure that you are seeing the selected metrics tied to a Fiksu classification.