オーディエンスルール

オーディエンスルールは、特定の人をカスタムオーディエンスに追加するかどうかを決めるためのものです。それらのルールは、参照URLか、特定のイベントとデータに適用されます。

ルールは、次のようなJSONエンコード文字列として指定します。

• 1つのオーディエンスルールには、2つのルールセットが含まれます。
• 各ルールセットには、包含ルールまたは除外ルールを含めることができます。
• 包含ルールまたは除外ルールのそれぞれには、さまざまなフィルターや集計関数を含めることができます。
• フィルターごとに1つのフィルターセットが含まれます。

オーディエンスルールは、ウェブサイトカスタムオーディエンス、モバイルアプリカスタムオーディエンス、オフラインカスタムオーディエンスといった、さまざまなタイプのカスタムオーディエンスに使われます。エンゲージメントオーディエンスルールについては、エンゲージメントカスタムオーディエンスをご覧ください。

制限

• オーディエンスのオーディエンスルールごとに、ルールを最大10個まで指定できます。inclusionsやexclusionsのrulesの数もこれに含められます。
• ルールごとに、フィルター(リーフノードと呼ばれる)を最大100個まで指定できます。

オーディエンスルールの構文

オーディエンスルールは、次の構文に従って定義します。

rule: {
   "inclusions": <RULE_SET>,
   "exclusions": <RULE_SET>,
}

利用可能なフィールド

ルールセットの構文

各ルールセットは、次の構造に従います。

{
  "operator" : <BOOLEAN_OPERATOR>,
  "rules" : <JSON_RULE>,
}

利用可能なフィールド

包含ルールと除外ルールの構文

包含ルールと除外ルールは、それぞれは以下の構造に従います。

{
  "event_sources" : <EVENT_SOURCE_DEFINITION>, 
  "retention_seconds" : <SECONDS>,
  "filter" : <FILTER>,
  "aggregation" : <AGGREGATION>, 
}

利用可能なフィールド

フィルター

フィルターの基本形式は次のとおりです。

"filter" : {
  "operator": <BOOLEAN_OPERATOR>,
  "filters": <FILTER_SET>,
  }

利用可能なフィールド

フィルターセットの構文

{
    "field": <FIELD>,
    "operator": <COMPARISON_OPERATOR>,
    "value": <VALUE>,
}

利用可能なフィールド

集計関数

行動の頻度や強度に基づいてカスタムオーディエンスを作成するには、オーディエンスルールフィールドでaggregationを使います。その上で、次の例のようにして集計関数を定義します。

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

利用可能なフィールド

例:

"aggregation" : {
  "type":"count",
  "operator":">",
  "value":1
}

比較演算子

例

ウェブサイトのカスタムオーディエンス

過去30日間について、文字列shoesを含むすべての参照元URLとのマッチング検索を実行します。

{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>",
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "url",
                            "operator": "i_contains",
                            "value": "shoes"
                        }
                    ]
                },
            }
        ]
    }
}

過去30日間について、商品価格が100米ドル以上のViewContentイベントとのマッチング検索を実行します。次のようなイベントの場合、このルールを使うことを検討してください。

_fbq.push([ 'track', 'ViewContent', { productId: 1234, category: 'Men > Shoes', price: 199 } ]);

{
    "inclusions": {
        "operator": "or",
        "rules": [
            {
                "event_sources": [
                    {
                        "type": "pixel",
                        "id": "<PIXEL_ID>"
                    }
                ],
                "retention_seconds": 2592000,
                "filter": {
                    "operator": "and",
                    "filters": [
                        {
                            "field": "event",
                            "operator": "eq",
                            "value": "ViewContent"
                        },
                        {
                            "operator": "or",
                            "filters": [
                                {
                                    "field": "price",
                                    "operator": ">=",
                                    "value": "100"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

モバイルアプリのカスタムオーディエンス

モバイルアプリカスタムオーディエンス、カスタムオーディエンスルールの例をご覧ください。

演算子とデータまたはイベント

ルールで使われる演算子とデータまたはイベントは、次のとおりです。

各ルールは、JSONエンコード文字列として指定します。