> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Offline Conversion Diagnostics

> Read Microsoft Ads offline conversion upload summaries and diagnostic file links

Read Microsoft Ads offline conversion upload summaries and diagnostic file links. Supply goal IDs for success/unattributed counts, reasons and upload-channel filtering. Account summaries remain unfiltered; diagnostics do not identify exact uploaders or schedules.

| | |
| - | - |
| **App** | Microsoft Ads |
| **Operation ID** | `microsoft_ads_get_offline_conversion_diagnostics` |
| **Type** | Action |
| **Connection** | `microsoft_ads` (required) |
| **Credits per run** | 1 |
| **Agent / MCP tool** | Yes |

## Inputs

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `account` | object or array of object or MicrosoftAdsAccountItem or string or integer | Yes | - | Microsoft Ads account whose offline conversion uploads to inspect. |
| `date_range` | OfflineConversionDateRange | Yes | - | Upload dates in UTC, inclusive. Use a preset or FIXED with start/end dates. Comparisons are not supported. Longer ranges are automatically split into seven-day requests for per-goal diagnostics. |
| `goal_ids` | array of integer | No | - | Optional offline conversion goal IDs as an array, JSON array, or comma-separated text. Supply IDs to include per-goal success counts, unattributed counts and reasons. Omit for account upload summaries only. Selections are automatically batched. Find IDs with microsoft\_ads\_list\_conversion\_goals. |
| `upload_channels` | array of enum (`CampaignManagementAPI`, `BulkAPI`, `WebUpload`, `Unknown`) | No | - | Optional channels for per-goal diagnostics; requires goal\_ids. Omit or null includes all channels. CampaignManagementAPI, BulkAPI, WebUpload (manual web upload), or Unknown. Does not filter account upload summaries. There is no separate scheduled-upload channel. |

### MicrosoftAdsAccountItem

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `value` | string | Yes | - | |
| `label` | string | Yes | - | |
| `customerId` | string | No | - | The Microsoft Ads customer ID used for REST CustomerId headers. If omitted, it is resolved from the account ID. |

### OfflineConversionDateRange

| Field | Type | Required | Default | Description |
| - | - | - | - | - |
| `start` | string | No | - | The start date of the date range to query, format: YYYY-MM-DD or dynamic node reference like \{\{nodeId\_\_data.start\_date}}. Required when preset is 'FIXED' or 'CUSTOM'. |
| `end` | string | No | - | The end date of the date range to query, format: YYYY-MM-DD or dynamic node reference like \{\{nodeId\_\_data.end\_date}}. Required when preset is 'FIXED' or 'CUSTOM'. |
| `preset` | string | No | - | Predefined date ranges or input modes: - Use 'FIXED' or leave empty when you want to specify exact dates (YYYY-MM-DD format) in start/end fields - Use 'CUSTOM' when you want to use dynamic values from other nodes (\{\{nodeId\_\_data.start\_date}} format) in start/end fields - Use other presets (TODAY, YESTERDAY, LAST\_7\_DAYS, etc.) for predefined date ranges (start/end will be ignored) LAST\_N\_MONTHS and LAST\_N\_WEEKS are complete calendar periods ending with last month or last week, so they exclude the current month or week; for a rolling window up to yesterday use LAST\_N\_DAYS (for example LAST\_90\_DAYS) or a FIXED range. When using 'FIXED' or 'CUSTOM', both start and end fields are required. |
| `compare` | null | No | - | Comparisons are not supported for upload diagnostics; omit or null. |

## Output

**Type**: `Dict`

Native DailySummaries with UploadDate, SuccessCount, FailureCount, FileUrl and FileUrlExpiryTimeUtc; optional goal\_reports preserve each request and its OfflineGoalConversionSummaries and PartialErrors. Goal reports are split into seven-day windows and batches of 20 IDs. Null data remains unknown; file links expire at the returned expiry time.

**Fields**: `date_range`, `upload_summary`, `goal_reports`, `has_partial_errors`, `note`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.