Invalid Click Report
The endpoints documented in this section allows you to pull invalid click data from the API. Each row will be representative of a click and the data isn’t aggregated.
Important: While the clicks analytics are kept forever, the raw data used to create the response on these endpoints is only kept for a period of 3 months on the Everflow servers. Requests for time intervals that go beyond that period will not return clicks. Raw data for clicks that lead to conversions, however, is kept forever.
Invalid Click Report
The maximum number of clicks that can be returned by this endpoint is : 1 000. If there are more than 1 000 clicks that match the request, they will not be returned.
This endpoint should not be used to extract every click from the platform. Requests to extracts large lists of invalid clicks can be made by reaching out to our support team.
/v1/networks/reporting/invalidclicks
Each request must contain :
fromandtodates inYYYY-mm-DD HH:MM:SSformattimezone_idused for the request. Find all timezones here
Optional query filters can be added to the call
Query Filters
Query filters allow you to limit the scope of the report returned by the API. You could create a filter to limit the reporting data to a single partner for example. You can use multiple filters in a request.
Filters that apply to the same resource_type will act as OR operator. Different resource_type work with an AND operator. The following filters :
{
//...
"query": {
"filters": [
{
"filter_id_value": "883",
"resource_type": "offer"
},
{
"filter_id_value": "518",
"resource_type": "offer"
},
{
"filter_id_value": "9",
"resource_type": "error_code"
}
]
}
}
translate to “Pull invalid clicks with error code 9 (Invalid country) on offer 883 OR offer 518”.
Filter Resource Types
The resource-type used in the filters and exclusions can take the following values :
offer, affilate_id, advertiser, creative, offer_group, campaign, transction_id, error_code
Error codes and their reason for failing can be found here
Request Example
cURL
curl --request POST \
--url https://api.eflow.team/v1/networks/reporting/invalidclicks \
--header 'content-type: application/json' \
--header 'X-Eflow-API-Key: <INSERT API KEY>' \
--data '<INSERT PAYLOAD>'
Example 1 : Invalid clicks for all partners on 2 offers
{
"from": "2024-11-31 12:30:00",
"to": "2024-11-31 13:00:00",
"timezone_id": 80,
"query":
{
"filters":
[
{
"filter_id_value": "1522",
"resource_type": "offer"
},
{
"filter_id_value": "1523",
"resource_type": "offer"
}
]
}
}
Example 2 : Invalid clicks that fail because the offer isn’t active being sent to the advertiser
{
"from": "2024-11-31 12:30:00",
"to": "2024-11-31 13:00:00",
"timezone_id": 80,
"query":
{
"filters":
[
{
"filter_id_value": "1008",
"resource_type": "error_code"
},
{
"filter_id_value": "10",
"resource_type": "advertiser"
}
]
}
}
Response
{
"transaction_id": "9a1f0ce2b0254752827f605467f543c2",
"is_unique": 1,
"unix_timestamp": 1731113091,
"tracking_url": "www.example-domain.com",
"source_id": "",
"sub1": "",
"sub2": "",
"sub3": "",
"sub4": "",
"sub5": "",
"payout_type": "",
"revenue_type": "",
"payout": 0,
"revenue": 0,
"referer": "",
"previous_network_offer_id": 0,
"error_code": 1018,
"project_id": "0069Y0000041PAnQAM",
"user_ip": "39.23.207.68",
"error_message": "Anura fraud check categorized click as fraud",
"url": "",
"is_view_through": false,
"is_async": false,
"server_side_url": "",
"server_side_output": "",
"custom_landing_page_id": 0,
"is_test_mode": false,
"idfa": "",
"idfa_md5": "",
"idfa_sha1": "",
"google_ad_id": "",
"google_ad_id_md5": "",
"google_ad_id_sha1": "",
"android_id": "",
"android_id_md5": "",
"android_id_sha1": "",
"error_filter_id": "",
"has_conversion": false,
"is_pass_through": false,
"creative_id": 0,
"relationship": {
"offer": {
"network_offer_id": 34,
"network_id": 1,
"network_advertiser_id": 64,
"network_offer_group_id": 0,
"name": "Test Offer",
"offer_status": "active",
"network_tracking_domain_id": 8,
"visibility": "private",
"currency_id": "USD"
},
"advertiser": {
"network_advertiser_id": 64,
"network_id": 1,
"name": "Example Advertiser",
"account_status": "active"
},
"account_manager": {
"network_employee_id": 5,
"network_id": 1,
"first_name": "Jane",
"last_name": "Doe",
"full_name": "Jane Doe",
"account_status": "inactive"
},
"affiliate": {
"network_affiliate_id": 1,
"network_id": 1,
"name": "Example Affiliate",
"account_status": "active",
"network_traffic_source_id": 5
},
"affiliate_manager": {
"network_employee_id": 10,
"network_id": 5,
"first_name": "Bob",
"last_name": "Smith",
"full_name": "Bob Smith",
"account_status": "active"
},
"geolocation": {
"country_code": "US",
"country_name": "United States",
"region_code": "",
"region_name": "District of Columbia",
"city_name": "Washington",
"dma": 0,
"dma_name": "",
"timezone": "America/New_York",
"carrier_name": "",
"carrier_code": 0,
"organization": "",
"isp_name": "Google Cloud",
"is_mobile": false,
"is_proxy": true,
"postal_code": "20011"
},
"device_information": {
"is_mobile": false,
"platform_name": "Unknown",
"os_version": "",
"brand": "Unknown",
"model": "",
"is_tablet": false,
"browser_name": "",
"browser_version": "",
"device_type": "PC",
"language": "",
"http_accept_language": "",
"is_robot": false,
"is_filter": false
},
"http_user_agent": "GoogleStackdriverMonitoring-UptimeChecks(https://cloud.google.com/monitoring)",
"query_parameters": {},
"forensiq_score": "0"
},
"coupon_code": "",
"redirect_method": "standard",
"is_sdk_click": false,
"category_id": 17,
"currency_id": "USD"
}