概要

アプリ内イベントを利用すると、流入元ごとのアプリのエンゲージメントやユーザーの質を計測し、適切なユーザー獲得戦略を立てられます。アドネットワークは、アプリ内イベントの情報を使ってキャンペーンを最適化し、アクションやイベントの発生に応じて課金するキャンペーンを運用します。アプリ内イベントのデータは、リアルタイムのポストバックでアドネットワークに送信されます。リッチアプリ内イベントの詳細はこちら。

ポストバックするアプリ内イベントの選択

広告主は、この記事で説明する設定を使って、アドネットワークにポストバックを送信するアプリ内イベントを選択できます。

アプリ内イベントのポストバック期間

たとえば、インストールから15日以内に発生したイベントが課金対象になる場合は、次のように設定します。

期間を過ぎたイベントのポストバックは送信されず、アドネットワークへの通知も行われません。ただし、AppsFlyerでは引き続きイベントが記録され、そのアドネットワークにアトリビューションされます。

ポストバックを送信するかどうかは、常に現在の期間設定に基づいて判断されます。次の例をご覧ください。

デフォルトのポストバック期間

アプリ内イベントのポストバックを初めて設定する際は、期間が自動的に6か月に設定されます。

ポストバック期間を設定できるユーザー

次のユーザーがポストバック期間を設定できます。

• 広告主
• ［アプリ内イベントのポストバック設定を許可］の権限を付与された代理店。
  注意：同じアドネットワークを利用する広告主と代理店は、それぞれの契約に基づいて、ポストバック期間を個別に設定できます。
• ［アプリ内イベントのポストバック設定を許可］の権限を付与されたパートナー。

イベントのマッピング

同じ種類のイベントでも、広告主によって異なる名前が付けられることがあります。また、広告主が付けたイベント名とパートナー側のイベント名が異なる場合もあります。

たとえば、アプリ内でユーザーが商品を購入した場合、広告主はイベントにpurchaseという名前や、内容の分かりにくいevent5などのIDを付ける一方、パートナーはpurchase_eventという名前を使っていることがあります。

広告主とパートナーで同じイベントを対応付けるには、イベント名のマッピングが必要です。  

マッピング方法

アプリ内イベントのマッピングに使用する方法は、パートナーごとに次の中から定められています。

• パートナーのイベントIDを入力
• リストからイベントIDを選択
• イベントをそのまま送信（マッピングなし） 

パートナーのイベントIDを入力

• AppsFlyerイベント：アプリのイベント一覧からイベントを選択します。
• パートナー側のイベント名／ID：AppsFlyerイベントに対応する、パートナーから提供されたイベントIDをテキストフィールドに入力します。

注意

• イベント名では大文字と小文字が区別されます。不一致を防ぐため、すべてのメディアソースとアプリのバージョンで、正しいイベント名を使用してください。
• イベント名を入力する際は、名前の前後にアンダースコア（_）を付けることができます。ただし、AppsFlyerから送信されるイベント名にも、まったく同じアンダースコアが付いている場合に限って使用してください。

リストからイベントIDを選択

• AppsFlyerイベント：アプリのイベント一覧からイベントを選択します。
• パートナー側のイベント名／ID：パートナーが定義したイベントの一覧から、AppsFlyerイベントに対応するイベントを選択します。

イベントをそのまま送信（マッピングなし）

一部のパートナーは、マッピングせずにアプリ内イベントのポストバックを受信する方式を採用しています。この場合、イベント名はアプリで使用している名前のまま送信されます。イベント名がpurchase、acquisition、event5のいずれであっても、そのまま送信されます。

マッピングせずにパートナーに送信するイベントは、次の方法で選択できます。

• 手動で追加：特定のイベントを選択します。
• すべてのイベントを送信（アンインストールとセッションを除く）。アンインストール、セッション（アプリの起動）、af_app_openedイベントは含まれません。

注意

広告主が意図せずサードパーティの分析プラットフォームに過剰な情報を共有することを防ぐため、2019年3月以降、これらのプラットフォームでは［すべてのイベントを送信（アンインストールとセッションを除く）］の選択肢を廃止しました。それ以前に設定された分析プラットフォームでは、引き続きこの選択肢を利用できます。

イベントを手動で追加するには：

1. ［イベントを追加］をクリックします。
2. ポストバックのオプションを選択します。
   • AppsFlyerイベント：アプリのイベント一覧からイベントを選択します。
   • 対象ユーザーの流入元：イベントの送信対象を選択します。
   • 送信するデータ：ポストバックに含めるデータを選択します。
3. ほかのイベントも同じ手順で追加します。 

すべてのイベントを送信するには：

1. ［すべてのイベントを送信（アンインストールとセッションを除く）］を選択します。
2. ポストバックのオプションを選択します。
    
   • 対象ユーザーの流入元：すべてのイベントに適用する送信対象を選択します。
   • 送信するデータ：すべてのイベントのポストバックに含めるデータを選択します。

イベントのマッピングについて詳しくは、アプリ内イベントのポストバックをご覧ください。 

ポストバックの送信対象

イベントごとに、ポストバック期間内のどのイベントを送信するかを選択できます。

• このパートナーのみ：このパートナーにアトリビューションされたイベントのみ、ポストバックを送信します。つまり、そのパートナー経由で流入したユーザーが実行したイベントが対象です。
• オーガニックを含むすべてのメディアソース：どのパートナーにアトリビューションされたイベントでも、オーガニックイベントも含め、このパートナーにポストバックを送信します。つまり、ユーザーの流入元を問わず、イベントが送信対象となります。注意：［オーガニックを含むすべてのメディアソース］を選択した場合、ほかのパートナーにアトリビューションされたイベントのポストバックには、アトリビューションデータは含まれません。

ポストバックに含めるデータ

ポストバックでパートナーに共有するイベントデータの種類を選択できます。次のいずれかを選択します。

• イベント値・収益を送信しない：イベントの発生のみを送信し、イベント値や収益などのパラメータは送信しません。
• 収益を除くイベント値を送信：収益の値を除くすべてのパラメータを送信します。
• イベント値・収益を送信：収益の値がイベントに存在する場合は、その値を含むすべてのイベントパラメータを送信します。
• イベント値・収益・純収益を送信：収益と純収益の値がイベントに存在する場合は、それらを含むすべてのイベントパラメータを送信します。

アドネットワークによるキャンペーンの最適化と成果の向上を目的とする場合は、収益データの共有を推奨します。ただし、収益データの共有は必須ではありません。収益の共有は、イベント値にaf_revenueまたはaf_projected_revenueが定義されているイベントに対してのみ有効にしてください。これらが定義されていないと、アドネットワークは収益の値が空のイベントを受信します。

収益の共有

ポストバックでは、af_revenueとaf_currencyが、event_valueのJSONの外側にそれぞれmonetaryとcurrencyとして記述され、個別に送信できます。ポストバックの構造例：

https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&content_id=(af_content_id)

［イベント値・収益・純収益を送信］を選択すると、af_net_revenueも、event_valueのJSONの外側にnet-monetaryとして記述し、個別に送信できます。ポストバックの構造例：

https://appsflyer.com/push?event_value=(event-value)&monetary=(monetary)&net-monetary=(net-monetary)&content_id=(af_content_id)

例

広告主が、次のevent_valueを含む購入イベントを送信します。

{"af_currency":"USD","af_content_id":"1234567","af_revenue":50.87,"af_content_type":"category_a"}

各パラメータがどのように送信されるかを、次の表に示します。

条件付きアプリ内イベントポストバック

複数の条件を使ってアプリ内イベントのポストバックを絞り込み、条件ごとに異なるイベントにマッピングできます。セルフレポーティングネットワーク（SRN）や分析パートナーを含む各パートナーには、フィルター条件を満たすイベントのみが送信されます。この機能は、次の目的に利用できます。

• ユーザーのセグメント化、パーソナライズ、リテンションの最適化
• 共有するデータの最小化
• ユーザーのプライバシー保護

例

ゲームアプリの広告主が、レベル10またはレベル50をクリアしたユーザー、もしくはアプリ内購入で3ドルを支払ったユーザーのみを対象に、アドネットワークで実施中のキャンペーンを最適化するとします。

このイベントの条件は、次のように設定します。

• levelが10の場合、fb_mobile_level_acheivedにマッピングします。
  それ以外の場合（OR）：
• levelが50の場合、fb_mobile_level_acheivedにマッピングします。
  それ以外の場合（OR）：
• costが3の場合、fb_mobile_purchaseにマッピングします。

イベントの条件を設定するには：

1. パートナーの連携ページで、パートナーに送信するアプリ内イベントを定義してマッピングします。
2. 対象イベントの［条件を追加］アイコンをクリックします。
3. 次の条件フィールドを、イベント値に記録されているとおりに入力します。
   • プロパティ名
   • 値
   • 条件に対応付けるパートナーイベント（いずれかのマッピング方法を使用）
4. 条件をさらに追加する場合は、先に既存の条件のすべてのフィールドを入力してください。
5. ［連携を保存］をクリックします。 

設定時の留意事項

条件を設定する際は、パートナーにイベントが送信されるよう、次の点を確認してください。

複数イベントの一括編集

イベントのマッピング時には、［対象ユーザーの流入元］と［送信するデータ］の値を、複数のイベントで一括変更できます。

複数のイベントを編集するには：

1. 更新するイベントを選択します。
2. ［一括操作］をクリックします。
3. 選択したすべてのイベントに適用する新しい設定を選択します。
   • 対象ユーザーの流入元（いずれか1つを選択）
     • このパートナーのみ
     • オーガニックを含むすべてのメディアソース
   • 送信するデータ（いずれか1つを選択）
     • データを送信しない（デフォルト）
     • 収益を除くイベント値を送信
     • イベント値・収益を送信

カスタムイベント

マッピングできるイベントの一覧には、SDKから、またはサーバー間イベントとしてAppsFlyerに送信され、すでに記録されたイベントのみが表示されます。マッピングしたいイベントがドロップダウンに表示されない場合、次の理由が考えられます。

• そのイベントをまだ誰も実行していない
• 最後にそのイベントが発生してから2週間以上経過している
• 記録されているイベントの数が多い

いずれの場合も、イベントをパートナーIDにマッピングするには、次の手順を実施します。

1. ドロップダウンで［+ 項目を追加］をクリックします。
2. 追加するイベントの名前をテキストボックスに入力します。
3. チェックマークをクリックして確定します。追加したイベントが一覧に表示され、選択できるようになります。
4. イベントをパートナー側の識別子にマッピングします。
5. ［連携を保存］をクリックして、マッピングを保存します。

代理店とアドネットワークには、次の制限があります。

• カスタムイベントは追加できません。
• 広告主がイベントを追加し、必要な権限を付与した後にのみ、イベントの表示やマッピングを行えます。

アドネットワークによるイベントのマッピング

広告主は、アドネットワーク自身がイベントをマッピングできるように設定できます。そのためには、次の手順でアドネットワークに必要な権限を付与します。

1. ［有効な連携］ページで、権限を付与するパートナーを検索します。
2. ［権限］タブで［アプリ内イベントのポストバック設定を許可］をオンにします。

権限を付与されたアドネットワークは、 「パートナーのイベントIDを入力」の手順に従って、イベントをマッピングできます。

代理店によるイベントのマッピング

広告主は、代理店がアプリ内イベントのポストバックを設定できるようにすることもできます。

代理店にアプリ内イベントのポストバック設定権限を付与するには：

1. ［有効な連携］ページで代理店を検索します。
2. 代理店がすべてのイベントを共有できるようにするか、特定のアドネットワークにアトリビューションされたイベントのみ共有できるようにするかを選択します。
3. 代理店によるイベント収益の送信を許可するかどうかを選択します。
4. 代理店による共有を許可するイベントを選択します。

関連記事

• リッチアプリ内イベント ｜ 概要
• リッチアプリ内イベント ｜ イベント構造