소셜 활동

좋아요, 답글, 팔로우, 수신 메시지, 게임 내 경쟁 이벤트 등 사용자와 관련된 일이 발생할 때 사용자에게 알리세요. 이러한 알림은 사용자가 현재 앱에서 활동하지 않을 때도 재참여를 유도합니다.

OneSignal은 실시간 커뮤니케이션을 위해 설계되지 않았습니다. 푸시 알림은 사용자가 앱에 적극적으로 있지 않을 때 대체 수단으로 사용하는 것이 가장 좋습니다. 실시간 인앱 메시징의 경우 앱의 기존 메시징 레이어를 사용하고 수신자가 오프라인이거나 비활성 상태일 때만 OneSignal 알림을 트리거하세요.

누군가 좋아요, 댓글, 멘션, 태그 또는 팔로우할 때 사용자에게 알립니다.

다이렉트 메시지

디바운싱과 대화 딥 링크로 새로 수신된 메시지를 사용자에게 알립니다.

게임 알림

기지 공격, 도전, 길드 활동과 같은 시간에 민감한 경쟁 이벤트를 전송합니다.

사전 요구 사항

시작하기 전에 다음을 확인하세요:

앱에 OneSignal SDK가 설치되어 있어야 합니다. 모바일 SDK 설정 또는 웹 SDK 설정을 참조하세요.
자체 식별자로 사용자를 타겟팅할 수 있도록 모든 사용자에 대해 external_id가 설정되어 있어야 합니다. 사용자 및 별칭을 참조하세요.
소셜 활동을 감지하고 OneSignal API를 호출할 수 있는 백엔드가 필요합니다. REST API 개요를 참조하세요.
개인화를 위해 custom_data를 사용할 계획이라면 대시보드에서 템플릿을 생성해야 합니다. custom_data를 사용하려면 template_id가 필요합니다.

custom_data 페이로드는 2KB 미만으로 유지하세요. custom_data 필드에는 엄격한 크기 제한이 있습니다. 전체 대화 목록, 리더보드 배열, base64 이미지, HTML과 같은 큰 페이로드를 보내면 잘리거나 거부될 위험이 있습니다. 풍부한 콘텐츠의 경우 식별자(예: digest_id 또는 summary_url)를 전달하고 수신자의 기기가 탭할 때 백엔드에서 전체 페이로드를 가져오도록 하세요. 크기 제한 세부 정보와 배열 반복 패턴은 API custom_data로 메시지 개인화를 참조하세요.

소셜 활동 알림

사용자가 소셜 활동에 관련될 때 푸시 알림을 전송하세요. custom_data를 사용하여 전송 시점에 발신자의 이름, 아바타 및 관련 컨텍스트를 메시지에 삽입합니다. OneSignal에는 데이터가 저장되지 않습니다.

일반적인 소셜 활동

활동	알림 예시
좋아요	”Anna님이 회원님의 사진을 좋아합니다.”
댓글	”Leo님이 답장했습니다: ‘멋져 보이네요!’”
멘션	”Sara님이 댓글에서 회원님을 언급했습니다.”
태그	”James님이 게시물에 회원님을 태그했습니다.”
팔로우	”Maya님이 회원님을 팔로우하기 시작했습니다.”
초대	”Ben님이 이벤트에 회원님을 초대했습니다.”
공유	”Alex님이 ‘하와이 앨범’을 회원님과 공유했습니다.”

설정

백엔드에서 활동 감지

소셜 활동이 발생하면 백엔드에서 발신자와 수신자, 그리고 게시물 ID나 콘텐츠 같은 관련 컨텍스트를 식별합니다:

JSON

{
  "action": "like",
  "sender_id": "user_b",
  "sender_name": "Anna",
  "sender_avatar": "https://cdn.yourapp.com/avatars/anna.jpg",
  "recipient_id": "user_a",
  "post_id": "xyz789",
  "post_title": "My Hawaii trip"
}

푸시 템플릿 생성

대시보드에서 Messages > Templates > New Push Template로 이동하세요. Liquid 구문을 사용하여 custom_data 필드를 참조합니다:제목:

Liquid

{{ message.custom_data.sender_name | default: "Someone" }}

메시지:

Liquid

{{ message.custom_data.sender_name | default: "Someone" }} liked your post "{{ message.custom_data.post_title | default: "your post" }}".

이미지(선택 사항, 발신자의 아바타 표시):

Liquid

{{ message.custom_data.sender_avatar }}

템플릿을 저장하고 template_id를 기록해 두세요.

Create Message API 호출

백엔드에서 수신자에게 알림을 전송합니다:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_a"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "sender_avatar": "https://cdn.yourapp.com/avatars/anna.jpg",
    "post_title": "My Hawaii trip",
    "post_id": "xyz789"
  },
  "url": "yourapp://posts/xyz789"
}

OneSignal은 custom_data 값을 사용하여 전송 시점에 템플릿을 렌더링합니다. 발신자의 이름과 아바타는 OneSignal에 저장되지 않고 알림에 표시됩니다.

선택 사항: 이메일 및 SMS 대체 수단 추가

푸시가 비활성화되어 있거나 알림이 전달되지 않은 사용자에게 도달하려면 아래의 이메일 및 SMS 대체 수단을 참조하세요.

필드가 누락되어도 메시지가 자연스럽게 읽히도록 모든 Liquid 자리 표시자에 | default: 필터를 사용하세요. 예: {{ message.custom_data.sender_name | default: "Someone" }}. 더 많은 필터는 Liquid 구문 사용을 참조하세요.

아바타 및 이미지 URL 요구 사항. sender_avatar URL(및 기타 알림 이미지)은 다음을 충족해야 합니다:

HTTPS — iOS는 HTTP URL을 거부합니다.
공개적으로 접근 가능 — APNs와 FCM은 인증된 요청을 보낼 수 없습니다.
~1MB 미만 — iOS 제한은 10MB이지만 실질적인 전달 시간을 고려하면 더 작은 자산이 유리합니다.
올바른 Content-Type 헤더로 제공 — image/jpeg, image/png 등.

캐시 헤더가 설정된 CDN에서 호스팅하는 것이 가장 안전한 설정입니다.

대량 활동 제한

바이럴 게시물은 초당 수천 건의 like 이벤트를 생성할 수 있습니다. 각 이벤트마다 푸시를 보내지 마세요. 이는 수신자를 알림으로 넘치게 하고 앱이 음소거되거나 삭제되는 원인이 됩니다. 패턴은 다음과 같습니다:

백엔드에서 수를 누적합니다(예: 수신자 + 게시물을 키로 하는 Redis 카운터).
잠잠한 기간(10분이 합리적인 기본값)이 지나면 단일 요약 푸시를 전송합니다: “12명이 회원님의 게시물을 좋아합니다.”
요약 후 좋아요가 더 도착하면 새로운 기간을 시작하세요. 즉시 다시 푸시하지 마세요.

동일한 로직이 댓글, 팔로우, 반응에도 적용됩니다. 백엔드에서 디바운스할 수 없는 경우 OneSignal 측 속도 제한은 제한을 참조하세요.

다이렉트(사용자 간) 메시지

사용자가 새 다이렉트 메시지를 받았을 때 알리고 대화로 바로 딥 링크하세요.

수신자가 채팅에 적극적으로 있지 않을 때만 푸시를 보내세요. 이미 대화를 읽고 있는 사람에게 알림을 보내면 좋지 않은 경험이 됩니다. 알림을 트리거하기 전에 앱 자체 로직을 사용하여 수신자가 현재 활동 중인지 확인하세요. OneSignal은 사용자가 현재 앱을 사용 중인지 추적하지 않습니다.

설정

메시지 전송 감지 및 활동 확인

사용자 A가 사용자 B에게 메시지를 보낼 때 사용자 B가 현재 해당 대화에서 활동 중인지 확인합니다. 사용자 B가 오프라인이거나 대화에 있지 않으면 푸시 전송을 진행합니다.

메시지당 하나의 푸시 전송 방지

사용자 A가 여러 메시지를 연속으로 보내는 경우 마지막 메시지 후 짧은 시간을 기다렸다가 알림을 트리거하세요. 백엔드에서 다음과 같이 구현합니다:

첫 번째 메시지가 도착하면 타이머(예: 60초)를 시작합니다.
타이머가 끝나기 전에 다른 메시지가 도착하면 타이머를 재설정합니다.
새 메시지 없이 타이머가 끝나면 읽지 않은 메시지 수를 요약한 단일 푸시를 전송합니다.

OneSignal은 여러 API 호출을 자동으로 통합하지 않으므로 API를 다섯 번 호출하면 다섯 개의 알림이 전송됩니다.

푸시 알림 전송

대화로 연결되는 딥 링크와 함께 사용자 B에게 푸시를 전송합니다:

JSON

{
  "app_id": "YOUR_APP_ID",
  "headings": { "en": "New message" },
  "contents": { "en": "Anna: 'Hey, you around?'" },
  "include_aliases": {
    "external_id": ["user_b_id"]
  },
  "url": "yourapp://chat/chat_1234",
  "data": {
    "click_action": "open_chat",
    "conversation_id": "chat_1234",
    "sender_id": "user_a_id"
  }
}

앱은 알림이 열릴 때 data.conversation_id를 읽고 올바른 화면으로 이동합니다. 플랫폼별 설정은 딥 링킹을 참조하세요.

선택 사항: 이메일 및 SMS 대체 수단 추가

푸시가 비활성화되어 있거나 알림이 전달되지 않은 사용자에게 도달하려면 아래의 이메일 및 SMS 대체 수단을 참조하세요.

대화별로 알림을 네이티브하게 그룹화하세요. 백엔드 디바운싱은 발송되는 알림의 개수를 줄이지만 iOS와 Android는 여러 알림을 단일 스레드로 시각적으로 접을 수도 있습니다. 스레드 또는 collapse 식별자(예: conversation_id)를 설정하여 OS가 동일한 채팅의 메시지를 그룹화하도록 하세요. 알림 그룹화를 참조하세요.

새 메시지마다 배지 수를 업데이트하세요. 대부분의 채팅 앱은 iOS/Android 배지가 모든 대화의 총 읽지 않은 메시지 수를 반영하기를 원합니다. 사용자가 하나의 알림을 지웠지만 다른 알림이 남아 있는 경우에도 배지가 정확하게 유지되도록 각 푸시마다 API를 통해 읽지 않은 수를 전달하세요. 배지를 참조하세요.

잠금 화면 개인 정보 보호. iOS는 기본적으로 잠금 화면에 메시지 미리보기(“Anna: ‘Hey, you around?’”)를 포함한 알림 내용을 표시합니다. 민감한 콘텐츠(건강, 금융, 데이팅, 업무)를 다루는 메시징 앱의 경우 일반적인 미리보기(“Anna님의 새 메시지”)를 전송하고 사용자가 인앱 설정을 통해 전체 미리보기를 선택하도록 하는 것을 고려하세요.

게임: 경쟁 및 소셜 알림

경쟁 게임은 긴박감을 조성하는 시간에 민감한 알림의 이점을 누립니다. custom_data를 사용하여 이러한 알림이 구체적이고 개인적으로 느껴지도록 하세요. 공격자의 이름을 명시하거나 정확한 자원 수를 보여주는 알림은 일반적인 알림보다 훨씬 더 매력적입니다.

일반적인 경쟁 이벤트

이벤트	알림 예시
기지 공격	”마을이 공격받고 있습니다! Orca가 회원님의 기지를 습격하고 있습니다.”
도전	”DragonSlayer99님이 랭크 결투를 신청했습니다. 24시간 내에 응답하세요.”
리더보드	”상위 10위에서 밀려났습니다. Orca가 방금 8위로 회원님을 추월했습니다.”
길드 이벤트	”길드 전쟁이 30분 후에 시작됩니다. BladeClan이 회원님을 기다립니다!”
클랜 초대	”DragonSlayer99님이 BladeClan에 초대했습니다.”
자원 준비 완료	”부대 훈련이 완료되어 배치할 준비가 되었습니다.”

설정

게임 백엔드에서 게임 이벤트 감지

경쟁 이벤트가 발생하면 게임 백엔드에서 영향을 받는 플레이어를 식별하고 관련 컨텍스트를 수집합니다:

JSON

{
  "event": "base_attack",
  "attacker_id": "user_orca",
  "attacker_name": "Orca",
  "recipient_id": "user_dragon",
  "resources_at_risk": {
    "gold": 12400,
    "elixir": 8200
  }
}

푸시 템플릿 생성

대시보드에서 Liquid 참조가 포함된 Push Template을 생성합니다:제목:

Liquid

⚔️ Your village is under attack!

메시지:

Liquid

{{ message.custom_data.attacker_name | default: "An enemy" }} is raiding your base. You're at risk of losing {{ message.custom_data.gold | default: "0" }} gold and {{ message.custom_data.elixir | default: "0" }} elixir.

템플릿을 저장하고 template_id를 기록해 두세요.

알림 전송

게임 백엔드에서 Create Message API를 호출합니다:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "attacker_name": "Orca",
    "gold": "12400",
    "elixir": "8200"
  },
  "url": "yourgame://base/defend",
  "data": {
    "event": "base_attack",
    "attacker_id": "user_orca"
  }
}

url은 플레이어를 방어 화면으로 바로 딥 링크합니다. data 객체는 앱의 알림 핸들러에 컨텍스트를 전달하여 올바른 전투 상태를 로드할 수 있게 합니다.

선택 사항: 이메일 및 SMS 대체 수단 추가

푸시가 비활성화되어 있거나 알림이 전달되지 않은 플레이어에게 도달하려면 아래의 이메일 및 SMS 대체 수단을 참조하세요.

긴급하지 않은 알림은 방해 금지 시간을 존중하세요. 현지 시간 새벽 3시의 기지 공격 푸시는 잘 알려진 옵트아웃 요인입니다. 게임 알림을 두 단계로 나누세요:

시간이 중요한 알림(30분 후 시작되는 길드 전쟁, 지금 공격받고 있는 기지) — 현지 시간과 관계없이 즉시 전송합니다.
시간이 중요하지 않은 알림(부대 준비 완료, 일일 보상 수령 가능, 주간 요약) — 지능형 전달 또는 시간대별 사용자 지정 시간을 사용하여 플레이어의 현지 시간대에서 깨어 있는 시간에 도착하도록 하세요.

대부분의 게임 알림 옵트아웃은 첫 번째 범주가 너무 빈번해서가 아니라 두 번째 범주가 잘못된 시간에 전송되어 발생합니다.

진행 중인 이벤트에는 Live Activities를 고려하세요. iOS 16.1+에서 진행 중인 경기, 습격 또는 라이브 이벤트의 경우 잠금 화면과 Dynamic Island의 Live Activity가 동일한 컨텍스트를 업데이트하는 반복적인 푸시 알림보다 나은 경험인 경우가 많습니다. 라이브 상태(“23분 남음, 현재 4위”)에는 Live Activities를 사용하고 푸시는 마일스톤 또는 완료 순간을 위해 남겨 두세요.

더 많은 게임 알림 예시

리더보드 추월
길드 이벤트
도전 초대

템플릿 메시지:

Liquid

{{ message.custom_data.overtaker_name | default: "Another player" }} just passed you. You dropped from #{{ message.custom_data.previous_rank }} to #{{ message.custom_data.current_rank }} on the leaderboard.

API 요청:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "overtaker_name": "Orca",
    "previous_rank": "8",
    "current_rank": "9"
  },
  "url": "yourgame://leaderboard"
}

여러 external_id 값을 전달하여 모든 길드원에게 동시에 전송합니다. 각자 동일한 메시지를 받습니다.템플릿 메시지:

Liquid

Guild war alert! {{ message.custom_data.guild_name | default: "Your guild" }} clashes in {{ message.custom_data.minutes_until | default: "30" }} minutes. Get in position.

API 요청:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon", "user_orca", "user_shadow"]
  },
  "custom_data": {
    "guild_name": "BladeClan",
    "minutes_until": "30"
  },
  "url": "yourgame://guild/war"
}

템플릿 메시지:

Liquid

{{ message.custom_data.challenger_name | default: "A player" }} challenged you to a {{ message.custom_data.game_mode | default: "duel" }}. You have {{ message.custom_data.hours_to_respond | default: "24" }} hours to accept.

API 요청:

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "challenger_name": "DragonSlayer99",
    "game_mode": "ranked duel",
    "hours_to_respond": "24"
  },
  "url": "yourgame://challenges/incoming",
  "data": {
    "challenge_id": "chal_9876",
    "challenger_id": "user_dragonslayer99"
  }
}

이메일 및 SMS 대체 수단

푸시가 비활성화되어 있거나 알림이 전달되지 않은 사용자에게 도달하기 위해 모든 알림 유형에 이메일 또는 SMS 대체 수단을 추가하세요. View Message API를 사용하여 확인된 수신 또는 클릭 여부를 확인하세요. 지연 기간 내에 기록이 없으면 이메일 또는 SMS 템플릿과 동일한 custom_data 방식을 사용하여 후속 메시지를 전송하세요.

소셜 활동멘션과 직접 답글 같은 가치가 높은 활동에 가장 적합합니다.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_EMAIL_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_a"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "sender_avatar": "https://cdn.yourapp.com/avatars/anna.jpg",
    "action": "liked your post",
    "post_title": "My Hawaii trip",
    "post_url": "https://yourapp.com/posts/xyz789"
  }
}

이메일 템플릿 예시(제목):

Liquid

{{ message.custom_data.sender_name | default: "Someone" }} {{ message.custom_data.action | default: "interacted with your post" }}

다이렉트 메시지메시지별 알림보다는 읽지 않은 대화의 일일 요약으로 가장 적합합니다.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_EMAIL_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_b_id"]
  },
  "custom_data": {
    "unread_count": "3",
    "conversations": [
      { "sender_name": "Anna", "preview": "Hey, you around?", "url": "https://yourapp.com/chat/chat_1234" },
      { "sender_name": "Leo", "preview": "Did you see this?", "url": "https://yourapp.com/chat/chat_5678" }
    ]
  }
}

이메일 템플릿 예시(제목):

Liquid

You have {{ message.custom_data.unread_count | default: "new" }} unread message{% if message.custom_data.unread_count != "1" %}s{% endif %}

이메일 템플릿 예시(본문, conversations 배열 반복):

Liquid

<h2>You have {{ message.custom_data.unread_count }} unread messages</h2>
<ul>
  {% for conversation in message.custom_data.conversations %}
    <li>
      <strong>{{ conversation.sender_name }}:</strong>
      "{{ conversation.preview }}"
      <a href="{{ conversation.url }}">Open</a>
    </li>
  {% endfor %}
</ul>

중첩된 객체 및 조건부 렌더링을 포함한 전체 배열 반복 참조는 API custom_data로 메시지 개인화를 참조하세요.게임주간 리더보드 요약, 길드 전쟁 결과, 마일스톤 달성과 같은 긴급하지 않은 요약에 가장 적합합니다.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_EMAIL_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "player_name": "DragonSlayer99",
    "rank": "7",
    "rank_change": "+3",
    "top_players": [
      { "name": "Orca", "score": "48200" },
      { "name": "Shadow", "score": "45100" },
      { "name": "DragonSlayer99", "score": "43800" }
    ],
    "summary_url": "https://yourgame.com/rankings/weekly"
  }
}

이메일 템플릿 예시(제목):

Liquid

Your weekly rankings: #{{ message.custom_data.rank }} ({{ message.custom_data.rank_change }} this week)

소셜 활동일상적인 좋아요나 팔로우가 아닌 멘션과 직접 답글 같은 중요도가 높은 활동에 가장 적합합니다.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_SMS_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_a"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "post_title": "My Hawaii trip",
    "post_url": "https://yourapp.com/posts/xyz789"
  }
}

SMS 템플릿 예시:

Liquid

{{ message.custom_data.sender_name | default: "Someone" }} mentioned you in "{{ message.custom_data.post_title | default: "a post" }}". Tap to reply: {{ message.custom_data.post_url }}

다이렉트 메시지대량 메시지 시퀀스보다는 개별 부재중 메시지에 가장 적합합니다.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_SMS_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_b_id"]
  },
  "custom_data": {
    "sender_name": "Anna",
    "message_preview": "Hey, you around?",
    "conversation_url": "https://yourapp.com/chat/chat_1234"
  }
}

SMS 템플릿 예시:

Liquid

New message from {{ message.custom_data.sender_name | default: "a user" }}: "{{ message.custom_data.message_preview }}". Reply in the app: {{ message.custom_data.conversation_url }}

게임플레이어가 즉시 행동해야 하는 기지 공격과 같은 시간이 중요한 이벤트에 가장 적합합니다.

JSON

{
  "app_id": "YOUR_APP_ID",
  "template_id": "YOUR_SMS_TEMPLATE_ID",
  "include_aliases": {
    "external_id": ["user_dragon"]
  },
  "custom_data": {
    "attacker_name": "Orca",
    "gold": "12400",
    "game_url": "https://yourgame.com/base/defend"
  }
}

SMS 템플릿 예시:

Liquid

⚔️ ATTACK! {{ message.custom_data.attacker_name | default: "An enemy" }} is raiding your base. {{ message.custom_data.gold | default: "0" }} gold at risk. Defend now: {{ message.custom_data.game_url }}

사용자가 대체 수단 기본 설정을 제어할 수 있도록 하세요. “메시지를 놓치면 SMS로 알림 받기”와 같은 옵트인은 의도적으로 푸시를 비활성화한 사용자에게 원치 않는 메시지가 전송되는 것을 방지하는 데 도움이 됩니다.

FAQ

OneSignal은 채팅 앱처럼 실시간으로 알림을 보낼 수 있나요?

아니요. 푸시 알림은 Apple(APNs) 및 Google(FCM) 인프라를 통해 전달되므로 전달 시간이 가변적이며 전달이 보장되지 않습니다. 실시간 인앱 커뮤니케이션에는 앱의 기존 메시징 레이어를 사용하고 수신자가 앱에 적극적으로 있지 않을 때 대체 수단으로 OneSignal을 사용하세요.

이미 앱에 있는 사용자에게 알림이 가지 않도록 하려면 어떻게 해야 하나요?

OneSignal은 사용자가 현재 앱에서 활동 중인지 추적하지 않습니다. 알림을 트리거할지 여부는 자체 백엔드 로직으로 결정해야 합니다. 수신자가 오프라인이거나 해당 화면에 있지 않음을 확인한 경우에만 OneSignal API를 호출하세요.

빠른 메시지 시퀀스로 인한 다중 알림을 방지하려면 어떻게 해야 하나요?

알림을 보내기 전에 백엔드에 짧은 지연을 추가하세요. 첫 번째 메시지가 도착하면 타이머를 시작합니다. 타이머가 끝나기 전에 다른 메시지가 들어오면 재설정합니다. 타이머가 끝나면 읽지 않은 수와 함께 단일 푸시를 전송합니다. OneSignal은 여러 API 호출을 자동으로 통합하지 않으므로 API를 다섯 번 호출하면 다섯 개의 알림이 전송됩니다.

메시지 전송 후 `custom_data`가 사용자 프로필에 저장되나요?

아니요. custom_data는 일시적이며 API 요청 중에만 존재하고 전송 시점에 템플릿을 렌더링하는 데 사용됩니다. OneSignal에 저장되지 않으며 향후 메시지나 Journeys에서 재사용할 수 없습니다. 영구적인 사용자 데이터에는 태그를 사용하세요.

하나의 API 호출로 여러 수신자를 타겟팅할 수 있나요?

예. include_aliases 배열에 여러 external_id 값을 전달하세요. 각 수신자에게 서로 다른 개인화된 콘텐츠(예: 서로 다른 공격자 이름)가 필요한 경우 custom_data의 대량 개인화 패턴을 사용하세요. 전체 접근 방식은 API custom_data로 메시지 개인화를 참조하세요. 호출당 정확한 수신자 상한과 속도 제한은 Create Message API 참조에 문서화되어 있습니다. 매우 큰 대상의 경우 호출당 수천 개의 external_id 값을 전달하는 것보다 세그먼트 기반 타겟팅이 더 효율적입니다.

해외 사용자를 위해 메시지를 현지화해야 하나요?

여러 언어를 사용하는 대상이라면 예. headings 및 contents 필드는 여러 언어 코드(예: { "en": "...", "es": "...", "fr": "..." })를 허용하며 OneSignal은 각 구독의 언어에 따라 올바른 버전을 선택합니다. 동일한 패턴이 템플릿 필드에도 적용됩니다. 대체 언어 동작을 포함한 전체 참조는 다국어 메시징을 참조하세요.

API custom_data로 메시지 개인화

custom_data와 Liquid 구문을 사용하여 동적인 메시지별 데이터를 템플릿에 삽입합니다.

메시지 개인화

태그, 사용자 속성, 세분화를 포함한 OneSignal의 모든 개인화 옵션 개요.

딥 링킹

사용자가 알림을 탭할 때 앱의 특정 화면으로 라우팅합니다.

활동 피드 생성

OneSignal의 알림 인박스를 사용하여 앱 내에 소셜 알림 기록을 표시합니다.

템플릿

푸시, 이메일, SMS용 재사용 가능한 메시지 템플릿을 생성하고 관리합니다.

Create Message API

custom_data, 타겟팅 및 사용 가능한 모든 필드로 메시지를 전송하기 위한 전체 API 참조.

튜토리얼

🏢 산업별

📈 참여도 & 유지도 증가

🔔 중요 또는 시간 민감한 메시지 전달

🧠 타겟팅 & 개인화 강화

🛠️ 사용자 경험 & 온보딩 개선

소셜 활동

소셜 활동

다이렉트 메시지

게임 알림

사전 요구 사항

소셜 활동 알림

일반적인 소셜 활동

설정

대량 활동 제한

다이렉트(사용자 간) 메시지

설정

게임: 경쟁 및 소셜 알림

일반적인 경쟁 이벤트

설정

더 많은 게임 알림 예시

이메일 및 SMS 대체 수단

FAQ

OneSignal은 채팅 앱처럼 실시간으로 알림을 보낼 수 있나요?

이미 앱에 있는 사용자에게 알림이 가지 않도록 하려면 어떻게 해야 하나요?

빠른 메시지 시퀀스로 인한 다중 알림을 방지하려면 어떻게 해야 하나요?

메시지 전송 후 `custom_data`가 사용자 프로필에 저장되나요?

하나의 API 호출로 여러 수신자를 타겟팅할 수 있나요?

해외 사용자를 위해 메시지를 현지화해야 하나요?

관련 페이지

API custom_data로 메시지 개인화

메시지 개인화

딥 링킹

활동 피드 생성

템플릿

Create Message API

소셜 활동

다이렉트 메시지

게임 알림

​사전 요구 사항

​소셜 활동 알림

​일반적인 소셜 활동

​설정

​대량 활동 제한

​다이렉트(사용자 간) 메시지

​설정

​게임: 경쟁 및 소셜 알림

​일반적인 경쟁 이벤트

​설정

​더 많은 게임 알림 예시

​이메일 및 SMS 대체 수단

​FAQ

​OneSignal은 채팅 앱처럼 실시간으로 알림을 보낼 수 있나요?

​이미 앱에 있는 사용자에게 알림이 가지 않도록 하려면 어떻게 해야 하나요?

​빠른 메시지 시퀀스로 인한 다중 알림을 방지하려면 어떻게 해야 하나요?

​메시지 전송 후 custom_data가 사용자 프로필에 저장되나요?

​하나의 API 호출로 여러 수신자를 타겟팅할 수 있나요?

​해외 사용자를 위해 메시지를 현지화해야 하나요?

​관련 페이지

API custom_data로 메시지 개인화

메시지 개인화

딥 링킹

활동 피드 생성

템플릿

Create Message API

사전 요구 사항

소셜 활동 알림

일반적인 소셜 활동

설정

대량 활동 제한

다이렉트(사용자 간) 메시지

설정

게임: 경쟁 및 소셜 알림

일반적인 경쟁 이벤트

설정

더 많은 게임 알림 예시

이메일 및 SMS 대체 수단

FAQ

OneSignal은 채팅 앱처럼 실시간으로 알림을 보낼 수 있나요?

이미 앱에 있는 사용자에게 알림이 가지 않도록 하려면 어떻게 해야 하나요?

빠른 메시지 시퀀스로 인한 다중 알림을 방지하려면 어떻게 해야 하나요?

메시지 전송 후 `custom_data`가 사용자 프로필에 저장되나요?

하나의 API 호출로 여러 수신자를 타겟팅할 수 있나요?

해외 사용자를 위해 메시지를 현지화해야 하나요?

관련 페이지