Superwall SDK 연동

Superwall 연동을 통해 구독 라이프사이클 이벤트를 Superwall에서 Adjust로 서버 간(S2S) 전달할 수 있습니다. Superwall은 앱 스토어 구독 이벤트를 Adjust S2S 이벤트 API로 전송합니다.

연동은 두 부분으로 구성됩니다.

• 클라이언트 측 : 기기 식별자와 Adjust 기기 ID(ADID)를 Superwall SDK에 전달하여 Superwall이 S2S 요청에 이를 포함할 수 있도록 합니다.
• 서버 측 : Adjust 대시보드에서 이벤트 토큰을 생성하고, 이를 Superwall 대시보드의 Superwall 구독 이벤트에 매핑할 수 있습니다.

시작에 앞서

Superwall 연동을 구성하기 전에 다음 작업을 완료하시기 바랍니다.

1. Adjust iOS SDK를 연동합니다.
2. Superwall iOS SDK를 연동합니다.

Adjust ADID 전달

ADID는 기기가 첫 번째 트래킹된 세션을 완료한 이후에 사용할 수 있습니다. Adjust 세션 성공 콜백에서 이를 조회하고, setIntegrationAttributes를 사용하여 Superwall SDK에 전달합니다.

1
extension AppDelegate: AdjustDelegate {
2
   func adjustSessionTrackingSucceeded(_ session: ADJSessionSuccess?) {
3
      guard let adid = session?.adid else { return }
4
      Superwall.shared.setIntegrationAttributes(
5
         [.adjustId: adid]
6
      )
7
   }
8
}

1
- (void)adjustSessionTrackingSucceeded:(ADJSessionSuccess *)session {
2
   NSString *adid = session.adid;
3
   if (adid == nil) { return; }
4
   [Superwall.sharedInstance
5
      setIntegrationAttributes:@{@"adjustId": adid}];
6
}

추가 어트리뷰션 전달

Superwall은 각 S2S 요청에 대해 추가 어트리뷰션을 전달합니다. Adjust는 더 강력한 기기 매칭과 캠페인 최적화를 위해 이러한 식별자를 사용합니다. 다음의 어트리뷰션을 수집하고 setUserAttributes를 사용하여 Superwall에 전달합니다.

Superwall SDK는 각 S2S 요청에 대해 자동으로 device_name 및 os_version을 수집하고 전달합니다.

어트리뷰션 수집

Adjust SDK는 IDFA, IDFV, ATT 상태를 조회하는 메서드를 제공합니다. AdSupport 및 AppTrackingTransparency를 직접 가져오는 대신 이를 사용할 수 있습니다. Adjust SDK를 통해 ATT를 처리하는 경우 ATT 인증 콜백에서도 이러한 값을 조회할 수 있습니다.

1
// IDFV — available without ATT authorization
2
Adjust.idfv { idfv in
3
   if let idfv {
4
      Superwall.shared.setUserAttributes(["idfv": idfv])
5
   }
6
}
7

8
// IDFA and ATT status — retrieve after ATT prompt response
9
Adjust.idfa { idfa in
10
   var attributes: [String: Any] = [
11
      "att_status": Adjust.appTrackingAuthorizationStatus()
12
   ]
13
   if let idfa, idfa != "00000000-0000-0000-0000-000000000000" {
14
      attributes["idfa"] = idfa
15
   }
16
   Superwall.shared.setUserAttributes(attributes)
17
}

1
// IDFV — available without ATT authorization
2
[Adjust idfvWithCompletionHandler:^(NSString *idfv) {
3
   if (idfv) {
4
      [Superwall.sharedInstance
5
         setUserAttributes:@{@"idfv": idfv}];
6
   }
7
}];
8

9
// IDFA and ATT status — retrieve after ATT prompt response
10
[Adjust idfaWithCompletionHandler:^(NSString *idfa) {
11
   NSMutableDictionary *attributes = [NSMutableDictionary dictionary];
12
   attributes[@"att_status"] =
13
      @([Adjust appTrackingAuthorizationStatus]);
14
   if (idfa && ![idfa isEqualToString:@"00000000-0000-0000-0000-000000000000"]) {
15
      attributes[@"idfa"] = idfa;
16
   }
17
   [Superwall.sharedInstance setUserAttributes:attributes];
18
}];

Superwall 대시보드 구성

이벤트 전달을 활성화하려면 Superwall 대시보드에서 다음의 설정을 구성합니다.

이벤트 매핑

Adjust 대시보드에서 이벤트 토큰을 생성한 다음, Superwall 대시보드에 추가하여 각 토큰을 해당 Superwall 구독 이벤트에 매핑합니다. 전달하고자 하는 각 이벤트에 대해 별도의 이벤트 토큰을 생성해야 합니다. 이벤트는 상응하는 이벤트 토큰이 구성된 경우에만 전달됩니다.

지원되는 이벤트의 전체 목록과 해당 매핑 로직은 Superwall Adjust 이벤트 매핑 문서를 참조하시기 바랍니다.

S2S 보안 토큰

Adjust에서 S2S 보안을 활성화한 경우, S2S 보안 토큰을 생성하여 Superwall 대시보드에 추가합니다. Superwall은 각 S2S 요청에 대해 토큰을 Authorization: Bearer 헤더로 포함합니다.

환경

Superwall은 각 이벤트가 샌드박스 또는 프로덕션 환경에서 발생한 것인지를 자동으로 감지합니다. TestFlight 또는 샌드박스 Apple ID를 통한 샌드박스 구매는 environment가 sandbox로 설정된 상태로 전달됩니다. 프로덕션 구매는 environment가 production으로 설정된 상태로 전달됩니다. Adjust는 이 필드를 사용하여 테스트 데이터를 라이브 데이터와 구분합니다.

매출

매출이 포함된 이벤트의 경우 Superwall은 구매 금액과 통화를 Adjust에 전달합니다. Superwall 대시보드에서 매출 리포팅 모드를 Revenue 또는 Proceeds로 설정할 수 있습니다.

• Revenue : 전체 구매 가격인 총매출입니다.
• Proceeds : 앱 스토어 수수료와 같은 결제 처리자 수수료를 제외한 순매출입니다.

매출이 없는 이벤트는 매출 파라미터 없이 전송됩니다. 매출은 계산된 금액이 0.001 미만인 경우 생략됩니다.

S2S 요청 파라미터

Adjust S2S 이벤트 API로 전달되는 각 이벤트에 다음의 파라미터가 포함됩니다.