태그에는 특정 사용자 또는 기기와 관련된 모든 임의의 데이터를 포함할 수 있습니다. 이 데이터에는 사용자 이름, ID, 도시, 좋아하는 축구팀, 선호하는 뉴스 카테고리 또는 사용자에 대한 기타 관련 정보가 포함될 수 있습니다.

어떤 태그를 사용할지 결정하기

먼저 비즈니스 요구 사항을 파악하고 잠재고객을 어떻게 세분화할지 결정하는 것부터 시작하세요. 연령, 위치, 인앱 구매 내역 또는 사용자를 타겟팅하기 위한 기타 관련 기준과 같은 요소를 고려하세요.

태그 값

태그 값을 사용하면 푸시 캠페인을 더 스마트하게 만들 수 있습니다. 각 태그는 _거의 무한한 수의 값_을 저장할 수 있습니다. 기본적으로 이는 하나의 태그만으로도 데이터베이스에 있는 각 최종 사용자에 대한 특정 유형의 정보를 기록하기에 충분하다는 것을 의미합니다.

태그 유형

정수(Integer) — 정수 데이터(게임 내에서 획득한 현금, 달성한 레벨, 나이)에 사용됩니다.
문자열(String) — 문자열 값(사용자 이름, 이메일, 식별자)에 사용됩니다.
목록(List) — 문자열 유형과 동일하지만 각 사용자는 동시에 여러 값을 설정할 수 있습니다(음악 선호도, 뉴스 카테고리, 요리 선호도).
불리언(Boolean) — 참/거짓 유형의 태그입니다.
날짜(Date) — 달력 날짜에 사용됩니다. 기본적으로 이것은 Unix Epoch 타임스탬프를 저장하는 정수 유형 태그입니다(그레고리력 날짜에서/로 자동 변환됨).
가격(Price) — “*.XX” 형식으로 지정된 통화에 따라 값을 설정할 수 있습니다 자세히 알아보기.
버전(Version) — 버전 관리에 사용됩니다. 허용되는 형식의 예는 w.x.y.z (Major.Minor.Patch.Build)입니다. 각 버전 부분의 최대값은 9999이므로 최대 버전 번호는 9999.9999.9999.9999보다 클 수 없습니다.

태그 연산자

각 태그 유형에는 적용 가능한 특정 연산자 집합이 있습니다. 태그 연산자는 세분화 목적으로 태그와 해당 값 간의 관계를 정의합니다.

정수 태그 연산자: is, is not, are, not in, not set, any
문자열 태그 연산자: is, is not, are, not in, not set, any
목록 태그 연산자: in, not in, not set, any
불리언 태그 연산자: is (true/false), not set, any
날짜 태그 연산자: exactly on, on or after, on or before, between, not set, any
가격 태그 연산자: is, is not, greater or equals, less or equals, between, in, not in, not set, any
버전 태그 연산자: is, is not, greater or equals, less or equals, between, in, not in, not set, any

태그 범위: 일반 대 사용자별

태그를 생성할 때 값이 저장되는 방식을 선택합니다:

General (user_specific: false, /addTag의 기본값): 태그 값은 기기(HWID)별로 저장됩니다. 동일한 사용자의 각 기기는 독립적으로 다른 값을 가질 수 있습니다.
User-specific (user_specific: true, 제어판 양식 및 setTags로 자동 생성되는 태그의 기본값): 태그 값은 사용자(UserID)별로 저장됩니다. UserID를 통해 설정하면 해당 값은 사용자의 모든 기기에 한 번에 적용됩니다. 구독 등급, 로열티 포인트, 선호 언어와 같이 특정 기기가 아닌 개인에게 속하는 속성에 유용합니다.

예시

한 사용자가 앱의 iOS 및 Android 버전을 모두 설치했습니다. UserID를 통해 subscription_tier 태그를 "premium"으로 설정하면 두 기기에 즉시 적용됩니다. General 태그를 사용하면 기기별로 별도로 설정해야 합니다.

{
   "request":{
      "application": "XXXXX-XXXXX",
      "userId": "the id of a specific user",
      "tags": {
           "subscription_tier": "premium",
           "loyalty_points": 350
      }
   }
}

기본 태그

이러한 태그는 Pushwoosh에서 기본적으로 제공되므로 수동으로 설정할 필요가 없습니다(실제로 설정해서는 안 됩니다). 대부분은 애플리케이션에서 설정되어 registerDevice 및 기타 API 호출을 통해 서버로 전송되며 일부는 서버 자체에서 설정됩니다. SMS Marketing Consent 및 Viber Marketing Consent는 예외입니다. 사용자가 마케팅 메시지 수신에 동의하거나 거부하면 개발자가 setTags로 이 태그를 설정합니다.

이름	유형	설정 위치	설명
Application Version	Version	SDK	기기에 설치된 앱의 현재 버전
Browser Type	String	SDK	기기가 웹 프로젝트에 등록되면 모바일 또는 데스크톱 유형이 자동으로 추적됩니다.
City	String	Server	기기의 최신 등록된 지리적 위치
Country	String	Server	기기의 최신 등록된 지리적 위치
Device Model	String	SDK	앱이 설치된 기기 모델을 나타냅니다.
First Install	Date	Server	기기가 처음으로 알림에 등록된 시간을 나타냅니다.
In-app Product	List	SDK	앱 사용자가 구매한 인앱 제품
Last In-app Purchase date	Date	SDK	기기에서 이루어진 최신 인앱 구매 날짜
Language	String	SDK	ISO-639-1에 따른 기기 로케일의 두 글자 소문자 약어, 기기 설정에서 가져옴
Last Application Open	Date	Server	기기에서 가장 최근에 앱을 실행한 시간
Last Email Open	Date	Server	기기의 이메일 주소가 가장 최근에 이메일 열람 이벤트를 등록한 날짜
Last Email Open Message Code	String	Server	메시지 코드가 가장 최근에 열린 이메일의 코드(형식 `XXXX-XXXXXXXX-XXXXXXXX`). 각 `PW_EmailOpen` 이벤트에서 업데이트됩니다. 특정 이메일 캠페인의 수신자를 열람한 사람별로 세분화하는 데 사용하세요.
Last Email Click	Date	Server	기기의 이메일 주소가 가장 최근에 이메일 링크 클릭을 등록한 날짜
Last Email Click Message Code	String	Server	메시지 코드가 가장 최근에 링크가 클릭된 이메일의 코드(형식 `XXXX-XXXXXXXX-XXXXXXXX`). 각 `PW_EmailLinkClicked` 이벤트에서 업데이트됩니다. 특정 이메일 캠페인의 수신자를 클릭한 사람별로 세분화하는 데 사용하세요.
Last Email Confirm	Date	Server	기기의 이메일 주소에 대한 가장 최근의 이중 옵트인 구독 확인 날짜
Bounced Email	Date	Server	이 이메일 주소에 하드 바운스가 발생한 날짜. 예를 들어 최근 바운스가 있는 사용자를 제외하는 등 시간 기반 세분화를 활성화하기 위해 날짜로 저장됩니다.
Unsubscribed Emails	Boolean	SDK	사용자가 앱에서 이메일 수신을 거부했는지 여부를 나타냅니다.
SMS Marketing Consent	Boolean	Server, setTags	SMS 구독자가 마케팅 SMS 수신에 동의했는지 여부: `true`는 동의, `false`는 수신 거부, 값 없음은 알 수 없음. 자세히 알아보기
Viber Marketing Consent	Boolean	Server, setTags	Viber 구독자가 Viber 마케팅 메시지 수신에 동의했는지 여부: `true`는 동의, `false`는 수신 거부, 값 없음은 알 수 없음. 자세히 알아보기
OS Version	Version	SDK	기기에서 실행 중인 운영 체제 버전
Platform	String	SDK	사용자가 프로젝트를 사용하고 있는 플랫폼입니다.
Push Alerts Enabled	Boolean	SDK	기기 설정에서 푸시 알림이 허용되는지 여부를 나타냅니다.
SDK Version	Version	SDK	기기에 구현된 Pushwoosh SDK의 버전
Live Activity ID	List	SDK	Live Activity ID를 기기와 연결하여 라이브 액티비티를 관리하는 데 사용됩니다. 12시간 후 자동으로 정리됩니다. 예약됨: 이 이름으로 사용자 지정 태그를 생성할 수 없습니다.
WhatsApp Session Expires At	Date	Server	고객의 마지막 수신 WhatsApp 메시지로 열린 현재 24시간 고객 서비스 창을 저장합니다. 수신 메시지마다 자동으로 설정됩니다. 예약됨: 이 이름으로 사용자 지정 태그를 생성할 수 없습니다. 현재 창만 저장하며 기록은 남기지 않습니다.
WhatsApp Ad Click ID	String	Server	수신 WhatsApp 메시지의 referral에 포함된 Click-to-WhatsApp 광고 클릭 ID(`ctwa_clid`). Meta는 대화를 시작하는 메시지에서 한 번만 이 값을 보냅니다. 더 최근의 클릭은 `WhatsApp Ad Click Date`와 함께 이 값을 덮어씁니다. 다시 전송되었거나 순서가 뒤바뀐 webhook은 이 값을 이전 값으로 되돌리지 않습니다.
WhatsApp Ad Click Date	Date	Server	`WhatsApp Ad Click ID`에 기록된 클릭 시간. 해당 태그와 함께 업데이트됩니다. 더 최근의 클릭이 이전 날짜를 덮어씁니다.

사용자 지정 태그

여기서 특정 비즈니스 목표를 달성하기 위해 창의력을 발휘할 수 있습니다. 사용자 지정 태그는 고유한 비즈니스 요구에 적합한 세분화 논리 또는 타겟팅 패턴을 기반으로 생성할 수 있습니다. 마케팅 팀과 협력하여 캠페인에 필요한 추가 사용자 지정 태그를 정의하세요.

사용자 지정 태그 설정 방법

태그를 미리 생성하는 것은 선택 사항입니다. setTags를 통해 새 태그 이름을 보내면 값에서 유추된 유형으로 자동 생성됩니다:

정수는 정수가 됩니다.
4.99처럼 소수 부분이 있는 숫자는 가격이 됩니다. 5.0 같은 숫자는 정수가 됩니다.
문자열은 문자열이 되며, 2024-10-02 22:11과 같은 인식된 날짜-시간 형식의 경우 날짜가 됩니다.
숫자, true 또는 false, JSON 배열을 담은 문자열은 내용에 따라 유형이 결정되므로 "42"는 문자열이 아닌 정수가 됩니다.
배열은 목록이 됩니다.
불리언은 불리언이 됩니다.

이벤트 속성은 문자열을 내용에 따라 해석하지 않으므로 이벤트로 보낸 "42"는 문자열이 됩니다. 자동으로 생성되는 이벤트를 참조하세요.

자동 생성된 태그는 항상 User-specific(user_specific: true)입니다. 자동 생성으로 유추할 수 없는 버전 태그나 General 태그의 경우 제어판 또는 /addTag를 통해 먼저 태그를 명시적으로 추가하세요.

태그 자동 생성은 대부분의 계정에서 기본적으로 활성화되어 있습니다. setTags가 예상대로 새 태그를 생성하지 않는 경우 Pushwoosh 지원팀에 문의하여 계정에 대해 이 기능이 비활성화되었는지 확인하세요.

Pushwoosh 제어판에서 새 태그를 추가하거나 /addTag 메서드를 사용할 수 있습니다.

addTag

POST https://api.pushwoosh.com/json/1.3/addTag

계정에 태그를 생성합니다.

요청 본문

이름	유형	설명
auth*	string	Pushwoosh 제어판의 API 액세스 토큰입니다.
tag*	object	태그 매개변수입니다.
tag.name*	string	태그 이름입니다.
tag.type*	integer	태그 유형. 아래에서 가능한 값을 참조하세요.
tag.user_specific	boolean	`true`인 경우 태그 값은 사용자 수준에 저장되며 UserID로 설정 시 사용자의 모든 기기에서 공유됩니다. `false`(기본값)인 경우 태그는 기기 수준이며 HWID별로 설정됩니다.

{
    "status_code": 200,
    "status_message": "OK",
    "response": {
        "result": true
    }
}

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // 필수, Pushwoosh 제어판의 API 액세스 토큰
    "tag": {
      "name": "TAG_NAME",    // 필수
      "type": 1,             // 필수, 아래에서 가능한 값을 참조하세요
      "user_specific": false // 선택 사항. true = 사용자 수준; false = 기기 수준(기본값)
    }
  }
}

가능한 태그 값 유형:

1 - 정수
2 - 문자열
3 - 목록
4 - 날짜
5 - 불리언
6 - 십진수. 예: 19.95
7 - 버전. 예: “1.0.0.0”

사용자로부터 정보 수집 방법

태그를 추가하고 구성하면 사용자로부터 정보를 수집할 준비가 된 것입니다. 다음 단계에 따라 구현하세요:

관련 통합 가이드에 따라 Pushwoosh SDK를 프로젝트에 통합하세요.
setTags 함수를 사용하여 태그를 할당하고 사용자 데이터를 수집하세요.

아래는 setTags 함수를 사용하는 다양한 프레임워크에 대한 구현 예시입니다.

iOS Native

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};

[[PushNotificationManager pushManager] setTags:tags];

문서

Android Native

pushwoosh.setTags(Tags.intTag("intTag", 42));

문서

Cordova

PushNotification.prototype.setTags = function(  config, success, fail  )

문서

Flutter

Future<void> setTags(Map tags) async {
  await _channel.invokeMethod("setTags", {"tags" : tags});
}

문서

React Native

pushNotification.setTags({
    "string_tag" : "Hello world",
    "int_tag" : 42,
    "list_tag":["hello", "world"]
});

문서

Unity

SetIntTag

기기에 정수 태그를 설정합니다.

public virtual void SetIntTag(string tagName, int tagValue)

SetStringTag

기기에 문자열 태그를 설정합니다.

public virtual void SetStringTag(string tagName, string tagValue)

SetListTag

기기에 목록 태그를 설정합니다.

public virtual void SetListTag(string tagName, List<object> tagValues)

문서

Unreal Engine

FPushwooshModule& pushwoosh = FPushwooshModule::Get();
pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");

문서

Expo

Pushwoosh.setTags({ "key": keyValue, "value": inputValue });

문서

.NET MAUI

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};
[[PushNotificationManager pushManager] setTags:tags];

문서

Outsystems

입력 매개변수 Tags – TagName과 TagValue를 포함하는 태그 레코드 목록입니다.

TagName은 항상 텍스트 유형이어야 합니다.
TagValue는 텍스트, 정수, 불리언, 날짜 등이 될 수 있습니다.

자세히 알아보기

API를 통한 태그 설정

대부분의 경우(99%) 태그는 애플리케이션에서 설정되지만 Pushwoosh API를 통해서도 태그를 설정할 수 있습니다. 아래는 /setTags 엔드포인트에 대한 일반적인 요청 예시입니다:

POST https://api.pushwoosh.com/json/1.3/setTags

{
   "request": {
      "application": "XXXXX-XXXXX", // 필수, Pushwoosh 애플리케이션 코드
      "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // 필수, /registerDevice API에서 사용되는 하드웨어 기기 ID
      "tags": { // 필수
           "StringTag": "string value", // 문자열 태그 예시
           "IntegerTag": 42, // 정수 태그 예시
           "ListTag": ["string1", "string2"], // 목록 태그 예시
           "DateTag": "2024-10-02 22:11", // 참고: 시간은 UTC여야 합니다
           "BooleanTag": true // 유효한 값: true, false
      }
   }
}

자세한 내용은 setTags API 문서를 참조하세요

기본 City 태그 사용하기

기기의 위치는 해당 기기에서 앱이 마지막으로 실행된 순간의 IP 주소를 기반으로 결정됩니다. GeoIP는 위치 데이터를 Pushwoosh에 제출하고, Pushwoosh는 GeoIP에서 받은 위치를 특정 기기의 City 태그 값으로 저장합니다.

경우에 따라 GeoIP에서 제출한 위치가 도시 이름과 다를 수 있습니다. 예를 들어, 도시의 한 지역이나 다른 행정 단위를 참조하는 경우입니다. 세분화 목적으로 기본 City 태그를 사용할 때는 주의하세요. 올바른 값을 선택해야 합니다.

예를 들어, 뮌헨의 사용자를 타겟팅하려는 경우, “Munich” 자체(GeoIP에서 반환되어 태그 값으로 저장될 수 있는 다양한 철자 변형과 같은 모든 해당 값 포함)와 여러 인근 지역을 포함하여 여러 City 태그 값으로 이를 포괄해야 합니다.