Retrieve Single Job (Tracking Bulk Async)

From $1

    Table of contents
    1. 1. Method
    2. 2. Results
    Doc-Wiki-BannerHK.png

    (Click the banner to go to the related Docs.Code.ExactTarget.com page.)

    The Retrieve Single Job (Tracking Bulk Async) call retrieves complete tracking data for an email send. Following the call, the The ExactTarget application returns a batchID and places the results in a compressed .ZIP file on your FTP site or a secure FTP site.

    The call requires a jobID to retrieve the data related to that job. You can also specify a date range to narrow data down to that time period.

    The call can also return complete tracking data, complete tracking data with subscriber attributes of those subscribers involved in the send, or any of this data within a specified data range. The file includes this information only if that subscriber opened the email, the email bounced, or if the email was returned undeliverable.

    Method

    To retrieve complete tracking data for an email send, use the following syntax. Note that the use of a date range, shown in this code sample, is optional.

    <system>
        <system_name>tracking</system_name>
        <action>BulkAsync</action>
        <sub_action>all_ToFTP</sub_action>
        <search_type>jobID</search_type>
        <search_value>39408</search_value>
        <search_value2/>
        <daterange>
            <startdate>1/1/2010</startdate>
            <enddate>1/31/2010</enddate>
        </daterange>
    </system>

    If you want to include the attribute data for each subscriber who contributed to this email send's tracking data, use the following syntax. Note that this sample does not show the date range option, which can be added (follow the syntax shown above).

    <system>
        <system_name>tracking</system_name>
        <action>BulkAsync</action>
        <sub_action>all_attributes_ToFTP</sub_action>
        <search_type>jobID</search_type>
        <search_value>39408</search_value>
        <search_value2/>
    </system>

    With this call, you also have the option of picking up the resulting file from your own FTP site rather than from the ExactTarget secure FTP site, by including the <results> node in your call. See the Output for a Batch File Export (Bulk Async) Call help topic for the syntax to use.

    XML Tag

    Tag Description

    <search_value>

    Job ID of the email send for which you want to retrieve tracking data.

    <search_value2>

    Leave the value for this tag blank. (Do not omit the tag.)

    <daterange>

    (Optional) If you want to retrieve tracking data for a specific period, enter the dates within the <startdate> and <enddate> tags in the format M/D/ YYYY.

    Results

    The immediate results of this call will be a confirmation message and the batch ID for this request, as described in Output for a Batch File Export (Bulk Async) Call. Use the batch ID to check on the status of the request; see Batch Inquire (Status Check).

    The zipped file that will be deposited to the secure FTP site (or to your own FTP site, if you used the <results> node in your call) will contain the same XML output that you receive for the Tracking Retrieve (Bulk Export) method; see that topic for details.


    This page was last updated by Ryan Williams on Fri, 06 Jan 2012 21:25:50 GMT.

    If you require assistance with the ExactTarget application, please contact Global Support. If you wish to send Ryan direct feedback, fill out the form below:

     


    Was This Page Helpful?
    Suggestions or Comments:
    Name (optional):
    Email Address (optional):
    Enter 16920 backwards:
       
    Tags: (Edit tags)
    • No tags
     
    Comments (0)
    You must login to post a comment.

     
    Powered by MindTouch 2010
    Admin