주요 콘텐츠로 건너뛰기

게임 내 팝업

게임 내 팝업은 게임 개발자와 플레이어 간의 직접적인 커뮤니케이션 채널로, 적절한 시기에 정보, 프로모션, 인센티브를 전달하도록 설계되었습니다. Aghanim LiveOps Builder를 활용하면 개발자는 게임 내 플레이어 동작이나 게임 허브에서의 상호작용을 기반으로 팝업을 트리거할 수 있으며, 전략적 기준에 맞춰 참여를 강화하고 게임 경험을 개선할 수 있습니다.

요구 사항

게임 내 팝업을 Aghanim에 통합하려면, 게임이 다음 요구 사항을 충족해야 합니다:

  • 게임의 분위기에 어울리고 자연스러운 사용자 경험을 제공하는 인게임 팝업용 프론트엔드가 개발되어 있습니다.
  • 게임 내 팝업을 표시하기 위해, Aghanim의 팝업 웹훅을 수신할 수 있는 외부에서 접근 가능한 HTTPS 엔드포인트가 필요합니다.
  • 게임 내 이벤트에 의해 트리거되는 캠페인의 경우, 캠페인을 시작할 게임 내 조건을 정의하고 Aghanim API 호출을 실행하여 캠페인을 시작하는 데 필요한 로직을 구현합니다.

게임 내 팝업을 실행하기 위한 일반적인 흐름

게임 내 팝업을 구현하려면 다음 단계를 따르세요:

  1. 게임 → 웹후크에서 Aghanim 대시보드의 웹후크 URL을 등록하여 Aghanim 팝업 웹후크를 처리하도록 하십시오. 이벤트 유형으로 게임 내 팝업을 선택했는지 확인하세요.
  2. Aghanim 대시보드에서 캠페인을 만들고, 게임 내 팝업이 플레이어에게 언제, 왜 나타나야 하는지 자세히 설명합니다.
  3. 캠페인 편집 모드의 설정 섹션에서 캠페인을 게시합니다.
  4. 게임 내 이벤트로 시작된 캠페인의 경우, 게임에서 필요한 API 호출과 트리거 로직을 설정하여 Aghanim API를 통해 캠페인을 트리거합니다.
  5. 캠페인 조건이 충족되면 Aghanim은 다음 형식으로 팝업을 표시하기 위해 웹훅을 보냅니다:
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.popup",
        "idempotency_key": null,
        "event_data": {
          "player_id": "<PLAYER_ID>",
          "title": "<IN_GAME_POPUP_TITLE>",
          "body": "<IN_GAME_POPUP_BODY>",
          "icon": null,
          "url": null
        }
      }'

사용 사례: 게임 내 팝업을 통해 게임 허브 뉴스로 플레이어 재참여 유도

이 캠페인은 12시간 이상 게임 허브를 방문하지 않은 플레이어를 대상으로 최신 뉴스를 강조하여 다시 방문하도록 유도하는 것을 목표로 합니다:

Payment flow image
Payment flow image

캠페인은 커스텀 이벤트로 시작되며, 트리거 로직을 구현해야 합니다. 예를 들어, 플레이어 로그인을 이 캠페인의 트리거 조건으로 설정할 수 있습니다. 로그인 후, 게임은 캠페인을 시작하기 위해 Aghanim에 API 호출을 수행합니다. 그러면 Aghanim은 플레이어가 지난 12시간 동안 게임 허브에 참여했는지 확인합니다. 결근 시간이 12시간을 초과하면, Aghanim이 팝업의 세부 정보가 포함된 웹훅을 발송합니다. 이후, 귀하의 게임 엔드포인트는 해당 정보를 처리하여 팝업을 표시하고, 플레이어가 다시 게임 허브 활동으로 자연스럽게 유입되도록 유도합니다.

캠페인을 구현하려면:

  1. 캠페인 팝업의 프런트엔드를 개발합니다.

  2. 플레이어를 게임 허브의 뉴스 페이지로 안내하는 딥링크를 만들어 팝업에 통합합니다.

  3. 플레이어 로그인과 같은 팝업을 트리거하는 게임 내 조건을 정의하고, 게임에 해당 로직을 구현합니다.

  4. 플레이어 로그인 후, 캠페인을 시작하기 위해 아가님 API를 호출합니다. 예:

    curl -u sk_xxxxxxxxxxxx: -X POST https://api.aghanim.com/s2s/v1/events \
      -H "Content-Type: application/json" \
      -d '{ \
          "event_time":1711366555685, \
          "event_type":"My Campaign", \
          "event_data":{ \
              "player_id":"testplayer" \
          } \
      }'

  5. 웹훅을 수신하면 Aghanim은 지정된 플레이어가 지난 12시간 동안 게임 허브를 방문했는지 확인합니다.

  6. 플레이어의 마지막 방문이 12시간을 초과한 경우, Aghanim은 팝업 콘텐츠가 포함된 웹훅을 발송합니다. 예:

    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": "cam_ezSOgmVybuV",
            "event_time": 1709974737,
            "event_type": "ingame.popup",
            "idempotency_key": null,
            "event_data": {
              "player_id": "testplayer",
              "title": "Stay ahead of the game! 🌟",
              "body": "Dive into the latest game updates and insights that will keep you on the edge of your seat. Explore now and be part of the unfolding adventure that is captivating gamers worldwide!",
              "icon": null,
              "url": null
            }
          }'

  7. 수신된 웹훅을 게임 측에서 처리하고 제공된 콘텐츠가 포함된 팝업을 표시합니다.

도움이 필요하세요?
통합팀에 문의하십시오 integration@aghanim.com

On this page