태그 API

참고

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

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 별로 설정됩니다.

200

{
  "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의 이름입니다.

200

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

예시

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

listTags

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

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

요청 본문

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

200

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

예시

{
  "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”