adjust-icon

앱 설정 엔드포인트

/app/{app_token}/settings 엔드포인트를 사용하여 상세한 앱 설정을 조회할 수 있습니다. 이 엔드포인트는 이벤트, 파트너, 어트리뷰션 설정 등 앱 구성에 관한 종합적인 정보를 제공합니다.

앱 설정 조회

특정 앱에 대한 상세 설정을 조회합니다. 모든 설정을 요청하거나 특정 섹션을 기준으로 필터링할 수 있습니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/app/{app_token}/settings

호출하여 트래킹할 수 있습니다: GET

응답: 앱 설정 응답

파라미터

파라미터데이터 유형In필수설명
app_tokenStringPathOAdjust 앱 토큰.
sectionsArray[String]Query아니요특정 섹션으로 필터링. 제공되지 않은 경우 모든 섹션이 반환됩니다.

이용 가능한 섹션

이 엔드포인트는 앱 설정 응답에 나열된 모든 섹션을 지원합니다.

예

모든 앱 설정 가져오기

요청 - cURL
curl --location 'https://automate.adjust.com/app-automation/app/abc123xyz/settings' \
--header 'Authorization: Bearer {your-adjust-api-token}'
응답
{
   "app_info": {
      "id": 12345,
      "name": "My App",
      "app_token": "abc123xyz",
      "default_platform": "android",
      "stores": {
         "google_play": { "store_id": "com.example.myapp" }
      }
   },
   "events": [
      {
         "name": "purchase",
         "unique": false,
         "archived": false,
         "token": "abc1de",
         "app_token": "abc123xyz"
      },
      {
         "name": "registration",
         "unique": true,
         "archived": false,
         "token": "fgh2ij",
         "app_token": "abc123xyz"
      }
   ],
   "partners": [
      {
         "name": "facebook",
         "revenue_forwarding": true,
         "session_forwarding": false,
         "parameter_forwarding": true,
         "events_linking": { "purchase": "fb_purchase" }
      }
   ],
   "attribution_settings": {
      "click_device_matching": { "window": 604800, "enabled": true },
      "click_fingerprinting": { "window": 86400, "enabled": true },
      "impression_device_matching": { "window": 86400, "enabled": true }
   }
}

특정 섹션만 가져오기

요청 - cURL
curl --location 'https://automate.adjust.com/app-automation/app/abc123xyz/settings?sections=events&sections=partners' \
--header 'Authorization: Bearer {your-adjust-api-token}'
응답
{
   "events": [
      {
         "name": "purchase",
         "unique": false,
         "archived": false,
         "token": "abc1de",
         "app_token": "abc123xyz"
      }
   ],
   "partners": [
      {
         "name": "facebook",
         "revenue_forwarding": true,
         "session_forwarding": false,
         "events_linking": {}
      }
   ]
}

SDK 시크릿 가져오기(v3 포함)

요청 - cURL
curl --location 'https://automate.adjust.com/app-automation/app/abc123xyz/settings?sections=combined_secrets' \
--header 'Authorization: Bearer {your-adjust-api-token}'
응답
{
   "combined_secrets": {
      "enforce_install_signing": true,
      "secrets": [
         {
            "id": 1001,
            "name": "Production Secret",
            "active": true,
            "value": ["secret1", "secret2", "info1", "info2"],
            "internal_version": 2,
            "version": 2,
            "created_at": "2024-01-15T10:30:00Z",
            "updated_at": "2024-01-15T10:30:00Z"
         },
         {
            "id": 2001,
            "platform": "android",
            "label": "Android SDK Secret",
            "active": true,
            "algorithm": "adj1",
            "internal_version": 2,
            "version": 3,
            "created_at": "2024-06-01T12:00:00Z",
            "updated_at": "2024-06-01T12:00:00Z"
         }
      ]
   }
}

CSV로 설정 가져오기

CSV 형식으로 앱 설정을 내보냅니다. 현재 이벤트 내보내기가 지원됩니다.

API 프로토콜

엔드포인트: https://automate.adjust.com/app-automation/settings/csv

호출하여 트래킹할 수 있습니다: GET

응답: CSV 파일 내용

파라미터

파라미터데이터 유형In필수설명
sectionStringQueryO내보낼 섹션. 현재 events만 지원됩니다.
app_tokensStringQueryO내보내기에 포함할 쉼표로 구분된 앱 토큰 목록.

예시

요청 - cURL
curl --location 'https://automate.adjust.com/app-automation/settings/csv?section=events&app_tokens=abc123xyz,def456uvw' \
--header 'Authorization: Bearer {your-adjust-api-token}'
응답(CSV)
app_token,event_name,event_token,unique,archived
abc123xyz,purchase,abc1de,false,false
abc123xyz,registration,fgh2ij,true,false
def456uvw,purchase,klm3no,false,false
def456uvw,level_complete,pqr4st,false,false

데이터 모델

앱 설정 응답

모든 필드는 선택 사항이며, 해당 섹션이 요청된 경우에만 포함됩니다.

파라미터데이터 유형설명
app_infoObject기본 앱 정보.
attribution_privacy_modelString어트리뷰션 프라이버시 모델(iOS만 해당).
attribution_settingsObject어트리뷰션 윈도우 구성.
callbacksArray[Object]서버 콜백 구성.
csv_upload_settingsObject클라우드 스토리지 업로드 설정.
eventsArray[Object]이벤트 정의.
external_data_forwardingObject데이터 포워딩 설정.
fraud_prevention_settingsObject광고 해킹 예방 구성.
partnersArray[Object]파트너 모듈 구성.
purchase_verificationObject결제 검증 설정.
signatureObjectAndroid 핑거프린트를 포함한 서명 설정.
sdk_secretsObject레거시 SDK 시크릿 구성.
combined_secretsObject모든 SDK 시크릿(레거시 + v3).
skad_networkObjectSKAdNetwork v3 설정.
skad_network_v4ObjectSKAdNetwork v4 설정.
preview_link_settingsObject소셜 공유 미리보기 설정.
s2sObjectS2S 보안 설정.
trackersArray[Object]트래커 구성.

이벤트 설정

파라미터데이터 유형설명
name*String이벤트 이름.
unique*Boolean이벤트가 사용자별로 고유한지 여부.
archived*Boolean이벤트의 아카이브 여부.
token*StringSDK 연동을 위한 이벤트 토큰.
app_token*String해당 이벤트가 속한 앱 토큰.

파트너 설정

파라미터데이터 유형설명
name*String파트너 이름/슬러그.
revenue_forwardingBoolean매출 데이터 포워딩 여부.
session_forwardingBoolean세션 데이터 포워딩 여부.
parameter_forwardingBoolean파트너 파라미터 포워딩 여부.
cost_forwardingBoolean비용 데이터 포워딩 여부.
attributed_onlyBoolean어트리뷰션된 데이터만 포워드할지 여부.
uninstall_forwardingBoolean삭제 데이터 포워딩 여부.
ad_revenue_forwardingBoolean광고 매출 포워딩 여부.
channel_setupObject파트너별 구성.
events_linkingObject해당 파트너에 대한 이벤트 이름 매핑.

결합된 시크릿 응답

파라미터데이터 유형설명
enforce_install_signing*Boolean서명되지 않은 설치 거부 여부.
secrets*Array[Object]레거시 시크릿을 포함한 모든 SDK 시크릿 목록.

레거시 시크릿

파라미터데이터 유형설명
id*Integer시크릿 ID.
nameString시크릿 이름/라벨.
active*Boolean시크릿의 활성화 여부.
value*Array[String]시크릿 값.
internal_version*IntegerSDK Signature(SDK 서명) 라이브러리 버전.
version*IntegerSDK 시크릿 버전(1 또는 2).
created_at*String생성된 ISO 날짜/시간.
updated_at*String마지막으로 업데이트된 ISO 날짜/시간.

SDK 시크릿

파라미터데이터 유형설명
id*Integer시크릿 ID.
platform*String타겟 플랫폼(android, ios).
label*String시크릿 라벨.
active*Boolean시크릿의 활성화 여부.
algorithm*String서명 알고리즘.
internal_version*IntegerSDK Signature(SDK 서명) 라이브러리 버전.
version*IntegerSDK 시크릿 버전(3 이상).
created_at*String생성된 ISO 날짜/시간.
updated_at*String마지막으로 업데이트된 ISO 날짜/시간.