Personalization Response Error

An event triggered when the Personalization API returns an unexpected or invalid response. Typical causes include schema mismatches, incorrect data types, timeouts, empty offer lists, or non-existent external IDs.

Event Data

eventName · string

Event name: webstore.personalization_api.error.

eventId · string

Event ID. Use this ID to deduplicate re-delivered events.

timestamp · number

Event timestamp in Epoch time, represented in milliseconds. Example: 1754307361396.

sessionId · string

The session ID of the player’s current session. Example: 345397c6-d963-4aa4-a0ba-2aaca6c3ee05.

requestId · string

ID assigned by Appcharge to each request sent to the publisher. Helps the publisher identify and debug failed requests.

result · string

Event result. This field is not currently in use.

reason · string

Reason for the event result. This field is not currently in use. Error details are returned in the error object.

attributes · map<any,any>

A key-value map used to label events for tracking personas or tests. Example: { "persona":"non_payer", "blackFridayTest":"Base_group" }

customer · object

Information about the player.

Show properties

id · string

Player ID.

email · string

Deprecated. Player email address.

name · string

Deprecated. Reserved for the player’s name in future versions.

sessionMetadata · any

Session metadata for passing data to Appcharge to be returned later.

correlationRequestId · string

The requestId sent when calling the Web Store Personalization API service.

error · object

Information about the error.

Show properties

type · string

Error type.

reason · string

Reason for the error.

httpStatusCode · string

HTTP status code of the error.

Event Payload

{
  "eventName": "webstore.personalization_api.error",
  "eventId": "3f5bffbc-369e-4599-8c4d-abfe0ae0ef96",
  "timestamp": 1754307361396,
  "sessionId": "345397c6-d963-4aa4-a0ba-2aaca6c3ee05",
  "requestId": "23539478-c744-566a-c78c-c4cc7763ff62",
  "result": null,
  "reason": null,
  "attributes": {
    "persona": "non_payer",
    "blackFridayTest": "Base_group"
  },
  "customer": {
    "id": "671e81bb-55ef-428b-97ba-f67783971e0d",
    "name": null,
    "email": null
  },
  "sessionMetadata": { 
    "abTest": "group1", 
    "locale": "en-US" 
  },
  "correlationRequestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "error": {
    "type": "general_error",
    "reason": "timeout",
    "httpStatusCode": "504"
  }
}