Integral Ad Science API Connector

• Channel: Ad Verification
• Data Stream Type: Ads Verification
• Data Lagging: 1 day

Prerequisites

To connect to IAS, you need a valid IAS username and password.

Details

• Data is retrieved on the Campaign, Media Partner, and Placement level for all media types.
• The Basic IAS measurements are automatically mapped, however many measurements are unmapped as well.

General Setup

After entering your credentials, select the relevant Team you want to retrieve data for. This correlates to the teams in the IAS platform

Extended Properties

• Report Type - Select the IAS report you want to retrieve data for. You must have permission to generate the report in the Excel Reports section in IAS for it to be available to you in Marketing Cloud Intelligence Data Pipelines.
  • The following reports are supported for Campaign Monitoring:
    • 3MS Viewability - MRC mandated data set that uses measured impressions as the denominator, providing clients with a tangible in-view number.
    • Campaign Viewability - Report that shows the data behind the ability for a digital ad to be seen by an actual consumer. Extrapolated report that uses data science to provide clients and with an in-view percentage across all unblocked impressions. This report includes custom metrics to help provide additional detail.
    • Adsafe Monitoring - Brand Safety level reporting that reports back on Risk Level analysis of a campaign and its ads.
    • Country Compliance - Ads Tracked by Country Location in which they were served.
    • DMA Compliance - Ads Tracked by Sub Region in the Country’s in which they were served. (Sub Regions vary by Country. (that is, USA’s Sub Regions are States)).
    • Device Type - Ads Tracked by device on which they were served (that is, Laptop/Desktop, Mobile, Tablet).
    • Traq Score - TRAQ (True Advertising Quality) score. TRAQ combines critical variables - Ad Fraud, Viewability, Brand Safety, Ad Clutter, and Professionalism - to offer the most comprehensive appraisal of media quality. You can target web pages based on scores ranging between 250 and 1,000, with higher scores meaning higher quality.
    • Suspicious Activity - Suspicious Activity Report is an aggregated report that provides data on suspicious imps, non-suspicious, their percentages, and the different types of bot impressions seen per campaign for a given time period.
    • Facebook Display Viewability - Detailed analysis for advertisers who want to see Facebook campaign performance in terms of Display Viewability.
    • Facebook Video Viewability - Detailed analysis for advertisers who want to see Facebook campaign performance in terms of Video Viewability.
    • Overview - A summary view of metrics from various detailed reports. Overview Report doesn’t report on any new metrics, all metrics are from Fraud Report, Brand Safety Report, or Viewability Report.
    • Viewability - IAB and MRC reporting that shows a detailed analysis of data with the removal of fraudulent data from ads that weren’t shown to a human due to bot activity, pixel stuffing, could never be in view, etc.
    • Brand Safety - Reporting that provides a detailed analysis of ads categorized by the 7 Brand Safety Content categories.
    • Ad Fraud - Reporting that provides a detailed analysis of any deliberate activity that prevents the proper delivery of ads to the intended people, at the right time, and in the right place.
  • The following reports are supported for Firewall:
    • Facebook Display Viewability
    • Facebook Video Viewability
    • Overview
    • Viewability
    • Brand Safety
    • Ad Fraud
• IAS Product - Select the IAS product you want to retrieve data for. The following products are supported:
  • Campaign Management
  • Firewall Note that if the selected product doesn’t correspond to the team's settings, the Data Stream processing will either fail or retrieve zero rows, depending on your user permissions.

Known Issues

• The IAS vendor operates in US hours. US hours may not be compatible with your time zone processing hour, which can lead to incomplete data for the previous day. The following run the next day should retrieve the full data for the incomplete day.
• Some ‘Firewall’ reports have been deprecated from both the IAS platform and API, therefore when trying to process these deprecated Data Streams the following error message appears: *PROVIDER_INTERNAL_ERROR,Message=The report isn’t supported in Firewall Product*

How to QA

• To QA your data, generate a compatible report in the 'Excel Reports' section located under the 'Overview' menu.
• Create the desired report in the platform for the required date range. The 'Cut Off' field should be set to zero. It’s recommended that you select all the 'Delivery Environment' checkboxes and the 'Campaign' and 'Placement' checkboxes to ensure the view in IAS will be identical to the view in Marketing Cloud Intelligence Data Pipelines.
• Next, process the relevant Data Stream in Intelligence Data Pipelines for the same date range.
• Create a Report/Pivot Table within Intelligence Data Pipelines containing the exact same Dimensions and Measurements for the same report and date range.
• Compare the Measurement Totals and make sure they’re aligned.