앱 마케터인 귀사는 다음의 일로 바쁩니다:

• 2개의 게임 앱(game_a와 game_b)을 유지 관리합니다.
• 게임_c 출시
• 다음 사용자 속성을 활용하여 현재 앱 사용자를 타겟팅합니다:
  • 좋아하는 스포츠: 크리켓
  • 현재 게임 점수: 현재 게임 중 하나에서 15점 이상

이 표는 귀사의 CRM에서 가져온 사용자 속성 데이터를 포함하고 있습니다. 오디언스 규칙 세트는 이 데이터에 액세스해야 합니다. 

규칙 세트에서 CRM 데이터 사용

오디언스에서 사용자 속성(좋아하는 스포츠와 게임 점수)을 생성합니다. 이를 통해 규칙 세트가 CRM 데이터에 액세스할 수 있게 됩니다. 

시나리오 사용자 속성

이름	형식	수준
게임 점수	숫자: 'ScoreGameB는 29보다 큽니다'와 같은 규칙을 설정할 수 있습니다.	앱 수준: 사용자의 점수는 각 게임마다 기록됩니다. 의미: ScoreGameA, ScoreGameB.
좋아하는 스포츠	문자열: '가장 좋아하는 스포츠가 테니스인 사용자를 대상으로' 규칙을 설정할 수 있습니다. 주의! 값은 대소문자를 구분합니다.	계정 수준: 앱에 상관없이 유저가 가장 좋아하는 스포츠는 같습니다. 주의! 유저는 계정 수준 속성과 연결된 값을 하나만 가질 수 있습니다.

규칙 세트의 유저 속성

유저 속성은 오디언스 규칙 세트에서 필터로 작용합니다. 이 예시는 마케터가 설정한 기준(좋아하는 스포츠와 게임 점수)을 사용합니다. 

alt유저속성예.jpgalt

필수 조건:

앱 수준 속성을 관리하려면 계정 유저가 앱 권한을 가지고 있어야 합니다. 

유저 속성을 설정하려면 다음을 따르세요:

1. 유저 속성을 추가합니다.

2. 다음 중 하나를 수행하세요.

   • CSV로 유저 속성 데이터를 가져옵니다.

   • API로 유저 속성 데이터를 가져옵니다.

3. 규칙 세트에 유저 속성을 구현합니다.

유저 속성을 추가하려면:

1. 앱스플라이어의 사이드 메뉴에서 (유저를 앱에) 참여시키다 > 오디언스를 선택합니다.
2. 유저 속성 탭을 클릭합니다.
3. 클릭 사용자 속성 추가.
   

   

4. 필드를 채우세요. 현재 특성은 다음 표에서 확인할 수 있습니다. 
   
   • 속성 이름
   • 형식
   • 수준
5. 저장을 클릭하세요.

유저 속성 필드

필드	특성
속성 이름	영문자만 사용 가능 구두점이나 특수문자 사용 불가 같은 이름은 앱 수준과 계정 수준에서 모두 사용할 수 없습니다. 동일한 이름 을 앱 수준에서 사용할 수 있습니다. 예를 들어 위 시나리오에서는 ScoreGameA와 ScoreGameB가 있습니다.
형식	텍스트: 속성 값이 지정된 규칙 값과 같거나 같지 않은지를 시험합니다. 예: 크리켓인가 아닌가. 숫자: 속성 값이 지정된 규칙 값보다 큰지, 작은지, 혹은 같은지를 시험합니다. 예: 점수가 15보다 큼
수준	계정 수준: 속성이 앱과 관련이 없습니다. 예시: 성별, 좋아하는 스포츠 앱 수준: 속성이 앱과 관련이 있습니다. 속성과 연결된 앱을 선택하세요.

유저 속성을 관리하려면 오디언스 > 유저 속성 탭으로 이동하세요.

alt오디언스유저속성_us-en.pngalt

유저 속성 관리

기능	설명
검색 및 필터	속성 이름, 앱 이름, 속성 수준별로.
정렬 기준	표 행을 정렬하려면 열 머리글을 클릭하세요.
데이터 가져오기	CSV로 데이터 가져오기 API로 데이터 가져오기
API 가져오기 키 변경	API 가져오기 키를 변경하려면: 데이터 가져오기를 클릭합니다. API를 선택하세요. 가져오기 키y 새로고침을 클릭합니다.  참고! 스크립트에 내장된 키가 있는 경우 새 키로 업데이트하세요.

어드민 유저만 속성을 삭제할 수 있습니다.

규칙 세트에 있는 속성을 삭제하려면:

1. 규칙 세트에서 속성을 제거합니다.
2. 속성을 삭제합니다.

유저 속성 필드 목록

필드	콘텐츠	형식	데이터 추가 CSV로	CSV로 데이터 제거
device_id	다음 유저 ID 중 하나를 포함합니다: IDFA GAID	텍스트	device_id 또는 customer_id는 필수입니다.	device_id 또는 customer_id는 필수입니다.   기존 데이터를 제거하려면 발송하지 마세요.
customer_id	고객 유저 ID	텍스트	device_id 또는 customer_id는 필수입니다.	device_id 또는 customer_id는 필수입니다.   기존 데이터를 제거하려면 발송하지 마세요.
app_id	앱 수준 속성: 대시보드에 표시되는 앱 ID입니다. iOS 앱의 경우 접두사 ID를 포함합니다.  계정 수준 속성: 항상 *로 채워주세요	텍스트	필수	필수
속성_키	유저 속성 이름은 유저 속성 탭에 표시되는 이름과 정확히 같습니다.	텍스트	필수	필수
속성값	할당된 값 *제한 사항 참조	텍스트 또는 숫자	필수	발송하지 마세요

유저 속성 데이터는 CSV 파일을 통해 추가되거나 제거됩니다. 다음 그림과 CSV 파일 예시는 이 문서에서 설명하는 기능과 일치합니다.

유저 속성 예제.csv

CSV 파일 요구 사항

• 헤더 행이 없습니다.
• 이전 표에 나열된 모든 열을 포함합니다. 

CSV 파일을 가져오려면:

1. 오디언스 > 유저 속성 탭으로 이동합니다.
2. 데이터 가져오기를 클릭합니다.
3. CSV를 선택하세요.
4. 중 하나를 선택하세요:
   • 데이터 추가
   • 데이터 제거
5. 가져올 CSV 파일을 선택하세요. 
6. 업로드를 클릭하면 업로드 상태 메시지가 나타납니다.

참고: 유저 속성을 가져올 때 고객 ID와 연결된 모든 디바이스에도 해당 속성이 할당됩니다. 예를 들어, 유저가 "게임 점수" 속성을 customer_id로 10개의 디바이스에 가져왔고, customer_id 중 하나가 2개의 디바이스(즉, 동일한 CUID를 가진 2개의 GAID)와 연결된 경우, 이 가져오기에는 11개의 유저 속성 레코드가 포함됩니다.

 

이 가져오기 메서드에는 요청 URL과 유저 속성 데이터가 포함된 JSON이 필요합니다.

1. 대시보드에서 준비된 API 요청 및 JSON 템플릿을 가져옵니다.
2. 필드 사양에 따라 JSON 템플릿에 귀사의 데이터를 채웁니다. 

API 요청 URL과 JSON 템플릿을 생성하려면:

1. 데이터 가져오기를 클릭합니다.
2. API를 선택하세요.
3. 작업을 선택하세요:
   
   • 유저 속성 업데이트: 덮어쓰거나 추가합니다.
   • 유저 속성을 제거합니다.
   • 유저 데이터 제거: 특정 유저와 관련된 모든 데이터를 삭제합니다. 유저는 앱스플라이어 ID로 식별됩니다.
   • 앱 데이터 제거: 앱 수준의 모든 데이터를 제거합니다. 
4. 발생한 API 요청 URL을 복사합니다.
5. 발생한 API 요청 본문을 복사합니다.
6. 지정된 JSON 형식으로 JSON(유저 속성 데이터 포함)을 준비합니다. 계정 수준 속성의 경우 "app_ids"를 ["*"]로 설정합니다.
7. URL과 요청 본문을 기준으로 API 호출을 준비합니다.
8. 요청을 프로그래밍 방식으로 발송합니다.

예시 요청 및 JSON

https://hq1.appsflyer.com/api/user-attributes-import-api/set-user-data
{
  "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
  "attributes_values": [
    {
      "device_id": "",
      "customer_id": "",
      "app_ids": [],
      "attributes": [
        {
          "attribute_key": "",
          "attribute_value": ""
        }
      ]
    }
  ]
}

여러 디바이스 ID, 속성 키 및 속성 값이 포함된 예시

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "2222222",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 5
                }
                ,
                {
                    "attribute_key": "favorite_sport",
                    "attribute_value": "cricket"
                }
            ]
        }
        ,
        {
            "device_id": "555555-d1d1-d1d1-555-fffffffff",
            "customer_id": "111111",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "order",
                    "attribute_value": 7
                }
                ,
                {
                    "attribute_key": "number",
                    "attribute_value": 8
                }
            ]
        }]
}

하나의 디바이스 ID와 여러 속성 키 및 값을 포함한 예시

{
    "import_key": "c733e4d7-b538-4d12-a2ef-ffffffffffff",
    "attributes_values": [
        {
            "device_id": "0bcfc579-f1f3-4452-9111f",
            "customer_id": "12345678",
            "app_ids": ["game.a.demo"],
            "attributes": [
                {
                    "attribute_key": "score",
                    "attribute_value": 90
                }
                ,
                {
                    "attribute_key": "favorite-sport",
                    "attribute_value": "cricket"
                }
                ,
                {
                    "attribute_key": "orderNumber",
                    "attribute_value": 93
                }
                ,
                {
                    "attribute_key": "netPromoterScore",
                    "attribute_value": 94
                }
            ]
        }
    ]
}

 

참고: 유저 속성을 가져올 때, 고객 ID와 관련된 모든 알려진 디바이스에도 해당 속성이 할당됩니다. 예를 들어, 유저가 "게임 점수" 속성을 customer_id로 10개의 디바이스에 가져왔고, customer_id 중 하나가 2개의 디바이스(즉, 동일한 CUID를 가진 2개의 GAID)와 연결된 경우, 이 가져오기에는 11개의 유저 속성 레코드가 포함됩니다. CSV 가져오기 제한 사항

일반 제한 사항

• CSV/ API 가져오기 데이터는 정수(완전한 숫자)만 지원됩니다. 실수형(소수점) 숫자는 지원되지 않습니다. 예시: "점수" 속성 값은 90이 될 수 있지만 90.5는 될 수 없습니다.
• 유저 속성 데이터는 출력하거나 다운로드할 수 없습니다. 

• 속성 값 제한:

  • 속성 값에 쉼표, 점 또는 기타 특수 문자를 사용할 수 없습니다.
  • 문자열 속성 값의 길이는 40자로 제한됩니다.
  • 속성 값은 0으로 시작할 수 없습니다.

API 가져오기 제한

• 분당 최대 350개의 API 요청, 단일 속성의 경우 1만 개 디바이스, 두 개 속성의 경우 5천 개 디바이스 등
• device_id와 customer_id 키는 각각의 가져오기 요청에 필수입니다. 이 식별자 중 하나만 사용해서 속성을 가져오려면 다른 식별자의 "헤더"를 빈 문자열로 포함해야 합니다. 예를 들어, device_id별로 속성을 가져오고 customer_id는 제외하려면 호출은 다음과 같습니다:

"attributes_values": [
{
"device_id": "39e123.......",
"customer_id": "",

 

CSV 가져오기 제한 사항

• 유저 속성 값을 추가할 때 CSV 파일당 최대 1천만 개의 행이 허용됩니다.