These documents return various demographics information.
Demographics
This document returns the demographics associated with a subscriber.
| Data Element | Type | Length | Conditional | Description |
|---|---|---|---|---|
| Count | Int | Number of matches based on criteria | ||
| subscriber_id | Int | True | Unique Subscriber ID | |
| subscriber_demographics_id | Int | True | Unique Subscriber Demographic ID | |
| demographic_id | Int | True | Unique Demographic ID | |
| demographic_name | String | 255 | True | Demographic Name |
| demographic_category_id | Int | True | Demographic Category ID | |
| demographic_category_name | String | 255 | True | Demographic Category Name |
| String | 100 | True | Email address | |
| user_id | String | 255 | True | Unique remote ID |
Request
<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
<Brand id="9999">Test Brand</Brand>
<User></User>
<Grids>
<Grid type="subscriber_demographics">
<ReturnFields>
<DataElement>demographic_category_id</DataElement>
<DataElement>demographic_category_name</DataElement>
<DataElement>demographic_id</DataElement>
<DataElement>demographic_name</DataElement>
<DataElement>subscriber_demographics_id</DataElement>
</ReturnFields>
</Grid>
</Grids>
</GridRequest>
Extended Demographics
This document returns details for extended demographics.
| Data Element | Type | Length | Conditional | Description |
|---|---|---|---|---|
| subscriber_id | Int | True | Unique Subscriber ID | |
| remote_id | String | 50 | True | Subscriber ID for the remote system |
| subscriber_email | String | -1 | True | Subscriber Email Address |
| category_id | Int | True | Unique Demographic Category ID | |
| category_name | String | 255 | True | Demographic Category Name |
| demographic_id | Int | True | Unique Demographic ID | |
| demographic_name | String | 255 | True | Demographic Name |
| category_extended_field_name | String | 100 | True | Demographic Category Extended Field Name |
| category_extended_field_value | String | 100 | True | Demographic Category Extended Field Value |
Request
<GridRequest xmlns="http://partner.informz.net/aapi/2009/08/">
<Password></Password>
<Brand id="9999">Test Brand </Brand>
<User></User>
<Grids>
<Grid type="subscriber_extended_demographic">
<Conditions>
<Condition>
<Single>
<DataElement>subscriber_id</DataElement>
<DataValue>525108846</DataValue>
<Comparator>EQ</Comparator>
</Single>
</Condition>
<Condition>
<Single>
<DataElement>category_id</DataElement>
<DataValue>1759</DataValue>
<Comparator>EQ</Comparator>
</Single>
</Condition>
</Conditions>
<ReturnFields>
<DataElement>subscriber_id</DataElement>
<DataElement>remote_id</DataElement>
<DataElement>subscriber_email</DataElement>
<DataElement>is_unsubscriber</DataElement>
<DataElement>category_id</DataElement>
<DataElement>category_name</DataElement>
<DataElement>demographic_id</DataElement>
<DataElement>demographic_name</DataElement>
<DataElement>category_extended_field_name</DataElement>
<DataElement>category_extended_field_name</DataElement>
</ReturnFields>
</Grid>
</Grids>
</GridRequest>
Response
<?xml version="1.0" encoding="utf-8"?>
<GridResponse xmlns="http://partner.informz.net/aapi/2009/08/">
<Brand id="9999">Test Brand</Brand>
<User></User>
<Grids>
<Grid type="subscriber_extended_demographic">
<Record row="1">
<Fields>
<Field element="subscriber_id">525108846</Field>
<Field element="remote_id" />
<Field element="subscriber_email"></Field>
<Field element="is_unsubscriber">0</Field>
<Field element="category_id">1759</Field>
<Field element="category_name">Extended test - school</Field>
<Field element="demographic_id">27977</Field>
<Field element="demographic_name">Ukraine</Field>
<Field element="category_extended_field_name">Primary</Field>
<Field element="category_extended_field_value">"Pervocvit"</Field>
</Fields>
</Record>
<Record row="2">
<Fields>
<Field element="subscriber_id">525108846</Field>
<Field element="remote_id" />
<Field element="subscriber_email"></Field>
<Field element="is_unsubscriber">0</Field>
<Field element="category_id">1759</Field>
<Field element="category_name">Extended test - school</Field>
<Field element="demographic_id">27977</Field>
<Field element="demographic_name">Ukraine</Field>
<Field element="category_extended_field_name">Secondary</Field>
<Field element="category_extended_field_value">#96</Field>
</Fields>
</Record>
<Record row="3">
<Fields>
<Field element="subscriber_id">525108846</Field>
<Field element="remote_id" />
<Field element="subscriber_email"></Field>
<Field element="is_unsubscriber">0</Field>
<Field element="category_id">1759</Field>
<Field element="category_name">Extended test - school</Field>
<Field element="demographic_id">27977</Field>
<Field element="demographic_name">Ukraine</Field>
<Field element="category_extended_field_name">National</Field>
<Field element="category_extended_field_value">LNU</Field>
</Fields>
</Record>
</Grid>
</Grids>
</GridResponse>