Using the logs to troubleshoot server-side Webhooks

Before you start

Webhook logs allow you to troubleshoot server-side Webhook executions. You will find comprehensive information on the status of your Webhooks as well as the failure reason.

Getting started

Advertisers and Platform admins can check the logs of their Partners Webhooks via the main menu under Integrations/Webhooks

Partners can check the logs of their Webhooks via the main menu under Webhooks/Logs

What do the logs look like?

Webhook logs

There are three sections of interest here.

Filter section
Result section
Detail section

We'll go over each in detail now.

Filtering the logs - Filter section

In order to find log entries you're interested in, you can use the Visual Query Builder to filter the results. If you have a specific Target configuration that you want to analyse, you can specify a query that matches the configurations name like this.

Filter using the Visual Query Builder

Visit the Visual Query Builder documentation for more information.

Basic log data - Result section

The basic log data in the results table is there to give you a general overview of your Webhook executions. The following information can be found here.

Data field	Description	Filter
Status	Status of the Webhook execution. Possible values: `UNKNOWN` `EXECUTED` `FAILED` `UNKNOWN_TEMPLATE_PARAMETER_USED` `SKIPPED_UNSUPPORTED_TRANSITION` `SKIPPED_STATUS_CHANGE_WITHOUT_STATUS_PLACEHOLDER_IN_CODESET` `SKIPPED_DISPLAY_MODE_ADVERTISER_ONLY`	YES
Response Code	Http Response code (only if Status is `EXECUTED`)	YES
Last change	Date of the last execution (or attempt)	YES
Partner	Name of the Partner this Webhook belongs to	YES
Adspace	Name of the Adspace on which the conversion that triggered this execution was fired.	YES
Advertiser	Name of the Advertiser the conversion that triggered this execution belongs to.	YES
Order Id	The conversions order Id	YES
Conversion Status	Status of the Conversion at the moment this Webhook was executed. Possible values: `Unknown` `Open` `Approved` `Confirmed` `Rejected`	YES

Detailed log data - Detail section

The detailed log data in the results table is there to give you detailed information of your Webhook executions. The following information can be found here (in addition to the already described basic logs data).

Data field	Description	Filter
Conversion Target	Conversion Target of the conversion	YES
Tracking Category	Tracking Category of the conversion	YES
Rule	The Webhook rule that triggered this execution	YES
Target configuration	The applied Target configuration applied to this execution (Configured in the Webhook Rule)	YES
Replacements	The applied Target configuration applied to this execution (Configured in the Webhook Rule)	YES
Status message	Detailed information on what went wrong when an execution failed or was skipped.	YES

If the HTTP request was executed you can find request specific information in the Response Info tab.