メインコンテンツへスキップ
Adjust は、マーケティングチャネル全体でインストール、セッション、アプリ内イベントをアトリビュートするモバイル計測パートナー (MMP) です。この統合では、OneSignal の External ID を onesignal_customer_id パートナーパラメータとして Adjust に渡すことで、Adjust が OneSignal に転送するイベントを正しいユーザーと関連付けられるようにします。

​
要件

  • OneSignal モバイル SDK バージョン 5.5.0 以上。
  • OneSignal ユーザーに設定された External ID。Adjust と OneSignal 間のデータ同期はこの ID をキーに行われるため、匿名ユーザーのイベントを統合で関連付けることはできません。

​
セットアップ

Adjust のコールバックが正しい OneSignal ユーザーに届くには、2 つの条件が必要です。Adjust がイベントを OneSignal に転送するように構成されていること、そしてアプリが各セッションで External ID をパートナーパラメータとして付加していることです。

​
1. Adjust ダッシュボードでデータ共有を有効化する

Adjust ダッシュボードで OneSignal 統合を有効化し、転送するイベントを選択します。Adjust はデフォルトで install と session のアクティビティを送信し、加えてカスタムイベントとアプリ内収益をマッピングできます。具体的な手順は Adjust の Set up OneSignal ガイドに従ってください。
このダッシュボード側の手順を行わないと、Adjust から OneSignal にコールバックが送信されないため、次の手順の SDK コードで onesignal_customer_id パラメータを付加する対象が存在しません。

​
2. External ID をパートナーパラメータとして渡す

ユーザーがアプリにサインインしたら、OneSignal の login メソッドを呼び出して External ID を設定し、続いて Adjust の addGlobalPartnerParameter メソッドを呼び出して、キーを onesignal_customer_id、値を同じ External ID にします。Adjust は以降の各コールバックでそのキー–値ペアを転送し、OneSignal は onesignal_customer_id を使ってコールバックを正しいユーザーに紐付けます。
iOS 以外のすべての Adjust SDK は (key, value) の引数順を使います。iOS の Swift と Objective-C は (value, forKey: key) を使います。External ID を誤ってキーとして渡すと、統合はエラーを出さずに壊れます。Adjust はユーザー ID 文字列を名前に持つパラメータを転送してしまい、OneSignal は onesignal_customer_id を認識できません。
val externalId = "your_user_id"
OneSignal.login(externalId)
Adjust.addGlobalPartnerParameter("onesignal_customer_id", externalId)
Adjust SDK 自体のリファレンスについては、Adjust の Global Partner Parameters ドキュメント（Android および iOS）を参照してください。

​
Deep linking

Adjust は、プッシュのタップをアプリ内の特定の画面へルーティングするために iOS Universal Links と Android App Links を使用します。Adjust のディープリンクを開くべき OneSignal 通知を送信する際は、Adjust の Push Notifications ガイドの説明に従って、通知の Launch URL を Adjust のディープリンクに設定してください。Launch URL の各プラットフォームでの扱いについては、OneSignal のディープリンクガイドを参照してください。

​
FAQ

​
onesignal_customer_id パートナーパラメータとは何ですか？

onesignal_customer_id は、OneSignal が Adjust のコールバックから読み取り、Adjust イベントを OneSignal ユーザーと関連付けるために使う正確なキーです。その値には、OneSignal.login に渡すのと同じ External ID を設定してください。他のキー名は認識されません。

​
Adjust.addGlobalPartnerParameter はいつ呼び出すべきですか？

OneSignal.login を呼び出すたびに呼び出してください。アプリ起動時にユーザー ID が判明した時点、およびアカウント切り替え時です。これは OneSignal の login のガイダンスに対応しており、Adjust のパートナーパラメータを現在の OneSignal ユーザーと同期状態に保ちます。

​
ユーザーがログアウトまたはアカウントを切り替えるとどうなりますか？

Adjust は、変更または削除するまでグローバルパートナーパラメータをメモリに保持します。ログアウト時には Adjust.removeGlobalPartnerParameter("onesignal_customer_id") を呼び出す（または次回ログイン時に値を上書きする）ようにしてください。そうしないと、Adjust は以降のイベントを前のユーザーの External ID に紐付け続けます。

​
Adjust は OneSignal にどのようなデータを送りますか？

Adjust はデフォルトで install と session のアクティビティを転送し、加えて Adjust ダッシュボードでマッピングしたイベントを転送します。転送されるフィールドの一覧は、Adjust の OneSignal 統合の記事に記載されています。

​
関連ページ

External ID

パートナー統合がデータを関連付けられるよう、OneSignal ユーザーに安定した識別子を設定します。

Mobile SDK: login

呼び出しタイミングや再試行の挙動を含む OneSignal.login のリファレンス。

Deep linking

プッシュ、アプリ内、メール、SMS 向けに Universal Links、App Links、URI スキームを構成します。

Keys & IDs

Adjust ダッシュボードの設定に使う OneSignal の App ID と REST API Key を確認します。