Skip to main content

Conversion Enquiries

UK

Conversion enquiries refers to any enquiries you get from your customers that you submit to us. We collate these enquiries, match them to a conversion and submit them to advertisers for a response.

Our process is designed to be as seamless as possible to ensure you and your customer get a resolution quickly. To this end it's important that you submit your conversion enquiries using our template view template.

The Process

  • Upload your template via File Explorer.
  • You'll receive a notification if there are any errors, see below for more information on this. Correct errors and upload new file to File Explorer.
  • Enquiries with no errors will continue through the process so they aren't held up by any errors.
  • We'll process the files and liaise with the advertiser to resolve the enquiries.
  • Check the status at any time using our new Enquiries report. You'll find it under Conversions > Manage on our Insights platform.
tip

Why not check out our Optimise Network API to check enquiry statuses without logging in?

ConversionEnquiriesFlowchart

The Error File

As soon as your conversion enquiries are uploaded our system runs a range of validation checks on the data.

Those lines that pass continue to the internal Optimise process for dealing with enquiries and any that fail form an error file. You will be notified by email if there are any errors.

Primary Validation errors

Our validation first looks at the data you've uploaded and checks the following:

*Error Message*Additional Information
Entry data contains unauthorized or missing columns.Ensure that correct template is used.
AID is invalid.Check AID matches that of primary Insights login.
PID is invalid.Check PID is provided and is for a campaign publisher is live on.
PID is for an Item Level product.Item level campaigns set commissions against items within a basket and will be handled separately.
MerchantAppID is invalid.Add MerchantAppID.
UID is invalid.Add UID.
TransactionDate is invalid.Enter using dd/mm/yyyy format.
AffiliateRef is invalid.Add AffiliateRef.
TransactionValue is invalid.Must be max 2 decimal places and have no currency. symbol.
ExpectedCommissionValue is invalid.Must be max 2 decimal places and have no currency. symbol.

Campaign Validations

Some campaigns have specific validations that an advertiser requires. These error messages are explained below.

Error MessageAdditional Information
A name must be specified for enquiries on this campaign.Customer name is required — min 3 characters.
A valid postal code must be specified for enquiries on this campaign.Postcode requires min. 5 characters.
A valid email address must be specified for enquiries on this campaign.Ensure email address field is populated with valid addresses for each line.
A valid, numeric transaction value must be specified for enquiries on this campaign.Ensure transaction value is numeric without currency and to two decimal places.
MerchantAppID does not match the criteria for the Campaign. Value should be numeric.Ensure MerchantAppID value is numeric without currency and to two decimal places.
MerchantAppID does not match the criteria for the Campaign. Value should be alphanumeric.Ensure MerchantAppID value is alphanumeric.
MerchantAppID does not match the criteria for the Campaign. Value should be alphanumeric.Ensure MerchantAppID value has no numbers.
MerchantAppID does not match the criteria for the Campaign. Format should be ${productValidation.ReferenceValidation}.Ensure MerchantAppID is in the specified format.
MerchantAppID should contain minimum 3 characters.Ensure MerchantAppID contains at least three characters.
MerchantAppID characters length should not exceed ${productValidation.ReferenceValidationMaxLength}.Ensure MerchantAppID is not greater than the specified size.
Transaction date should be older than ${productValidation.EnquiryMaxAge} month(s).Ensure TransactionDate is greater than the specified date.

API documentation

We've built our Conversion Enquiries process on API's. You can use our Conversion Enquiries API to pull the status of an enquiry and our File Explorer API to submit a file without logging into Insights.

We have full documentation on all our API's here.

Global Markets (Excluding UK)

Conversion Enquiries refers to any missing sales or enquiries submitted to us by publishers.

Conversion Enquiries should be submitted on a monthly basis so that they can be included in the validation file sent to advertisers. You will be emailed every month with details of what format to send and the deadline to do so.

File format

The terminology used on the file you submit has changed to reflect the language used on our Insights platform. A summary below explains the fields and new terminology. More information on language can be found in the glossary.

**Old Language**New Language
MerchantAdvertiser
AffiliatePublisher
TransactionConversion
ProgrammeCampaign
Field NameDefinitionRequired?
PIDCampaign ID — the ID for the Campaign this conversion relates to.Yes
AIDPublisher ID — the ID assigned to you by Optimise.Yes
UIDThe UID for the conversion.No
OrderIDThe OrderID for the conversion. Previously known as TransactionID.Yes
ConversionDateThe date the conversion took place.Yes
AdvertiserNameThe name of the advertiser for this conversion.Yes
ConversionValueThe value of the conversion.Yes in South East Asia. No in India
CampaignNameThe name of the Campaign this conversion relates to.No
ConversionCurrencyThe currency used for the conversion.Yes
ExpectedCommissionValueThe commission you expect to receive.No

Checking the status of Conversion Enquiries

Check the status of an enquiry on the Enquiry View page. You can access this in your login via Conversions > Enquiry View.

Use the filters to find enquiries for the date range you're interested in and then view the status in the table. Where a conversion has been rejected by an advertiser you'll also see any notes the advertiser has made to explain the rejection.