概要:検証ルールにより、キャンペーンのターゲット設定の間違いや不正に対する保護レイヤーをカスタマイズして追加できます。このルールにより、アプリ所有者は、どのインストールとアプリ内イベントのアトリビューションをブロックするか、または最後の有効なキャンペーンにアトリビューションするかを制御できます。
概要
- 検証ルールは、ルール作成ビルダーの中でカスタマイズした条件とロジックを使用して定義されます。このロジックでは、どのインストールやアプリ内イベントを保持またはブロックするかのフィルターを行います。
- 検証ルールは、次のような複数のユースケースのさまざまなパラメーターに基づいて構成されます:
- キャンペーンのターゲット以外のインストール(間違った地域やOSバージョン等)
- アドネットワークと同意したインサーションオーダーに適さないインストール
- 不正ネットワークによってハイジャックされたインストール
- ボット、エミュレーター、デバイスファームから発生した不正インストールや不正アプリ内イベント
- アプリ内イベントに対して設定されたルールは、その時点でまだブロックされていないインストールに紐づくイベントに対してのみ適用されます。
- アドネットワークを条件に含んでいるルールは、そのアドネットワークの担当者に対しても公開されます(ルールに含まれている他のアドネットワークの情報は表示されません)。これは情報開示を目的としており、アドネットワークが提供するトラフィックのパフォーマンスをネットワーク自身がより良く理解するのに役立ちます。
- 検証ルールはリアルタイムで適用され、即座にアクションが実行されます。詳細は、成果セクションを確認してください。
- Protect360をご利用の場合、Protect360の自動不正ブロックおよび検知に加えて、検証ルールでも追加ルールを利用可能です。これらの条件は、さまざまな種類のインストールハイジャック、不正インストール、不正アプリ内イベントの検出に役立ちます。
注:検証ルールは、Protect360によって検知されなかったインストール/アプリ内イベントに対してのみ適用されます。
結果
- インストールの場合:検証ルールは、選択したアクションに応じて、アトリビューションをブロックして最後(直近)のルックバック期間内の有効なメディアソースへアトリビューションするか、アトリビューション自体を完全にブロックします。
- アプリ内イベントの場合:検証ルールは、アプリ内イベントのアトリビューションをブロックします。
-
検証ルールのブロックタイプの結果を示す以下の表を参照してください。
ブロックタイプ 説明 インストールデータの表示場所 その後のアプリ内イベント インストール アトリビューションのブロックおよび最後の有効なメディアソースに成果の紐付けを修正 - インストールを本物と見なすが、設定した条件がどのメディアソースに紐づけるか否かを決定する場合に使用されます。
- 計測は正しく、インストールは直近の有効なメディアソースへ紐づけられます。
- 有効なメディアソースがない場合には、オーガニックインストールになります。
- 直近の有効媒体の通常のインストールとして、管理画面とローデータレポートに表示されます。
- Protect360をご利用の場合:
- Protect360の画面
- Protect360のインストールローデータレポート (ブロックされたメディアソースの情報を含む)
- Protect360をご利用でない場合:
- Protect360のインストールローデータレポート (ブロックされたメディアソースの情報を含む)
- 修正後の媒体でイベントも計測されます。
- Protect360で利用可能なデータ:
- 修正後の媒体に紐付いたアプリ内イベントAppsFlyer管理画面とレポートに表示
- Protect360のアプリ内イベントの画面と、Protect360のブロック済みアプリ内イベントのローデータレポート内でブロックされた媒体の情報を含むデータを確認可能
インストールを無効としてマークし、アトリビューションしない - ルールの条件に基づき無効と判定されたインストールが、不正と見なされる場合に使用されます。
- そのインストールはどこにも紐づけられません。(非オーガニックでもオーガニックでもない)
- Protect360をご利用の場合:
- Protect360の画面
- Protect360のインストールローデータレポート (ブロックされたメディアソースの情報を含む)
- Protect360をご利用でない場合:
- Protect360のインストールローデータレポート (ブロックされたメディアソースの情報を含む)
- ブロックされます。
- Protect360をご利用の場合:
Protect360のアプリ内イベントの画面と、ブロック済みアプリ内イベントのローデータレポートでデータを確認可能
アプリ内イベント アトリビューションブロック - ルールの条件に基づいて無効と判定されたアプリ内イベントが、不正と見なされる場合に使用されます。
-
Protect360をご利用の場合:
- Protect360のアプリ内イベントの画面
- Protect360のアプリ内イベントのローデータレポート
- Protect360をご利用でない場合:
確認不可
- Protect360をご利用の場合:Protect360のアプリ内イベントの画面とブロック済みアプリ内イベントのローデータレポートでデータを確認可能
AppsFlyerから完全に削除 - 一切データを必要としないアプリ内イベントが存在する場合にオススメです。
- AppsFlyerではこれらのイベントを一切記録しません。
- アドネットワークと代理店は、広告主が必要な権限を付与した場合にのみデータを閲覧可能です。
-
インストールがブロックされるか、リアルタイムに有効なメディアソースに紐付けられた場合:
ブロックされたデータのポストバックがブロックされたアドネットワークに即座に送信され、媒体との調整フローを効率化できます。アトリビューションがブロックされ、直近の有効なメディアソースに修正された場合は、その有効なメディアソースへもポストバックが送信されます。 -
アプリ内イベントのアトリビューションがブロックされると、ブロックされたアドネットワークに即座に拒否ポストバックが送信されます。
注意:- ポストバックは、そのアドネットワークがAppsFlyerのポストバックを受け取る連携が完了している場合にのみ送信されます。
- ポストバックとブロックされたデータのポストバックレポートは、データエクスポートページから利用可能です。
- 詳細は、ポストバックとブロックされたデータのポストバックをご覧ください。
-
インストールとアプリ内イベントアトリビューションのブロックは、AppsFlyerでデータがレポートされる方法と場所にのみ影響します。 あくまでも成果の紐付け先やアトリビューション計測停止のみであり、データのみに影響し、エンドユーザーのアプリの使用を妨げることは一切ありません。
- 必要に応じて、ブロック済みインストールとブロック済みアプリ内イベントのローデータレポートを使うことで、無効にすべきアプリユーザーの一覧を取得することも可能です。(データエクスポートページ、Pull API、Data Locker経由で取得可能)。
-
ブロック済みインストール / ブロック済みアプリ内イベントとブロックされたデータのポストバックのローデータレポートには、block reasonの項目にブロックしたルール名が記載されます。複数ルールが適用された場合については、複数ルールの適用のセクションを確認してください。
- Protect360によってインストールやアプリ内イベントがブロックされた場合、関連する検証ルールがある場合でも、Protect360のブロック理由がブロック理由の項目に記載されます。
- 検証ルールを使用することで、独自のインストール検証ロジックを適用している Meta Ads や Google AdwordsなどのSRN媒体とAppsFlyerの間で、レポート数値の乖離が発生することがあります。
複数ルールの適用
- 条件に該当した場合には、1つのインストール / アプリ内イベントに対して複数の検証ルールを適用できます。
- インストール / アプリ内イベントは、ルール内のいずれかの条件の一つでも適さない場合、無効なデータとして分類されます。
- ローデータレポートとブロックされたデータのポストバックレポートでは、block reasonの値の項目には、インストールイベントまたはアプリ内イベントを無効として分類した全ルール名が記載されます。
- 同じインストールに対する複数のルールは、ルールのブロックタイプに従って、次の順序で実行されます。
ルール/ブロックタイプ | 順序 |
---|---|
インストールブロック |
ランダム |
アトリビューションブロック |
ランダム |
アプリ内イベントブロック |
ランダム |
AppsFlyerから完全に削除 |
他のルールは無視され、AppsFlyer上でデータは一切記録されません。 |
インストールブロックとアトリビューションブロック |
|
Protect360と検証ルールによるインストールブロックとアトリビューションブロック |
|
Protect360と検証ルールによるアプリ内イベントブロック |
|
ルールビルダー
ルールビルダーの画面は、インタラクティブにルールを構築できるように設計されています。
ヒント! まずは実際にルールビルダーを操作してみてからこの記事を参照すると、より理解し易くなります。
ルールビルダーに含まれているのは以下のセクションです:
セクション | 備考 |
---|---|
一般的な詳細 |
この選択によって、以下のセクションで利用できるオプションが異なります。(代理店、メディアソース、キャンペーンなど) |
トラフィックソース | ルールが適用されるトラフィックソースです。Protect360のソースもご確認ください。 |
条件 |
定義した条件に「一致」または「一致しない」インストール / アプリ内イベントをブロックするかどうかを選択します。
|
アクション |
インストールに関しては、特定の条件に該当したインストールに対して、何を実行するか選択してください:
アプリ内イベントに関しては、特定の条件に該当するインストールに対して何を実行するかを選択してください:
詳細は結果のセクションをご覧ください。 |
インストールソース(流入元)
ソースセクションでは、ルールが適用されるインストールのトラフィック流入元を定義します。
主に2つの選択肢があります:
-
全てのトラフィック:流入元に関係なく、全トラフィック(代理店、メディアソース、キャンペーン、オーガニックなど)にルールが適用されます。
注意:この設定はオーガニックインストールを含むため、細かい流入元の指定はできず、検証後のアクションではインストールブロックのオプションのみが利用可能です。これは、オーガニックインストールに対して、アトリビューションブロックや成果紐付けの修正を行うことができないためです。 - 非オーガニックのみ:このルールは選択した媒体に対して、以下の表のように項目、演算子、値などの設定とともに適用されます。
Protect360をご利用のお客様は、インストールとアプリ内イベントに対して追加のソースオプションが利用できます。
項目 | 演算子 | 値 | 備考 |
---|---|---|---|
Agency |
|
|
|
Media source |
|
|
|
Campaign |
|
|
|
Campaign ID |
|
||
Ad ID | |||
Adset ID | |||
Ad set name |
インストール条件
条件のセクションでは、インストールをブロックするか、最後の有効な媒体に紐づけるかを決定する条件を設定することができます。
各ルールに対して、複数の条件と条件のグループを追加できます。
条件は、次の表に示す、条件、演算子、および値に従って定義されます。
Protect360をご利用のお客様は、インストールとアプリ内イベントに対して追加の条件オプションが利用できます。
条件 | 演算子 | 値 | 備考 |
---|---|---|---|
Campaign |
|
|
|
Campaign ID |
|
||
Ad ID | |||
Adset ID | |||
Ad set name | |||
Device type | |||
Geo (国・地域) |
|
|
|
Platform |
メニューから値を選択してください。 |
||
OS version |
|
|
|
Lookback days (ルックバック期間) |
|
|
|
Is preinstalled (プリインストールされたかどうか) |
|
|
|
Is deeplink (ディープリンクか否か) |
ローデータのディープリンクの項目が空欄の場合、Is deeplink = No と見なされます。 |
アプリ内イベントのソース
イベントセクションでアプリ内イベントを選択した場合、通常のメディアソースオプションに加えて、ルールを適用するアプリ内イベントを定義するためのもう一つのメディアソースオプションが利用できます。
このメディアソースは、次の表に示す項目、演算子、および値毎に定義されます。
注意:全てのアプリ内イベントのメディアソースは、イベントに紐づくインストールのメディアソースに基づいています(例えば、代理店、メディアソース、キャンペーン、キャンペーンID、サイトIDなど)。
項目 | 演算子 | 値 | 備考 |
---|---|---|---|
Event name |
|
|
|
アプリ内イベントの条件
イベントセクションでアプリ内イベントを選択すると、ルールを適用するアプリ内イベントを定義する条件オプションが利用できます。これらの条件は前述のProtect360以外の条件と一緒に組み合わせて利用できます。
Protect360に関する条件は、次の表に示す条件、演算子、および値に従って定義されます。
条件 | 演算子 | 値 | 備考 |
---|---|---|---|
Event name |
|
|
|
Protect360のインストールとアプリ内のイベントソース
通常のメディアソースオプションに加えて、Protect360をご利用のお客様は、ルールを適用するインストールを定義するためのもう一つのメディアソースオプションが利用できます。このメディアソースは、次の表に示す項目、演算子、および値毎に定義されます。
項目 | 演算子 | 値 | 備考 |
---|---|---|---|
Site ID |
|
|
|
Protect360のインストール条件
Protect360をご利用のお客様は、インストールを検証するための追加条件を利用できます。これらの条件は、前述のProtect360以外の条件と一緒に組み合わせることができます。
Protect360に関する条件は、次の表に示す条件、演算子、および値に従って定義されます。
条件 | 演算子 | 値 | 備考 |
---|---|---|---|
CTIT (クリックからインストールまでの時間) |
|
|
|
Customer user ID (CUID) |
|
|
|
App version |
|
|
|
SDK version |
|
|
|
Installer/Store (インストーラ / ストア) |
|
メニューから値を選択してください:
|
ユーザー端末がインストーラ / ストアパラメーターをAppsFlyerに提供しない場合、このルールは適用されません。 |
アトリビューションタッチタイプ |
|
|
|
Carrier |
|
|
|
User agent |
|
|
|
IPアドレス |
|
|
Protect360のアプリ内イベントの条件
イベントセクションでアプリ内イベントが選択されると、Protect360をご利用のお客様は、ルールを適用するアプリ内イベントを定義する条件オプションが利用できます。これらの条件は前述のProtect360以外の条件と一緒に組み合わせて利用できます。
Protect360に関する条件は、次の表に示す条件、演算子、および値に従って定義されます。
条件 | 演算子 | 値 | 備考 |
---|---|---|---|
Event source |
|
|
SDK または S2Sを選択します。 |
Event value |
|
|
|
インストールからイベントまでの経過時間 (秒) |
|
フリーテキストで、数値を入力してください。 |
|
条件と条件グループの間のロジック
ルールに複数の条件や条件グループを追加する場合は、次のいずれかの方法で、条件同士に論理的な関係を設定してください:
- And:そのインストールが、定義されている全ての条件に当てはまることを意味します。
- Or:そのインストールが、定義されている条件の少なくとも1つに当てはまることを意味します。
例えば、プラットフォームとOSの両方を指定してインストールを検証したい場合は、andを選択してください。一方、インストールをプラットフォームとOSのいずれかで検証したい場合は、or を選択してください。
手順
ルールリストの確認
アカウント内で作成された全てのルールを表示する方法:
-
AppsFlyer管理画面左メニュー 設定 > 検証ルールへ進むと
検証ルールの画面が開き、ルール一覧が表示されます。 - リスト表示 / 詳細表示のトグルを使用して、表示方法を選択してください。
-
検索とフィルタオプションを使用してリスト内のルールを絞り込んでください。
- ルール名、メディアソース、条件名、値で検索できます。
- 例えば、「7」と入力すると、OSバージョンに7を含むルールを全て検索できます(例:「2.7.4」、「7.1」など)。
または、「Canada」と入力すると、地域条件としてCanadaが定義されているルールを検索できます。
ルールの追加
新しいルールを設定する方法:
-
AppsFlyer管理画面 左メニュー 設定 > 検証ルールへ移動します。
検証ルールの画面が開きます。 - [ルールを追加]をクリックして、新しいルールを追加する画面を開いてください。
- まず、ルール名を入力してください。次のように、ルール毎にユニークな名前を使用してください:
- ルールの内容を正確に表現している。
- アドネットワークに送信されるブロック済みのインストールレポートとブロックされたデータのポストバックレポートにも表示されるため、アドネットワークに対して失礼ではないルール名を設定してください。
- ルール構築セクションを完了してください。
- [オプション] 必要に応じて、条件または条件グループを追加してください。その際、関連する条件 / 条件グループ間でのロジックを必ず選択してください。
- [オプション] トラフィックへの影響を推定をクリックして、ルールがトラフィックに与える影響を確認してください。
- [保存] をクリックします。
検証ルールの影響を確認
検証ルールがトラフィックに与える影響の推定を確認します。つまり、ブロックされたインストールとブロックされたアトリビューションの数を示します。
注意
- 検証ルールの推定機能を利用できるのは広告主のみで、パートナーや代理店はアクセスできません。
- 推定値はインストールに関するルールで利用でき、アプリ内イベントに関するルールでは利用できません。
- 推定値には、ルールに適用される内容も表示されます。ただし、Protect360不正防止機能、別の検証ルールによって既にブロックされている、推定ルールが新しいものでない場合は、トラフィックは以前の設定でブロックされています。
検証ルールの影響の推定値を確認する方法:
- AppsFlyerにて、検証ルールへ移動してください。
- 既存のルールを選択するか、+ ルールを追加をクリックしてルールを提供するソースと条件を設定し新しいルールを作成してください。
- ルールの一番下までスクロールダウンしトラフィックへの影響を推定をクリックすると、ルールによる影響の推定画面が開きます。
- 影響の推定値を過去最終日または過去7日間に基づいて表示するかを選択してください。
ルールの編集・削除
Tルールを編集、削除、有効化、無効化する方法:
- ルールリストにて、特定のルールに対して実行したいアクションを選択します。
- アクティブにて:ルールを有効または無効にしてください。
- アクションにて:ルールを編集、または削除します。
よくある質問
「正規表現」とは?
正規表現パターンとは、一致するものを検索する文字で構成されます。単純なパターンとは、直接一致する部分を見つけたい文字から構成されたものです。一致の検索で直接一致以外のものが必要な場合は、パターンに特殊文字を含めることができます。
例:
正規表現 | 説明 |
---|---|
^abc | abcで始まる |
xyz$ |
xyzで終わる |
^abc.*xyz$ |
abc で始まり xyz で終わる |
^abc.*(?<!xyz)$ |
abc で始まり xyz で終わらない |
^([0-9]{2}) |
2桁で始まる |
\"example_param\":\"[5|6] | 特定のパラメーターの値は5または6で始まります。 |
^.{0}$|^\{\}$ | Is empty, or is only {} |
検索時にメディアソースまたは条件が推奨値として表示されないのはなぜですか?
考えられる理由は2つあります。
- 関連するアプリが選択されていることを確認してください。アプリが選択されていないと、検索結果に値が表示されません。
- 検索結果は、過去30日間のトラフィックにその値が含まれる場合にのみ表示されます。さらに、コンバージョンが発生してから、媒体または条件がメニューオプションとして表示されるまでに最大1日の遅延があります。
検索結果として値が表示されない場合は、値をフリーテキストとして入力してキーボードでEnterキーを押してください。
メディアソースのオプションにMeta広告とX Adsしか含まれていないのはなぜですか?
メディアソースの項目は代理店の選択により影響されます。トラフィックソースの一つに「運用媒体を開示しない代理店」が選択されている場合、運用媒体を開示しない代理店でもデータが開示される媒体であるMeta AdsとX Ads以外のメディアソースは表示されません。
注:ルールが複数のアプリに適用される場合、代理店が一部のアプリで媒体開示をしており、その他アプリでしていない場合は、この代理店は運用媒体を開示しない代理店と見なされます。つまり、Meta広告やX広告以外の特定のメディアソースを選択することはできません。
特定の条件ないと条件グループ間の両方で「and/or」を設定する必要がありますか?
ユースケースによって異なります。どちらのオプションも同じ結果になる場合があります。または、両方のオプションが必要な場合もあります。
例えば、米国ではOS V10以降でのみインストールをサポートし、ブラジルでは V7 以降からサポートする場合は、次のようなルールが必要になります。
{[Geo = US] and [OS version = 10]} OR {[Geo = Brazil] and [OS version = 7]}
検証ルールはクリックをブロックしますか?
いいえ。検証ルールはインストールをブロックしたり、インストール成果をメディアソースに紐づけることをブロック(メディアソースのクリック/インプレッションの成果が計測されるのを防ぐ)したり、またはアプリ内ベントをブロックします。ただし、これらのオプションのいずれも実際のクリックをブロックすることはなく、検証ルールを実行してもクリックKPIには影響は出ません。
ローデータで、検証ルールによってブロックされると思ったインストールが別の理由でブロックされているようです。なぜですか?
これはブロックがProtect360エンジンによるもので検証ルールによるものではないことを示します。複数のルールセクションをご覧ください。
既存のルールは、新しく連携された代理店のトラフィックに自動的に適用されますか?
これは、次の表で説明するように、Sourceの設定によって異なります。
ルールが自動的に適用されない場合は、ルールを編集してください。
- 代理店の項目を代理店と代理店以外のトラフィック、または特定の代理店に変更します。
ソースの設定 |
代理店項目の選択肢 |
アプリと代理店を連携する前にルールが作成された場合、ルールは適用されますか? |
アプリと少なくとも1つの代理店を連携した後にルールが作成された場合、ルールは適用されますか? |
---|---|---|---|
全てのトラフィック |
N/R |
Yes(はい) |
Yes(はい) |
非オーガニックのみ |
N/R |
No(いいえ) |
N/R |
代理店と非代理店トラフィック |
N/R |
Yes(はい) |
|
代理店以外のトラフィックおよび/または 特定の代理店 |
N/R |
No(いいえ) |
「Not in last (最後の...ではない)」条件はどのように機能しますか?
「Not in last (最後の...ではない)」は、検証ルールに含める一連のアプリバージョンが 1つある場合に使用される条件です。「Not in Last (major) (最後の主要な...ではない) は、検証ルールに含める一連のアプリバージョンが複数ある場合に使用される条件です。
例:
- 一連のアプリバージョン 1.0 と 2.0 があります
- 既存のすべてのアプリのバージョンは以下の通りです。
- 1.0.01
- 1.0.02
- 1.0.03
- 2.0.01
- 2.0.02
- 2.0.03
- 「Not in last 2 versions (最後の2つのバージョンではない)」ブロックで定義されたルール:
- 2.0.02
- 2.0.03
- 「Not in last (major) 2 versions (最後の主要な2つのバージョンではない)」ブロックで定義されたルール:
- 1.0.02
- 1.0.03
- 2.0.02
- 2.0.03
特性と制限
特性 | 説明 |
---|---|
アカウントユーザーのアクセス | 適切な権限 を持つアカウントユーザーのみが、検証ルールを表示、追加、および編集可能です。 |
ユーザー獲得 | 検証ルールは、インストール、再インストール、リアトリビューション(アプリがデバイスから削除された場合)に適用されます。リエンゲージメント、つまりアプリがまだデバイス上にある場合は適用されません。 |
自動的にルールが無効になる場合 |
次の場合、ルールが自動で無効になります:
|
アドネットワーク |
ルールの詳細を閲覧するには、検証ルールを表示する権限を広告主から付与してもらう必要があります。注:ルール名は常に表示されます(ローデータにも含まれる)。 |
代理店 |
広告主から以下の権限を付与してもらう必要があります:
|
ユニークユーザー |
アプリ内イベントが100件を超える場合は、入力規則を使用して特定のアプリ内イベントを無効にしても、 ユニークユーザー数の制限 が適用されます。つまり、100 を超えるイベントは、入力規則によって無効にされた場合でも、一意のユーザーはカウントされません。 |
SKAN |
サポートされておらず、計測対象外です |