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

検索

検証ルールの実装｜不正防止

  • 更新

Validation rules add a custom layer of protection against incorrectly targeted campaigns and fraud. The rules enable app owners to control which installs and in-app event attributions get blocked, or attributed to the last valid source.

5906_animation-750x330__1_.gif

概要

  • 検証ルールは、ルールビルダーで独自の条件やロジックを設定し、どのアプリインストールまたはアプリ内イベントのアトリビューションを保持するか、あるいはブロックするかをフィルタリングして選択する仕組みです。
  • ルールにはさまざまなパラメーターを使用でき、以下を含む複数のユースケースに対応します。
    • キャンペーンのターゲティング対象外となるインストール（地域やOSバージョンが異なる場合など）
    • アドネットワークと締結したインサーションオーダーの条件を満たさないインストール
    • 不正なネットワークによってハイジャックされたインストール
    • ボット、エミュレーター、デバイスファームから送信された偽のインストールまたはアプリ内イベント
  • アプリ内イベントに対してのみ定義されたルールは、それ以前にブロックされていないインストールに紐づくアプリ内イベントにのみ適用されます。
  • アドネットワークを条件に含むルールは、そのアドネットワークの担当者にも表示されます。 ただし、同じルールに含まれる他のアドネットワークを確認することはできません。これは透明性を確保するとともに、アドネットワークが自社から提供したトラフィックのパフォーマンスをより深く理解できるようにするためです。
  • ルールはリアルタイムで実行され、即座に適用されます。詳細は、成果セクションを確認してください。
  • タグ付けモードを使用すると、アトリビューションを実際にブロックする前に、本番トラフィックに対して検証ルールをテストできます。ルールのステータスをタグ付けに設定すると、AppsFlyerは条件に一致するインストールおよびアプリ内イベントに、レポートおよび分析用のフラグを付けますが、アトリビューション自体には影響しません。タグ付けモードを使用して、ルールの動作を確認し、誤検知の可能性を特定し、ルールのステータスを適用済みへ変更する前に、その影響を確認してください。詳細は「検証ルールのタグ付けモード」を参照してください。
  • Protect360を利用しているお客様は、Protect360による自動的な不正ブロックおよび検知に加えて、さらに多くの検証ルールオプションを利用できます。これらの条件は、さまざまなインストールハイジャック、フェイクインストール、フェイクアプリ内イベントの不正検知に有効であることが知られています。
    注意：検証ルールで検証されるのは、Protect360によって不正と判定されなかったインストールおよびアプリ内イベントのみです。
Outcomes
  • For installs: Validation rules, depending on the selected action, either block the attribution and correct to the last valid media source, or block the attribution completely.
  • For in-app events: Validation rules block the attribution of the in-app event. 

  • See the following table showing the validation rule block type outcomes.
     

      Block type Description Where install data can be viewed In-app events that follow
    Installs Block attribution and correct to last valid media source
    • Selected when you consider the install real, but your conditions determine which sources should or shouldn’t be attributed for it.
    • Attribution is corrected, and the install is attributed to the last valid media source.
    • If no valid media source is identified, the install is marked as organic.
    • AppsFlyer dashboards and raw data reports as a regular install (attributed to the last valid media source)
    • With Protect360 Premium plan:
    • Without Protect360 Premium plan:
      • Protect360 installs raw data report (with the blocked media source)
    • Has the same corrected attribution as the install
    • Data available with Protect360 Premium plan:
      • With corrected attribution in AppsFlyer dashboards and reports as a regular IAE
      • With blocked media source in the Protect360 IAE dashboard and Protect360 blocked IAE raw data report
    Mark installs as invalid and don't attribute them
    • Selected when installs that are invalid based on the rule’s conditions are considered fake.
    • The install is not attributed at all (neither as non-organic nor organic)
    • With Protect360 Premium plan:
    • Without Protect360 Premium plan:
      • Protect360 installs raw data report (with the blocked media source)
    • Blocked
    • Data available with Protect360 Premium plan in Protect360 IAE dashboard and blocked IAE raw data report
    In-app events Block attribution 
    • Selected when in-app events that are invalid based on the rule’s conditions are considered fake.
    • With Protect360 Premium plan:
    • Without Protect360 Premium plan: N/A
    • Data available with Protect360 Premium plan in Protect360 IAE dashboard and blocked in-app events raw data report
    Remove from AppsFlyer entirely
    • Recommended for use when there are in-app events that you don't need any data for.
    • AppsFlyer does not record these events at all. 
  • Ad networks and agencies can only view data if the advertiser gives them the required permissions.
  • When an install attribution is blocked or attributed to a valid media source in real-time, a rejected postback is instantly sent to the blocked ad network, to streamline your reconciliation flow. When attribution is blocked and corrected to the last valid media source, a postback is also sent to the last valid ad network.
  • When an in-app event attribution is blocked, a rejection postback is instantly sent to the blocked ad network.
    Note:
    • A postback is only sent if the ad network set to receive it is integrated with AppsFlyer to receive postbacks.
    • Postbacks and rejected postbacks reports are available on the export page.
    • Learn more about postbacks and rejected postbacks.
  • Install and IAE attribution blocking, only affects how and where data is reported in AppsFlyer. They do not prevent app usage by your end-users.
  • Blocked installs/IAE reports and rejected postbacks contain the name of the rules that blocked the installs/IAE under the block reason. See the multiple rules section if there is more than one rule.
    • When installs/in-app events are blocked by the Protect360 anti-fraud engine, even if there is also a validation rule, the Protect360 reasons are displayed.
  • Rules can result in reporting discrepancies between AppsFlyer and SRNs like Meta ads and Google Adwords as they deploy their own logic to validate installs.
Multiple rules
  • Multiple validation rules can run on the same install/IAE. This happens when the install meets the conditions of multiple rules.
  • The install/IAE is classified as invalid when it does not comply with the conditions of any of the rules separately.
  • In raw data reports and rejected postbacks, the block reason value field contains the names of all the rules that classify the install or in-app event as invalid.
  • Multiple rules for the same install are sequenced to run in the following order, based on the block types of the rules:
Rule/block types Order
Block installs Random
Block attribution Random
Block in-app event Random
Remove from AppsFlyer entirely and anything else Removed from AppsFlyer. Other rules are ignored.
Block installs and block attribution
  1. Block install rules (in random order)
  2. Block attribution rules (in random order)
Block installs and block attribution with Protect360 engine and validation rules
  1. Block installs from Protect360 engine
  2. Block install from validation rules
  3. Block attribution from Protect360 engine
  4. Block attribution from validation rules
Block in-app events with Protect360 engine and validation rules
  1. Block IAE from Protect360 engine
  2. Block IAE from validation rules

ルールビルダー

The rule builder user interface is designed for interactive rule building. Tip! Familiarize and experiment with the rule builder before reviewing this article in detail.

カテゴリ別に分類されたディメンションを使用する

When adding rule conditions, parameters are grouped into categories to make rule setup easier. Categories and parameters are shown based on the selected event type and your account permissions.

You can search across all categories simultaneously. Matching categories expand automatically.

Parameters that aren’t relevant to the selected event type, or aren’t included in your permissions, are hidden.

Category Parameters
Campaign & source Media source, Campaign, Campaign ID, Site ID, Ad set name, Ad set ID, Ad ID, AF Sub 1-5
Geography & device Geo, Platform, OS version, Device model, Carrier, User agent
Attribution CTIT, Lookback days, Lookback hours, Attribution touch type
Identity Customer user ID, IDFA, Advertiser ID, IP address
App & SDK App version, SDK version, Installer/Store, Custom Installer/Store, Is preinstalled, Is Deeplink
End-user event Event name, Event value, Install to event time, Event source, Currency, Revenue
Engagements Engagement
New Validation Rule page.jpg

The rule builder contains the following sections: 

Section Remarks
General details
  • Rule name - Enter a name for the new rule.
  • Rule type - Select the rule type, Real time, or Post attribution.
  • Events - Select the event type for which the rule is applied, Installs or In-app events.
  • App selection - Select Selected apps, or All apps.
    • If Selected apps is selected:
      Select apps - Select the apps for which the rule is applied: A single app, multiple apps, or all apps in the account.
    • If All apps is selected:
      Option to check Include future apps - This allows future apps to be included in this rule.

The selections affect the options available in the following sections (agency, media source, campaign, etc.)

注意

App version must only contain numbers. For example 2.2.1

Note: 

Numeric app versions (for example, 2.2.1) supports all operators (equals, greater than, lower than, etc.).

If the app version is custom text (for example, version123 or our_latest_version), only the "equals" or "doesn't equal" operators work; "greater than" or "lower than" won't apply.
Traffic sources Traffic source for which the rule is applied. See also Protect360 sources
Conditions

Choose whether you want to block installs/in-app events that "Match" or "Don't match" the defined conditions. 

  • Match conditions - Attribution will be blocked for installs/in-app events that match the defined conditions, and the action you select below will apply to all of these.
     
  • Do not match conditions - Attribution will be blocked for installs/in-app events that don’t match the following conditions, and the action you select below will apply to all the rest.

See also Protect360 conditions for installs and in-app events.
Actions

For installs, select what to do with the installs meeting the specified conditions:

  • Mark installs as invalid and don’t attribute them. Installs won’t appear in AppsFlyer dashboards except Protect360 and reports.
     
  • Block attribution and correct to last valid media source. If no valid media source is identified, the install is considered organic.
     

For in-app events, select what to do with the installs meeting the specified conditions:

  • Block attribution, but show in Protect360 data. Events aren’t attributed but show in the Protect360 dashboard and raw data.
  • Remove from AppsFlyer. Events will not show in the AppsFlyer platform at all.

See Outcomes for more information.

検証ルールの設定例

Install sources

The Sources section is where you define the traffic sources of the installs the rule applies to.

There are three primary options: 

  • All traffic: Includes both organic and non-organic installs. Source information is unavailable for organic installs. This option includes all media sources, including those added in the future.
    Example: Apply a rule to all traffic with app version lower than X.

  • All traffic of Non-organic: Applies to all agency and non-agency non-organic traffic sources, including new sources added later.
    Example: Block non-organic traffic from a specific geo where you don’t run UA or retargeting campaigns.

  • Selected traffic of Non-organic: Applies the rule to specific agencies or media sources only. You must manually select or add media sources when editing the rule.
    Example: Block installs from a specific media source if the CTIT is longer than X days.

Additional source options are available for Protect360 customers for installs and in-app events. 

Field Operator Value Remarks
Agency
  • In
  • Agency and non-agency traffic
  • Non-agency traffic
  • Transparent agencies (menu)

Transparent agencies:

  • These are agencies that specify their media sources.
  • Agencies that are transparent for only some of your selected apps, display in the non-transparent agencies menu.
  • All agencies are required to share their media sources.</li><li>Agencies that share media sources for only some of your selected apps appear in the Transparent agencies menu.</li></ul>
Media source
  • In list
  • Not in list
  • Equals
  • Doesn't equal
  • Contains
  • Doesn't contain
  • Starts with
  • Ends with
  • Matches regular expression
  • Search for desired value.
  • Select from menu.
  • Free text (for values that don’t exist in your search results).
  • Menu is based on:
    • Selected apps and agencies.
    • Traffic of the past 30 days, ordered by traffic volume.
  • Free text must be typed exactly as it appears in raw data.
Campaign
  • In list
  • Not in list
  • Equals
  • Doesn't equal
  • Contains
  • Doesn't contain
  • Starts with
  • Ends with
  • Is empty
  • Isn't empty
  • Matches regular expression
  • Search for desired value.
  • Select value from menu.
  • Free text (for values that don’t exist in your search results).
Campaign ID
  • Free text only.
  • Possible to add multiple values separated by spaces.
Ad ID
Ad set ID
Ad set name
Install conditions

The Conditions section is where you define the conditions that determine when install attributions are blocked, or attributed to the last valid source. 

You can add multiple conditions, and groups of conditions to every rule.

Conditions are defined as per the conditions, operators, and values outlined in the table that follows.

一括アップロード

When selecting the operators In list or not in list inside of conditions that support it, you have the option to bulk upload a CSV file when adding new items.

To do this:

  1. Select a condition with an In list or not in list operator.
  2. Select In list or not in list from the operator dropdown list.
  3. Select Upload CSV file from the Add new items box. 

Note: The CSV file can contain up to 17K values.

 

Additional condition options are available for Protect360 customers, for installs and in-app events. 

Condition Operator Value Remarks
Campaign
  • Equals
  • Doesn't equal
  • Doesn't contain
  • Contains
  • Starts with
  • Ends with
  • In list
  • Not in list
  • Matches regular expression
  • Is empty
  • Isn't empty
  • Search for desired value.
  • Select value from menu.
  • Free text (for values that don’t exist in your search results).
  • Menu is based on:
    • Selected apps and agencies.
    • Traffic of the past 30 days, ordered by traffic frequency.
  • Free text must be typed exactly as it appears in raw data.
Campaign ID
  • Free text only.
  • Possible to add multiple values separated by spaces.
Ad ID
Ad set ID
Ad set name
Device type
Geo
  • In list
  • Not in list
  • Equals
  • Doesn't equal


 
  • Search required value (based on country name, country code, state, or city).
  • Select value from menu.
Platform Select value from menu.
Currency

Currency only. Possible values:

USD, NZD, SGD, IMP, ANG, MNT, BIF, BBD, HUF, ERN, AZN, AOA, PYG, MYR, GYD, VUV, SLL', FKP, DJF, GNF, LVL, MMK, MRO, RSD, CLF, XDR, ZAR, TND, PHP, KGS, XPD, RON, RUB, KMF, SCR, GIP, TRY, JEP, UYU, XCD, FJD, GHS, MVR, AWG, UGX, TOP, CVE, MKD, COP, CUC, GTQ, KZT, MXN, MGA, AUD, BDT, ISK, KRW, DZD, GGP, OMR, ZMW, MOP, CUP, JPY, SHP, LSL, ETB, BWP, MAD, AED, NGN, BRL, GEL, IDR, EUR, GBP, WST, XAF, SZL, XOF, SEK, UZS, KES, KYD, ILS, KWD, NPR, BZD, QAR, UAH, BTN, HTG, DKK, VND, SBD, JMD, IQD, LBP, XPT, HRK, HKD, JOD, PAB, CDF, VEF, XAU, BAM, CNY, SOS, XPF, GMD, DOP, XAG, KPW, BOB, BHD, BYN, BYR, LRD, BGN, AMD, CZK, CAD, LAK, EEK, MTL, PLN, LKR, BTC, MWK, LTL, ZMK, PGK, YER, PEN, KHR, RWF, BSD, AFN, ZWL, LYD, TMT, HNL, TWD, IRR, MUR, THB, ALL, TJS, SDG, BMD, CRC, NOK, SRD, MZN, CLP, STD, SYP, TZS, EGP, ARS, MDL, INR, SAR, PKR, TTD, NIO, BND, NAD, SVC, CHF
Revenue
  • Lower then
  • Lower than or equals
  • Greater than
  • Greater than or equals
  • Is between
  • Equals
  • Doesn't equal
  • Free text only.
OS version
  • Lower than
  • Lower than or equals
  • Greater than
  • Greater than or equals
  • Equals
  • Doesn't equal
  • Is between
  • In list
  • Not in list
  • Is empty
  • Isn’t empty
  • Search for desired value.
  • Select from menu.
  • Free text (for values that don’t exist in your search results).
App version
  • Lower than
  • Lower than or equals
  • Greater than
  • Greater than or equals
  • Equals
  • Doesn't equal
  • Is Between
  • In list
  • Not in list
  • Not in last
  • Not in last (major)
  • Is empty
  • Isn’t empty
  • Search for desired value.
  • Select value from menu.
  • Free text (for values that don’t exist in your search results).
  • Menu is based on traffic of the past 30 days, ordered by traffic frequency.
  • Free text must be typed exactly as it appears in raw data.
  • For "Not in last," if you have more than one series of versions, select "Not in last (major)". Learn more
Lookback days
  • Lower than
  • Greater than or equals
  • Is between
  • Free text: A single numeric value.
  • Refers to the impression/click lookback window in days.
  • Ensures you don’t pay for installs with an attribution link that was modified to allow a longer attribution period.
  • Does not replace the configuration of the lookback window in your attribution link.
  • [Recommended] Use in combination with the attribution touch type condition (available with Protect360)
Is preinstalled
  • Yes
  • No
  • No value (operator is the value)
  • Validates all types of preinstalls:
    • Factory preinstalls, meaning an app that comes on the device as part of the OS.
    • Offered preinstalls, meaning an app promoted and offered to users as soon as the device is initialized. This is done by media sources designated for preinstalls.
  • For installs with multiple clicks/ sources, this condition validates whether one of the sources is a preinstall.
Is deeplink An empty deep link field in raw data is considered to be Is deeplink = No

注意

Organic installs have no associated campaign or media source, so fields like Campaign and Ad set name are always null for them, not empty strings. A rule that uses Match conditions with an Is empty operator on these fields won't match organic installs, so it won't block them.

To also catch organic traffic, configure the rule with Don't match conditions instead, combining your conditions with Or, using Isn't empty on the same fields (for example, Campaign isn't empty Or Ad set name isn't empty, plus any other conditions the rule needs). Inverting the logic this way lets the rule match null values along with empty strings.

アプリ内イベントの流入元

イベントセクションでアプリ内イベントを選択すると、通常の流入元オプションに加えて、ルールを適用するアプリ内イベントを定義するための追加オプションを利用できます。 

流入元は、以下の表に記載されているフィールド、演算子、値に基づいて定義します。

注意：その他のアプリ内イベントの流入元はすべて、そのアプリ内イベントが紐づくインストールの流入元に基づきます。 （例：代理店、メディアソース、キャンペーン、キャンペーンID、サイトIDなど）

地域 演算子 値 Remarks
イベント名
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない)
  • Contains（〜を含む）
  • Doesn't contain（〜を含まない）
  • Starts with（〜で始まる）
  • Ends with（〜で終わる）
  • Is empty（空である）
  • Isn't empty（空ではない）
  • Matches regular expression（正規表現と一致）
  • 目的の値を検索
  • メニューから選択
  • 検索結果に存在しない値の場合、フリーテキストを入力
  • フリーテキストの場合は、ローデータに表示される値と完全に同じ表記で入力する必要があります。
アプリ内イベントの条件

イベントセクションでアプリ内イベントを選択すると、ルールを適用するアプリ内イベントを定義するための追加条件を利用できます。これらの条件は、前述のProtect360以外の条件と自由に組み合わせて使用できます。

Protect360の条件は、以下の表に記載されている条件、演算子、値に基づいて定義します。

条件 演算子 値 Remarks
イベント名
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない)
  • Contains（〜を含む）
  • Doesn't contain（〜を含まない）
  • Starts with（〜で始まる）
  • Ends with（〜で終わる）
  • Is empty（空である）
  • Isn't empty（空ではない）
  • Matches regular expression（正規表現と一致）
  • 目的の値を検索
  • メニューから選択
  • 検索結果に存在しない値の場合、フリーテキストを入力
  • フリーテキストの場合は、ローデータに表示される値と完全に同じ表記で入力する必要があります。



 
アプリバージョン
  • Lower than（〜未満）
  • Lower than or equals（〜以下）
  • Greater than（〜より大きい）
  • Greater than or equals（〜以上）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない）
  • Is between (〜の間)
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Not in last (直近のバージョンに含まれない)
  • Not in last (major) (直近のメジャーバージョンに含まれない)
  • Is empty（空である）
  • Isn't empty（空ではない）
  • 目的の値を検索
  • メニューから選択
  • 検索結果に存在しない値の場合、フリーテキストを入力
  • メニューは、過去30日間に発生したトラフィックを、頻度順に表示
  • フリーテキストの場合は、ローデータに表示される値と完全に同じ表記で入力する必要があります。
  • Not in last（直近のバージョンに含まれない）を使用する際、バージョン系列が複数存在する場合は、Not in last (major)（直近のメジャーバージョンに含まれない）を選択してください。（詳細）

注意

イベント名の条件では、大文字と小文字は区別されません。すべてのイベント名は、判定前に自動的に小文字へ変換されます。たとえば、Submit Formと入力した場合、システム上ではsubmit formとして扱われます。

Protect360におけるインストールおよびアプリ内イベントの流入元

Protect360を利用しているお客様は、通常の流入元オプションに加えて、ルールを適用するインストールを定義するための追加の流入元オプションを利用できます。流入元は、以下の表に記載されているフィールド、演算子、値に基づいて定義します。

地域 演算子 値 Remarks
サイトID
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない)
  • Contains（〜を含む）
  • Doesn't contain（〜を含まない）
  • Starts with（〜で始まる）
  • Ends with（〜で終わる）
  • Is empty（空である）
  • Isn't empty（空ではない）
  • Matches regular expression（正規表現と一致）
  • 自由入力のみ
  • スペースで区切ることで、複数の値を追加できます。
  • フリーテキストの場合は、ローデータに表示される値と完全に同じ表記で入力する必要があります。
Protect360のインストール条件

Protect360を利用しているお客様は、インストールを検証するための追加条件を利用できます。これらの条件は、前述のProtect360以外の条件と自由に組み合わせて使用できます。

Protect360の条件は、以下の表に記載されている条件、演算子、値に基づいて定義します。

条件 演算子 値 Remarks
CTIT(クリックからインストールまでの時間)
  • Lower than（〜未満）
  • Greater than or equals（〜以上）
  • Is between (〜の範囲内)
  • フリーテキスト：単一の数値
  • 特定のCTITが明確に分かっている場合にのみ、このフィールドを使用してください。 Otherwise, you may cause false-positive blocked installs.
    注意：Protect360の不正防止エンジンには、アトリビューションハイジャック、クリック洪水、ボットによるフェイクインストールなどに起因する複雑なCTIT異常を検出するための高度な仕組みがあらかじめ組み込まれています。
  • この項目は、以下と組み合わせて使用することをオススメします。
    • プリインストールかどうか
    • Is deeplink
    • Geo

注意：CTITのインストール条件では、エンゲージドクリックのエンゲージメントタイプにアトリビューションされたインストールはブロックできません。
Customer user ID (CUID)
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない）
  • Doesn't contain（〜を含まない）
  • Contains（〜を含む）
  • Starts with（〜で始まる）
  • Ends with（〜で終わる）
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Matches regular expression（正規表現と一致）
  • Is empty（空である）
  • Isn't empty（空ではない）
  • 自由入力のみ
  • スペースで区切ることで、複数の値を追加できます。
  • Menu is based on traffic of the past 30 days, ordered by traffic frequency.
  • フリーテキストの場合は、ローデータに表示される値と完全に同じ表記で入力する必要があります。
SDK version
  • Lower than（〜未満）
  • Lower than or equals（〜以下）
  • Greater than（〜より大きい）
  • Greater than or equals（〜以上）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない）
  • Is between (〜の間)
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • 目的の値を検索
  • メニューから選択
  • 検索結果に存在しない値の場合、フリーテキストを入力
  • Menu is based on traffic of the past 30 days, ordered by traffic frequency.
  • フリーテキストの場合は、ローデータに表示される値と完全に同じ表記で入力する必要があります。
インストーラー / ストア
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない)

メニューから値を選択してください：

  • Google Play
  • それ他のストア
  • ストア外
  • Google Play：AppsFlyerが、インストールパッケージをcom.android.vendingとして識別した場合です。
  • その他のストア：AppsFlyerが、サードパーティのAndroidストアからのインストールとして識別した場合です。
  • ストア外：AppsFlyerが、いずれのAndroidストアにも存在しないAPKとして識別した場合です。

ユーザーのデバイスからインストーラー / ストアのパラメーターがAppsFlyerへ提供されない場合、このルールは適用されません。
カスタムインストーラー / ストア 検索結果に存在しない値はフリーテキスト
  • 「その他」という条件と「カスタムインストーラー＝X」という条件をANDで組み合わせた場合： インストーラーXのみがブロック対象になります。
  • 「その他」という条件と「カスタムインストーラー＝X」という条件をORで組み合わせた場合： 「その他」に分類されるすべてのインストーラー / ストアがブロック対象になります。 Xもそのグループに含まれます。
アトリビューションタッチタイプ
  • クリック
  • インプレッション
キャリア（通信事業者）
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない）
  • フリーテキストのみ
  
ユーザーエージェント
  • Contains（〜を含む）
  • Doesn't contain（〜を含まない）
  • フリーテキストのみ
  
IPアドレス
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない）
  • フリーテキストのみ
  
Protect360のアプリ内イベントの条件

イベントセクションでアプリ内イベントを選択すると、Protect360を利用しているお客様は、ルールを適用するアプリ内イベントを定義するための追加条件を利用できます。これらの条件は、前述のProtect360以外の条件と自由に組み合わせて使用できます。

Protect360の条件は、以下の表に記載されている条件、演算子、値に基づいて定義します。

条件 演算子 値 Remarks
イベントソース
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない)
  • 目的の値を検索
  • メニューから選択 
 SDKまたはS2Sのいずれかを選択します。
イベント値
  • In list（リスト内に含む）
  • Not in list（リスト内に含まない）
  • Equals（〜と一致する）
  • Doesn't equal（〜と一致しない)
  • Contains（〜を含む）
  • Doesn't contain（〜を含まない）
  • Starts with（〜で始まる）
  • Ends with（〜で終わる）
  • Is empty（空である）
  • Isn't empty（空ではない）
  • Matches regular expression（正規表現と一致）
  • フリーテキストのみ
  • スペースで区切ることで、複数の値を追加できます。
  • 対象とする値を選択してください。
インストールからイベントまでの時間（秒）
  • Lower than（〜未満）
  • Greater than or equals（〜以上）
  • Is between (〜の範囲内)
 Free text. A single numeric value.
  • Based on your app’s flow, you decide the valid time to pass between the app install and an IAE.
    • 例：レベル5に到達するまでの時間、初回入金（FTD）までの時間、チェックアウトまでの時間など。
  • Time is in seconds, but you can validate minutes, hours, or days using the seconds equivalent.
条件および条件グループ間のロジック

1つのルールに複数の条件または条件グループを追加する場合は、それらの論理関係として以下のいずれかを選択します： 

  • AND：インストールが、定義したすべての条件を満たすことを意味します。
  • OR：インストールが、定義した条件のうち少なくとも1つを満たすことを意味します。

たとえば、プラットフォームとOSの両方に基づいてインストールを検証する場合は、ANDを選択する必要があります。これにより、指定したプラットフォームと指定したOSが常に同時に満たされる必要があります。一方、プラットフォームまたはOSのいずれかに基づいてインストールを検証する場合は、ORを選択します。

その他の機能

ルールリストの確認

アカウント内で作成された全てのルールを表示する方法：

  1. AppsFlyerで、以下の場所に移動します 設定 > 検証ルール
    検証ルール画面が開きます。
  2. リスト表示 / 詳細表示のトグルを使用して、表示方法を選択してください。
  3. 検索とフィルタオプションを使用してリスト内のルールを絞り込んでください。
    • ルール名、メディアソース、条件名、値で検索できます。
    • たとえば、7と入力すると、OSバージョンに7を含む条件が設定されたすべてのルールを検索できます。対象には、2.7.4や7.1などが含まれます。また、Canadaと入力すると、地域条件としてCanadaが定義されているルールを検索できます。 

検証ルールの表には、デフォルトで1ページあたり25件のルールが表示されます。 1ページあたりの表示件数は、10件、25件、または50件に変更できます。

検索およびフィルターは、現在表示しているページにかかわらず、すべてのルールに対して適用されます。

ルールの追加

新しいルールを設定する方法：

  1. AppsFlyerで、以下の場所に移動します 設定 > 検証ルール
    「検証ルール」ウィンドウが開き、検証ルールの一覧が表示されます。
  2. [ルールの追加] をクリックします。
    「新しいルールを追加」ウィンドウが開きます。
  3. まず、ルール名を入力してください。 ルール名には、以下の条件を満たす一意の名前を使用してください：
    • ルールの内容を正確に表している
    • アドネットワークに送信されるブロック済みのインストールレポートとブロックされたデータのポストバックレポートにも表示されるため、アドネットワークに対して失礼ではないルール名であること
  4. ルールビルダーの各セクションを完了してください。
  5. ［任意］ 必要に応じて、条件や条件グループを追加します。条件または条件グループ間の適切なロジックが選択されていることを確認してください。
  6. ［任意］［トラフィックへの影響を推定］をクリックして、ルールがトラフィックに与える影響を確認します。
  7. 保存をクリックします。

Note

アプリバージョンには、数字のみを使用してください。例：2.2.1

注意： 

2.2.1のような数値形式のアプリバージョンでは、等しい、より大きい、より小さいなど、すべての演算子を使用できます。

version123やour_latest_versionのように、アプリバージョンが任意のテキストで構成されている場合は、equals（等しい）またはdoesn't equal（等しくない）の演算子のみが機能します。 greater than（〜より大きい）やlower than（〜未満）の演算子は適用されません。

VR tagged mode

タグ付けモードを使用すると、アトリビューションをブロックする前に、本番トラフィックに対して検証ルールをテストできます。タグ付けされたルールでは、ルールの条件に一致するインストールおよびアプリ内イベントにフラグが付けられますが、アトリビューション自体には影響しません。

タグ付けモードは、インストールおよびアプリ内イベントでのみ利用できます。

タグ付けモードは、以下の目的で使用します：

  • アトリビューションをブロックする前に、本番トラフィックに対して複雑なルールをテストする
  • 誤検知の可能性を特定する
  • ルールを適用する前に、そのルールが作動する理由を確認する
  • ルールのステータスを適用済みに変更する前に、実際のトラフィックへの影響を把握する

ベストプラクティス：最初にタグ付けモードでルールを作成し、Data Lockerでフラグが付けられたトラフィックを確認してください。 ルールの精度に問題がないと判断したら、ルールのステータスを適用済みに変更します。有効な保護を継続するため、この確認作業は7日以内に完了することを推奨します。

タグ付けモードの仕組み

検証ルールを作成または編集する際、ルールの結果セクションで検知ステータスを選択します。

  • タグ付け：条件に一致するデータに、レポートおよび分析用のフラグを付けます。アトリビューションには影響しません。
  • 適用済み：選択したルールの結果に従って、アトリビューションを実際にブロックします。

注意：タグ付けモードは、ルールを保存した時点以降の本番トラフィックにのみ適用されます。過去のデータに遡ってタグを付けることはできません。

ルールの結果の設定

ルールの結果セクションは、以前はアクションと呼ばれていたセクションです。 このセクションでは、ルールの条件に一致するトラフィックをAppsFlyerがどのように処理するかを定義します。また、ルール設定の概要が表示されるため、ルールを保存する前に想定される影響を確認できます。

検知ステータス アトリビューションへの影響 データの利用場所
タグ付け 影響はありません。トラフィックは通常どおりアトリビューションされます。 Data Lockerおよびローデータレポートに表示されます。
適用済み 実際にブロックされます。選択したルールの結果に従って、アトリビューションがブロックされます。 Protect360ダッシュボードおよび出力レポートに表示されます。

ルールを設定する際に表示される内容

ルールの設定中は、以下の項目に基づいて想定されるルールの動作が動的な情報パネルに表示されます。

  • ［条件に一致］または［条件に一致しない］のロジック
  • アプリの選択
  • 検知ステータス

検知ステータスをタグ付けに設定すると、ルールは調査用のツールとして機能します。 AppsFlyerには、条件に一致するデータがData Lockerを含むエクスポートレポートで確認できるようフラグ付けされる一方、アトリビューションはブロックされないことを示す通知が表示されます。

検知ステータスを適用済みに設定すると、ルールの条件に一致するインストールまたはアプリ内イベントは、選択したルールの結果に従って、アトリビューションがブロックされるか、別の流入元へ再アトリビューションされます。情報パネルには、ルールを保存する前に、実際に適用される結果の概要が表示されます。

例：条件に一致する場合

選択したアプリにおいて、ルールの条件を満たす検知対象のインストールについて、情報パネルには以下のような結果が表示されます。

  • Blocked from attribution or detected as post-attribution.
  • 最後に有効だった非オーガニックまたはオーガニックの流入元へ再アトリビューションされる
  • Visible in export reports.

例：条件に一致しない場合

今後追加されるアプリを含む、選択したアプリにおいて、ルールの条件を満たさない検知対象のインストールについて、情報パネルには以下のような結果が表示されます。

  • アトリビューションがブロックされる、またはアトリビューション後に検知される
  • アトリビューションを修正せず、不正としてマークされる
  • エクスポートレポートに表示される

これらのアプリ内でルール条件を満たすその他のインストールは、ブロックされません。

ルールをタグ付けモードに設定する

タグ付けモードで検証ルールをテストするには、以下の手順を実行します：

  1. AppsFlyerで、「設定」＞「検証ルール」に移動します。
  2. 既存のルールを選択するか、「ルールを追加」をクリックしてください。
  3. ルールの詳細、トラフィックソース、および条件を入力してください。
  4. 「ルールの結果」のセクションで、「検出ステータス」を「タグ付け」に設定します。
  5. ［保存］をクリックします。

ルールを保存すると、AppsFlyerは条件に一致する本番トラフィックに、レポートおよび分析用のフラグを付けます。アトリビューションは通常どおり継続されます。

タグ付けされたデータを分析する

検証ルールによってタグ付けされたデータは、Protect360ダッシュボードまたはFraud Protection Suiteには表示されません。

検証ルールによってタグ付けされたデータは、Data Lockerまたはローデータのエクスポートレポートで確認できます。・タグ付けされたインストールは、タグ付けされたインストールレポートで確認できます。 ・タグ付けされたアプリ内イベントは、タグ付けされたアプリ内イベントレポートで確認できます。

タグ付けされたデータの対応関係：

タグ付けされたデータ Data Locker ローデータレポート
タグ付けされたインストール インストールレポート タグ付けされたインストール
タグ付けされたアプリ内イベント アプリ内イベントレポート タグ付けされたアプリ内イベントレポート

タグ付けされたデータのフィールド

検証ルールによってフラグが付けられたトラフィックを特定するには、Data Lockerおよびローデータのエクスポートで以下の列を使用します。

Column 説明

Rule name

（ローデータレポート）

 レコードにフラグを付けた検証ルールの名前です。

Rule ID

（ローデータレポート）

 レコードにフラグを付けた検証ルールの一意のIDです。

detected_rule_name

（Data Locker）

 レコードにフラグを付けた検証ルールの名前です。

detected_rule_id

（Data Locker）

 レコードにフラグを付けた検証ルールの一意のIDです。

タグ付けルールを適用済みに変更する

タグ付けされたデータを確認し、ルールが想定どおりに機能していることを確認したら、ルールのステータスを適用済みに変更します。

ルールをタグ付けから適用済みへ変更するには、以下の手順を実行します：

  1. AppsFlyerで、「設定」＞「検証ルール」に移動します。
  2. 対象のルールを選択してください。
  3. 「ルールの結果」セクションで、「検出ステータス」を「適用済み」に設定します。
  4. ［保存］をクリックします。

ルールを保存した時点から、AppsFlyerは、選択したルールの結果に従って、条件に一致するトラフィックを実際にブロックします。

ルールの編集・削除

ルールを編集、削除、有効化、無効化する方法：

  • ルール一覧にて、特定のルールに対して実行したいアクションを選択します。
    • 有効：ルールを有効または無効にします。
    • アクション：ルールを編集または削除します。

よくある質問

「正規表現」とは何ですか？

正規表現のパターンは、一致する文字列を検索するための文字で構成されます。単純なパターンでは、直接一致させたい文字をそのまま使用します。単純な一致だけでは検索条件を表現できない場合は、パターンに特殊文字を含めることができます。

例：

正規表現 説明
^abc abcで始まる
xyz$ xyzで終わる
^abc.*xyz$ abc で始まり xyz で終わる
^abc.*(?<!xyz)$ abc で始まり xyz では終わらない
^([0-9]{2}) 2桁の数字で始まる
"example_param":"[5|6] 指定したパラメーターの値が5または6で始まる
^.{0}$|^\{\}$ 空である、または{}のみである
検索しても、流入元や条件が候補値として表示されないのはなぜですか？

考えられる理由は2つあります。

  • 対象のアプリが選択されていることを確認してください。アプリが選択されていない場合、そのアプリの値は検索結果に表示されません。
  • 検索している値が、過去30日間のトラフィックで使用されている場合にのみ、検索結果に表示されます。また、コンバージョンが発生してから、流入元や条件がメニューの選択肢として表示されるまでに、最大1日の遅延が生じる場合があります。

値が検索結果に表示されない場合は、フリーテキストで値を入力し、キーボードのEnterキーを押してください。

メディアソースの選択肢にMeta広告とX広告しか表示されないのはなぜですか？

メディアソースフィールドに表示される選択肢は、代理店フィールドでの選択内容によって変わります。

個々の条件内と条件グループ間の両方で、AND／ORを設定する必要がありますか？

ユースケースによって異なります。 Sometimes either option achieves the same results. Other times, both options are necessary.

たとえば、米国ではOSバージョン10以降のインストールのみを許可し、ブラジルではOSバージョン7以降のインストールを許可する場合は、以下のようなルールが必要です。

{［地域 = 米国］AND［OSバージョン = 10］} OR {［地域 = ブラジル］AND［OSバージョン = 7］}

検証ルールによってクリックはブロックされますか？

いいえ。検証ルールでは、以下の処理を実行できます。 ・インストールをブロックする ・インストールの流入元へのアトリビューションをブロックする ・アプリ内イベントをブロックする インストールの流入元へのアトリビューションをブロックすると、そのクリックまたはインプレッションのメディアソースにはアトリビューションが付与されません。ただし、いずれの処理でも実際のクリック自体がブロックされることはなく、検証ルールを適用してもクリックに関するKPIには影響しません。

ローデータを確認すると、検証ルールでブロックされると想定していたインストールに、ルール名とは異なるブロック理由が表示されています。なぜですか？

This means the block was due to the Protect360 engine and not a validation rule. ルールが複数ある場合は、「複数ルールの適用」のセクションを参照してください。

既存のルールは、新たに連携された代理店トラフィックにも自動的に適用されますか？

以下の表に示すとおり、流入元 の設定によって異なります。

ルールが自動的に適用されない場合は、ルールを編集し、代理店フィールドを以下のいずれかに変更する必要があります。

  • Change the Agency field to either Agency and non-agency traffic, or select the specific agency.
Source setting 代理店フィールドの選択 いずれかのアプリで代理店連携を行う前にルールを作成した場合、ルールは適用されますか？ いずれかのアプリで1件以上の代理店連携を行った後にルールを作成した場合、ルールは適用されますか？
すべてのトラフィック N/R はい はい
Non-organic only N/R いいえ N/R
代理店経由および代理店以外のトラフィック N/R はい

Non-agency traffic and/or

特定の代理店

 N/R いいえ
「Not in last（直近のバージョンに含まれない）」の条件はどのように機能しますか？

「Not in last（直近のバージョンに含まれない）」の条件を使用すると、最新のアプリバージョンからのインストールを許可し、それより古いバージョンからのインストールをブロックできます。

  • アトリビューションをブロックし、Protect360のデータには表示する： イベントはアトリビューションされませんが、Protect360ダッシュボードおよびローデータには表示されます。
     
  • Not in last (major) X versions（直近のXのメジャーバージョンに含まれない）：バージョン体系に複数のメジャーバージョン系列が含まれる場合に使用します。 たとえば、1.x系列と2.x系列がある場合です。この条件では、各メジャーバージョン系列内の直近X個のバージョンからのインストールを許可し、それぞれの系列におけるそれより古いバージョンからのインストールをブロックします。
例：Not in last (直近のバージョンに含まれない)

以下のアプリバージョンが存在するとします：

  • 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
       
  • ブロック： 
    • 1.0.01
    • 1.0.02
    • 1.0.03
    • 2.0.01
例：Not in last (major) (直近のメジャーバージョンに含まれない)

上記と同じバージョン一覧を使用し、Not in last (major) 2 versions（直近の2メジャーバージョンに含まれない）と設定したルールでは、以下のように処理されます。

  • 許可： 
    • 1.0.02
    • 1.0.03
    • 2.0.02
    • 2.0.03
       
  • ブロック： 
    • 1.0.01
    • 2.0.01
複数のアプリを選択した場合の条件の動作

インストールまたはアプリ内イベントは、各ルールの条件のいずれか1つでも個別に満たさなかった場合、無効と分類されます。

たとえば、Not in last 3 versions（直近の3バージョンに含まれない）と設定し、アプリA、アプリB、アプリCを選択した場合は、以下のように処理されます。

  • アプリAでは、アプリAのバージョン履歴に基づく直近3バージョンが許可されます。
  • アプリBでは、アプリBのバージョン履歴に基づく直近3バージョンが許可されます。

アプリCでは、アプリCのバージョン履歴に基づく直近3バージョンが許可されます。

インプレッション経由のインストールまたはアプリ内イベントへのアトリビューションをブロックするには、どうすればよいですか？

インプレッションベースのエンゲージメントへのアトリビューションを防ぎ、有効なクリックに対するアトリビューションのみを維持したい場合は、検証ルールを使用します。有効なクリックベースのメディアソースが見つからない場合、インストールはオーガニックとしてアトリビューションされます。この設定は、インストールハイジャックに関連するアトリビューションの問題に対処する際に役立ちます。

ルールは以下のように設定します：

  • Under Traffic sources, select All non-organic traffic.
  • Under Conditions, select Attribution touch type.
    • Set the operator to In list.
    • Select Impression.
  • Under Action, select Block attribution and correct to last valid media source.

Don’t select Mark installs as invalid and don’t attribute them for this use case. このアクションは、無効または不正と判断したインストールを対象としています。 If the install is real, but you don’t want to attribute it to impression-based engagement, use Block attribution and correct to last valid media source instead.

タグ付けモードは、すべての条件タイプに対応していますか？

はい。タグ付けモードは、以下を含むすべての検証ルールの演算子とフィールドに対応しています。 ・AND／ORロジック ・地域 ・OSバージョン ・SDKバージョン ・イベント値

タグ付けされたデータは、ブロック済みレポートに表示されますか？

いいえ。タグ付けされたデータは、ブロックされたトラフィックには分類されません。タグ付けされたトラフィックはタグ付け済みとして処理され、有効なトラフィックの一部とみなされます。 Data Lockerでは、有効なデータのレポート内に表示されます。

タグ付けされたデータはどこで確認できますか？

タグ付けされたルールの影響を分析するには、Data Lockerまたはローデータの出力レポートを使用します。タグ付けされたデータは、インストールとアプリ内イベントの両方で利用できます。

タグ付けされたデータは、Protect360ダッシュボードまたはFraud Protection Suiteには表示されません。

ルールをタグ付けから適用済みにいつでも変更できますか？

はい。エクスポートデータを確認し、ルールが想定どおりに機能していることを確認したら、ルールを編集し、検知ステータスを適用済みに設定して保存します。保存した時点から、選択したルールの結果に従って、条件に一致するトラフィックが実際にブロックされます。

タグ付けに設定できるルール数に上限はありますか？

タグ付けモードは、Premiumプランのお客様が利用できます。タグ付けに設定できるルール数に、厳密な上限はありません。ベストプラクティスとして、タグ付けされたルールの結果を確認し、ルールの精度に問題がないと判断したら、ステータスを適用済みに変更してください。

特性と制限事項
Trait 説明
アカウントユーザーのアクセス権限 適切な権限を持つアカウントユーザーのみが、検証ルールの表示、追加、編集を行えます。 
ユーザー獲得 検証ルールは、インストール、再インストール、およびリアトリビューションに適用されます。 リアトリビューションとは、アプリが端末から削除された後に、再度インストールされた場合を指します。一方、アプリが端末に残っている状態で発生するリエンゲージメントには適用されません。
ルールの自動無効化

If you create rules:

  • Protect360のライセンスまたはトライアル期間が終了した場合、該当するルールは自動的に無効化されます。
アドネットワーク

ルールの詳細を確認するには、広告主から検証ルールの閲覧権限を付与されている必要があります。注意：ルール名は、ローデータを含め、権限の有無にかかわらず常に表示されます。

Learn more about validation rules for ad networks
代理店

Require advertiser permission to:

  • 検証ルールの閲覧： ルールの詳細を確認できます。注意：ルール名は、ローデータを含め、権限の有無にかかわらず常に表示されます。
  • 検証ルールの追加： ルールを追加および編集できます。注意：代理店は、広告主が作成したルールを編集できません。
  • Protect360ダッシュボードおよびローデータへのアクセス： Protect360の条件を使用したルールを表示および追加できます。

Learn more about validation rules for agencies
ユニークユーザー 100件を超えるアプリ内イベントを設定している場合、検証ルールを使用して一部のアプリ内イベントを無効にしても、ユニークユーザー数の集計上限は引き続き適用されます。つまり、検証ルールによって無効化されたイベントが含まれていたとしても、100件を超えるイベントについてはユニークユーザー数が集計されません。
SKAN サポートされていません。
エンゲージメント条件 エンゲージメント条件でブロックできるのは、click_to_appおよびviewのエンゲージメントタイプのみです。その他のエンゲージメントタイプはサポートされていません。

Tags