Get a Unique Contact Adds Landing Page Report
To get details about how many unique contacts were added to an account from a landing page, make a GET call to the reports/landing_pages/campaign_details/{campaign_activity_id}/p_unique_contact_adds endpoint and include the campaign_activity_id to identify which landing page campaign activity to use.
The response returns details about each contact (identified by contact_id), with the most recent activity listed first. For example:
{
"tracking_activities": [
{
"contact_id": "fgac8eda-9735-11e9-9d5c-fa163e277e19",
"campaign_activity_id": "62e09568-139e-4cbd-95ae-4d7cafc9b474",
"tracking_activity_type": "p_contact_adds",
"email_address": "f1_csm2355@nullmailer.com",
"first_name": "Joe",
"last_name": "Fawcett",
"device_type": "computer",
"created_time": "2023-06-25T21:53:00.000Z"
},
{
"contact_id": "dfac8eda-9735-11e9-9d5c-fa163e277e19",
"campaign_activity_id": "62e09568-139e-4cbd-95ae-4d7cafc9b474",
"tracking_activity_type": "p_contact_adds",
"email_address": "c2_csm2355@nullmailer.com",
"first_name": "Josie",
"last_name": "Langevin",
"device_type": "computer",
"created_time": "2023-06-25T21:53:00.000Z"
}
]
}Parameters
-
campaign_activity_id- Identifies which landing page campaign activity to use. Required. -
contacts_filter- Filters which contacts details to return, specify the contacts full or partial first or last name, or email. For example:JosieorJo. Optional. -
limit- Limits the number of tracking activities to return on each page. Valid values are1through500and the default value is500. Optional.
Example GET Request
The code examples that follow include both the limit and contacts_filter optional query parameters.
https://api.cc.email/v3/reports/landing_pages/campaign_details/{campaign_activity_id}/p_unique_contact_adds?limit=2&contacts_filter=joeEndpoint Requirements
User privileges: ui:campaign:metricsAuthorization scopes: campaign_dataOkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
.url("https://api.cc.email/v3/reports/contact_reports/landing_pages/campaign_details/{campaign_activity_id}/p_unique_contact_adds?limit=2&contacts_filter=joe'")
.method("GET", body)
.addHeader("Content-Type", "application/json")
.addHeader("Accept", "*/*")
.addHeader("Authorization", "Bearer {access_token}")
.build();Example Response
{
"tracking_activities": [
{
"contact_id": "fgac8eda-9735-11e9-9d5c-fa163e277e19",
"campaign_activity_id": "62e09568-139e-4cbd-95ae-4d7cafc9b474",
"tracking_activity_type": "p_contact_add",
"email_address": "f1_csm2355@nullmailer.com",
"first_name": "Joe",
"last_name": "Fawcett",
"device_type": "computer",
"created_time": "2023-06-25T21:53:00.000Z"
},
{
"contact_id": "dfac8eda-9735-11e9-9d5c-fa163e277e19",
"campaign_activity_id": "62e09568-139e-4cbd-95ae-4d7cafc9b474",
"tracking_activity_type": "p_contact_add",
"email_address": "c2_csm2355@nullmailer.com",
"first_name": "Josie",
"last_name": "Langevin",
"device_type": "computer",
"created_time": "2023-06-25T21:53:00.000Z"
}
]
}