모바일 푸시 웹훅

Aghanim의 라이브옵스 빌더를 통해 개발자는 플레이어 동작이나 상호 작용에 응답하여 모바일 푸시 알림을 트리거할 수 있습니다. 캠페인에서 설명된 조건이 충족되면, Aghanim은 캠페인에 지정된 모바일 푸시 콘텐츠를 포함하는 웹훅을 게임에 전송합니다.

요구 사항

Aghanim의 모바일 푸시 웹훅을 사용하려면 웹훅 서버를 다음과 같이 구성해야 합니다:

POST 웹후크 요청을 수락하는 HTTPS 엔드포인트.
Aghanim이 생성하고 서명한 이벤트를 수신합니다.
수신된 콘텐츠를 사용하여 모바일 푸시 표시를 트리거합니다.
웹훅을 성공적으로 수신하고 처리한 경우에는 2xx 상태 코드를 응답하며, 거부 또는 오류가 발생한 경우에는 4xx 또는 5xx를 응답합니다.

구성

ingame.push 웹훅 처리를 위한 함수를 개발합니다.
엔드포인트를 사용 가능하게 설정하세요.
Aghanim 계정 내에서 게임 → 웹훅 → 새 웹훅으로 이동하여 게임 내 푸시 이벤트 유형을 선택하여 엔드포인트를 등록하세요.
모바일 푸시 웹훅을 트리거하는 liveops 캠페인을 구성합니다.

모바일 푸시 캠페인 구성 가이드

대안으로, 웹후크 생성 API 방법을 사용하여 Aghanim 내에서 엔드포인트를 등록할 수 있습니다.

요청 스키마

아래는 예시입니다 ingame.push 웹훅 요청:

HTTP
cURL

POST /your/webhook/uri HTTP/1.1
Content-Type: application/json
Host: your-webhook-endpoint.com
User-Agent: Aghanim/0.1.0
X-Aghanim-Signature: 2e45ed4dede5e09506717490655d2f78e96d4261040ef48cc623a780bda38812
X-Aghanim-Signature-Timestamp: 1725548450

{
  "event_type": "ingame.push",
  "event_data": {
    "player_id": "2D2R-OP3C",
    "title": "안녕하세요!",
    "body": "오늘 기분은 어떠신가요?",
    "icon": null,
    "url": null
  },
  "event_time": 1725548450,
  "event_id": "whevt_eCacGbJVbvToOgzjXUgOCitkQE",
  "idempotency_key": null,
  "request_id": "d1593e9c-c291-4004-8846-6679c2e5810b",
  "sandbox": false,
  "trigger": "liveops.execute_action",
  "transaction_id": "whtx_eCacGbJVbvT",
  "context": null,
  "game_id": "gm_exTAyxPsVwh"
}
            

curl "https://your-webhook-endpoint.com/your/webhook/uri" \
    -X POST \
    -H "Content-Type: application/json" \
    -H "User-Agent: Aghanim/0.1.0" \
    -H "X-Aghanim-Signature: 2e45ed4dede5e09506717490655d2f78e96d4261040ef48cc623a780bda38812" \
    -H "X-Aghanim-Signature-Timestamp: 1725548450" \
    -d '{
      "event_type": "ingame.push",
      "event_data": {
        "player_id": "2D2R-OP3C",
        "title": "안녕하세요!",
        "body": "오늘 기분은 어떠신가요?",
        "icon": null,
        "url": null
      },
      "event_time": 1725548450,
      "event_id": "whevt_eCacGbJVbvToOgzjXUgOCitkQE",
      "idempotency_key": null,
      "request_id": "d1593e9c-c291-4004-8846-6679c2e5810b",
      "sandbox": false,
      "trigger": "liveops.execute_action",
      "transaction_id": "whtx_eCacGbJVbvT",
      "context": null,
      "game_id": "gm_exTAyxPsVwh"
    }'
            

이벤트 스키마

Key	유형	설명
`event_id`	`string`	Aghanim에 의해 생성된 고유 이벤트 ID.
`game_id`	`string`	Aghanim 시스템에서의 귀하의 게임 ID.
`event_type`	`string`	이벤트의 유형, `ingame.push` 이럴 경우.
`event_time`	`number`	유닉스 에포크 시간으로 된 이벤트 날짜.
`event_data`	`EventData`	이벤트 특정 데이터가 포함되어 있으며, 상속된 객체에 대한 가능한 키가 포함됩니다.
`idempotency_key`	`string\|null`	웹훅 작업이 재시도되어도 한 번만 실행되도록 보장합니다. 일 수 있습니다 `null` 이벤트 유형에 따라 달라집니다.
`request_id`	`string\|null`	이벤트가 API 요청에 의해 트리거된 경우, 요청 ID가 포함됩니다.
`sandbox`	`boolean`	이 이벤트가 샌드박스 게임 환경에서 전송되었는지를 표시합니다.
`trigger`	`string\|null`	The trigger that caused the event to be sent.
`transaction_id`	`string`	Aghanim이 생성한 거래 ID입니다. 이 ID는 동일한 거래 내에서 발생한 여러 이벤트에서 동일할 수 있습니다.
`context`	`EventContext\|null`	이벤트에 대한 컨텍스트 정보.

EventContext 스키마

Key	유형	설명
`order`	`OrderContext\|null`	해당되는 경우 이벤트와 관련된 주문 정보입니다.
`player`	`PlayerContext\|null`	플레이어 정보를 추가하려면 웹훅 설정에서 "플레이어 컨텍스트 추가"를 활성화하세요.

EventData 스키마

Key	유형	설명
`player_id`	`string`	푸시 알림을 표시하기 위해 선택된 고유한 플레이어 ID입니다.
`title`	`string`	푸시 알림 제목입니다.
`body`	`string`	푸시 알림 본문입니다.
`icon`	`string\	null`
`url`	`string\	null`

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