Retrieve All Subscribers for 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 All Subscribers for Job (Tracking Bulk Async) call retrieves data for all subscriber sent an email, along with complete tracking data for that send. The ExactTarget applications includes the results in a compressed .ZIP file and places that file either on your FTP site or a secure FTP site.

    This call requires jobID input, and you can also include a date range. The call immediately returns a batchID and places the .ZIP file on the specified FTP location.

    This call returns data on all subscriber, whether or not the send was opened, bounced, or returned as undeliverable. The results include complete tracking data for the send. Subscribers deleted from the list prior to the call will not be included in subscriber-level data, but the summary tracking data will include information from deleted subscribers.

    Method

    To retrieve complete tracking data for an email send, along with the attribute data for all subscribers who were sent the email, use the following syntax:

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

    To retrieve complete tracking data for an email send, along subscribers (but not subscriber attributes) who were sent the email, use the following syntax:

    <system>
        <system_name>tracking</system_name>
        <action>Sent_BulkAsync</action>
        <sub_action>all_ToFTP</sub_action>
        <search_type>jobID</search_type>
        <search_value>39408</search_value>
    </system>

    To restrict the tracking data returned in your resulting file to activities that occurred within a certain date range, add the date range as follows:

    <system>
        <system_name>tracking</system_name>
        <action>Sent_BulkAsync</action>
        <sub_action>all_attributes_ToFTP</sub_action>
        <search_type>jobID</search_type>
        <search_value>39408</search_value>
        <daterange>
            <startdate>1/1/2010</startdate>
            <enddate>1/31/2010</enddate>
        </daterange>
    </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.

    <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 essentially 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:52 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 7755 backwards:
       
    Tags: (Edit tags)
    • No tags
     
    Comments (0)
    You must login to post a comment.

     
    Powered by MindTouch 2010
    Admin