Zielgruppenregeln

Zielgruppenregeln bestimmen, ob eine Person deiner Custom Audience hinzugefügt wird. Die Regeln werden entweder auf die Referrer-URL oder auf bestimmte Events und Daten angewendet.

Gib deine Regeln als JSON-codierte Strings an, die wie folgt aufgebaut sind:

Verwende Zielgruppenregeln für verschiedene Arten von Custom Audiences, darunter Custom Audiences für Websites, Custom Audiences über mobile App und Offline-Custom Audiences. Mehr über Zielgruppenregeln für Interaktionen erfährst du unter Custom Audiences für Interaktionen.

Einschränkungen

  • In der Zielgruppenregel kann jede Zielgruppe bis zu 10 Regeln angeben. Dieser Wert enthält die Anzahl der rules in inclusions bzw. exclusions.
  • Für jede Regel können bis zu 100 Filter (Blattknoten) festgelegt werden.

Syntax von Zielgruppenregeln

Bei der Definition einer Zielgruppenregel muss die folgende Struktur beachtet werden:

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

Verfügbare Felder

Name Beschreibung

inclusions

Typ: String

Erforderlich.

JSON-String aus dem Regelsatz, der den Einschluss definiert. Siehe Syntax von Regelsätzen.

exclusions

Typ: String

Erforderlich.

JSON-String aus dem Regelsatz, der den Ausschluss definiert. Siehe Syntax von Regelsätzen.

Syntax von Regelsätzen

Beachte für jeden Regelsatz die folgende Struktur:

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

Verfügbare Felder

Name Beschreibung

operator

Typ: String

Erforderlich.

and oder or.

rules

Typ: String

Erforderlich.

JSON-String der Regeln (Array von Regeln). Siehe Syntax von Ein- und Ausschlussregeln.

Syntax von Ein- und Ausschlussregeln

Beachte für jede Ein- oder Ausschlussregel die folgende Struktur:

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

Die Felder aggregation und retention_seconds können bearbeitet werden. Die Bearbeitung von aggregation und retention_seconds führt jedoch nicht dazu, dass die Zielgruppe gelöscht wird. Dies bedeutet, dass Personen, die nur mit der alten Regel/Aggregation übereinstimmen, weiterhin bis zum Ablaufzeitpunkt in der Zielgruppe enthalten sind.

Verfügbare Felder

Name Beschreibung

event_sources

Typ: String

Erforderlich.

JSON-Objekt, das id und type enthält.


Dem type können weitere Event-Quellen mithilfe einer durch Kommas getrennten Liste "store_visits,pixel,app" hinzugefügt werden.

retention_seconds

Typ: Integer

Erforderlich.

Ganzzahl (in Sekunden) für das Kund*innenbindungsfenster der Zielgruppe, sollte weniger als retention_days betragen. Min = 1, Max = 365 Tage

filter

Typ: String

Erforderlich.

JSON-String der Filterregeln. Siehe Filter.

aggregation

Typ: Integer

Optional.

JSON-String der Aggregatfunktionen. Siehe Aggregatfunktionen.

Filter

Bei der Filterung ist das folgende allgemeine Format zu beachten:

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

Verfügbare Felder

Name Beschreibung

operator

Typ: String

Erforderlich.

and oder or

filters

Typ: String

Erforderlich.

Array von JSON-Objekten mit Filterregeln. Siehe Syntax von Filterregeln.

Syntax von Filtersätzen

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

Verfügbare Felder

Name Beschreibung

field

Typ: String

Erforderlich.


  • Für Custom Audiences für Websites verwende 'event', wenn der Filter ein Event angeben soll. Parameter, die vom Pixel gesendeten Events entsprechen (z. B. 'ViewContent', 'Purchase').
  • Für Custom Audiences über mobile App verwende 'event', wenn der Filter ein Event angeben soll. Parameter, die von der App gesendeten App-Events entsprechen; z. B. „_appVersion“, „_value“ usw.

operator

Typ: String

Erforderlich.

  • =
  • !=
  • >=
  • >
  • <=
  • <
  • i_contains
  • i_not_contains
  • contains
  • not_contains
  • is_any
  • is_not_any
  • i_is_any
  • i_is_not_any
  • i_starts_with
  • starts_with
  • "regex_match"[INFO]

Wird für fieldevent festgelegt, musst du = verwenden.

value

Typ: String

Erforderlich.

Falls das Attribut field auf "event" gesetzt ist, muss value auf einen Event-Namen festgelegt werden. Verwende die App Event API, um App Events und von der App gemeldete Parameter anzuzeigen.

Aggregatfunktionen

Erstelle Custom Audiences basierend auf der Frequenz und Intensität von Verhalten mithilfe der aggregation im Feld für Zielgruppenregeln. Hiermit definierst du eine Aggregatfunktion. Beispiel:

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

Verfügbare Felder

Name Beschreibung

type

Typ: String

Erforderlich.

Art der Aggregatfunktion.

  • Für Custom Audiences für Websites sind die folgenden Funktionen verfügbar: 'count', 'sum', 'avg', 'min', 'max', 'time_spent' und 'last_event_time_field'.
  • Für Custom Audiences über mobile App sind die folgenden Funktionen verfügbar: "count","sum", "avg", "min" und "max".

config

Für einige Aggregatfunktionsarten erforderlich.

method

Typ: String

Optional.

"absolute" (Personen hinzufügen, die Events in einem bestimmten Bereich protokolliert haben) oder "percentile" (Personen aus einem bestimmten Perzentilbereich hinzufügen). Bei Auswahl von percentile sollte der Operator nur in_range und not_in_range sein.

field

Typ: String

Erforderlich. Sofern der Typ nicht count ist.

Der Parameter, auf den die Aggregatfunktion angewendet wird

operator

Typ: String

Erforderlich.

=, !=, >=, >, <=, <, in_range, not_in_range

value

Typ: String

Erforderlich.

Erwarteter Wert des Parameters

Beispiel:

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

Vergleichsoperatoren

Operator Beschreibung

> oder gt

Wahr, wenn der Parameterwert des Events größer ist als der angegebene Wert.

>= oder gte

Wahr, wenn der Parameterwert des Events größer als oder gleich dem angegebenen Wert ist.

< oder lt

Wahr, wenn der Parameterwert des Events kleiner ist als der angegebene Wert.

<= oder lte

Wahr, wenn der Parameterwert des Events kleiner als oder gleich dem angegebenen Wert ist.

= oder eq

Wahr, wenn der Parameterwert des Events gleich dem angegebenen Wert ist. Hinweis: Dies trifft auch dann zu, wenn kein Operator festgelegt wurde, also „'x' : { 'eq' : 'y' }“ ist identisch mit „'x' : 'y' }“.

!= oder neq

Wahr, wenn der Parameterwert des Events ungleich dem angegebenen Wert ist.

contains

Wahr, wenn der Parameterwert des Events als String nicht den angegebenen String enthält. Wert von „shoe12345“ erfüllt „contains“, wenn der angegebene Wert „shoe“ ist.

not_contains

Wahr, wenn der Parameterwert des Events als String nicht den angegebenen String enthält. Wert von „shoe12345“ erfüllt „not_contains“, wenn der angegebene Wert „purse“ ist.

i_contains

„contains“, ohne Beachtung der Groß-/Kleinschreibung

i_not_contains

„not contains“, ohne Beachtung der Groß-/Kleinschreibung

is_any

Wahr, wenn der Parameterwert des Events mit beliebigen Strings in einem bestimmten Array übereinstimmt.

is_not_any

Wahr, wenn der Parameterwert des Events mit keinen Strings in einem bestimmten Array übereinstimmt.

i_is_any

„is_any“, ohne Beachtung der Groß-/Kleinschreibung

i_is_not_any

„is_not_any“, ohne Beachtung der Groß-/Kleinschreibung

starts_with

Wahr, wenn der Parameterwert des Events mit dem genannten String beginnt

i_starts_with

„starts_with“, Groß-/Kleinschreibung egal

regex_match

Stimmt mit einem regulären Ausdruck überein, z. B. \"example\.com.*purchase$\". Die PCRE-Grammatik wird vollständig unterstützt.

Beispiele

Custom Audiences für Websites

Übereinstimmung mit allen Verweis-URLs, die in den letzten 30 Tagen den String „shoes“ enthalten:

{
    "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"
                        }
                    ]
                },
            }
        ]
    }
}

Übereinstimmung mit ViewContent-Events, bei denen der Artikelpreis in den letzten 30 Tagen größer oder gleich 100 USD ist. Erwäge die Verwendung dieser Regel für das folgende Event:

_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"
                                }
                            ]
                        }
                    ]
                }
            }
        ]
    }
}

Custom Audiences über mobile App

Siehe Custom Audiences über mobile App, Custom Audience-Beispielregeln.

Operatoren und Daten oder Events

Regeln haben die folgenden Operatoren und Daten oder Events:

Operatoren Filtertyp

i_contains

Enthält einen Substring, ohne Beachtung der Groß-/Kleinschreibung

i_not_contains

Enthält keinen Substring, ohne Beachtung der Groß-/Kleinschreibung

contains

Enthält einen Substring, mit Beachtung der Groß-/Kleinschreibung

not_contains

Enthält keinen Substring, mit Beachtung der Groß-/Kleinschreibung

eq

Ist gleich, mit Beachtung der Groß-/Kleinschreibung

neq

Ist ungleich, mit Beachtung der Groß-/Kleinschreibung

lt

Kleiner als, nur numerische Felder

lte

Kleiner als oder gleich, nur numerische Felder

gt

Größer als, nur numerische Felder

gte

Größer als oder gleich, nur numerische Felder

regex_match

Stimmt mit einem regulären Ausdruck überein, z. B. \"example\\.com.*purchase$\". Die PCRE-Grammatik wird vollständig unterstützt.

Daten Gefilterte Daten

url

Vollständig kommentierte URL der besuchten Webseite

domain

Domäne der besuchten Webseite

path

Pfad der besuchten Webseite ohne Domäne

event

Name des Pixel-event, z. B. 'ViewContent'

device_type

Gerät, das auf die Webseite zugegriffen hat:

desktop

mobile_android_phone

mobile_android_tablet

mobile_ipad

mobile_ipod

mobile_iphone

mobile_tablet

mobile_windows_phone

beliebiges customData-Feld

Jedes zu customData hinzugefügte Feld für Pixelauslöser, z. B. productId, category, price

Gib jede Regel als JSON-codierten String an.