Segmentは、企業が顧客データを収集、クリーニングし、さまざまな宛先にルーティングするのを支援する顧客データ基盤（CDI）プラットフォームです。mParticleと同様に、Segmentは、ウェブサイト、モバイルアプリ、サーバー、クラウドサービスなどの複数のソースからデータを収集するための単一のAPIを提供します。

はじめに

追加セットアップ

pod "Analytics"
pod "Analytics-iAds-Attribution"

#import <Analytics-iAds-Attribution/SEGADTracker.h>

// Initialize the configuration as you would normally.
SEGAnalyticsConfiguration *configuration = [SEGAnalyticsConfiguration 
   configurationWithWriteKey:@"YOUR_WRITE_KEY"];
...

// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = @[ [SEGADTracker middleware] ];
[SEGAnalytics setupWithConfiguration:configuration];

import Analytics-iAds-Attribution

// Initialize the configuration as you would normally.
var configuration = SEGAnalyticsConfiguration(writeKey: "WriteKey")
...

// Configure the client with the iAD middleware to attach iAd properties.
configuration.middlewares = [SEGADTracker.middleware()]
    
SEGAnalytics.setup(with: configuration)

[analytics track:@"Application Installed",
    properties: nil,
    options: @{
      @"context" : @{
        @"campaign" : @{
          @"provider" : @"Apple",
          @"click_date" : attributionInfo[@"iad-click-date"],
          @"conversion_date" : attributionInfo[@"iad-conversion-date"],
          @"source" : @"iAd",
          @"name" : attributionInfo[@"iad-campaign-name"],
          @"content" : attributionInfo[@"iad-keyword"],
          @"ad_creative" : attributionInfo[@"iad-org-name"],
          @"ad_group" : attributionInfo[@"iad-adgroup-name"],
          @"id" : attributionInfo[@"iad-campaign-id"],
          @"ad_group_id" : attributionInfo[@"iad-adgroup-id"]
        }
      }
    }];

アトリビューションのインストール

初期化設定パラメータ（iOS、Android）を使ってライフサイクルイベント（アプリケーションの開封、アプリケーションのインストール、アプリケーションの更新）の自動トラッキングを有効にし、Singular でインストールとセッションをトラッキングします。上記のイベントを含む限り、Singularの「セッション」は統合によって自動的に送信されます。

カスタムイベントのトラッキング

Segmentの仕様に慣れていない方は、Trackメソッドが何をするのかを理解するためにご覧ください。

イベントを翻訳してSingularに送信するには、Segmentのトラック機能を使います：

[[SEGAnalytics sharedAnalytics] track:@"simple event"];

Analytics.with(this).track("event_name");

SegmentはすべてのイベントプロパティをSingularイベントのコールバックパラメータとして含みます。

SegmentはすべてのイベントプロパティをSingularイベントのコールバックパラメータとして含みます。イベントはレポートやユーザーレベルのエクスポートで利用できます。

注意事項

• サードパーティのパートナーや分析ソリューションを使用する場合は、互換性を保証するために、イベント名と属性を英語で渡すことを強く推奨します。
• イベント名は32 ASCII文字に制限されています。非ASCII文字の文字列は、UTF-8に変換された後、32バイト以下にする必要があります。
• 属性と値は500 ASCII文字に制限されています。

収益トラッキング

収益プロパティを含むイベントが送信されると、Singularは収益トラッキングを受信します（ゼロ値を含む）。オプションで通貨を（ISO 4217通貨コードコードとして）渡すことができます。デフォルトの通貨はUSDです。

[[SEGAnalytics sharedAnalytics] track:@"segment revenue event" properties:@{@"currency": @"USD", @"revenue":@20}];

Analytics.with(this).track("purchase", new Properties().putRevenue(2.5).putValue("currency","USD"));

カスタムユーザーID

セグメントユーザーIDをSingularに送信するには、Segmentidentifyメソッドを使用します。

• ユーザーIDはどのような識別子でも構いませんが、PII（個人を特定できる情報）を公開すべきではありません。例えば、ユーザーのメールアドレス、ユーザー名、電話番号は使用しないでください。Singularは、お客様のファーストパーティデータにのみユニークなハッシュ値を使用することを推奨します。
• Singularに渡すユーザーIDは、すべてのプラットフォーム（ウェブ/モバイル/PC/コンソール/オフライン）で同じ内部ユーザーIDを使用する必要があります。
• Singularはユーザーレベルのエクスポート、ETL、内部BIポストバック（設定されている場合）にユーザーIDを含めます。ユーザーIDはファーストパーティデータであり、Singularが他者と共有することはありません。
• 設定されたユーザーIDの値は、Segmentresetメソッドを使用して設定が解除されるか、アプリがアンインストールされるまで保持されます。アプリを終了または再起動しても、ユーザーIDは解除されません。

iOS、Androidの設定は、こちらの手順に従ってください。

[[SEGAnalytics sharedAnalytics] identify:@"segment custom user id"];

Analytics.with(context).identify("myUserId");

カスタムユーザーIDの設定を解除するには、リセットメソッドを呼び出します。

[[SEGAnalytics sharedAnalytics] reset];