오디언스—사용자 속성

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

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

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

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

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

시나리오 사용자 속성

규칙 세트의 유저 속성

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

alt유저속성예.jpgalt

필수 조건:

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

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

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

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

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

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

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

유저 속성을 추가하려면:

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

   

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

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

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

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

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

유저 속성 데이터는 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. 요청을 프로그래밍 방식으로 발송합니다.

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": ""
        }
      ]
    }
  ]
}

{
    "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
                }
            ]
        }]
}

{
    "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
                }
            ]
        }
    ]
}

일반 제한 사항

• 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천만 개의 행이 허용됩니다.