apply_offline_conversions
Import offline conversions keyed by MSCLKID, attributing each to a click and counting it under a named OfflineConversion goal.
Instructions
Import offline conversions against an OfflineConversion goal, keyed by MSCLKID.
This is the bid-eligible path for phone calls: create an OfflineConversion goal with create_conversion_goal, apply your own qualifying filter to the call-center log (e.g. keep calls >=60s), then upload one record per qualifying call. Each record is attributed to the click that drove it and counted under the goal whose name matches conversion_name. Returns per-record errors in partial_errors (the API returns no ids).
Note: wait ~2 hours after creating an OfflineConversion goal before uploading — earlier uploads are rejected with "OfflineConversionNotAcceptedForGoal" (expected, not a bug).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| conversions_to_apply | Yes | One or more conversions. Each has: click_id — the MSCLKID from the ad click (Microsoft auto-tags it onto landing-page URLs; see get_account_url_options); conversion_name — must match an existing OfflineConversion goal's name; conversion_time — ISO-8601 timestamp (treated as UTC if no offset given), after the click and within the goal's conversion window; value — optional conversion value (requires currency_code); currency_code — ISO 4217 code for value, e.g. "USD". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| ids | No | ||
| message | Yes | ||
| partial_errors | No |