Zeitplanbasierte Regeln

Überwachen Sie den Zustand Ihrer Werbeanzeigen, indem Sie sie in einem bestimmten Intervall überprüfen, um herauszufinden, ob sie die Kriterien für evaluation_spec erfüllen. Für zeitplanbasierte Regeln ist eine zusätzliche schedule_spec erforderlich.

curl \
-F 'name=Rule 1' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
    ...
   }' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \

-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Zeitplanspezifikation

Die schedule_spec einer Regel legt fest, wie oft sie ausgeführt werden soll. Wir geben dieses Intervall im Feld schedule_type an.

Wenn die schedule_typeCUSTOM ist, musst du außerdem eine Liste individueller Zeitpläne oder Zeitpunkte angeben, zu denen die Regel ausgeführt werden soll.

In der schedule-Liste kann jede Spezifikation aus einer Kombination der folgenden Felder bestehen. Die einzige Voraussetzung besteht darin, dass jeder Eintrag mindestens start_minute oder days enthalten muss.

Weitere Informationen zur Verwendung von CUSTOM-Zeitplanarten findest du unter Erweiterter Zeitplan.

Hier ist ein Beispiel für eine evaluation_spec. Diese Regel schließt alle Objekte in der anfänglichen Liste der IDs ein, die in den letzten 7 Tagen mehr als 10000 Impressionen erzielt haben. Beachte, dass wir in diesem Fall den entity_type-Filter nicht benötigen, da wir mit einem id-Filter ohne Präfix eine statische Liste anfänglicher Objekte definiert haben.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "time_preset",
         "value": "LAST_7_DAYS",
         "operator": "EQUAL"
       },
       {
         "field": "effective_status",
         "value": ["ACTIVE"],
         "operator": "IN"
       },
       {
         "field": "id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "impressions",
         "value": 10000,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Hier ist ein weiteres Beispiel. Diese Regel schließt alle Anzeigengruppen unter den Kampagnen mit den IDs 101, 102, 103 ein, die nur Laufzeitbudgets verwenden und vor weniger als 48 Stunden erstellt wurden. In diesem Fall benötigen wir keinen time_preset-Filter, da keine Insights-Filter vorhanden sind.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "campaign.id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "budget_reset_period",
         "value": ["LIFETIME"],
         "operator": "IN"
       },
       {
         "field": "hours_since_creation",
         "value": 48,
         "operator": "LESS_THAN"
       },
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Hier ist ein Beispiel für eine execution_spec. Diese Regel erhöht das Budget aller passenden Objekte um 10 %. Dies wird maximal 5-mal durchgeführt. Das bedeutet, dass für jedes Objekt, das möglicherweise von der Regel gefunden werden kann, das Budget jeweils höchstens fünfmal um 10 % erhöht werden kann.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 10,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
       {
         "field": "execution_count_limit",
         "value": 5,
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

Hier ist ein weiteres Beispiel. Diese Regel pausiert alle passenden Objekte und sendet eine E-Mail an eine Nutzerliste.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "PAUSE",
     "execution_options": [
       {
         "field": "user_ids",
         "value": [1001, 1002],
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library