Mobile Pushes

Mobile push notifications boost player engagement, retention, and monetization in mobile games by alerting players to new content, events, and rewards, encouraging frequent returns. Through Aghanim LiveOps Builder, developers can send targeted notifications based on in-game actions or interactions on the Aghanim-generated game hub.

Clicking on a push notification typically takes players directly to the mobile app, guiding them to their next action or presenting a popup for further steps, like claiming a reward.

Requirements

For integrating mobile push notifications with Aghanim, ensure your game meets these requirements:

A publicly accessible HTTPS endpoint to receive Aghanim mobile push webhooks to initiate push notifications for mobile players.
For campaigns triggered by in-game events, define the in-game conditions that will launch the campaign, and implement the necessary logic to execute an Aghanim API call to start the campaign.

General flow for implementing a mobile push

To implement a mobile push, follow these steps:

In the Aghanim Dashboard under Game → Webhooks, register the webhook URL designed to process Aghanim mobile push webhooks. Ensure you select In Game Push as the event type.
Create a campaign in the LiveOps Builder, detailing when and why a mobile push should be sent to players.
Publish the campaign in the Settings section of the campaign's editing mode.
For campaigns initiated by in-game events, trigger the campaign via the Aghanim API by setting up the necessary API call and trigger logic in your game.
Once campaign conditions are met, Aghanim dispatches a webhook to issue the mobile push as shown below:

curl -X "https://your-webhook-endpoint.com/your/webhook/uri" \
  -H "Host: your-webhook-endpoint.com" \
  -H "x-aghanim-signature-timestamp: <EVENT_TIMESTAMP>" \
  -H "x-aghanim-signature: <HMAC-SHA256_SIGNATURE>" \
  -H 'user-agent: Aghanim/0.1.0' \
  -H 'content-type: application/json' \
  -H 'accept-encoding: gzip, deflate' \
  -H 'accept: */*' \
  -d '{
        "event_id": "<EVENT_ID>",
        "event_time": 1709974737,
        "event_type": "ingame.push",
        "idempotency_key": null,
        "event_data": {
          "player_id": "<PLAYER_ID>",
          "title": "<MOBILE_PUSH_TITLE>",
          "body": "<MOBILE_PUSH_BODY>",
          "icon": null,
          "url": null
        }
      }'

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

Requirements​

General flow for implementing a mobile push​

Requirements

General flow for implementing a mobile push