improved

June 30th, 2022

Added a new field validation_status to CreateTrackingLink, UpdateTrackingLink API Response

We added a new field validation_status on success response of Create/Update TrackingLink API to provide a brief summary of the given TrackingLink's validation result.

It would be filled with one of the following values:
TRACKING_LINK_VALIDATION_STATUS_SUCCESS: The link has no warning case.
TRACKING_LINK_VALIDATION_STATUS_WARNING: The link contains query parameters in not recommended format. In that case, you can get more detailed information using Validate a TrackingLink..

Sample request & response

// CreateTrackingLink Request Body
{
  "title": "Test Tracking Link",
  "device_os": "ANDROID",
  "click_through_link": {
     "url": "https://app.appsflyer.com/testapp.com?advertising_id=%{a_idfa}&af_sub4=%{source}&clickid=%{campaign}&pid=moloco_int"
  },
  "tracking_company": "APPSFLYER"
}

// CreateTrackingLink Response Body
{
    "tracking_link": {
        "id": "dfeAziUDiMbkENmT",
        "ad_account_id": "Qe6lkft4MgABc6wd",
        "product_id": "BAPXC7fzh8cHcYu4",
        "title": "Test Tracking Link",
        "device_os": "ANDROID",
        "click_through_link": {
            "url": "https://app.appsflyer.com/testapp.com?advertising_id=%{a_idfa}&af_sub4=%{source}&clickid=%{campaign}&pid=moloco_int",
            "status": "UNVERIFIED",
            "unverified_status_data": {
                "stored_at": "2022-06-29T04:56:15Z"
            }
        },
        "tracking_company": "APPSFLYER",
        "created_at": "2022-06-29T04:56:15.593730Z",
        "updated_at": "2022-06-29T04:56:15.593730Z"
    },
    "validation_status": "TRACKING_LINK_VALIDATION_STATUS_WARNING"
}

To learn more about the valid TrackingLink, please refer to the guide document.