Prüfungsspezifikationsfilter

Bei zeitplanbasierten Regeln kannst du erweiterte Arten von Filterfeldern verwenden.

Insights-Felder mit Präfix

Du kannst bestimmte Arten von Präfixen für Insights-Filter festlegen. Das ähnelt den Präfixen für Metadatenfilter für eine Filterung auf mehreren Ebenen.

Du kannst ein Präfix auf Objektebene für einen Filter festlegen, um Insights auf mehreren Ebenen zu filtern. Eine Anzeigenregel kann beispielsweise nach Anzeigengruppe oder Performance der Werbekampagne gefiltert werden. Außerdem kannst du Präfixe für das Attributionsfenster und die Zeitvoreinstellung für einen Filter angeben. Damit werden das Attributionsfenster und die Zeitvoreinstellung für diesen Filter außer Kraft gesetzt.

Nutzung

Präfixe sind optional. Ein Feld kann folgende Präfixe erhalten:

  • Ein Präfix auf Objektebene
  • Ein Attributionsfensterpräfix
  • Ein Zeitvoreinstellungspräfix

Diese Optionen kannst du beliebig kombinieren oder gänzlich weglassen, solange du diese Reihenfolge einhältst. Das Feld muss das folgende Format haben:

{ object_level_prefix? } {attribution_window_prefix?} { time_preset_prefix? } { field_name }

Im Folgenden siehst du Beispiele für richtige und falsche Insights-Felder mit Präfixen. Außerdem zeigen wir dir anhand von Beispielen für richtige und falsche Metadatenfelder mit Präfixen, welche Metadatenfilter wir unterstützen.

Beispiele für Insights-Feld spent
Korrekte Beispiele

adset.yesterday_spent: Gesamtbetrag, der gestern auf Ebene der Anzeigengruppe ausgegeben wurde

adset.spent: Gesamtbetrag, der auf Ebene der Anzeigengruppe ausgegeben wurde

yesterday_spent: Gesamtbetrag, der gestern ausgegeben wurde

campaign.28d_view_1d_click:lifetime_results: Gesamtergebnisse auf Ebene der Anzeigengruppe während der gesamten Laufzeit, mit einem Attributionsfenster von 28 Tagen nach dem Aufruf und 1 Tag nach dem Klicken

campaign.lifetime_spent: Gesamtbetrag, der während der Laufzeit auf Ebene der Anzeigengruppe ausgegeben wurde

Falsche Beispiele

lifetime_campaign.spent: Zeitvoreinstellungspräfixe dürfen nicht vor Präfixen auf Objektebene stehen

lifetime_today_spent: Zwei Zeitvoreinstellungspräfixe sind nicht zulässig

ad.adset.spent: Zwei Präfixe auf Objektebene sind nicht zulässig

yesterday.adset_spent: Ungültiges Trennzeichen


Beispiele für Metadatenfeld daily_budget
Korrekte Beispiele

adset.daily_budget: Tagesbudget der Anzeigengruppe

daily_budget: Tagesbudget

Falsche Beispiele

yesterday_daily_budget: Zeitvoreinstellungspräfixe sind bei Metdatenfeldern nicht zulässig

ad.daily_budget: Für Werbeanzeigen gibt es kein Tagesbudget

Präfixe auf Objektebene

PräfixObjekttypGültig für Objekttypen

ad.

Werbeanzeige

Werbeanzeige

adset.

Anzeigengruppe

Werbeanzeige, Anzeigengruppe

campaign.

Kampagne

Werbeanzeige, Anzeigengruppe, Kampagne

Attributionsfensterpräfixe

Attributionsfensterpräfix Beschreibung

account_default:

Attributionsfenstereinstellung des Kontos verwenden

default:

Das standardmäßige Attributionsfenster auf Facebook ist 1 Tag für Aufrufe, 28 Tage für Klicks

inline:

Nur Inline-Attribution (0 Tage für Aufrufe, 0 Tage für Klicks)

1d_view:

1 Tag für Aufrufe, 0 Tage für Klicks

7d_view:

7 Tage für Aufrufe, 0 Tage für Klicks

28d_view:

28 Tage für Aufrufe, 0 Tage für Klicks

1d_click:

0 Tage für Aufrufe, 1 Tag für Klicks

7d_click:

0 Tage für Aufrufe, 7 Tage für Klicks

28d_click:

0 Tage für Aufrufe, 28 Tage für Klicks

1d_view_1d_click:

1 Tag für Aufrufe, 1 Tag für Klicks

7d_view_1d_click:

7 Tage für Aufrufe, 1 Tag für Klicks

28d_view_1d_click:

28 Tage für Aufrufe, 1 Tag für Klicks

1d_view_7d_click:

1 Tag für Aufrufe, 7 Tage für Klicks

7d_view_7d_click:

7 Tage für Aufrufe, 7 Tage für Klicks

28d_view_7d_click:

28 Tage für Aufrufe, 7 Tage für Klicks

7d_view_28d_click:

7 Tage für Aufrufe, 28 Tage für Klicks

28d_view_28d_click:

28 Tage für Aufrufe, 28 Tage für Klicks

Zeitvoreinstellungspräfixe

Diese Liste ist identisch mit der Liste der gültigen Zeitvoreinstellungswerte, aber in Kleinbuchstaben und mit einem Trennzeichen am Ende.

Präfix Beschreibung

lifetime_

Laufzeit des Objekts

today_

Der aktuelle Tag ab Mitternacht in der Zeitzone des Werbekontos

last_2_days_

YESTERDAY und TODAY

last_3_days_

Die letzten 2 vollständigen Tage und TODAY

last_7_days_

Die letzten 6 vollständigen Tage und TODAY

last_14_days_

Die letzten 13 vollständigen Tage und TODAY

last_28_days_

Die letzten 27 vollständigen Tage und TODAY

last_30_days_

Die letzten 29 vollständigen Tage und TODAY

this_month_

Dieser Monat, einschließlich TODAY

this_week_mon_today_

Diese Woche, wobei Montag als erster Tag der Woche gilt, einschließlich TODAY

this_week_sun_today

Diese Woche, wobei Sonntag als erster Tag der Woche gilt, einschließlich TODAY

yesterday_

Der vorherige vollständige Tag, ohne TODAY

last_2d_

Die letzten 2 vollständigen Tage, ohne TODAY

last_3d_

Die letzten 3 vollständigen Tage, ohne TODAY

last_7d_

Die letzten 7 vollständigen Tage, ohne TODAY

last_14d_

Die letzten 14 vollständigen Tage, ohne TODAY

last_28d_

Die letzten 28 vollständigen Tage, ohne TODAY

last_30d_

Die letzten 30 vollständigen Tage, ohne TODAY

last_nd_14_8_

Die letzten 14 Tage bis zu den letzten 7 Tagen, für ROAS

last_nd_30_8_

Die letzten 30 Tage bis zu den letzten 7 Tagen, für ROAS

last_nd_60_8_

Die letzten 60 Tage bis zu den letzten 7 Tagen, für ROAS

last_nd_120_8_

Die letzten 120 Tage bis zu den letzten 7 Tagen, für ROAS

last_nd_180_8_

Die letzten 180 Tage bis zu den letzten 7 Tagen, für ROAS

last_nd_lifetime_8_

Laufzeit bis zu den letzten 7 Tagen, für ROAS

last_nd_60_29_

Die letzten 60 Tage bis zu den letzten 28 Tagen, für ROAS

last_nd_120_20_

Die letzten 120 Tage bis zu den letzten 28 Tagen, für ROAS

last_nd_180_29_

Die letzten 180 Tage bis zu den letzten 28 Tagen, für ROAS

last_nd_lifetime_29_

Laufzeit bis zu den letzten 28 Tagen, für ROAS

Aggregation

Du kannst einige Insights-Felder über mehrere Anzeigenobjekte hinweg aggregieren. So kannst du Filter zu Metriken für eine bestimmte Untergruppe der Anzeigenobjekte erstellen, z. B. die Gesamtreichweite über mehrere Werbeanzeigen hinweg oder die Gesamtanzahl Klicks für verschiedene Anzeigengruppen.

Während einige Metriken wie clicks einfach aufsummiert werden, werden andere Metriken wie reach anders berechnet. Da reach auf individuellen Impressionen basiert, werden doppelte Nutzer*innen bei der Aggregation über mehrere Anzeigenobjekte entfernt.

Nutzung

Ein aggregiertes Feld hat das Format aggregate({ field }). Das field kann Präfixe für Attributionsfenster und Zeitvoreinstellung enthalten. Welche Anzeigenobjekte aggregiert werden sollen, wird durch ein weiteres erforderliches Filterfeld aggregation_id bestimmt.

Beispiele für Aggregationsfelder

Korrekte Beispiele

aggregate(reach)

aggregate(lifetime_reach)

Falsche Beispiele

aggregate(daily_budget)

aggregate(adset.reach)

Aggregations-ID-Filter

Der aggregation_id-Filter gibt an, welche Anzeigenobjekte aggregiert werden sollen. Er unterstützt nur den IN-Operator und eine Liste von IDs als Wert. Dabei können IDs von Werbeanzeigen, Anzeigengruppen oder Werbekampagnen verwendet werden, die aber allesamt derselben Objektebene angehören müssen.

Beispiel für aggregation_id-Filter

{
  "field": "aggregation_id",
  "operator": "IN",
  "value": [1234, 5678]
},
{
  "field": "aggregate(reach)",
  "operator": "GREATER_THAN",
  "value": 100
}

Unterstützte Felder

  • clicks
  • cpc
  • cpm
  • cpp
  • ctr
  • frequency
  • impressions
  • mobile_app_purchase_roas
  • reach
  • result_rate
  • spent
  • unique_clicks
  • unique_impressions
  • website_purchase_roas
  • cost_per_unique_click

Formelfelder

Du kannst einfache arithmetische Ausdrücke als Feld festlegen. So kannst du beispielsweise das Verhältnis zwischen zwei numerischen Feldern ermitteln.

Dieser Vorgang funktioniert mit Insights-Feldern und einigen der numerischen Metadatenfeldern. Die vollständige Liste der unterstützten Felder findest du weiter unten.

Nutzung

Ein Formelfeld besteht aus durch Leerzeichen getrennten Feldern oder Konstanten und Operatoren mit der korrekten Syntax. Dabei werden die Operatoren +-* und / unterstützt. Du kannst Konstanten hinzufügen, beispielsweise zur Gewichtung bestimmter Felder oder zur Offset-Festlegung.

In diesem Fall können die Felder mit gültigen Objektebenen- und Zeitvoreinstellungspräfixen versehen werden.

Derzeit sind höchstens 6 Nicht-Konstantenfelder in einer Formel zulässig. Du kannst beliebig viele Konstanten festlegen.

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

{ field_or_constant_1 } { + | - | * | / } { field_or_constant_2 }

Beispiele für Formeln

Korrekte Beispiele

today_spent / adset.daily_budget: Tägliche Ausgaben in Prozent

clicks / adset.clicks: Verhältnis der Klicks zu den Klicks der Anzeigengruppe

today_impressions / yesterday_impressions: Verhältnis der Impressionen von heute zu den Impressionen von gestern

today_impressions / aggregate(today_impressions): Verhältnis der Impressionen von heute zu einer aggregierten Anzahl von Impressionen

(adset.spent - spent): Klammern werden akzeptiert; Formeln aus API-Antworten werden in Klammern gesetzt

Falsche Beispiele

(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per: Es dürfen nicht mehr als 6 Felder verwendet werden

today_impressions/yesterday_impressions: Elemente müssen nur Leerzeichen getrennt sein

Gültige numerische Metadatenfelder

FeldGültig für Objekttypen

bid_amount

Werbeanzeige, Anzeigengruppe

daily_budget

Anzeigengruppe

lifetime_budget

Anzeigengruppe

spend_cap

Kampagne