Data Insertion Process

The Data Insertion API supports HTTP POST and HTTP GET for submitting data to Adobe Marketing Cloud servers.

The Analytics response to each data insertion includes a status message (SUCCESS or FAILURE).

HTTP POST

Use an HTTP POST to submit properly-formatted Data Insertion XML to the Data Insertion URL. The Data Insertion URL differs from the standard JavaScript data submission URL. Adobe ClientCare can provide the domain name of the Adobe data collection servers where you should send data. For example:

http://namespace.112.2o7.net/b/ss//6

http://namespace.122.2o7.net/b/ss//6

The "6" code at the end of the URL indicates that the data submission requires XML processing.

Upon receipt, Adobe servers perform basic tag validation of the data insertion. If it encounters an error, Adobe returns a Failure response. If the data insertion is successful, Adobe queues the data insertion request for processing by the standard Analytics Data Processing Engine. The engine processes these requests in the same way it processes data collected via JavaScript.

When using HTTP POST with the Data Insertion API, consider the following:

  • The Data Insertion API requires data in UTF-8 format. Specify the character encoding in the opening XML tag, as shown in XML Data Insertion Format.
  • Replace Ampersand (&), greater-than (>), and less-than (<) symbols with their HTML equivalents when passing them into a Analytics variable. For example, submit <evar1>News & Sports <local> </evar1> as <evar1>News &amp; Sports &lt;local&gt; </evar1>.
  • To submit data over an encrypted connection, the application must be configured to support HTTPS POST commands. Some tools that let you do this include:

HTTP GET

Use an HTTP GET to submit data to the Data Insertion URL in a query-string format that supports shortened variable names (for more information, see "Variables and Query String Parameters" in the Analytics Implementation Guide, available at Help > Documentation in the Marketing Cloud.

HTTP GET reduces bandwidth needs by 30% - 40%, but Adobe data collection servers do not send response messages, so if the data insertion doesn't work as expected, you do not have that feedback for troubleshooting purposes. For more information, see the HTTP GET Sample.

The Data Insertion URL differs from the standard JavaScript data submission URL. The <rsid> in the URL is the report suite where you want to submit the data. Adobe ClientCare can provide the domain name of the Adobe data collection servers where you should send data. For example:

http://namespace.112.2o7.net/b/ss/<rsid>/0

http://namespace.122.2o7.net/b/ss/<rsid>/0

The "0" code at the end of the URL indicates that the data submission requires JavaScript processing. For example:

Upon receipt, Adobe servers perform basic tag validation of the data insertion. If it encounters an error, Adobe returns a Failure response. If the data insertion is successful, Adobe queues the data insertion request for processing by the standard Analytics Data Processing Engine. The engine processes these requests in the same way it processes data collected via JavaScript.

The Data Insertion API requires data in UTF-8 format.

User Comments (1)

Hi ,

I am using the data insertion api method through http post method for my souq android app to transfer the data from Apsalar to omniture server.

Apsalar is a third party tool ,which tracks the various source of installs for us.

We are transferring couple of context data from Apsalar to Omniture through Data Insertion API method (http post method) on a particular page .

I am using the following configuration :

rsid :souqandroidapp
data center url:http://souq.sc.omtrdc.net/b/ss//6

The issue is that I am able to capture the context data from Apsalar.I am passing these context data into various eEvars, but the issue is that I am not able to break down the Evar by goal conversion metrics like Orders,Revenue etc.

The question I have is that how does the VisitorID 's context data from Apsalar matches with
rest of Omniture data.

Is there anything which I am doing wrong

Thanks & Regards,
Anand

Must be logged in to comment. now to comment!