Skip to main content

Aghanim-Singular Integration

This guide explains how to integrate Aghanim with Singular to streamline mobile attribution and analytics. By connecting Aghanim with Singular, you can track player-generated events from the Game Hub, ensuring precise tracking of user actions across your entire game environment.

info

Aghanim currently sends events to Singular only when a player successfully completes a payment on the Game Hub.

Requirements​

Step 1: Provide the Singular SDK Key​

Obtain an SDK Key from Singular UI under Developer Tools in the Main Menu to authenticate communication, enabling Aghanim to send events.

Step 2: Install the Singular plugin​

  1. Log in to your Singular dashboard.
  2. Proceed to Aghanim Dashboard → App Connect and install the Singular plugin.
  3. In the plugin settings, paste the SDK Key. 1Click Install.

Step 3: Add Singular attributes to player.verify webhook response​

To ensure Singular correctly identifies users and attributes their actions on the Game Hub, include the Singular‑specific attributes in the player.verify webhook response:

KeyTypeDescriptionRequired?
attributes.platformstringThe platform on which the player is using the Game Hub. Example: ios, android.Yes
attributes.singular_device_idobjectSpecifies the Device ID used by Singular to identify the user. Example: {"idfa": "D2CADB5F-410F-4963-AC0C-2A78534BDF1E"}. For more supported device IDs, see the Singular S2S API documentation.Yes
attributes.singular_app_idstringThis is the Package Name (case-sensitive) for Android or the Bundle ID for iOS or of your application. Example: com.singular.app.Yes

Example webhook response:

{
  "player_id": "1x1x-xxxx1",
  "name": "Molly",
  "attributes": {
    "platform": "ios",
    "singular_device_id": {
        "idfa": "D2CADB5F-410F-4963-AC0C-2A78534BDF1E"
    },
    "singular_app_id": "com.singular.app"
  }
}

Need help?
Contact our integration team at integration@aghanim.com