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