Attribution AI user guide
Attribution AI, as part of Intelligent Services is a multi-channel, algorithmic attribution service that calculates the influence and incremental impact of customer interactions against specified outcomes. With Attribution AI, marketers can measure and optimize marketing and advertising spend by understanding the impact of every individual customer interaction across each phase of the customers’ journeys.
This document serves as a guide for interacting with Attribution AI in the Intelligent Services user interface.
Create an instance
In the Adobe Experience Platform UI, click Services in the left navigation. The Services browser appears and displays available Adobe intelligent services. In the container for Attribution AI, click Open .
The Attribution AI service page appears. This page lists service instances of Attribution AI and displays information about them, including the name of the instance, conversion events, how often the instance is run, and the status of the last update. Click Create instance to begin.
Next, the setup page for Attribution AI appears, where you can provide basic information and specify a dataset for the instance.
Name the instance
Under Basic information , provide a name and optional description for your service instance.
Select a dataset
After filling out the basic information, click the dropdown labeled Select Dataset to select your dataset. The dataset is used to train the model and score the subsequent data it produces. When selecting a dataset from the dropdown selector, only ones that are compatible with Attribution AI and conform to the Experience Data Model (XDM) schema are listed. Once a dataset is chosen, click Next in the top-right corner to proceed to the define events page.
There are three different types of input data used for defining events:
- Conversion events: Business objectives that identify the impact of marketing activities, such as, e-commerce orders, in-store purchases, and website visits.
- Lookback window: Provides a time frame indicating how many days prior to the conversion event touchpoints should be included.
- Touchpoints: recipient, individual, and or cookie-level marketing events used to evaluate the numeric or revenue-based impact of conversions.
Define conversion events
In order to define a conversion event, you need to give the event a name and select the event type by clicking the Enter Field Name dropdown menu.
Once an event is selected, a new dropdown appears to its right. The second dropdown is used to provide further context to your event through the use of operations. For this conversion event, the default operation exists is used.
A string under your conversion name is updated as you define your event.
The Add event and Add Group buttons are used to further define your conversion. Depending on the conversion you are defining, you may need to use the Add event and Add group buttons to provide further context.
Clicking Add event creates additional fields which can be filled using the same method as outlined above. Doing so adds an AND statement to the string definition below the conversion name. Click the x to remove an event that has been added.
Clicking Add Group gives the option to create additional fields separate from the original. With the addition of groups, a blue And button appears. Clicking And gives an option to change the parameter to contain "Or". "Or" is used to define multiple successful conversion paths. "And" extends the conversion path to include additional conditions.
If you require more than one conversion, click Add conversion to create a new conversion card. You can repeat the process above to define multiple conversions.
Define lookback window
After you have finished defining your conversion, you need to confirm your lookback window. Using the arrow keys or by clicking the default value (56), specify how many days prior to your conversion event you wish to include touchpoints from. Touchpoints are defined in the next step.
Defining touchpoints follows a similar workflow to defining conversions . Initially you need to name your touchpoint and select a touchpoint value from the Enter Field Name dropdown menu. Once selected, the operator dropdown appears with the default value "exists". Click the dropdown to reveal a list of operators.
For the purpose of this touchpoint, select equals .
Once an operator for a touchpoint is selected, Enter Field Value is made available. The dropdown values for Enter Field Value populate based on the operator and touchpoint value you previously selected. If a value does not populate in the dropdown, you can type that value in manually. Click the dropdown and select CLICK .
The operators "exists" and "not exists" do not have field values associated with them.
The Add event and Add Group buttons are used to further define your touchpoint. Due to the complex nature surrounding touchpoints, it is not uncommon to have multiple events and groups for a single touchpoint.
When clicked, Add event allows for additional fields to be added. Click the x to remove an event that has been added.
Clicking Add group gives you the option to create additional fields separate from the original. With the addition of groups, a blue And button appears. Click And to change the parameter, the new parameter "Or" is used to define multiple successful paths. This particular touchpoint only has one successful path, therefore "Or" is not needed.
Use the string under Touchpoint name for a quick overview of your touchpoint. Notice that the string matches the name of the touchpoint.
You can add additional touchpoints by clicking Add touchpoint and repeating the process above.
Once you have finished defining all necessary touchpoints, scroll up and click Next in the top-right corner to proceed to the final step.
Advanced training and scoring setup
The final page in Attribution AI is the Advanced page used for setting up training and scoring.
Using the Schedule , you can select a day and time of the week you want scoring to take place.
Click the dropdown under Scoring Frequency to select between daily, weekly, and monthly scoring. Next, select the days of the week you want the scoring to take place. Multiple days can be selected. Click a day a second time to deselect it.
To change the time of day you want scoring to occur, click the clock icon. In the new overlay that appears, enter the time of day you want scoring to take place. Click outside the overlay to close it.
It can take up to 24 hours for each scoring process to complete.
Region-based modeling (optional)
Your customers' behaviors might differ significantly by country and geographic region. For global businesses, using country-based or region-based models can increase attribution accuracy. Each region added creates a new model with that region's data.
To define a new region, start by clicking Add region . In the container that appears, provide a name for the region. Only one value ("placeContext.geo.countryCode") populates from the Enter Field Name dropdown. Select this value.
Next, select an operator.
Lastly, type in the country code in the Enter Field Value dropdown.
Country codes are two characters long. A complete list can be found here ISO 3166-1 alpha-2 .
To ensure that you get the most accurate model possible, it is important to train your model with historical data that represents your business. By default, the model is trained using 2 quarters (6 months) of conversion events data. Select the dropdown to change the default. You can choose to train with one to four quarters of data (3-12 months).
A shorter training window is more sensitive to recent trends, whereas a longer training window creates a more robust model and is less sensitive to recent trends.
Once you have selected your training window, click Finish in the top-right corner. Allow some time for the data to process. Once complete, a popover dialog appears confirming that the instance setup is complete. Click Ok to be redirected to the Service instances page where you can see your service instance.
By following this tutorial, you have successfully created a service instance in Attribution AI. Once the instance has finished scoring (allow up to 24 hours), you are ready to discover Attribution AI insights . Additionally, if you wish to download your scoring results, visit the downloading raw scores documentation.
The following video outlines an end-to-end workflow for creating a new instance in Attribution AI.