태그 API

HWID 및 UserID 에 대한 태그 값을 설정하려면 Device API 의 /setTags 메서드를 사용하세요. addTag 는 선택 사항입니다. setTags 는 아직 인식하지 못하는 태그 이름을 생성하고 값에서 유형을 추론하기 때문입니다. 정수는 Integer, 소수점이 있는 숫자는 Price, 문자열은 String (또는 2024-10-02 22:11 과 같이 인식되는 날짜-시간 형식의 경우 Date), 배열은 List, 불리언은 Boolean 이 됩니다. 자동 생성된 태그는 항상 User-specific 태그(user_specific: true)입니다. 자동 생성이 추론할 수 없는 Version 태그나 General 태그(user_specific: false)에는 addTag 를 사용하세요. 태그 자동 생성은 대부분의 계정에서 기본적으로 활성화되어 있습니다. setTags 가 예상대로 새 태그를 생성하지 않는 경우, Pushwoosh 지원팀에 문의하여 계정에서 해당 기능이 비활성화되었는지 확인하세요.

주문이나 주문 목록과 같은 구조화된 데이터를 하나의 태그에 저장하려면 객체 태그(베타)를 사용하세요. addTag 는 필드를 받지 않으므로 객체 태그를 생성할 수 없습니다.

addTag

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

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

요청 본문

이름	유형	설명
auth*	string	Pushwoosh Control Panel 의 API access token 입니다.
tag*	object	태그 매개변수입니다.
tag.name*	string	태그 이름입니다.
tag.type*	integer	태그 유형입니다. 아래에서 가능한 값을 참조하세요.
tag.user_specific	boolean	`true` 이면 태그 값은 사용자 수준에 저장되며 UserID 로 설정 시 사용자의 모든 기기에서 공유됩니다. `false` (기본값)이면 태그는 기기 수준이며 HWID 별로 설정됩니다.
tag.application_specific	boolean	더 이상 사용되지 않습니다. 태그가 더 이상 애플리케이션별 태그와 계정 전체 태그로 나뉘지 않으므로 전달해도 무시됩니다. 전달하지 않아도 됩니다.

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

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // 필수. Pushwoosh Control Panel의 API access token
    "tag": {
      "name": "TAG_NAME",           // 필수.
      "type": 1,                    // 필수. 아래에서 가능한 값을 참조하세요
      "user_specific": false        // 선택. true = 사용자 수준 태그(모든 기기에서 공유); false = 기기 수준 태그(기본값)
    }
  }
}

가능한 태그 값 유형:

1 - Integer
2 - String
3 - List
4 - Date
5 - Boolean
6 - Decimal. 예: 19.95
7 - Version. 예: “1.0.0.0”

deleteTag

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

데이터베이스에서 모든 관련 정보와 함께 태그를 완전히 제거합니다.

요청 본문

이름	유형	설명
auth*	string	Pushwoosh Control Panel 의 API access token 입니다.
tag*	object	태그 매개변수입니다.
tag.name*	string	삭제할 tag의 이름입니다.

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

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // 필수. Pushwoosh Control Panel의 API access token
    "tag": {
      "name": "TAG_NAME"            // 필수. 삭제할 태그의 이름
    }
  }
}

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

계정의 태그 목록을 검색합니다.

요청 본문

이름	유형	설명
auth*	string	Pushwoosh Control Panel 의 API access token 입니다.

{
  "status_code": 200,
  "status_message": "OK",
  "response": {
    "tags": [{
      "name":"Language",
      "type":2,
      "isUserSpecific":true,
      "isApplicationSpecific":true
    }, {
      "name":"List tag",
      "type":3,
      "isUserSpecific":false,
      "isApplicationSpecific":true
    }]
  }
}

isUserSpecific은 태그가 User-specific인지 나타냅니다. 태그가 더 이상 애플리케이션별 태그와 계정 전체 태그로 나뉘지 않으므로 isApplicationSpecific은 항상 true이며 하위 호환성을 위해서만 유지됩니다. 이 필드에 의존하지 마세요.

{
  "request":{
    "auth": "yxoPUlwqm…………pIyEX4H" // Pushwoosh Control Panel의 API access token
  }
}

태그 유형:

1 - Integer
2 - String
3 - List
4 - Date
5 - Boolean
6 - Decimal. 예: 19.95
7 - Version. 예: “1.0.0.0”