メインコンテンツへスキップ

OneSignal Segment統合の概要

​
概要

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セットアップ構成画面

​
データアウト

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キー構成

APIキーをセットアップした後、Segment.comのデータポリシー設定を確認して、SegmentのEU Residency Endpointにイベントを送信する必要があるかどうかを判断してください。 これらの設定がすべて完了したら、OneSignalで使用するチャネルに応じて、Segmentアカウントに同期するイベントを選択できます。

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

Segment.com Dashboard > Destinations内にOneSignalが表示されるはずです。表示されない場合は、OneSignalを新しい宛先として追加します。 OneSignal宛先を有効にすると、OneSignal APIキーとアプリIDもすでに表示されているはずです

SegmentでのOneSignal宛先構成

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でデータタグとして保存されます。例：

ユーザーIdentify call例

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]
)

Track callプロパティ例

ユーザートレイトとプロパティのインターフェース

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

Persona Audiencesは、自動的にOneSignalのセグメントとして表示されます。 Computed Traitsは、OneSignalユーザーレコードのデータタグとして更新されます。 オーディエンス

PersonasオーディエンスとComputed Traitsのインターフェース

SegmentのTrack callを使用して送信されたオーディエンスは、オーディエンス名でOneSignalセグメントを作成します。 SegmentのIdentify callを使用して送信されたオーディエンスは：
  • オーディエンス名でOneSignalセグメントを作成します
  • 一致するすべてのユーザーレコードにデータタグを追加します（Identify callに追加のプロパティがある場合）。

SegmentからOneSignalで作成されたセグメント

ユーザーがオーディエンスに入るまたは出るたびに、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 Hardbounced永続的なエラーのため、メールが送信者に返送されました
Email Failed受信者の受信トレイにメールを配信できませんでした
SMS SentSMSが受信者に送信されました
SMS DeliveredSMSが正常に配信されました
SMS FailedSMSの送信に失敗しました

​
イベントプロパティ

以下は、OneSignalからSegment.comに送信されるイベントに含まれるプロパティです
プロパティ名説明
userIdメッセージに関連付けられたexternal_id
anonymousIdsubscription_id
messageId個別メッセージの識別子
campaign_idmessageIdと同じ値
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ユーザーレコードから削除されます。これは、データタグの制限内に収まるようにするために行われます。