{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Third Party Attribution File Spec","description":"MediaMath comprehensive APIs empower users to programmatically access and modify campaigns, reports, and log data in MediaMath Platform."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"third-party-attribution-file-spec","__idx":0},"children":["Third Party Attribution File Spec"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["How to send your attributed conversions to Infillion, so they drive optimization and appear in your campaign's standard"," ","conversion, revenue, CPA and ROI metrics."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Applies to"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Campaigns whose Measurement settings use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom or 3rd Party Attribution"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"campaign-setup","__idx":1},"children":["Campaign Setup"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the campaign's Measurement settings, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Custom or 3rd Party Attribution"]},". The campaign then reports and"," ","optimizes on the conversions you send. Infillion stops calculating Last Touch attribution for it."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the campaign's Merit Pixels (up to 10). Every ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merit_pixel_id"]}," in your files must be one of them. Conversions"," ","for any other pixel are not counted toward the campaign."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set the post-view and post-click windows. With 3rd Party Attribution these windows don't attribute anything: they are"," ","acceptance filters (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#how-conversions-appear-in-reporting"},"children":["How Conversions Appear in Reporting"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Depending on which partner you are working with for 3rd Party Attribution, you may be required to add the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[BID_ATTR.bid_id]"]}," macro to every creative's impression and click tracking URLs and to set up the"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/log-level-data-service"},"children":["Log Level Data Service"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Locked settings"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Weight Preset, Value, Post-View Discount Rate and Repeat Merit Events are locked on these campaigns. Your attribution"," ","partner decides how much credit each conversion gets."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivering-files","__idx":2},"children":["Delivering Files"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upload files to the Amazon S3 bucket ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["inf-third-party-conversions"]},". Put each file directly inside your organization's"," ","folder:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"s3://inf-third-party-conversions/organization_id=<your organization ID>/Conversions_20261007_060000_Part1.csv\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"getting-access","__idx":3},"children":["Getting Access"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To get access to upload third party conversions, open a"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://support.infillion.com/s/submit-a-case"},"children":["Support ticket"]},". Once access is in place, you write to your folder with"," ","temporary credentials obtained through an AWS role, the same way as for the Log Level Data Service (see"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/log-level-data-service/overview#obtaining-temporary-credentials-to-access-log-level-data"},"children":["Obtaining Temporary Credentials"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"folder-and-delivery","__idx":4},"children":["Folder and Delivery"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The folder name must be exactly ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id="]}," followed by your numeric organization ID. Files in subfolders are"," ","not processed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Files are picked up once an hour. You can deliver as often as you like, and as many files as you need."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"file-names","__idx":5},"children":["File Names"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"Conversions_YYYYMMDD_HHMMSS_PartN.<csv|tsv|json|parquet>[.gz]\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYYMMDD_HHMMSS"]}," must be a real date and time. Use the time you created the export, in UTC."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PartN"]}," numbers start at 1. Split a large export into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Part1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Part2"]}," and so on."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Files whose names don't follow this pattern are ignored without notice. They aren't processed or reported anywhere."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Each file name is processed once"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Re-uploading a file with the same name has no effect. To correct data, send the rows again in a new file (see"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#corrections-and-duplicates"},"children":["Corrections and Duplicates"]},")."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["SFTP and FTP are not supported."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"file-formats","__idx":6},"children":["File Formats"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Format"},"children":["Format"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Columns"},"children":["Columns"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Compression"},"children":["Compression"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CSV"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".csv"]},")",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["TSV"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".tsv"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A header row is required. The first 9 columns must be the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#fields"},"children":["fields"]}," below, in that exact order and with those exact lower-case names. Extra columns after them are ignored."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None, or gzip with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".gz"]}," suffix"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".json"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One JSON object per line (JSON Lines), not a single array. Fields are matched by name. Extra fields are ignored."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None, or gzip with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".gz"]}," suffix"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parquet"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".parquet"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fields are matched by name, and their types are checked (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#fields"},"children":["Fields"]},"). Extra fields are ignored."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal only: Snappy, Zstandard or gzip. Don't add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".gz"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Maximum file size: ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5 GiB"]},", after compression. Split larger exports into parts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Text timestamps (CSV, TSV, JSON) use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD HH:MM:SS"]},", in UTC. Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026-10-07 14:32:10"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Leave an optional value empty (CSV/TSV) or set it to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," (JSON)."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Every field must be present"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["\"Optional\" applies to a field's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["value"]},", never to the field itself. All 9 fields must be in every file, even when"," ","you never fill some of them, for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_timestamp"]}," in a feed with only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIEW"]}," rows or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revenue_credit"]}," without"," ","revenue. A file missing any of them is ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#whole-file-rejection"},"children":["rejected as a whole"]},". In CSV/TSV, keep the column and"," ","leave it empty. In JSON, include the key with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},". In Parquet, keep the column, with its type from the table"," ","below, and write nulls."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fields","__idx":7},"children":["Fields"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each row gives one impression credit for one conversion. If your partner splits credit for a single conversion across"," ","several impressions, send one row for each impression, using the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_id"]}," on every row. For example, an"," ","order credited 0.6 to one impression and 0.4 to another is two rows."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"#"},"children":["#"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auction_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BIGINT",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Parquet: INT64"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Infillion auction ID that identifies the impression. This is the value of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[BID_ATTR.bid_id]"]}," macro."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merit_pixel_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["INT",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Parquet: INT32"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Infillion Merit Pixel ID the conversion counts toward. It must be selected on the campaign."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversion_credit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DOUBLE",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Parquet: DOUBLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fractional credit from 0.0 to 1.0. A credit of 0.6 adds 60% of a conversion to the campaign."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revenue_credit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DOUBLE",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Parquet: DOUBLE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revenue credited to this impression, in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["USD"]},". It is converted to the campaign's reporting currency, and the Merit Pixel's own currency setting is ignored. Needed for ROI campaigns. Must not be negative."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversion_timestamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TIMESTAMP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When the conversion happened, in UTC."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["impression_timestamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TIMESTAMP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When the credited impression was served, in UTC. Required for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]}," rows too. This time must not be later than the click time or the conversion time."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["7"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_timestamp"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TIMESTAMP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]}," only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When the credited click happened, in UTC. Required when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attribution_type"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]},". Must be between the impression and the conversion."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["8"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["STRING"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your unique ID for the conversion, such as an order number. At most 255 characters."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["9"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attribution_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["STRING"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIEW"]},", in upper case: whether your partner credited a click or a view."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Parquet types must match exactly"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auction_id"]}," is INT64, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merit_pixel_id"]}," is INT32, and both credit fields are DOUBLE (FLOAT is rejected). Timestamps must"," ","be native TIMESTAMP columns: the legacy INT96 encoding is not supported, and their values are read as UTC."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"validation","__idx":8},"children":["Validation"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"whole-file-rejection","__idx":9},"children":["Whole-File Rejection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Nothing from a file is used if any of these apply:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The file is larger than 5 GiB, or can't be read (corrupt, wrong compression, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".gz"]}," on a Parquet file)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A required column is missing. For CSV/TSV, the rejection also happens when the first 9 columns are out of order or"," ","named differently."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A Parquet field has the wrong type, for example an INT32 ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auction_id"]}," or a FLOAT credit."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"Rejected files are not retried"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fix the problem and upload the data again under a new file name."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"row-level-checks","__idx":10},"children":["Row-Level Checks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These drop only the offending row. The rest of the file is processed. Checks run in this order, and each dropped row is"," ","counted under the first rule it fails:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A required field is empty or can't be read. Examples: a credit of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["abc"]},", or a timestamp in another format such as"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2026-10-07T14:32:10Z"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_id"]}," is longer than 255 characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversion_credit"]}," is below 0 or above 1."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revenue_credit"]}," is negative."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["attribution_type"]}," is not exactly ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIEW"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]}," row has no ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_timestamp"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The timestamps are out of order. The impression must come first, then the click (whenever ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["click_timestamp"]}," is set,"," ","on any row), then the conversion. Equal times are fine. A click before its impression, or a conversion before its"," ","impression or click, is invalid."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The impression is more than 30 days old when the file is processed. Send conversions promptly: an impression that was"," ","recent when the conversion happened can still be too old by the time the file arrives."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["After ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#matching-to-impressions"},"children":["matching"]},", the conversion falls outside the post-view window (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["VIEW"]}," rows, measured"," ","from the impression) or the post-click window (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CLICK"]}," rows, measured from the click) of the impression's campaign."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"matching-to-impressions","__idx":11},"children":["Matching to Impressions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each row is matched to an Infillion impression by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auction_id"]}," alone. An impression belongs to exactly one campaign, so"," ","it gives the conversion its campaign, strategy and advertiser. Make sure each row credits an impression from the campaign"," ","the conversion is meant for. The advertiser's Attribution Level setting (individual or household) doesn't apply here."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If a row's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auction_id"]}," doesn't match any Infillion impression, its conversion is not included in any reporting"," ","metric. The only place it shows up is the Unmatched Auction ID Rate in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#feed-status"},"children":["Feed Status"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Unmatched rows are not retried later. Send conversions once the impressions they credit are at least a few hours old."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"corrections-and-duplicates","__idx":12},"children":["Corrections and Duplicates"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can change a conversion you already sent for two reasons: to fix a mistake, or to restate its value. Restating is"," ","expected. For example, your attribution model may receive new information and reweight the credit it gave earlier. Both"," ","work the same way: send the conversion again in a new file with the same values for these four fields:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"auction_id + merit_pixel_id + conversion_timestamp + transaction_id\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The latest values replace the previous ones. Reports change by the difference, so nothing is counted twice."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Send the complete row. A correction with an empty ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revenue_credit"]}," sets the revenue to zero."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["To remove a conversion, send it with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversion_credit"]}," = 0 and an empty ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revenue_credit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sending a row with exactly the same credit and revenue changes nothing. Re-sending data is safe, but such rows"," ","are not counted as feed activity (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#feed-status"},"children":["Feed Status"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the same conversion appears more than once in one file, only one of those rows is kept. Put each correction in a"," ","later file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Corrections only change ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversion_credit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revenue_credit"]},". To change any of the four key fields, send"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversion_credit"]}," = 0 for the old row and add the new row."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-conversions-appear-in-reporting","__idx":13},"children":["How Conversions Appear in Reporting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your conversions populate the campaign's standard metrics."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Metric"},"children":["Metric"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Comes from"},"children":["Comes from"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conversions"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sum of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversion_credit"]},", fractions included"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revenue"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sum of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["revenue_credit"]},", converted from USD to the campaign's currency"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CPA, ROI, AOV"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Calculated from the conversions and revenue above, the same way as for any campaign"]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A conversion counts only if its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merit_pixel_id"]}," is one of the impression's campaign's Merit Pixels, and it falls"," ","within that campaign's post-view or post-click window (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#validation"},"children":["Validation"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Post-view conversions are not discounted, and repeat merit event rules are not applied. Your partner's credit is used"," ","as-is."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Metrics are available in reports, data exports, campaign charting and the Reporting API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Files are processed hourly. Data usually appears in reports within a few hours of delivery."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"examples","__idx":14},"children":["Examples"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"csv","__idx":15},"children":["CSV"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["File ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id=102807/Conversions_20261007_060000_Part1.csv"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csv","header":{"controls":{"copy":{}}},"source":"auction_id,merit_pixel_id,conversion_credit,revenue_credit,conversion_timestamp,impression_timestamp,click_timestamp,transaction_id,attribution_type\n7718226453901234567,847291,0.6,59.94,2026-10-07 14:32:10,2026-10-06 09:15:44,,ORD-100234,VIEW\n7718226453907654321,847291,1.0,120.00,2026-10-07 16:05:00,2026-10-07 15:40:12,2026-10-07 15:41:03,ORD-100235,CLICK\n7718226453905550001,847291,0.4,39.96,2026-10-07 14:32:10,2026-10-05 20:02:31,,ORD-100234,VIEW\n","lang":"csv"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The first and third rows split one order (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ORD-100234"]},") between two impressions: 0.6 and 0.4 of a conversion."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"json-lines","__idx":16},"children":["JSON Lines"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same first two rows, in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Conversions_20261007_060000_Part1.json"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\"auction_id\": 7718226453901234567, \"merit_pixel_id\": 847291, \"conversion_credit\": 0.6, \"revenue_credit\": 59.94, \"conversion_timestamp\": \"2026-10-07 14:32:10\", \"impression_timestamp\": \"2026-10-06 09:15:44\", \"click_timestamp\": null, \"transaction_id\": \"ORD-100234\", \"attribution_type\": \"VIEW\"}\n{\"auction_id\": 7718226453907654321, \"merit_pixel_id\": 847291, \"conversion_credit\": 1.0, \"revenue_credit\": 120.00, \"conversion_timestamp\": \"2026-10-07 16:05:00\", \"impression_timestamp\": \"2026-10-07 15:40:12\", \"click_timestamp\": \"2026-10-07 15:41:03\", \"transaction_id\": \"ORD-100235\", \"attribution_type\": \"CLICK\"}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"correction","__idx":17},"children":["Correction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The next day, your partner moves more credit to the earlier impression. In a new file,"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Conversions_20261008_060000_Part1.csv"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"csv","header":{"controls":{"copy":{}}},"source":"auction_id,merit_pixel_id,conversion_credit,revenue_credit,conversion_timestamp,impression_timestamp,click_timestamp,transaction_id,attribution_type\n7718226453901234567,847291,0.3,29.97,2026-10-07 14:32:10,2026-10-06 09:15:44,,ORD-100234,VIEW\n7718226453905550001,847291,0.7,69.93,2026-10-07 14:32:10,2026-10-05 20:02:31,,ORD-100234,VIEW\n","lang":"csv"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each row keeps its four key fields, so it replaces the earlier values. The order still totals 1.0 conversion and $99.90."," ","Each impression's campaign and strategy is adjusted by the difference: −0.3 and +0.3 conversions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-send-your-first-file","__idx":18},"children":["Before You Send Your First File"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The campaign uses Custom or 3rd Party Attribution, and every ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merit_pixel_id"]}," you send is one of its Merit Pixels."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You have requested access through a support ticket, and your partner's requirements are covered: the"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[BID_ATTR.bid_id]"]}," macro on every creative's impression and click tracking URLs, and Log Level Data Service, if they"," ","apply."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Files go directly into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_id=<your ID>/"]}," and are named ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Conversions_YYYYMMDD_HHMMSS_PartN.<ext>"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CSV/TSV files start with the exact 9-column header, in order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Timestamps are UTC, in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD HH:MM:SS"]}," (or native Parquet TIMESTAMP), and in order: impression, then click,"," ","then conversion."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Parquet files use INT64 for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["auction_id"]}," and DOUBLE for credits."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Revenue is in USD, and corrections are sent as complete rows in new files."]}]}]},"headings":[{"value":"Third Party Attribution File Spec","id":"third-party-attribution-file-spec","depth":1},{"value":"Campaign Setup","id":"campaign-setup","depth":2},{"value":"Delivering Files","id":"delivering-files","depth":2},{"value":"Getting Access","id":"getting-access","depth":3},{"value":"Folder and Delivery","id":"folder-and-delivery","depth":3},{"value":"File Names","id":"file-names","depth":3},{"value":"File Formats","id":"file-formats","depth":2},{"value":"Fields","id":"fields","depth":2},{"value":"Validation","id":"validation","depth":2},{"value":"Whole-File Rejection","id":"whole-file-rejection","depth":3},{"value":"Row-Level Checks","id":"row-level-checks","depth":3},{"value":"Matching to Impressions","id":"matching-to-impressions","depth":2},{"value":"Corrections and Duplicates","id":"corrections-and-duplicates","depth":2},{"value":"How Conversions Appear in Reporting","id":"how-conversions-appear-in-reporting","depth":2},{"value":"Examples","id":"examples","depth":2},{"value":"CSV","id":"csv","depth":3},{"value":"JSON Lines","id":"json-lines","depth":3},{"value":"Correction","id":"correction","depth":3},{"value":"Before You Send Your First File","id":"before-you-send-your-first-file","depth":2}],"frontmatter":{"seo":{"title":"Third Party Attribution File Spec"}},"lastModified":"2026-11-13T13:36:44.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/third-party-attribution","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}