Änderungsspezifikation für Anzeigenregeln

Auf dieser Seite wird die change_spec genauer erläutert. Dabei erfährst du, wie du die Ausführungsoption erstellst und die erweiterten Features nutzt.

Die change_spec wird für Ausführungsarten wie CHANGE_BUDGET und CHANGE_BID verwendet und enthält die folgenden Parameter: amount, limit, unit, target_field.

Feld	Beschreibung
`amount`	Erforderlich. Bestimmt den Betrag, um den das Budget oder Gebot geändert wird. Die genaue Verwendung dieses Betrags wird durch die Werte anderer Parameter in der `change_spec` gesteuert. Unterstützte Werte: Ein numerischer Wert wie `3000` oder `-50`
`limit`	Optional. Gibt den maximalen oder minimalen Budget- oder Gebotsbetrag an. Wenn du beispielsweise ein Budget oder Gebot erhöhst, gilt diese Zahl als Obergrenze. Wenn `target_field` vorhanden ist, gibt dieser Wert einen Bereich von der Untergrenze bis zur Obergrenze an. Unterstützte Werte: Währung wie `5000` für 50 USD oder für `target_field` ein Währungsbereich wie `[4000, 6000]` für 40 bis 60 USD
`unit`	Erforderlich, es sei denn `target_field` ist vorhanden. Gibt die Einheit für den `amount`-Wert an. Wenn die Einheit beispielsweise `PERCENTAGE` lautet, bedeutet der `amount`-Wert `-50-50%`. Unterstützte Werte:`ACCOUNT_CURRENCY` oder `PERCENTAGE`
`target_field`	Optional. Gibt an, ob Budgets oder Gebote um einen Zielwert geändert werden sollen. Wenn dieser Wert vorhanden ist, ist `amount` der Zielwert des Zielfelds. Budgets oder Gebote werden proportional erhöht oder verringert, je nachdem, ob der aktuelle Wert der Anzeigengruppe für das Zielfeld niedriger oder höher als `amount` ist. Unterstützte Werte: Ein Insights-Feld wie `cost_per_mobile_app_install` oder `mobile_app_purchase_roas`

Beispiele

In diesem Beispiel für eine CHANGE_BUDGET-Regel werden Budgets für alle Anzeigengruppen mit geringer Performance um 30 % verringert. Dabei wird geringe Performance als stabil hoher Laufzeit-Wert für frequency definiert. Diese Regel wird nur dienstags und freitags um Mitternacht ausgeführt.

curl \
-F 'name=Test Change Budget Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
          "start_minute": 0,
         "days": [2, 5]
       }
     ]
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "impressions",
         "value": 8000,
         "operator": "GREATER_THAN"
       },
       {
         "field": "frequency",
         "value": 5.0,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": -30,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

In diesem Beispiel wird das Gebot täglich basierend auf einem cost_per_mobile_app_install-Zielwert für Anzeigengruppe 123 skaliert.

Außerdem fügen wir einen Bereichsfilter für cost_per_mobile_app_install hinzu, um ein Toleranzfenster von 10 % einzurichten. Damit werden geringfügige proportionale Änderungen nicht vorgenommen, wenn der aktuelle Wert nahe genug am Zielwert liegt.

curl \
-F 'name=Test Change Bid Rule' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "id",
         "value": [123],
         "operator": "IN"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "mobile_app_install",
         "value": 100,
         "operator": "GREATER_THAN"
       },
       {
         "field": "cost_per_mobile_app_install",
         "value": [4.5, 5.5],
         "operator": "NOT_IN_RANGE"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BID",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 5.0,
           "limit": [2.0, 10.0],
           "target_field": "cost_per_mobile_app_install"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Angenommen, der aktuelle Wert beträgt 4.0. Dann wird das Gebot um 25% erhöht, da das die proportionale Differenz zwischen dem Zielwert 5.0 und dem aktuellen Wert ist.

Die Begrenzung verhindert ein Erhöhen des Gebots über 10.0 sowie die Verringerung unter 2.0.