Get details about contacts in your account that were updated from a landing page.

To get details about how many unique contacts were updated on an account from a landing page, make a GET call to the reports/landing_pages/campaign_details/{campaign_activity_id}/p_unique_contact_updates endpoint and include the campaign_activity_id to identify which landing page campaign activity to use.

The response returns contact details for unique contact updates (identified by contact_id). The resulting contact data is listed with most recent activity first.

The following example shows contact details returned in the response for unique contact update tracking activities.

{
    "tracking_activities": [
        {
            "contact_id": "fgac8eda-9735-11e9-9d5c-fa163e277e19",
            "campaign_activity_id": "62e09568-139e-4cbd-95ae-4d7cafc9b474",
            "tracking_activity_type": "p_contact_updates",
            "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_updates",
            "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: Josie or Jo. Optional.

  • limit - Limits the number of tracking activities to return on each page. Valid values are 1 through 500 and the default value is 500. Optional.

Example GET Request

The code examples that follow include both the limit and contacts_filter optional query parameters.

GET https://api.cc.email/v3/reports/landing_pages/campaign_details/{campaign_activity_id}/p_unique_contact_updates?limit=2&contacts_filter=joe

Endpoint Requirements

User privileges: ui:campaign:metrics

Authorization scopes: campaign_data

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.cc.email/v3/reports/contact_reports/landing_pages/campaign_details/{campaign_activity_id}/p_unique_contact_updates?limit=2&contacts_filter=joe',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'Accept: */*',
'Authorization: Bearer {access_token}'
),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

curl --location 
  'https://api.cc.email/v3/reports/contact_reports/landing_pages/campaign_details/{campaign_activity_id}/p_unique_contact_updates?limit=2&contacts_filter=joe' \
--header 'Content-Type: application/json' \
--header 'Accept: */*' \
--header 'Authorization: Bearer {access_token}'
OkHttpClient 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_updates?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_update",
            "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_update",
            "email_address": "c2_csm2355@nullmailer.com",
            "first_name": "Josie",
            "last_name": "Langevin",
            "device_type": "computer",
            "created_time": "2023-06-25T21:53:00.000Z"
        }
    ]
}

Try it!