サーバー間イベントAPI for モバイル (S2S-mobile)

AppsFlyerがS2Sアプリ内イベントを処理する際、アトリビューションフィールドはAppsFlyer IDを用いて入力され、アプリ内イベントより前の関連するインストールイベントを識別します。

つまり、AppsFlyerが非オーガニックS2Sアプリ内イベントに関連付けるデータの一部は、オーガニックS2Sアプリ内イベントには関連付けられないということです。

パラメーターを入力するための値を取得するには、バックエンドロジックが必要です。次に、AppsFlyer IDの取得方法を説明します。

• AppsFlyer IDは必須で、イベントを紐付けるために使用されます。
• これは、ユーザーがモバイルアプリを初めてインストールしたときに生成されます。
• CUIDをAppsFlyer IDにマッピングするには、アプリでCUIDを設定する必要があります。 

どのユーザーがどのイベントを実行したかを簡単に把握できるようにするため、以下のフローを実装してください。

• ユーザーがアプリをインストールするときにカスタマーユーザーIDを設定してください。
• AppsFlyerのローデータレポートにはCUIDとAppsFlyer IDが含まれています。データ配信ツールのいずれかを利用するか、AppsFlyerプッシュAPIを使用してください。 
• ローデータレポートを使用して、CUIDをAppsFlyer IDと一致させてください。 
• AppsFlyer IDは、アプリに統合されたSDK（Android/iOS）で利用可能です。
• AppsFlyer IDをカスタマーユーザーIDに社内システムでマッピングしてください（将来の利用に重要です）。

AppsFlyer IDをCUIDとマッピングすると、ユーザーと実行されたイベントを結び付けることができます。その後、他の値（イベントの価値、イベント通貨、イベント時間など）を取得し、サーバー間でアプリ内イベントを送信できます。

appsflyer_idは、サーバー間イベントメッセージにおける必須パラメーターです。AppsFlyerは、このパラメーターを使用して、イベントを元のデバイスと関連付けられたメディアソースに紐付けます。次のいずれかの方法でIDを取得できます。

• モバイルデバイスからAppsFlyer SDK APIを呼び出して取得:
  AndroidネイティブiOSネイティブUnityReact Native

  getAppsFlyerUIDを取得

  getAppsFlyerUIDを取得

  getAppsFlyerIdを取得

  getAppsFlyerUIDを取得

• AppsFlyerプラットフォームから次のいずれかを使用して取得してください:プルAPI, プッシュAPI, エクスポート ローデータインストール。

altタイムスタンプロジック図alt

S2SイベントがAppsFlyerに一括で到着すると、eventTimeプロパティの値と到着時間に基づいてタイムスタンプが付与されます。eventTimeプロパティはアプリ内イベントの発生時間を示します。

到着すると、イベントには以下のようにタイムスタンプが付けられます。

• eventTimeパラメータがイベントレコードに含まれていない場合、イベントの時間はHTTPメッセージの到着時間に設定されます。
• 02:00 UTCより前に到着したイベントにはeventTime値がスタンプされます。つまり、イベントにeventTimeのスタンプが付けられるためには、イベント当日か翌日02:00 UTCまでに報告される必要があります。
• 前日またはそれ以前に発生したイベントで02:00 UTC以降に到着した場合、到着時刻（APIコールの時間）でスタンプされます。
• 将来のeventTime値で到着するイベント（イベント時間が到着時間を超える場合）：
  • 報告されたeventTime時間と到着時間が同じ日付である場合、イベントはeventTime値でタイムスタンプされます。
  • 報告されたeventTimeが次の日付である場合、イベントは到着時間でタイムスタンプされます。
• 無効なeventTime値を持つイベントはHTTPメッセージの到着時間でスタンプされます。

例

• eventTime = 月曜日の21:00でイベントが送信されます。

収益値がマイナスのイベントは送信可能です。たとえば、購入がキャンセルされた場合です。これを記録するために、パラメータaf_revenueに負の値を設定できます。 

af_quantityを設定する場合、システムロジックに応じて負の値を設定することを検討してください。AppsFlyer はaf_quantity を使用していません。

• エンドポイント：利用しているエンドポイントが正しいことを確認してください。
• ペイロードに必須パラメーターが含まれていることを確認してください。こちらをご覧ください。
• イベントの起動に使用しているAppsFlyer IDが実際のappsflyer_idであり、実際のアプリインストールに関連していることを確認します。こちらをご覧ください。
• S2Sイベントは、1つのS2Sリクエストでマルチイベントをサポートしません。各イベントは個別のイベントとして送信する必要があります。
  • 応答時間を短縮するため、非同期方式でイベントを送信することができます。
• 概要管理画面では、日付範囲はアプリインストール日（LTV）に関連付けられ、イベントの日付ではありません。
  • 正しい日付範囲を選択するようにしてください。
  • 管理画面の日付範囲が、イベントの日付ではなく、デバイスのインストール日（appsflyer_id）に対応していることを確認してください。
• イベントローデータレポート：日付範囲はイベントの日付に関連し、インストール日ではありません。 

もしS2Sイベントを送信しても収益が記録されない場合は、送信するJSONが文字列化されていることを確認してください。最も重要な部分は、JSON内のイベント値パラメーターです。次の例に示すように、文字列化する必要があります。

"{\"af_revenue\":\"6\" ,\"af_content_type\":\"wallets\"}"

文字列化されていない場合、イベント価値が正しく処理されず、収益が記録されません。

収益の値はいかなる形式でもフォーマットしないでください。小数点を含めることができます。通貨記号やコード、, 区切り文字を含めないでください。収益には-のプレフィックスを付けることができます。

• 有効な値の例: 123、-123.45、123.456 
• 無効な値の例: 1,234.56、1,234

ローデータフィールドには、S2S コールで送信された値のみが入力されます（インストールイベントから生成された値を入力できるポストバックフィールドとは異なります）。

次のフィールドは S2S APIを通じて報告できないため、ローデータレポートの S2S イベントには入力されません。

• WIFI
• オペレーター
• 言語
• デバイスモデル
• デバイスカテゴリ
• アプリバージョンapp_version_nameを利用できます
• アプリ名
• ユーザーエージェント

S2Sイベント（ログインイベントなど）は、アプリがインストールされてSDKが起動されるとすぐにAppsFlyerに届きます。しかし、AppsFlyerがインストールイベントの処理を完了する前に、これらのS2Sアプリ内イベントが到着した場合（通常20〜30秒以上かかります）、それらは非アトリビュートのオーガニックイベントとしてマークされることがあります。

インストール直後に発生するS2Sアプリ内のイベントをサーバーに報告する前に、短い遅延を設けることをお勧めします。