+49 69 83008980 service@xqueue.com
Benötigen Sie Hilfe?

Get Unique Opens

Sie sind hier:
< Alle Themen
Returns a page of unique opens or the number of unique opens, only.

GET https://api.maileon.com/1.0/reports/opens/unique
 
GET https://api.maileon.com/1.0/reports/opens/unique/count

Attributes

ParameterDefaultDescription
from_dateIf provided, only the opens after or equal (including) the given date will be returned. The value of from_date must be a numeric value representing a point in time milliseconds after January 1, 1970 00:00:00
to_dateIf provided, only the opens before (excluding) the given date will be returned. The value of to_date must be a numeric value representing a point in time milliseconds afterJanuary 1, 1970 00:00:00
mailing_idMultivalued parameter to filter the opens by mailings. Each value must correspond to a mailing id.
idsMultivalued parameter to filter the results by contacts. Each value must correspond to a contact id.
emailsMultivalued parameter to filter the results by email addresses.
eidsMultivalued parameter to filter the results by external ids. Each value must correspond to a contacts external id
formatFilters the opens by format. Possible values are: html / text.
social_networkMultivalued parameter to filter the opens by the social networks where they occurred.
device_typeMultivalued parameter to filter the opens by device type. Possible values for device_type are: UNKNOWN / COMPUTER / TABLET / MOBILE
embed_email_client_infosfalseIf the set to true, available email client details will be appended to each open.
exclude_anonymous_openstrueSupported values: true / false. If set to true, the blocks that cannot be mapped to contacts because of permission types or because unsubscriptions are omitted in the results
embed_transaction_idfalseIf the set to true, the attribut “transaction_id” of a transaction will be returned that caused this open, if available.
If this setting is set to true, it will add a ‘transaction_id’ element to the result.
standard_fieldMultivalued parameter to query the value of a standard contact field.
custom_fieldMultivalued parameter to query the value of a custom contact field.
page_index1The index of the result page. The index must be greater or equal to 1.
page_size100The maximum count of items in the result page. If provided, the value of page_size must be in the range 1 to 1000.

Example

GET https://api.maileon.com/1.0/reports/opens/unique?page_index=1&amp;page_size=500&amp;embed_email_client_infos=true&amp;exclude_anonymous_clicks=true&amp;standard_field=FIRSTNAME&amp;custom_field=COLOR
Authorization: Basic XXXXXXXXXXXXXXX
Status: 200 OK
Content-Type: application/vnd.maileon.api+xml
Link: ...
X-Pages: ...
X-Items: ...
 
<xml version="1.0" encoding="UTF-8">
<opens>
   <open>
    <contact>
      <id>12345</id>
      <email>max.mustermann@xqueue.com</email>
      <external_id nil="true"></external_id>
      <standard_fields>
       <field>
        <name>FIRSTNAME</name>
        <value>Max</value>
       </field>
      </standard_fields>
      <custom_fields>
       <field>
        <name>COLOR</name>
        <value>BLUE</value>
       </field>
      </custom_fields>
    </contact>
    <timestamp>2013-04-09 11:26:17</timestamp>
    <mailing_id>4012</mailing_id>
    <format>html</format>
    <device_type>COMPUTER</device_type>
    <client>
      <os_name>WINDOWS_7</os_name>
      <os_group>WINDOWS</os_group>
      <browser>FIREFOX</browser>
      <browser_group>FIREFOX</browser_group>
      <browser_type>WEB_BROWSER</browser_type>
      <user_agent nil="true"></user_agent>
      <rendering_engine>GECKO</rendering_engine>
    </client>
  </open>
...
</opens></xml>

 

Inhaltsverzeichnis

Bleiben Sie Up-to-Date und profitieren Sie von spannenden News und Aktionen.

Maileon ist ein Produkt der XQueue GmbH