These requests retrieve information about mailings-based subscriber actions.
Mailing Activity Subscriber Actions
Use this request to retrieve information about the subscriber actions on mailings that were sent in the past 100 days.
NOTE: If your query returns no results, run the Subscriber Archive request (detailed below) to retrieve information from mailings that are older than 100 days.
| Data Element | Type | Length | Conditional | Description |
|---|---|---|---|---|
| Count | Bit | True | Number of matches based upon criteria | |
| was_clicked | Bit | True | Clicked counts | |
| was_delivered | Bit | True | Delivered counts | |
| String | 100 | True | Email address | |
| mailing_instance_id | Int | True | Unique mailing instance ID | |
| was_opened | Bit | True | Opened counts | |
| user_id | Int | True | Informz user ID |
Request
<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
<Password></Password>
<Brand id="9999">Test Brand</Brand>
<User></User>
<Grids>
<Grid type="mailing_activity_subscriber_actions">
<ReturnFields>
<DataElement>was_clicked</DataElement>
<DataElement>was_delivered</DataElement>
<DataElement>email</DataElement>
<DataElement>mailing_instance_id</DataElement>
<DataElement>was_opened</DataElement>
<DataElement>user_id</DataElement>
</ReturnFields>
</Grid>
</Grids>
</GridRequest>
Mailing Activity Subscriber Archive
Use this request to retrieve information about the subscriber actions on ("archived") mailings that were sent more than 100 days ago.
| Data Element | Type | Length | Conditional | Description |
|---|---|---|---|---|
| Count | Int | True | Number of matches based upon criteria | |
| was_clicked | Bit | True | Clicked counts | |
| was_delivered | Bit | True | Delivered counts | |
| String | 100 | True | Email address | |
| Mailing_Name | String | 255 | True | Name of the mailing |
| Mailing_date | DateTime | True | Date of the mailing | |
| mailing_instance_id | Int | True | Unique mailing instance ID | |
| was_opened | Bit | True | Opened counts | |
| user_id | Int | True | Informz user ID |
Request
<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
<Password></Password>
<Brand id="9999">Test Brand</Brand>
<User></User>
<Grids>
<Grid type="mailing_activity_subscriber_archive">
<ReturnFields>
<DataElement>was_clicked</DataElement>
<DataElement>was_delivered</DataElement>
<DataElement>email</DataElement>
<DataElement>mailing_instance_id</DataElement>
<DataElement>was_opened</DataElement>
<DataElement>user_id</DataElement>
</ReturnFields>
</Grid>
</Grids>
</GridRequest>