Superwall SDKの実装

Superwallとの連携により、SuperwallからAdjustへのサブスクリプション ライフサイクル イベントのサーバー間転送が可能になります。Superwallは、App StoreのサブスクリプションイベントをAdjustのサーバー間イベントAPIに送信します。

この連携は2つのパートで構成されています。

• クライアント側 ：デバイスIDとAdjustデバイスID（ADID）をSuperwall SDKにパスすることで、SuperwallがこれらをS2Sリクエストに追加できるようになります。
• サーバー側 ：Adjustダッシュボードでイベントトークンを作成し、SuperwallダッシュボードでSuperwallサブスクリプションイベントにマッピングします。

事前準備

Superwallの連携を設定する前に、以下のタスクを実行してください：

1. Adjust iOS SDKを実装します。
2. Superwall iOS SDKを実装します。

Adjust ADIDをパスする

ADIDは、デバイスが最初のセッション計測を完了した後に利用可能になります。Adjustセッション成功コールバックでADIDを取得し、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は、より強力なデバイスマッチングとキャンペーンの最適化のためにこれらのIDを使用します。以下のアトリビュートを収集し、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 ：App Storeの手数料などの決済処理手数料を差し引いた純収益。

収益を含まないイベントは、収益パラメーターなしで送信されます。計算された金額が0.001未満の場合、収益は省略されます。

S2Sリクエストパラメーター

Adjust S2SイベントAPIに転送される各イベントには、以下のパラメーターが含まれます。