Segment (Twilio)

概要

OneSignal + Segment統合により、次のことができます：

SegmentからOneSignalにユーザートレイトとイベントを送信して、ユーザープロファイルを充実させ、セグメンテーションを強化し、メッセージングをトリガーします。
OneSignalからSegmentにメッセージ配信とエンゲージメントイベントを送信して、一元化された分析とデータウェアハウジングを実現します。

この双方向セットアップは、OneSignalのすべての主要チャネル（プッシュ、アプリ内、メール、SMS）をサポートします。

要件

Growth、ProfessionalまたはEnterprise OneSignalアカウント。
Segment管理者権限
データを送信するOneSignal モバイルSDKおよび/またはWeb SDK。メールまたはSMSのみの統合はSDKを必要としません。
OneSignalプロパティ：外部ID（Segment.comのuserIdにマッピングされます）。

セットアップ

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統合はデータタグとイベントの両方を送信するため、データタグを参照する既存のテンプレートを更新する必要はありません。

Authenticateをクリックすると、Segment.comのWebページが開き、Segment.comアカウントにサインインするように求められます。次に、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ユーザーレコードから削除されます。これは、データタグの制限内に収まるようにするために行われます。

はじめに & 設定

メッセージングチャネル

ジャーニー

オーディエンス & カスタムイベント

分析 & 統合

プライバシー & セキュリティ

概要

要件

セットアップ

1. OneSignalをセットアップする

2. SegmentをOneSignalに接続する

データイン

データアウト

3. SegmentにOneSignal宛先を追加する

複数のSegment.comソース

4. SegmentからOneSignalにデータを送信する

ユーザートレイトまたはプロパティ

PersonasオーディエンスとComputed Traits

メッセージイベント

イベントの種類

イベントプロパティ

FAQ

サブスクリプションイベントはどのように渡せますか？

OneSignalでSegmentの予約済みおよびカスタムユーザープロパティを管理する

​概要

​要件

​セットアップ

​1. OneSignalをセットアップする

​2. SegmentをOneSignalに接続する

​データイン

​データアウト

​3. SegmentにOneSignal宛先を追加する

​複数のSegment.comソース

​4. SegmentからOneSignalにデータを送信する

​ユーザートレイトまたはプロパティ

​PersonasオーディエンスとComputed Traits

​メッセージイベント

​イベントの種類

​イベントプロパティ

​FAQ

​サブスクリプションイベントはどのように渡せますか？

​OneSignalでSegmentの予約済みおよびカスタムユーザープロパティを管理する

概要

要件

セットアップ

1. OneSignalをセットアップする

2. SegmentをOneSignalに接続する

データイン

データアウト

3. SegmentにOneSignal宛先を追加する

複数のSegment.comソース

4. SegmentからOneSignalにデータを送信する

ユーザートレイトまたはプロパティ

PersonasオーディエンスとComputed Traits

メッセージイベント

イベントの種類

イベントプロパティ

FAQ

サブスクリプションイベントはどのように渡せますか？

OneSignalでSegmentの予約済みおよびカスタムユーザープロパティを管理する