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"
  }
}

Step 4: Disable "Reject IAP Without Receipt" in Singular

Purchases on the Game Hub are processed by Aghanim outside the App Store and Google Play, so the revenue events Aghanim sends to Singular do not include a store purchase receipt — no receipt exists for these transactions.

If the Reject IAP Without Receipt fraud-prevention option is enabled for your app in Singular (Settings → Apps), Singular renames such events to __iapinvalid__, zeroes out their revenue, and does not send postbacks for them to your ad networks.

To make sure Game Hub revenue is tracked correctly, keep Reject IAP Without Receipt disabled for the app that receives Aghanim events.

For details on how Singular validates purchases, see the Singular In-App Purchase Validation FAQ.

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

On this page