API ISSUE!!! Found a bug in the Email Did not Open Report API endpoint

user6365
Rookie
0 Votes
This endpoint /reports/email_reports/{campaign_activity_id}/tracking/didnotopens (https://developer.constantcontact.com/api_guide/email_summary_non_opens_report.html) doesn't return the correct tracking_activity_type. It's supposed to return "em_didnotopens" according to the documentation but it returns "em_sends". This is a big issue for clients who leverage on the type of the report to take the right action. Let us know when this will be fixed. Thank you.
1 REPLY 1
Courtney_E
Employee
0 Votes

Hello user6365,

 

Thank you for reaching out to Constant Contact API Developer Support. My team is here to assist outside software developers with questions about building into Constant Contact's API.

 

Upon review, we've determined that 'em_sends' is actually the tracking_activity_type intended to be used by the "Did Not Opens Report" endpoint ( /reports/email_reports/{campaign_activity_id}/tracking/didnotopens ), and that the appearance of a non-existent 'em_didnotopens' activity type found on the following page is an issue with our documentation:

https://developer.constantcontact.com/api_guide/email_summary_non_opens_report.html

 

I apologize for any confusion this has caused, and appreciate your having brought it to our attention. We currently have a ticket open to have the API documentation updated to better reflect the functionality of this endpoint.

 

To explain the usage of the 'em_sends' type by the "Did Not Opens" report, not opening an email is less an activity itself, and more the lack of an activity. Essentially, this endpoint is returning the contacts that have an 'em_sends' activity, but no 'em_opens' or 'em_bounces' activity, for the campaign activity in question. This is somewhat obliquely referenced elsewhere in the documentation; in the description of the 'em_not_opened' stat, found in the "email campaign stats report":

 

"em_not_opened : Number of unique recipients who did not open the email. This is calculated as follows: em_not_opened is equal to em_sends - em_opens - em_bounces. This value is reported as zero if the calculation results in a negative value."

https://developer.constantcontact.com/api_guide/email_campaign_stats_report.html

 

Please have a look and let us know if you have any other questions!


Regards,

Courtney E.
Tier II API Support Engineer

Did I answer your question?
If so, please mark my post as an "Accepted Solution" by clicking the Accept as Solution button in the bottom right hand corner of this post.
Resources
Developer Portal

View API documentation, code samples, get your API key.

Visit Page

Announcements

API Updates

Join our list to be notified of new features and updates to our V3 API.

Sign Up