Migrate profiles to the new streaming media fields
This document describes the process of migrating the profile filtering service that exists on top of the Adobe Data Collection flows that are enabled for Adobe Analytics for streaming media data. The migration converts the profile filtering service from using the Adobe streaming media services data type called “Media” to use the new corresponding data type called “Media Reporting Details.”
Migrate profiles
To migrate the profile filtering from the old data type called “Media” to the new data type called “Media Reporting Details,” you must edit the existing profile filtering rules:
-
In Adobe Experience Platform, under the Sources section, go to the Dataflows tab.
-
Locate the dataflow responsible for importing streaming media data from Adobe Analytics to Adobe Experience Platform via Adobe Data Collection.
-
Select Update dataflow to modify the profile filtering setup by replacing every custom rule that contains a deprecated field with the new corresponding field from the new XDM object.
-
Locate the filters containing fields from the deprecated “Media” object.
-
Append those filters by adding fields from the new “Media Reporting Details” object.
-
Use an OR operator between the two fields;
-
Validate that the profiles are still working as expected.
See the Content ID parameter on the Audio and video parameters page to map between the old fields and the new fields. The old field path can be found under the “XDM Field Path” property while the new field path can be found under the “Reporting XDM Field Path” property.
Example
To make it easier to follow the migration guidelines, consider the following example dataflow that contains a single profile filtering rule. In this case, since there is only a single rule, you need to apply the migration guidelines only once.
- In Adobe Experience Platform, under the Sources section, go to the Dataflows tab.
1.Locate the dataflow responsible for importing streaming media data from Adobe Analytics to Adobe Experience Platform via Adobe Analytics.
-
Select Update dataflow to enter the editing UI as shown in the below image.
-
Select Next to go to the Filtering tab.
-
On the Filtering tab, identify the filtering rules that rely on
media.mediaTimedfields.
For each filter that uses the meda.mediaTimed object, find its correspondent in the
mediaReportingobject using the Audio and video parameters page to map between the old fields and the new fields. The old field path is found under the “XDM Field Path” property while the new field path is found under the “Reporting XDM Field Path” property. As an example, for Media Starts, the correspondent formedia.mediaTimed.impressions.valueismediaReporting.sessionDetails.isViewed.
-
Drag the relevant
mediaReportingfield to the filtering rule and use the OR operator between the two rules. Add the same rule as the existing one when using the new field.
-
Select Next to save your changes.