OneSignal + Segment統合により、次のことができます：
- SegmentからOneSignalにユーザートレイトとイベントを送信して、ユーザープロファイルを充実させ、セグメンテーションを強化し、メッセージングをトリガーします。
- OneSignalからSegmentにメッセージ配信とエンゲージメントイベントを送信して、一元化された分析とデータウェアハウジングを実現します。
この双方向セットアップは、OneSignalのすべての主要チャネル（プッシュ、アプリ内、メール、SMS）をサポートします。
セットアップ
1. OneSignalをセットアップする
OneSignalダッシュボードで既存のアプリを使用するか、新しいアプリを作成します。次に、希望するチャネルをセットアップします：
2. SegmentをOneSignalに接続する
OneSignalダッシュボード内で、Data > Integrationsに移動し、Segment.comカード内のActiveをクリックします。次に、セットアップオプションを続けます。
データイン
OneSignalへの「データイン」により、Segment.comアカウントからOneSignalセグメント、タグ、およびカスタムイベントをOneSignalに送信できます。OneSignalダッシュボードのSegment.com設定ページのData Inセクションの下にあるAuthenticateをクリックします。
カスタムイベントは現在ベータ版です。
アクセスをリクエストするには、以下の情報とともにsupport@onesignal.comにお問い合わせください：
- 会社名
- OneSignal組織ID
- 有効にするアプリID
カスタムイベントの追跡が有効になると、Segment.com統合はデータタグとイベントの両方を送信するため、データタグを参照する既存のテンプレートを更新する必要はありません。
データアウト
Segment.comへの「データアウト」を有効にすると、生成されたメッセージイベントがSegment.comアカウントに同期されます。これらのメッセージイベントは、OneSignalプラットフォームでユーザーにメッセージを送信することで生成されます。生成できるイベントの種類と送信されるプロパティの詳細については、下記を参照してください。
まず、Segment.comアカウントからOneSignalをソースとして追加する必要があります。これは、Segment Connections CatalogueのOneSignal Source listingに移動することで実行できます。
そこから、OneSignalダッシュボードにSegment.com APIトークンを追加できます。Segment APIキーを追加するには、OneSignalダッシュボードのData > Integrations > Segmentに移動してください。
APIキーをセットアップした後、Segment.comのデータポリシー設定を確認して、SegmentのEU Residency Endpointにイベントを送信する必要があるかどうかを判断してください。
これらの設定がすべて完了したら、OneSignalで使用するチャネルに応じて、Segmentアカウントに同期するイベントを選択できます。
3. SegmentにOneSignal宛先を追加する
Segment.com Dashboard > Destinations内にOneSignalが表示されるはずです。表示されない場合は、OneSignalを新しい宛先として追加します。
OneSignal宛先を有効にすると、OneSignal APIキーとアプリIDもすでに表示されているはずです
APIキーとアプリIDが設定されていない場合は、OneSignalダッシュボードに移動してアプリを選択し、Settings > Keys & IDsに移動します。「App ID」と「API key」をコピーしてSegment.comに貼り付けます。
複数のSegment.comソース
複数のソースがある場合は、SegmentのPersonas > Spaces機能を利用して、複数のソースを宛先にバインドできます。
4. SegmentからOneSignalにデータを送信する
OneSignalはチャネルレベルのレコード（Push/IAM、メール、SMS）を保存します。これらのレコードはOneSignalですでに作成されている必要があり、Segment.comによって送信されるuserIDフィールドに一致するように、OneSignalで外部IDエイリアスを設定する必要もあります。
Segment User ID <—> OneSignal External IDマッピングがないレコードはドロップされます。
ユーザートレイトまたはプロパティ
Segmentですべての顧客タッチポイントにわたってデータを集約し、これらのユーザープロパティをリアルタイムでデータタグとしてOneSignalに送信できます。
注：OneSignalは、ユーザープロパティとしてネストされたオブジェクトまたは配列を受け入れることができません。
Identify - SegmentのIdentify callを使用して送信されたユーザートレイトまたはプロパティは、OneSignalでデータタグとして保存されます。例：
Track - SegmentのTrack callを使用して送信されたイベントと関連プロパティについて、OneSignalはすべてのイベントプロパティをデータタグとして保存しますが、タグを保存する際にイベント名をドロップします。データタグにイベント名を保持したい場合は、OneSignalに送信する前にイベント名をプロパティに追加できます。例：
let timestampInSeconds = Int(NSDate().timeIntervalSince1970).toString()//convert to string since Segment adds decimals to end
//name will be dropped and only properties will be sent to OneSignal as tag "last opened: timestampInSeconds"
analytics.track(
name: "iOS App Last Opened",
properties: ["last opened": timestampInSeconds]
)
PersonasオーディエンスとComputed Traits
Persona Audiencesは、自動的にOneSignalのセグメントとして表示されます。
Computed Traitsは、OneSignalユーザーレコードのデータタグとして更新されます。
オーディエンス
SegmentのTrack callを使用して送信されたオーディエンスは、オーディエンス名でOneSignalセグメントを作成します。
SegmentのIdentify callを使用して送信されたオーディエンスは：
- オーディエンス名でOneSignalセグメントを作成します
- 一致するすべてのユーザーレコードにデータタグを追加します（Identify callに追加のプロパティがある場合）。
ユーザーがオーディエンスに入るまたは出るたびに、IdentifyおよびTrack callが自動的にOneSignalに送信されます。
Computed Traits Personas Computed Traitsは、Identify callまたはTrack callとしてOneSignalに渡されるかどうかに関係なく、OneSignalユーザーレコードのデータタグとして保存されます。その後、これらのデータタグを使用して、OneSignalセグメントを手動で作成し、メッセージングワークフローを自動化できます。
メッセージイベント
イベントの種類
以下は、OneSignalがSegmentに送信するメッセージイベントの種類です
| MessageEvent Kind | イベントの説明 |
|---|
| Push Sent | プッシュ通知が正常に送信されました |
| Push Received | プッシュ通知が正常に受信されました |
| Push Clicked | デバイスでプッシュ通知がタップされました |
| In-App Message Displayed | アプリ内メッセージがデバイスに正常に表示されました |
| In-App Message Clicked | デバイスでアプリ内メッセージがクリックされました |
| In-App Message Page Displayed | アプリ内メッセージのページが表示されています |
| Email Sent | メールが正常に送信されました |
| Email Opened | 受信者がメールを開封しました |
| Email Unsubscribed | 受信者がメールの配信を停止しました |
| Email Received | 受信者がメールを受信しました |
| Email Reported As Spam | 受信者がメールをスパムとして報告しました |
| Email Bounced | 永続的なエラーのため、メールが送信者に返送されました |
| Email Failed | 受信者の受信トレイにメールを配信できませんでした |
| SMS Sent | SMSが受信者に送信されました |
| SMS Delivered | SMSが正常に配信されました |
| SMS Failed | SMSの送信に失敗しました |
イベントプロパティ
以下は、OneSignalからSegment.comに送信されるイベントに含まれるプロパティです
| プロパティ名 | 説明 |
|---|
userId | メッセージに関連付けられたexternal_id |
anonymousId | subscription_id |
messageId | 個別メッセージの識別子 |
campaign_id | messageIdと同じ値 |
message_name | メッセージ名 |
message_title | メッセージタイトル |
message_contents | メッセージの内容 |
| |
subscription_type | メッセージが送信されたチャネル |
template_id | 使用されたメッセージテンプレート |
subscription_id. | OneSignalが設定したデバイス/メール/SMS識別子 |
device_type | メッセージを受信したデバイスタイプ |
language | デバイスの2文字言語コード |
message_type | 送信されたメッセージのタイプ（プッシュ、アプリ内、メール、SMS） |
FAQ
サブスクリプションイベントはどのように渡せますか？
サブスクリプションイベントは現在自動的に送信されていません。これは、OneSignal SDKのSubscription Observer Methodsを使用して実行できます。詳細については、サブスクリプション追跡を参照してください。
OneSignalでSegmentの予約済みおよびカスタムユーザープロパティを管理する
- Segmentのすべてのユーザートレイトは、データタグとしてOneSignalに送信されます。OneSignalで許可されるデータタグの数は、OneSignal料金プランによって異なります。許可された数を超えるタグはドロップされます。
- OneSignalは、一致するユーザーのfirstNameとlastNameプロパティを常に更新します。他のすべてのトレイトは、先着順で追加/更新されます。firstNameとlastNameタグは「first_name」と「last_name」として保存されます。
- 空白/null値でOneSignalに送信されたユーザープロパティは、OneSignalユーザーレコードから削除されます。これは、データタグの制限内に収まるようにするために行われます。
