Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
curl --request GET \
--url https://api.tagdeliver.com/v2/report/health-check/{uid}/{id} \
--header 'Authorization: Bearer <token>'{
"results": {
"public": true,
"domain_info": {
"primary_category": [
"Automotive"
],
"secondary_category": null,
"domain": "example.com",
"description": "Just an example domain, for demo usage"
},
"score": {
"health_score": 44,
"health_score_date": "2025-08-31 00:00:00",
"previous_health_score": null,
"previous_health_score_date": null,
"comment": null
},
"ads_txt": {
"file_found": 1,
"last_updated": "2025-01-23 23:09:25",
"total_reseller": 265,
"total_direct": 35,
"total_issues": 20,
"total_account": 300,
"total_exchange": 67,
"total_file_lines": 342,
"unique_errors": {
"duplicate": 20
},
"comment": "Based on your ads.txt file data, your reseller relationship percentage is below the recommended 90%, indicating that a majority of your ads are being sold through resellers rather than directly. This can potentially lead to lower ad revenue as resellers typically take a portion of the ad revenue. Your file_issues are also above 0, which means there are some issues with your ads.txt file that need to be addressed. Additionally, your exchange_account_total is at the maximum recommended limit of 300, indicating that you have a large number of exchanges listed in your ads.txt file. This can make it difficult for advertisers to differentiate between legitimate and fraudulent exchanges, potentially leading to lower ad revenue. \n\nTo optimize your ads.txt file and potentially increase ad revenue, you may want to consider reviewing and reducing the number of resellers and exchanges listed, as well as addressing any issues with your ads.txt file. Prioritizing direct relationships with advertisers can also be beneficial. Regularly monitoring and updating your ads.txt file is also recommended to maintain its accuracy and effectiveness."
},
"cwv": {
"dates": [
"2025-01-03",
"2025-01-04",
"2025-01-05",
"2025-01-06",
"2025-01-07",
"2025-01-08",
"2025-01-09",
"2025-01-10",
"2025-01-11",
"2025-01-12",
"2025-01-13",
"2025-01-14",
"2025-01-15",
"2025-01-16",
"2025-01-17",
"2025-01-18",
"2025-01-19",
"2025-01-20",
"2025-01-21",
"2025-01-22",
"2025-01-23"
],
"cwv_lcp_50th": [
1447.850000143,
1599.750000008,
1488,
1525.199999988,
1503.299999997,
1424.75,
1405.799999952,
1378.499999978,
1451.700000003,
1613.349999994,
1351.550000009,
1440.200000003,
1322.299999994,
1328.25,
1321.199999988,
1409.799999952,
1566.100000009,
1623.55000037,
1599.049999988,
1276.5,
1423.399999857
],
"cwv_lcp_50th_average": 1452.3857142968095,
"cwv_inp_50th": [
144,
140.869565217,
138.636363637,
152.637681159,
146.666666667,
154.666666667,
148.48,
141.835920178,
140.553846154,
142.523965142,
155.692307692,
156.028368794,
150,
152,
148.631578947,
144,
147.384615385,
176,
174.769230769,
145.636363636,
150.222222222
],
"cwv_inp_50th_average": 150.0588267745714,
"cwv_fcp_50th": [
1061.549999953,
1192.450000048,
1080.200000018,
1091.100000002,
1095.85,
1023.800000012,
1015.099999994,
1007,
1086,
1150.950000018,
1007,
1090.899999976,
1000.099999994,
1021.5,
971.399999991,
1052.900000006,
1150.399999976,
1193,
1219.199999988,
995.599999994,
1095.800000012
],
"cwv_fcp_50th_average": 1076.2761904753334,
"cwv_cls_50th": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0.000021147,
0,
0,
0,
0,
0.000042603,
0
],
"cwv_cls_50th_average": 0.000031875,
"comment": "Based on your core web vital performance data, your cumulative layout shift is very low, which is considered good. This means that the visual stability of your website is high and users are less likely to experience unexpected layout changes, which can lead to a positive user experience and potentially impact ad revenue positively.\n\nYour largest contentful paint is 1452ms, which is below the recommended threshold of 2500ms. This indicates that the main content of your website is loading relatively quickly, which can also contribute to a good user experience and potentially increase ad revenue.\n\nYour interaction to next paint is 150ms, which is also below the recommended threshold of 200ms. This means that users are able to interact with your website and navigate to the next page quickly, which can also contribute to a positive user experience and potentially increase ad revenue.\n\nLastly, your first contentful paint is 1076ms, which is below the recommended threshold of 1800ms. This means that your website is loading relatively quickly and users are able to see the content of your website in a timely manner, which can also contribute to a good user experience and potentially increase ad revenue.\n\nIn summary, your web vital performance data shows that your website has good visual stability, fast loading times, and quick"
},
"implementation": {
"direct_tag": 0,
"cmp_error_rate": 0,
"mobile_ad_density": 5,
"tag_latency": 3440,
"comment": "Based on the data, it appears that the ad implementation on your website is not optimal. The user consent error rate is currently at 0%, which is good. However, the ad tag delay due to page latency is 3440ms, which is above the recommended threshold of 4000ms. This delay may result in a poor user experience and could potentially lead to lower ad revenue. Additionally, the ad density on mobile is only 5%, which is well below the recommended threshold of 30%. This indicates that there may be room to increase the number of ads on the mobile version of your website to potentially increase revenue. Lastly, the content ignite tag is not directly on the page, which is not ideal. This could potentially affect the effectiveness of the ads and may need to be addressed. Overall, it is important to regularly monitor and optimize the ad implementation on your website to ensure maximum ad revenue. This may include minimizing page latency, increasing ad density on mobile, and ensuring that all ad tags are directly on the page."
},
"risk": {
"invalid_traffic": "medium",
"click_fraud": "low",
"viewability": "medium",
"domain_masking": "low",
"traffic_sources": "Direct",
"brand_safety": {
"adult_content": "low",
"alcohol_content": "low",
"drug_content": "low",
"hate_speech": "low",
"phishing": "low",
"malware": "low"
},
"social_media_traffic": 2.46,
"private": false,
"comment": "This data suggests that the site has a medium level of invalid traffic and viewability, but a low level of click fraud and domain masking. The majority of traffic comes from direct sources and the site has a low risk for displaying adult, alcohol, drug, hate speech, phishing, and malware content. The site is also registered publicly. To maximize ad revenue, it is important to continue monitoring and reducing invalid traffic and improving viewability. Additionally, it may be beneficial to advertise the low risk of brand safety to potential advertisers."
},
"ethical_media": {
"emi_score": 41,
"advertising": {
"score": 68,
"invalid_traffic": 95,
"adselection_display": 79,
"viewability": 1
},
"content": {
"score": 24,
"iab_category": 50,
"media_quality": 50,
"sdg_count": 0
},
"corporate": {
"score": 47,
"esg_environment": 50,
"esg_community": 50,
"esg_compensation": 50,
"esg_diversity": 50,
"esg_governance": 50,
"domain_rep": 99.33,
"green_energy": 0,
"mediadistribution": 50.25
},
"comment": "Your overall EMI score is below 50, which means there is room for improvement in your sustainability efforts. Your advertising category score is above 70, which is good, but you may want to consider implementing even more sustainable advertising practices. Your content category score is below 50, indicating a need for more ethical and sustainable content. Lastly, your corporate category score is above 67, but you may want to focus on improving sustainability within your company to further boost this score. Possible actions you could take include implementing sustainable advertising strategies, incorporating ethical and sustainable messaging into your content, and implementing sustainable practices within your company operations."
},
"header_bidding": {
"aps": false,
"pbjs": {
"timeout": 2000,
"version": "9.25.0",
"versions_behind": 3,
"bidders": 9
},
"comment": "The failure to integrate Amazon's TAM for header bidding could significantly decrease ad revenue for publishers, and they should consider implementing this integration to maximize their potential earnings.\n\n This data suggests that your prebid setup may be behind by more than 12 versions, which could negatively impact your ad revenue. It is also recommended that your prebid timeout falls between 1000ms and 2500ms, as this can lead to better results. Additionally, having between 6 and 12 prebid SSPs is ideal. If your data matches this, no immediate action is needed. However, if your prebid setup is significantly behind or your timeout is not within the recommended range, it may be beneficial to update and optimize your prebid settings to potentially increase ad revenue."
},
"benchmarking": {
"health_score": {
"cohort": 65,
"network": 68.5
},
"cls": {
"cohort": 0,
"network": 0
},
"fcp": {
"cohort": 1899.142857142857,
"network": 0
},
"lcp": {
"cohort": 2512.0476190476193,
"network": 0
},
"inp": {
"cohort": 195.33333333333334,
"network": 0
},
"cpm_issues": {
"cohort": 6.78,
"network": 0
},
"mobile_ad_density": {
"cohort": 2,
"network": 9.25
},
"tag_latency": {
"cohort": 2510,
"network": 0
},
"emi_score": {
"cohort": 43.85,
"network": 47.65
},
"corporate_systems_score": {
"cohort": 46.5,
"network": 57.1
},
"advertising_science_score": {
"cohort": 80.91,
"network": 74.33
},
"content_ethics_score": {
"cohort": 23.94,
"network": 32.36
},
"prebid_versions_behind": {
"network": 28
},
"prebid_bidders": {
"network": 15
},
"prebid_timeout": {
"network": 3000
},
"sustainability": {
"cohort": 0.06,
"network": 0.51
}
},
"sustainability": {
"is_green": false,
"cleaner_than": 0.35,
"bytes": 2826617,
"energy": 0.0016099006182979793,
"co2_grams": 0.7115760732877069,
"co2_litres": 0.3957786119626225,
"engagement": {
"visits": 2691540,
"month": 12,
"year": 2024
},
"comment": "This data indicates that the sustainability cleanliness of your website is below 40%, which is not desirable. Additionally, the amount of carbon emissions per visit to your website is 0.62g, which is also not ideal. However, it is positive that you are using green energy.\n\nThese metrics could potentially affect your ad revenue, as advertisers are increasingly focused on working with environmentally-friendly publishers. To improve your sustainability and reduce carbon emissions, you could consider implementing eco-friendly practices such as using renewable energy sources, optimizing your website for efficiency, and reducing unnecessary energy usage. This could help attract more environmentally-conscious advertisers and potentially increase ad revenue."
},
"section_map": {
"plan": false
},
"actions": "- Review and potentially reduce the number of resellers and exchanges listed in your ads.txt file\n- Address any issues with your ads.txt file\n- Prioritize direct relationships with advertisers\n- Regularly monitor and update your ads.txt file\n- Consider reviewing and optimizing your prebid setup, aiming for 6-12 SSPs and a prebid timeout between 1000ms and 2500ms\n- Monitor and reduce invalid traffic to improve viewability and attract more advertisers\n- Increase ad density on mobile from 5% to the recommended threshold of 30%\n- Ensure all ad tags are directly on the page for maximum effectiveness\n- Implement sustainable advertising strategies, messaging, and operations to improve sustainability scores and attract environmentally-conscious advertisers\n- Potentially integrate Amazon's TAM for header bidding to maximize ad revenue\n- Implement eco-friendly practices such as using renewable energy and optimizing website efficiency to reduce carbon emissions and attract more advertisers.",
"plan": {
"crawl": {
"health_score": 44,
"actions": "- Review and potentially reduce the number of resellers and exchanges listed in your ads.txt file\n- Address any issues with your ads.txt file\n- Prioritize direct relationships with advertisers\n- Regularly monitor and update your ads.txt file\n- Consider reviewing and optimizing your prebid setup, aiming for 6-12 SSPs and a prebid timeout between 1000ms and 2500ms\n- Monitor and reduce invalid traffic to improve viewability and attract more advertisers\n- Increase ad density on mobile from 5% to the recommended threshold of 30%\n- Ensure all ad tags are directly on the page for maximum effectiveness\n- Implement sustainable advertising strategies, messaging, and operations to improve sustainability scores and attract environmentally-conscious advertisers\n- Potentially integrate Amazon's TAM for header bidding to maximize ad revenue\n- Implement eco-friendly practices such as using renewable energy and optimizing website efficiency to reduce carbon emissions and attract more advertisers."
},
"walk": {
"health_score": 46,
"actions": ""
},
"run": {
"health_score": 48,
"actions": ""
}
}
},
"success": true
}Returns a single health check report
curl --request GET \
--url https://api.tagdeliver.com/v2/report/health-check/{uid}/{id} \
--header 'Authorization: Bearer <token>'{
"results": {
"public": true,
"domain_info": {
"primary_category": [
"Automotive"
],
"secondary_category": null,
"domain": "example.com",
"description": "Just an example domain, for demo usage"
},
"score": {
"health_score": 44,
"health_score_date": "2025-08-31 00:00:00",
"previous_health_score": null,
"previous_health_score_date": null,
"comment": null
},
"ads_txt": {
"file_found": 1,
"last_updated": "2025-01-23 23:09:25",
"total_reseller": 265,
"total_direct": 35,
"total_issues": 20,
"total_account": 300,
"total_exchange": 67,
"total_file_lines": 342,
"unique_errors": {
"duplicate": 20
},
"comment": "Based on your ads.txt file data, your reseller relationship percentage is below the recommended 90%, indicating that a majority of your ads are being sold through resellers rather than directly. This can potentially lead to lower ad revenue as resellers typically take a portion of the ad revenue. Your file_issues are also above 0, which means there are some issues with your ads.txt file that need to be addressed. Additionally, your exchange_account_total is at the maximum recommended limit of 300, indicating that you have a large number of exchanges listed in your ads.txt file. This can make it difficult for advertisers to differentiate between legitimate and fraudulent exchanges, potentially leading to lower ad revenue. \n\nTo optimize your ads.txt file and potentially increase ad revenue, you may want to consider reviewing and reducing the number of resellers and exchanges listed, as well as addressing any issues with your ads.txt file. Prioritizing direct relationships with advertisers can also be beneficial. Regularly monitoring and updating your ads.txt file is also recommended to maintain its accuracy and effectiveness."
},
"cwv": {
"dates": [
"2025-01-03",
"2025-01-04",
"2025-01-05",
"2025-01-06",
"2025-01-07",
"2025-01-08",
"2025-01-09",
"2025-01-10",
"2025-01-11",
"2025-01-12",
"2025-01-13",
"2025-01-14",
"2025-01-15",
"2025-01-16",
"2025-01-17",
"2025-01-18",
"2025-01-19",
"2025-01-20",
"2025-01-21",
"2025-01-22",
"2025-01-23"
],
"cwv_lcp_50th": [
1447.850000143,
1599.750000008,
1488,
1525.199999988,
1503.299999997,
1424.75,
1405.799999952,
1378.499999978,
1451.700000003,
1613.349999994,
1351.550000009,
1440.200000003,
1322.299999994,
1328.25,
1321.199999988,
1409.799999952,
1566.100000009,
1623.55000037,
1599.049999988,
1276.5,
1423.399999857
],
"cwv_lcp_50th_average": 1452.3857142968095,
"cwv_inp_50th": [
144,
140.869565217,
138.636363637,
152.637681159,
146.666666667,
154.666666667,
148.48,
141.835920178,
140.553846154,
142.523965142,
155.692307692,
156.028368794,
150,
152,
148.631578947,
144,
147.384615385,
176,
174.769230769,
145.636363636,
150.222222222
],
"cwv_inp_50th_average": 150.0588267745714,
"cwv_fcp_50th": [
1061.549999953,
1192.450000048,
1080.200000018,
1091.100000002,
1095.85,
1023.800000012,
1015.099999994,
1007,
1086,
1150.950000018,
1007,
1090.899999976,
1000.099999994,
1021.5,
971.399999991,
1052.900000006,
1150.399999976,
1193,
1219.199999988,
995.599999994,
1095.800000012
],
"cwv_fcp_50th_average": 1076.2761904753334,
"cwv_cls_50th": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0.000021147,
0,
0,
0,
0,
0.000042603,
0
],
"cwv_cls_50th_average": 0.000031875,
"comment": "Based on your core web vital performance data, your cumulative layout shift is very low, which is considered good. This means that the visual stability of your website is high and users are less likely to experience unexpected layout changes, which can lead to a positive user experience and potentially impact ad revenue positively.\n\nYour largest contentful paint is 1452ms, which is below the recommended threshold of 2500ms. This indicates that the main content of your website is loading relatively quickly, which can also contribute to a good user experience and potentially increase ad revenue.\n\nYour interaction to next paint is 150ms, which is also below the recommended threshold of 200ms. This means that users are able to interact with your website and navigate to the next page quickly, which can also contribute to a positive user experience and potentially increase ad revenue.\n\nLastly, your first contentful paint is 1076ms, which is below the recommended threshold of 1800ms. This means that your website is loading relatively quickly and users are able to see the content of your website in a timely manner, which can also contribute to a good user experience and potentially increase ad revenue.\n\nIn summary, your web vital performance data shows that your website has good visual stability, fast loading times, and quick"
},
"implementation": {
"direct_tag": 0,
"cmp_error_rate": 0,
"mobile_ad_density": 5,
"tag_latency": 3440,
"comment": "Based on the data, it appears that the ad implementation on your website is not optimal. The user consent error rate is currently at 0%, which is good. However, the ad tag delay due to page latency is 3440ms, which is above the recommended threshold of 4000ms. This delay may result in a poor user experience and could potentially lead to lower ad revenue. Additionally, the ad density on mobile is only 5%, which is well below the recommended threshold of 30%. This indicates that there may be room to increase the number of ads on the mobile version of your website to potentially increase revenue. Lastly, the content ignite tag is not directly on the page, which is not ideal. This could potentially affect the effectiveness of the ads and may need to be addressed. Overall, it is important to regularly monitor and optimize the ad implementation on your website to ensure maximum ad revenue. This may include minimizing page latency, increasing ad density on mobile, and ensuring that all ad tags are directly on the page."
},
"risk": {
"invalid_traffic": "medium",
"click_fraud": "low",
"viewability": "medium",
"domain_masking": "low",
"traffic_sources": "Direct",
"brand_safety": {
"adult_content": "low",
"alcohol_content": "low",
"drug_content": "low",
"hate_speech": "low",
"phishing": "low",
"malware": "low"
},
"social_media_traffic": 2.46,
"private": false,
"comment": "This data suggests that the site has a medium level of invalid traffic and viewability, but a low level of click fraud and domain masking. The majority of traffic comes from direct sources and the site has a low risk for displaying adult, alcohol, drug, hate speech, phishing, and malware content. The site is also registered publicly. To maximize ad revenue, it is important to continue monitoring and reducing invalid traffic and improving viewability. Additionally, it may be beneficial to advertise the low risk of brand safety to potential advertisers."
},
"ethical_media": {
"emi_score": 41,
"advertising": {
"score": 68,
"invalid_traffic": 95,
"adselection_display": 79,
"viewability": 1
},
"content": {
"score": 24,
"iab_category": 50,
"media_quality": 50,
"sdg_count": 0
},
"corporate": {
"score": 47,
"esg_environment": 50,
"esg_community": 50,
"esg_compensation": 50,
"esg_diversity": 50,
"esg_governance": 50,
"domain_rep": 99.33,
"green_energy": 0,
"mediadistribution": 50.25
},
"comment": "Your overall EMI score is below 50, which means there is room for improvement in your sustainability efforts. Your advertising category score is above 70, which is good, but you may want to consider implementing even more sustainable advertising practices. Your content category score is below 50, indicating a need for more ethical and sustainable content. Lastly, your corporate category score is above 67, but you may want to focus on improving sustainability within your company to further boost this score. Possible actions you could take include implementing sustainable advertising strategies, incorporating ethical and sustainable messaging into your content, and implementing sustainable practices within your company operations."
},
"header_bidding": {
"aps": false,
"pbjs": {
"timeout": 2000,
"version": "9.25.0",
"versions_behind": 3,
"bidders": 9
},
"comment": "The failure to integrate Amazon's TAM for header bidding could significantly decrease ad revenue for publishers, and they should consider implementing this integration to maximize their potential earnings.\n\n This data suggests that your prebid setup may be behind by more than 12 versions, which could negatively impact your ad revenue. It is also recommended that your prebid timeout falls between 1000ms and 2500ms, as this can lead to better results. Additionally, having between 6 and 12 prebid SSPs is ideal. If your data matches this, no immediate action is needed. However, if your prebid setup is significantly behind or your timeout is not within the recommended range, it may be beneficial to update and optimize your prebid settings to potentially increase ad revenue."
},
"benchmarking": {
"health_score": {
"cohort": 65,
"network": 68.5
},
"cls": {
"cohort": 0,
"network": 0
},
"fcp": {
"cohort": 1899.142857142857,
"network": 0
},
"lcp": {
"cohort": 2512.0476190476193,
"network": 0
},
"inp": {
"cohort": 195.33333333333334,
"network": 0
},
"cpm_issues": {
"cohort": 6.78,
"network": 0
},
"mobile_ad_density": {
"cohort": 2,
"network": 9.25
},
"tag_latency": {
"cohort": 2510,
"network": 0
},
"emi_score": {
"cohort": 43.85,
"network": 47.65
},
"corporate_systems_score": {
"cohort": 46.5,
"network": 57.1
},
"advertising_science_score": {
"cohort": 80.91,
"network": 74.33
},
"content_ethics_score": {
"cohort": 23.94,
"network": 32.36
},
"prebid_versions_behind": {
"network": 28
},
"prebid_bidders": {
"network": 15
},
"prebid_timeout": {
"network": 3000
},
"sustainability": {
"cohort": 0.06,
"network": 0.51
}
},
"sustainability": {
"is_green": false,
"cleaner_than": 0.35,
"bytes": 2826617,
"energy": 0.0016099006182979793,
"co2_grams": 0.7115760732877069,
"co2_litres": 0.3957786119626225,
"engagement": {
"visits": 2691540,
"month": 12,
"year": 2024
},
"comment": "This data indicates that the sustainability cleanliness of your website is below 40%, which is not desirable. Additionally, the amount of carbon emissions per visit to your website is 0.62g, which is also not ideal. However, it is positive that you are using green energy.\n\nThese metrics could potentially affect your ad revenue, as advertisers are increasingly focused on working with environmentally-friendly publishers. To improve your sustainability and reduce carbon emissions, you could consider implementing eco-friendly practices such as using renewable energy sources, optimizing your website for efficiency, and reducing unnecessary energy usage. This could help attract more environmentally-conscious advertisers and potentially increase ad revenue."
},
"section_map": {
"plan": false
},
"actions": "- Review and potentially reduce the number of resellers and exchanges listed in your ads.txt file\n- Address any issues with your ads.txt file\n- Prioritize direct relationships with advertisers\n- Regularly monitor and update your ads.txt file\n- Consider reviewing and optimizing your prebid setup, aiming for 6-12 SSPs and a prebid timeout between 1000ms and 2500ms\n- Monitor and reduce invalid traffic to improve viewability and attract more advertisers\n- Increase ad density on mobile from 5% to the recommended threshold of 30%\n- Ensure all ad tags are directly on the page for maximum effectiveness\n- Implement sustainable advertising strategies, messaging, and operations to improve sustainability scores and attract environmentally-conscious advertisers\n- Potentially integrate Amazon's TAM for header bidding to maximize ad revenue\n- Implement eco-friendly practices such as using renewable energy and optimizing website efficiency to reduce carbon emissions and attract more advertisers.",
"plan": {
"crawl": {
"health_score": 44,
"actions": "- Review and potentially reduce the number of resellers and exchanges listed in your ads.txt file\n- Address any issues with your ads.txt file\n- Prioritize direct relationships with advertisers\n- Regularly monitor and update your ads.txt file\n- Consider reviewing and optimizing your prebid setup, aiming for 6-12 SSPs and a prebid timeout between 1000ms and 2500ms\n- Monitor and reduce invalid traffic to improve viewability and attract more advertisers\n- Increase ad density on mobile from 5% to the recommended threshold of 30%\n- Ensure all ad tags are directly on the page for maximum effectiveness\n- Implement sustainable advertising strategies, messaging, and operations to improve sustainability scores and attract environmentally-conscious advertisers\n- Potentially integrate Amazon's TAM for header bidding to maximize ad revenue\n- Implement eco-friendly practices such as using renewable energy and optimizing website efficiency to reduce carbon emissions and attract more advertisers."
},
"walk": {
"health_score": 46,
"actions": ""
},
"run": {
"health_score": 48,
"actions": ""
}
}
},
"success": true
}Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Was this page helpful?