Portal Block Clicked

An event triggered when a Game Portal block is clicked. Event Data

string

Event name: portal.block.clicked.

string

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

number

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

string

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

string

ID assigned by Appcharge to each request sent to the publisher. Helps the publisher identify and debug failed requests. Example: 23539478-c744-566a-c78c-c4cc7763ff62.

string

Event result. Supported values: success, failed.

string

Reason for the event result. Example: invalid_credentials.

map<any,any>

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

object

Information about the player.

Show properties

string

Player ID. Example: 671e81bb-55ef-428b-97ba-f67783971e0d.

string

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

string

Deprecated. Player email address. Example: john.doe@gmail.com.

object

UTM data.

Show properties

string

Source of the traffic. This is where the player came from before reaching the store. Example: Google.

string

Marketing channel used to bring in the traffic. Example: email.

string

Identifies the marketing campaign associated with the traffic. Example: black_friday.

string

Paid search keyword or term that generated the traffic. Example: buy+coins.

string

A label that identifies which version of content a player clicked to reach the web store. Useful for A/B testing and analyzing performance of different ad or link variations within the same campaign. Example: summer_sale_ad1

object

Information about the player’s device.

Show properties

string

Device platform. Example: iOS.

string

Device model. Example: iPhone 16 Pro.

string

Operating system type. Example: Apple.

string

Operating system version. Example: 18.

string

Browser type. Example: Google Chrome.

string

Browser version. Example: 138.

object

Information about the block.

Show properties

string

Block type. Example: image.

[object]

Show properties

string

Button label text. Applies to: cta.

string

URL the player is redirected to when clicking the block. Applies to: cta, image.

boolean

Whether the URL redirects to an external web store. Applies to: cta.

string

Desktop asset URL for the block. Applies to: cta.

string

Mobile asset URL for the block. Applies to: cta.

string

Desktop image URL. Applies to: image.

string

Mobile image URL. Applies to: image.

string

Content item ID. Applies to: contentsPreview.

string

Content type. Example: news. Applies to: contentsPreview.

string

Content title. Applies to: contentsPreview.

string

Content subtitle. Applies to: contentsPreview.

string

Thumbnail image URL. Applies to: contentsPreview.

string

Publication date in ISO 8601 format. Example: 2025-12-28T21:52:21.539Z. Applies to: contentsPreview.

string

Content slug. Applies to: contentsPreview.

[string]

List of labels or tags associated with the content. Applies to: contentsPreview.

object

Information about the player’s geolocation.

Show properties

enum

Two-letter country code in ISO-3166 alpha-2 format. Example: US

string

Deprecated. Region or state. Example: Florida.

string

Deprecated. IP address in IPv4 format. Example: 192.168.1.1.

string

Deprecated. Zip code. Example: 34997.

object

Session metadata.

Show properties

any

An object for passing data to Appcharge to be returned later. Example: { "abTest": "group1", "locale": "en-US" }.

{
  "eventName": "portal.block.clicked",
  "eventId": "3f5bffbc-369e-4599-8c4d-abfe0ae0ef96",
  "timestamp": 1754307361396,
  "sessionId": "345397c6-d963-4aa4-a0ba-2aaca6c3ee05",
  "requestId": "23539478-c744-566a-c78c-c4cc7763ff62",
  "result": "success",
  "reason": "invalid_credentials",
  "attributes": {
    "persona": "non_payer",
    "blackFridayTest": "Base_group"
  },
  "customer": {
    "id": "671e81bb-55ef-428b-97ba-f67783971e0d",
    "name": null,
    "email": null
  },
  "utm": {
    "utmSource": "google",
    "utmMedium": "cpc",
    "utmCampaign": "spring_sale",
    "utmTerm": "buy+coins",
    "utmContent": "ad1"
  },
  "device": {
    "platform": "iOS",
    "deviceModel": "iPhone 16 Pro",
    "osType": "Apple",
    "osVersion": "18",
    "browserType": "Google Chrome",
    "browserVersion": "138"
  },
  "block": {
    "type": "cta",
    "items": [
      {
        "text": "click me",
        "redirectUrl": "https://example.com/redirect",
        "isStoreRedirect": true,
        "assetUrl": "https://example.com/asset.png",
        "assetUrlMobile": "https://example.com/asset-mobile.png"
      }
    ]
  },
  "geolocation": {
    "countryCode2": "US",
    "region": null,
    "ipAddress": null,
    "zipCode": null
  },
  "sessionMetadata": { "abTest": "group1", "locale": "en-US" }
}

Overview

What's New

Web Store

Checkout

Game Portal

Media

Events Center

Translations