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.

  1. Filter section

  2. Result section

  3. 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.