アプリ内イベント

アプリ内イベントでは、ユーザーがどのようにアプリを利用しているかを把握することができます。AppsFlyerのSDKを使うと、これらのインタラクションを簡単に記録することができます。

アプリ内イベントSDKガイド

アプリ内イベントは2つの要素で構成されています。

イベント名：固有のイベント識別子です。通常、マーケターが管理画面でイベントを確認するための名前です。
イベント値：イベントパラメーターと呼ばれるキーと値のペアで構成されるオブジェクトです。イベントパラメーターは、発生したイベントに関する追加のコンテキストと情報を提供します。

イベント名とイベントパラメーターは、既定またはカスタムのいずれかです。

👍
ヒント
弊社のアプリ内イベント生成ツールを使用して、全ての主要なプラットフォームのアプリ内イベントコードをすばやく定義して生成しましょう。

SDKでは、既定のイベントやパラメーターが定数として公開されています。

イベントを送信する際には、生の文字列ではなく、定数を使用することをお勧めします。

技術的には、定義済みのイベント名/パラメーターは、次のプレフィックスを持つ文字列です： af_.

カスタムイベントの名前とパラメーターは、広告主が定義し、通常、アプリのビジネスロジックやユーザーのアプリとのインタラクションに特有のシナリオを示すものです。

🚧
注記
既定のイベントとの混同を避けるため、カスタムイベント名の前に次のプレフィックスを付けないでください： af_.

カスタムイベント名は、以下のルールに従ってください。

カスタムイベントのパラメーター：

理想的には、マーケティング担当者が、アプリ内イベントの定義のガイドに基づいて、明確なイベント構造の定義を提供すべきです。例えば、eコマースアプリの af_content_view イベントの定義は以下のようになります。

イベント名	イベントパラメーター	パラメータ値	いつ／どこで（オプション）
`af_content_view`	`af_price` `af_content_type` `af_content_id`	`af_price`：商品価格 `af_content_type`：商品カテゴリ `af_content_id`：商品SKU	ユーザーが商品の表示に移動した時。

最初の列（イベント名）は logEventの第二引数で渡される値です。

af_content_view は、管理画面でマーケターが確認するイベント名です。マーケターが提供する生の文字列値ではなく、既定イベント定数を使用することをお勧めします。
2列目（イベントパラメーター）には、そのイベントに関連するイベントパラメーターが表示されます。この場合、以下のイベントパラメーターを logEvent に渡してください： logEvent:
- af_price
- af_content_type
- af_content_id
3番目の列（パラメーター値）には、イベントパラメーターに割り当てられた特定の値に関する追加情報が含まれます。上記の例では、マーケティング担当者は、 af_content_id というイベントパラメーターが表示された商品のSKUであることを明確に伝えています。
4番目の列は、マーケターがアプリ内のどこで、いつ、そのイベントが発生するかを説明する場所です。

上記の定義例が Android と iOS にどのように実装されているかをご覧ください。

SDKでは、インターネットに接続されていないときに発生するアプリ内イベントをキャッシュすることができます。

SDKキャッシュは最大40個のイベントをキャッシュできます。最初の40個までのオフラインイベントのみが保管されます。その後（次の成功した反応まで）のものは、すべて捨てられます。