AppsFlyerアプリイベントコネクタのセットアップガイド | サーバーサイドコネクタ

コネクタのアクション

アクション名	AudienceStream	EventStream
インストールをトラッキング	✓	✓
アプリ内イベントをトラッキング	✓	✓
アプリ内イベントをトラッキング (SDKクライアント)	✓	✓

設定の構成

コネクタマーケットプレイスに移動して、新しいコネクタを追加します。コネクタを追加する方法の一般的な手順については、コネクタの概要の記事を読んでください。

コネクタを追加した後、次の設定を構成します：

アプリID
- これはデータを渡すアプリのAppsFlyerアプリIDです。
Devキー
- AppsFlyerダッシュボードのアプリ設定画面から取得したアカウントのDevキーです。

S2Sキーはアクセスを有効にするために使用されます。詳細については、AppsFlyer：APIとサーバー間のS2Sトークンの管理を参照してください。

アクションの設定 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでコネクタのアクションを構成します。

アクション名ボックスにアクションの名前を入力します。
アクションタイプリストからアクションのタイプを選択します。
プラットフォームリストからイベントの発生元のプラットフォームを選択します。選択によって、マッピングテーブルに表示されるパラメータが決まります。
- Android
- iOS
- Windows

このセクションでは、各アクションのパラメータとオプションの設定方法について説明します。

アクション - インストールをトラッキング

パラメータ

プラットフォームデータのパラメータは必須です。Apple Search Adsとカスタムデータのパラメータはオプションです。

プラットフォームデータ

パラメータ	プラットフォーム	説明
Ad ID Enabled Flag (必須)	すべて	このパラメータを`true`に設定して、ユーザーをAppsFlyerAnalyticsからオプトアウトします。
App Open Counter (必須)	すべて	このパラメータを`1`または`2`に設定して、最初の起動のアトリビューションに使用するか、`3`以上に設定してリターゲティングに使用します。
Device Advertising ID (必須)	AndroidまたはWindows	デバイスの広告IDです。例：`caf5555d48f22222d34f03bcd7ab333b`。
Device IP Address (必須)	すべて	デバイスのIPアドレスです。
Device Locale (必須)	すべて	デバイスのロケールです。例：`en-US`。
Device Type/Model (必須)	すべて	デバイスのタイプまたはモデルです。
Install Date (必須)	すべて	デバイス上のアプリケーションの最初の起動日またはインストール日です。ISO 8601 UTC形式で指定します。例：`2015-01-22T08:45:33.412`。
iOS Ad ID (必須)	iOS	広告主向けのOS ID（`advertisingIdentifier`）で、SHA1ハッシュ化することができます。例：`AC9FB4FB-AAAA-BBBB-88E6-2840D9BB17F4`。
OS Version (必須)	すべて	オペレーティングシステムのバージョンです。
Unique User ID (必須)	すべて	ユニークなユーザーIDです。例：`1b1758cd-c22b-461e-924e-ceb0c7f849aa`。
User Agent (必須)	すべて	アプリケーションのユーザーエージェントです。
App Bundle ID	iOS	アプリのバンドルIDです。例：`com.company.appname`。
Customer User ID	IOSおよびAndroid	開発者が設定した顧客ユーザーID。広告主のシステムでは、これをユーザー識別子として使用します。例：`3d4d05e5-9ae4-4755-9363-8166568f7935`。
Device IMEI	Android	デバイスのIMEI（International Mobile Equipment Identity）で、SHA1ハッシュ化することができます。
Device Android ID	Android	デバイスのAndroid IDで、SHA1ハッシュ化することができます。
Facebook Tracking Cookie Value	AndroidおよびWindows	Facebookトラッキングクッキーの値です。
Full DeepLink URL	すべて	トラッキングコールの完全なDeepLink URLです。例：`myapp://page/1?param1=val1`。
Google Play Referrer	Android	Google Playレシーバーから受け取ったリファラーです。URLエンコードは行いません。例：`af_tranid=1A4F123KJHG73F0P&c=c1&pid=MediaSource1`。
Microsoft Store Referrer	Windows	Microsoft Storeから受け取ったWindowsリファラーです。URLエンコードは行いません。例：`af_tranid=1A4F123KJHG73F0P`。
iOS Identifier for Vendor	iOS	ベンダーのためのiOS識別子です。例：`95C9BD22-4A4C-41C8-9548-ED07C5C8C145`。
App Tracking Transparency	iOS 14以降	このパラメータを設定して、ユーザーがIDFAの使用をオプトアウトしたかどうかを示します： `0`：決定されていません。 `1`：制限されています。 `2`：拒否されました。 `3`：許可されました。詳細については、Apple：ATTrackingManager.AuthorizationStatusを参照してください。
App Type	iOS	これがアプリクリップのインストールである場合。
Open Anonymous Device Identifier	Android	オープン匿名デバイス識別子です。例：`57cfbf44-edfc-9f25-7fcf-7 3fdffc59929`。
Amazon Advertising ID	Android	Amazonデバイスのユニークな広告IDです。例：`24c5f114-7718-4a12-97d9-1273397be3c6`。
App Store	Android	アプリのダウンロード元のストアです。

Apple Search Ads

パラメータ	説明
iad-adgroup-id	Ad IDグループID。
iad-adgroup-name	Ad IDグループ名。
iad-attribution	Ad IDのアトリビューション。
iad-campaign-id	Ad IDキャンペーンID。
iad-campaign-name	Ad IDキャンペーン名。
iad-click-date	Ad IDクリック日。
iad-conversion-date	Ad IDコンバージョン日。
iad-keyword	Ad IDキーワード。
iad-lineitem-id	Ad IDラインアイテム。
iad-lineitem-name	Ad IDラインアイテム名。
iad-org-name	Ad ID組織名。

カスタムデータ

このセクションを使用して、イベントメッセージにカスタマイズされた情報を追加します。

アクション - アプリ内イベントをトラッキング

パラメータ

プラットフォームデータおよびイベントデータパラメータは必須です。カスタムデータパラメータはオプションです。

プラットフォームデータ

このアクションでは、インストールをトラッキングアクションと同じプラットフォームデータパラメータを使用します。

イベントデータ

パラメータ	説明
イベント通貨	イベントのデフォルト通貨 `USD`の場合のみ、イベントプロパティ（`event_value`）セクションの`af_currency`キーを使用してマッピングテーブルにマップします。
イベント名 (必須)	イベント名を表す文字列。例：`af_purchase`。

カスタムデータ

このセクションを使用して、イベントメッセージにカスタマイズされた情報を追加します。

アプリ内イベントをトラッキング (SDKクライアント)

このアクションは、AppsFlyer SDKがインストールされており、アプリ外で発生するモバイルイベントを送信したい場合に使用します。

プラットフォームデータ

パラメータ	プラットフォーム	説明
Appsflyer ID	すべて	(必須) アプリが初めて起動したときにAppsFlyerによって生成される一意の識別子です。
Advertising ID	Android	デバイスの広告IDです。
Open Anonymous Device Identifier	Android	オープン匿名デバイス識別子です。
Amazon Advertising ID	Android	Amazon広告IDです。
Device IMEI	Android	デバイスのIMEIで、SHA1ハッシュ化することができます。
iOS Ad ID	iOS	広告主向けのOS ID（`advertisingIdentifier`）で、SHA1ハッシュ化することができます。
iOS Identifier for Vendor	iOS	ベンダーのためのiOS識別子です。
Advertising ID Enabled Flag	iOS	ユーザーが広告主IDの共有をオプトアウトしたかどうかを示すためのブールフラグです。
App Tracking Transparency	iOS 14以降	このパラメータを設定して、ユーザーがIDFAの使用をオプトアウトしたかどうかを示します： `0`：決定されていません。 `1`：制限されています。 `2`：拒否されました。 `3`：許可されました。詳細については、Apple：ATTrackingManager.AuthorizationStatusを参照してください。
App Store	すべて	アプリクリップのインストールである場合。
App Type	すべて	ユーザーイベントが`app_clip`で発生する場合は、パラメータを送信します。それ以外の場合はパラメータを送信しないでください。
App Version Name	すべて	アプリのバージョン名です。
Bundle Identifier	すべて	一意のアプリ識別子です。生データでは、パラメータはBundle IDに入ります。
Customer User ID	すべて	開発者が設定した顧客ユーザーIDです。これは広告主のシステムでユーザー識別子として使用されます。
Event Time	すべて	イベントが発生した時刻（UTCタイムゾーン）です。設定されていない場合、Appsflyerは受信したイベント時刻を使用します。
IP Address	すべて	イベント発生時のモバイルデバイスのIPアドレスです。送信された場合、IPアドレスはジオロケーションフィールドに入力されます。送信されない場合、AppsFlyerはインストールアトリビューションイベントの値を使用してジオロケーションフィールドを入力します。
Operating System	すべて	デバイスのオペレーティングシステムバージョンです。
Sharing Filter	すべて	共有フィルタは、ポストバック/APIを介したS2Sイベントのパートナーや他のサードパーティ統合による共有をブロックします。すべてのパートナーをブロックするには`all`を設定します。特定のパートナーをブロックするには、パートナーIDの配列を渡します。

イベントデータ

パラメータ	説明
イベント名	(必須) イベント名を表す文字列。例：`af_purchase`。
イベント通貨	イベントのデフォルト通貨。例：`USD`。
カスタムデータ	このセクションを使用して、イベントメッセージに追加のカスタマイズ情報を追加します。