どのようにお手伝いできますか?

アプリ内イベントポストバック設定

  • 更新

概要:アプリエンゲージメントとユーザーの質を測定し、アプリ内イベントデータを利用してキャンペーンを最適化します。

概要

アプリ内イベントにより、マーケターはさまざまなソースからアプリエンゲージメントとユーザーの質を測定し、適切なユーザー獲得戦略を構築できます。アドネットワークは、アプリ内イベント情報を利用してキャンペーンを最適化し、CPAまたはイベント単価キャンペーンを実行します。アドネットワークは、ポストバックを介してリアルタイムでアプリ内イベントデータを受信します。リッチアプリ内イベントに関する詳細はこちら。

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

マーケターは、本記事で説明する設定を用いて、どのアプリ内イベントに対しアドネットワークにポストバックを送信するか選択できます。

注記

  • アプリ内イベントには拒否されたイベント、つまり、Protect360によってブロックされた、または検証ルールの条件を満たさないイベントが含まれています。
  • アプリ内イベントポストバックセクションが連携タブに存在しない場合は、パートナーがまだAppsFlyerでのアプリ内イベント記録を予備設定していないことを意味します。パートナーは、パートナーアシスタントウィジェットを使用してAppsFlyerに連絡し、連携を完了できます。

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

アプリ内イベントポストバック期間は、CPA (アクション単価) ベースでネットワークと作業するマーケターが、コンバージョン後の期間を設定し、その後はイベントポストバックが送信されないようにすることを可能にします。

例えば、ユーザーがインストールしてから15日以内に発生するイベントに課金される場合、このように期間を設定します。

15-day_in_app_event_postback_setting.png

この期間を超えるとポストバックは送信されず、ネットワークにも通知されませんが、イベントはAppsFlyerに記録され続け、ネットワークに帰属します。

ポストバックは常に現行の期間設定に基づいて送信されます。次の例を参照してください。

1月1日

期間は15日です。

ユーザーがアプリをインストールします。

1月2日 期間は10日に変更されます。
1月14日

ユーザーが購入します。

イベントが現行の期間(10日) 内に含まれないため、ポストバックはアドネットワークに送信されません。

1月15日 期間は20日に変更されます。
1月18日

ユーザーによる再度の購入。

今回は、イベントが現在の期間内(20日間)に入っているため、ポストバックが送信されます。

注

「オーガニックを含むすべてのメディアソース」が選択されている場合、このルールは適用されません。この場合、この設定を行ったパートナーは、たとえそのコンバージョンイベントの帰属先が別のパートナーであったとしても、設定を行ったパートナーに対して定義されたポストバック期間内にイベントが発生した限り、広告主が受信するすべてのコンバージョンイベントについてポストバックを受け取ります。

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

アプリ内イベントのポストバック設定を始める際、デフォルトの期間は自動で6か月に設定されます。

注記

2019年7月30日より前に、パートナーのアプリ内イベントポストバックを利用し始めた場合、デフォルトの期間設定はライフタイム(制限なし)です。つまり、アプリ内イベントのポストバックは常に送信されます。

ポストバック期間を設定できるのは誰か

  • マーケター
  • 代理店(アプリ内イベントのポストバック設定を許可する 権限がある場合)。
    注:同じアドネットワークを利用するマーケターと代理店は、それぞれ独自にポストバック期間を設定できます。これはネットワークとの契約に基づきます。
  • パートナー(アプリ内イベントのポストバック設定を許可する 権限がある場合)。

イベントマッピング

各マーケターは同じタイプのイベントに異なる名前を付けられます。これらのイベント名はパートナーの名義と異なることもあります。

例えば、ユーザーがアプリ内で購入をすると、あるマーケターはそれを purchase や event5 など、情報量の少ないIDで命名し、パートナーは purchase_event と名付けるかもしれません。

マーケターのイベントがパートナーのイベントと一致するようにするには、イベント名をマッピングする必要があります。  

 注

特定のパートナーの連携タブでマッピングされたイベントは、標準のポストバックおよび SKAN ポストバック の両方に適用されます。

マッピング方法

各パートナーは、以下の方法のいずれかを選んでアプリ内イベントをマッピングします。

注記

  • 全てのパートナーに全てのマッピング方法があるわけではありません。
  • マッピングをパートナー自らが行える 権限を与えることが可能です。

パートナーイベントIDを入力してください。

  • AppsFlyerイベント: アプリイベントのリストからイベントを選んでください。
  • パートナーイベントにマッピング済み:テキストフィールドに、パートナーから受け取った、アプリイベント(AppsFlyerイベント)に対応するイベントIDを入力してください。

注記

  • イベント名では大文字と小文字が区別されます。不一致を避けるために、すべてのメディアソースとアプリバージョンで正しいイベント名を使用するようにしましょう。
  • イベント名を入力する際、イベント名の前後にアンダースコア(低いダッシュ)を使用できます。AppsFlyerから送信されるイベント名が正確に同じアンダースコアを持っている場合にのみ、アンダースコアを使用してください。

enter_event_name.png

リストからイベントIDを選択してください。

  • AppsFlyerイベント: アプリイベントのリストからイベントを選択します。
  • パートナーイベントにマッピング済み:定義済みのパートナーイベントのリストから、アプリイベント(AppsFlyerイベント)に対応するイベントを選択します。

In-app_event_postbacks_en-us.png

イベント名をそのまま送信する(マッピングなし)

一部のパートナーは、マッピングされていないアプリ内イベントポストバックを好みます。つまり、イベント名はアプリでの名前どおりに送信されます。イベント名が 購入、獲得、イベント5 であっても構いません。

パートナーに送信する未マッピングのイベントを選択できます。

  • 手動で追加:特定のイベントを選択してください。
  • すべてのイベントを送信(アンインストールとセッションは除外):すべてのイベントを送信します。これには、アンインストール、セッション(アプリの起動)、af_app_openedイベントは含まれません。

注記

広告主が意図せず第三者のアナリティクスプラットフォームと情報を共有しすぎないようにするため、2019年3月以降、アナリティクスプラットフォームに対して、[Send All Events (excludes uninstalls and sessions)](すべてのイベントを送信 - アンインストールとセッションを除く)オプションを削除しました。この日付以前に設定された分析プラットフォームでは、このオプションがそのまま保持されています。

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

  1. イベントを追加をクリックしてください。
  2. ポストバックオプションを選択してください:
    • AppsFlyerイベント: アプリイベントのリストからイベントを選択します。
    • ユーザー向け:イベントの送信オプションを選択します。
    • 含む:ポストバックに含めるデータを選択します。
  3. さらにイベントに対してこの手順を繰り返してください。 

send_postbacks_as_is_en-us.png

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

  1. 「すべてのイベントを送信(アンインストールとセッションを除く)」を選択します。
  2. ポストバックオプションを選択してください:
     

send_postbacsk_as_is_no_mapping.png

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

ポストバック送信のオプション

各イベントで、どのような場合にポストバックを送信するかを選択できます(ポストバック期間内)。

  • このパートナーのみ:イベントがこのパートナーに起因する場合、つまり、イベントを実行したユーザーがこのパートナーから来た場合にのみ、ポストバックを送信します。
  • オーガニックを含む全メディアソース:任意のパートナーに起因するイベントやオーガニックイベント、つまりイベントを実行したユーザーがどのメディアソースから来た場合でも、すべてのメディアソースにポストバックを送信します。 注:オーガニックを含むすべてのメディアソースを選択した場合、他のパートナーのポストバックにはアトリビューションデータは含まれません。

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

ポストバックでアドネットワークと共有するイベントデータの種類を選択することができます。次のいずれかのオプションを選択します。

  • 値も収益もなし:パラメーター(値または収益)なしでイベント自体のみを送信します。
  • 値有りで収益なし:収益値以外のすべてのパラメーターを送信します。
  • Values & revenue(値も収益も送信する):収益値を含む全てのイベントパラメーターを送信します(存在する場合)。
  • 価値 / 収益 / 純収益イベントに含まれる収益値および純収益値(イベントに存在する場合)を含む、すべてのイベントパラメーターを送信してください。

注

「値、収益、純収益」オプションをご利用いただくには、ROI360 Advancedのサブスクリプションが必要です。また、このオプションは およびaf_ars_* イベントでのみaf_purchase*ご利用いただけます。

広告ネットワークがキャンペーンを最適化し、結果を改善するためには収益の共有をお勧めします。ただし、収益の共有は必須ではありません。イベントの価値にaf_revenueが定義されている場合のみ、収益共有を有効にしてください。それ以外の場合、広告ネットワークは収益値が空のイベントを受け取ります。

シェア収益

ポストバックでは、af_revenueおよびaf_currencyはJSONevent_valueの外側に「monetary」および「currency」として記述され、個別に送信することができます。ポストバック構造の例:

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

「値、収益、net revenue」オプションが選択されている場合、af_net_revenueJSONのevent_value外部に「net-monetary」として記述し、別途送信することも可能です。ポストバック構造の例:

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

注

「値なし・収益なし」または「値あり・収益なし」を選択した場合、それぞれのパラメーターは「N/A」で表示されます。

ヒント

アプリ内イベントポストバック設定では、標準のマネタリーパラメータ()にグロス収益の代わりとしてネット収益を送信することも可能です。この設定を利用するには、Customer Success Manager(CSM)へお問い合わせください。

 例

マーケティング担当者は、次の event_value と共に購入イベントを送信します:event_valueevent_value

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

以下の表は、パラメーターがどのように送信されるかを示しています。

フィールド名 イベント価値 金銭的 通貨 net-monetary
価値なし & 収益なし 該当なし 該当なし 該当なし 該当なし
価値あり & 収益なし {"af_currency":"N/A","af_content_id":"1234567","af_revenue":"N/A","af_content_type":"category_a"}&monetary=N/A&content_id=1234567 該当なし 該当なし 該当なし
価値あり & 収益あり {"af_currency":"USD","af_content_id":"1234567","af_revenue":50.87,"af_content_type":"category_a"}&monetary=50.87&content_id=1234567 50.87 米ドル 該当なし
価値 / 収益 / 純収益 {"af_currency":"USD","af_content_id":"1234567","af_revenue":50.87,"af_net_revenue":35.61,"af_content_type":"category_a"}&monetary=50.87&net-monetary=35.61&content_id=1234567 50.87 米ドル 35.61

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

異なるイベントにマッピングできる複数の条件を使用してアプリ内イベントのポストバックをフィルタリングします。フィルター条件を満たすイベントのみがSRNやAnalyticsパートナーなどのパートナーに送信されます。この機能は次の用途に利用します:

  • ユーザーのセグメンテーション、パーソナライゼーション、リテンションの最適化
  • データの最小化
  • ユーザーブライバシーの保護

 例

ゲームアプリのマーケティング担当者は、アドネットワークを通じて行っているキャンペーンを最適化しようとしていますが、その対象はレベル10またはレベル50に到達したユーザーや、アプリ購入に3ドルを使うユーザーのみです。

in_app_event_condition__1_.png

このイベントの条件は次のように設定されています:

  • レベル が10に等しいとき、fb_mobile_level_acheivedにマップします。
    それ以外の場合(または)、
  • レベル が50に等しいとき、fb_mobile_level_acheivedにマップします。
    それ以外の場合(または)、
  • コスト が3に等しいとき、fb_mobile_purchaseにマップします。

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

  1. パートナー連携ページで、定義しマッピングする必要のあるアプリ内イベントをパートナーに送信します。
  2. 必要なイベントのアイコンimage.pngをクリックして条件を追加します。
  3. イベント価値で表示される条件フィールドを入力します。
    • プロパティ名
    • 価値
    • 条件をマッピングするパートナーイベント(これらのマッピングオプションのいずれかを使用)
  4. さらに条件を追加できますが、まず既存の条件の全てのフィールドを入力してください。
  5. 統合を保存をクリックします。 

考慮事項

条件を構成する際に、パートナーに送信されるイベントについて次の考慮事項が満たされていることを確認してください。

条件の構造

  • 条件のプロパティと値がイベントのデータと一致している必要があります。
  • 現在、条件は「等しい」のみ設定可能です。
  • 配列などの複雑な構造はサポートしていません。

イベントに対する複数の条件 

  • 1つのイベントに設定できる条件は最大5つです。
  • ポストバックを送信するには、少なくとも1つの条件を満たす必要がありますが、実行されるのは1つのみです。
  • 条件は出現順にチェックし、最初に満たされた条件を実行します。
  • 各条件は個別にマッピングされます。パートナーイベント名が「条件に基づく」に変更されます。
  • 複数の条件が同じプロパティまたは同じ値を持つことは可能ですが、2つの条件が同時に同じプロパティと値を持つことはできません。
  • 複数の条件を同一のイベントにマッピングすることが可能です。

注記

  • この機能は、キャンペーンの最適化に与える影響を把握するために、テストアプリやマイナーなイベントなどでテストすることをお勧めします。
  • ポストバックコンテンツを確認するには、ローデータポストバックレポートをダウンロードしてください。 

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

イベントをマッピングする際、ユーザーに関するフィールドの値は、と(含む)で複数のイベントに対して1回の操作で編集できます。

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

  1. 更新するイベントを選択します。
  2. 一括操作をクリックします。
  3. 選択したすべてのイベントに適用する新しい設定を選択してください。
    • ユーザーの選択(1オプションのみ選択可能)
      • このパートナーのみ
      • オーガニックを含む全てのメディアソース
    • 含む(1オプションのみ選択可能)
      • データなし(デフォルト)
      • 収益のない価値
      • 価値と収益

In-app_event_postbacks_en-us.png

カスタムイベント

マッピング可能なイベントのリストには、SDKにより既に報告されたイベント、またはAppsFlyerに送信されたサーバー間イベントのみが表示されます。マップしたいイベントがドロップダウンリストに表示されない場合、次の理由が考えられます。

  • まだイベントを実行したユーザーがいません
  • このイベントが最後に発生したのは2週間以上前です
  • アクティブなイベントのリストが多すぎます

いずれの場合も、イベントをパートナーIDにマッピングするためには、以下の手順に従ってください。

  1. ドロップダウンリストから[+ アイテムを追加]をクリックします。
  2. テキストボックスに、追加したいイベントの名前を入力してください。
  3. 確認するには、Vマークをクリックしてください。追加したイベントがリストに表示され、選択できるようになります。 add-custom-event-name.jpg
  4. イベントをパートナーの識別子にマッピングします。
  5. 連携を保存をクリックしてマッピングを保存してください。

注意

  • ポストバックページにカスタムイベントを追加しても、アプリから自動的に取得されるわけではありません。適切な機能を確保するには、SDKまたはS2Sでイベントを設定する必要があります。詳細はAppsFlyerにイベントを送信する方法をご覧ください。
  • 特定のパートナーでカスタムイベントが追加されると、このイベントは全てのパートナーのリストに追加されます。つまり、このイベントはどのパートナーのドロップダウンリストでも確認できます。
  • イベント名とパラメーターの定義に関する ヒント と 制限事項 を参照してください。 

代理店と広告ネットワーク:

  • カスタムイベントを追加することはできません。
  • マーケターがイベントを追加し、必要な権限を許可した後にのみ、イベントを表示またはマッピングできます。

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

マーケティング担当者は、アドネットワークが独自にイベントをマッピングすることを許可できます。そのためには、マーケターがアドネットワークに必要な権限を与える必要があります。

  1. アクティブ統合ページで、権限を付与したいパートナーを見つけます。
  2. [権限]タブで、[アプリ内イベントのポストバック構成を許可]トグルを[オン]に切り替えます。

広告ネットワーク権限ポストバック.png

アドネットワークが権限を取得すると、「イベントIDをテキストフィールドに入力」の指示に従ってイベントをマッピングできます。

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

マーケティング担当者は代理店にアプリ内イベントポストバックの設定を許可することができます。

注意

広告主と代理店の両方が同じアドネットワークに対して同じアプリ内イベントのポストバックを有効にしている場合、AppsFlyerはポストバックを1回のみ送信します。これにより、イベントの重複が防止されます。

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

  1. アクティブ統合ページから代理店を見つけます。
  2. 代理店が全てのイベントを共有できるか、特定のアドネットワークに関連するイベントのみを共有できるかを選択します。
  3. 代理店がイベントの収益を送信できるかを選択します。
  4. 代理店が共有できる特定のイベントを選択します。

代理店イベント.png