Gebots-Multiplikatoren

HINWEIS: Diese API ist in eingeschränkter Weise für Partner und Werbetreibende auf der Positivliste verfügbar. Setze dich mit deinem*deiner Meta-Vertreter*in in Verbindung, wenn du sie nutzen möchtest.

Mit Gebots-Multiplikatoren können Werbetreibende das Ausmaß der notwendigen Zielgruppensegmentierung verringern, da sie ermöglichen, eine nuancierte Gebotsstrategie in einer einzelnen Anzeigengruppe mit einer Zielgruppe zu verwenden. So erstellen sie in der Regel Anzeigengruppen, damit sie verschiedene Gebote für die unterschiedlichen Zielgruppen nutzen können. Sie können beispielsweise drei separate Anzeigengruppen für drei verschiedene Altersgruppen definieren: 18–25, 26–35, 36–65. Ein Werbetreibender kann eine einzelne Anzeigengruppe erstellen und dann Gebots-Multiplikatoren verwenden, um jeweils unterschiedliche Gebote für diese Buckets zu nutzen.

Best Practices für Gebots-Multiplikatoren

• Verwende selbstdefinierte Gebotsstrategien, ohne viele Zielgruppensegmente oder Anzeigengruppen erstellen zu müssen. So erreichst du eine bessere Anzeigenauslieferung und vermeidest gleichzeitig übermäßige Segmentierung von Kampagnen in viele Anzeigengruppen mit relativ kleinen Zielgruppen.
• In der Vergangenheit konntest du drei Anzeigengruppen erstellen, die drei Altersgruppen entsprachen. Anschließend konntest du für jede einzelne dieser Anzeigengruppen ein Gebot abgeben. Jetzt kannst du eine einzelne Anzeigengruppe erstellen und über Gebots-Multiplikatoren für jede dieser Altersgruppen unterschiedlich bieten. Gebots-Multiplikatoren reichen von 0,09 bis 1.0.
• Gebots-Multiplikatoren müssen unter einem einzelnen user_groups-Schlüssel angegeben werden.
• Gebots-Multiplikatoren stehen bei Auktionskampagnen zur Verfügung.
• Alle Gebotsstrategien werden mit Gebots-Multiplikatoren unterstützt: Gebotsbegrenzung, Kostenbegrenzung und Niedrigste Kosten.

Zielgruppenkategorien einrichten

Bei Gebots-Multiplikatoren kannst du Zielgruppenkategorien definieren und jeder einen Gebots-Multiplikator zuweisen. Zielgruppenkategorien werden durch die demografischen Informationen der Nutzer*innen, die Nutzer*innengeräte und die selbstdefinierten Daten des Werbetreibenden definiert. Bei Kampagnen für Wohnraum, Beschäftigung oder Kredite ist es nicht möglich, Gebote für die Zielgruppenkategorien age, gender, locale, home_location, user_bucket und Lookalike-custom_audience (eine Custom Audience, die von einer Lookalike Audience abgeleitet wird) zuzuweisen.

age

Nutzer*innen nach Altersgruppen gruppieren, beispielsweise 18-25, 26-35. Beispiel: Biete bei einer Anzeigengruppe mit einer Gebotsbegrenzung von 5 USD für Nutzer*innen zwischen 18 und 25 Jahren 2,50 USD, für Nutzer*innen zwischen 26 und 40 Jahren 3,50 USD und für alle anderen Nutzer*innen 5 USD. Hinweis: Der Standard ist optional. Du kannst 1.0 als Multiplikator anwenden.

Beispiel

{
    "user_groups": {
      "age": {
        "18-25": 0.5,
        "26-40": 0.7,
        "default": 1.0
      }
    }
}

booking_window

Als Aufschlüsselungswert ist jeder ganzzahlige Bereich größer oder gleich 1 möglich. Beispiel: 1-3, 4-9 usw.

Beispiel

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"booking_window":{"event_sources":["123456789"],"1-2":0.1,"3-5":0.2,"default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Siehe auch Beispiel für Reisen-Multiplikator.

custom_audience

Du kannst Gebote basierend auf deinen Custom Audiences anpassen.

Beispiel

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"custom_audience":{"<CUSTOM_AUDIENCE_ID>":0.8, "<CUSTOM_AUDIENCE_ID>":1.0, "default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

device_platform

Mögliche Aufschlüsselungswerte:

• mobile
• desktop

Beispiel

{
  "user_groups": {
    "device_platform": {
      "mobile": 0.7,
      "desktop": 0.9
    }
  }
}

gender

Teile Gruppen nach Geschlecht ein:

• male
• female
• default

Beispiel

{
  "user_groups": {
    "gender": {
      "male": 0.5,
      "female": 0.7,
      "default": 1.0
    }
  }
}

home_location

Mögliche Aufschlüsselungswerte:

• city id
• region id
• 2-stellige Landesvorwahl

Du findest city id und region id in der Search API. Du kannst die Abfrage vom Graph API Explorer oder von deinem Terminal durchführen.

Hinweis: Der default-Wert kann nur unter home_location festgelegt werden, nicht unter cities, regions oder countries.

Beispiel

{
  "user_groups": {
    "home_location": {
      "cities": {
         "2420605": 0.2
      },
      "regions": {
         "3847": 0.5
      },
      "countries": {
         "US": 0.2
      },
      "default": 0.8
     }
  }
}

length_of_stay

Als Aufschlüsselungswert ist jeder ganzzahlige Bereich größer oder gleich 1 möglich. Beispiel: “1-3”, “4-9” usw.

Beispiel

curl -X POST \ 
  -F 'bid_adjustments=
  {"user_groups":{"length_of_stay":{"event_sources":["123456789"],"1-2":0.1,"3-     5":0.2,"default":0.5}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Siehe auch Beispiel für Reisen-Multiplikator.

locale

Du kannst Gebietsschema- oder Gebietsschemagruppen-IDs wie 6 für Englisch (USA) oder 5 für Deutsch verwenden.

Du findest die Gebietsschema-IDs über Targeting-Suche, Gebietsschemata mit type=adlocale. Zum Beispiel:

{
  "user_groups": {
    "locale": {
      6: 0.8,
      5: 0.3
    }
  }
}

position_type

Diese Kategorie ähnelt den Positionsoptionen in der Targeting API. Mögliche Aufschlüsselungswerte:

Beispiel

{
  "user_groups": {
    "position_type":{
        "facebook_feed":0.9,
        "messenger_messenger_home":0.7,
        "instagram_stream":0.8,
        "audience_network_classic":0.5,
        "default":0.4
    }
  }
}

publisher_platform

Mögliche Aufschlüsselungswerte:

• facebook
• instagram
• audience_network
• messenger

Beispiel

{
  "user_groups": {
    "publisher_platform": {
      "facebook": 0.7,
      "instagram": 0.9,
      "default": 1.0 // We'll apply bid multiplier 1.0 if no default is specified anyway
    }
  }
}

travel_start_date

Als Aufschlüsselungswert ist jeder Datumsbereich im Format _yyyymmdd_-_yyyymmdd_ möglich.

Beispiel

curl -X POST \ 
  -F 'bid_adjustments=
     {"user_groups":{"travel_start_date":{"event_sources":["123456789"],"20180901-20181001":0.2,"default":0.9}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Siehe auch Beispiel für Reisen-Multiplikator.

travel_start_day_of_week

Als Aufschlüsselungswert ist jede Ganzzahl zwischen 0 und 6 (einschließlich) möglich. 0 ist Montag. 6 ist Sonntag.

Beispiel

curl -X POST \ 
  -F 'bid_adjustments=
  {"user_groups":{"travel_start_day_of_week":{"event_sources":        ["123456789"],"0":0.1,"2":0.2,"6":0.3,"default":0.9}}}' \ 
  -F 'access_token='$access_token \ 
  https://graph.facebook.com/<API_VERSION>/<ad_set_id>

Siehe auch Beispiel für Reisen-Multiplikator.

user_bucket

Du kannst uns die Ergebnisse deines eigenen Klassifizierers senden. Sende uns dann einen zusätzlichen user_bucket-Parameter in Pixel-Auslösungen oder App-Events. Nutzer*innen-Buckets sind Ganzzahlen in einem Bereich von 0 bis 100.

Gib die Gruppendefinition des Nutzer*innen-Buckets im folgenden Format an:

• event_sources – Zu erfassende Pixel-Auslöse- oder App-Event-Quelle.
• event_retention – Optional. Zeit in Sekunden zum Ignorieren alter user_bucket-Werte.
• events_dedup_mode – Optional. Flag zum Angeben, welcher user_bucket-Wert verwendet werden soll, wenn eine einzelne Event-Quelle verschiedene user_bucket-Werte für denselben*dieselbe Nutzer*in sendet. Der Standardwert ist latest.
• event_source_preference – Optional. Flag zum Angeben, welcher user_bucket-Wert verwendet werden soll, wenn mehrere Event-Quellen verschiedene user_bucket-Werte für denselben*dieselbe Nutzer*in senden. Der Standardwert ist latest.

Beispiel

{
  "user_groups": {
   "user_bucket": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "event_retention": 604800, // optional, exclude old events
      
      //optional, useful when multiple event sources have user_bucket
      "events_dedup_mode": "max"|"min"|"latest",
      
      //optional, dedup user_bucket values sent from one single event source
      "event_source_preference": "max"|"min"|"latest",
      
      "1":0.7, // these are the bid multipliers
      "2":1.0,
     }
  }
}

user_device

Mögliche Aufschlüsselungswerte:

• iPad
• iPhone

Weitere mögliche Werte findest du unter Targeting Search API mit type=adTargetingCategory und class=user_device.

Beispiel

{
  "user_groups": {
    "user_device": {
      "iPad": 0.7,
      "iPhone": 0.9,
      "default": 1.0
    }
  }
}

Beispiel

curl
  -F 'name=Test BM Adset '$(date +%s) \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=23843038336220329' \
  -F 'promoted_object={"product_set_id":"267888283975766"}' \
  -F 'targeting={
     "geo_locations": {"countries":["AQ"]},
     "dynamic_audience_ids": ["23842885952670329"],
     "publisher_platforms": ["facebook"]
    }' \
  -F 'bid_adjustments={"user_groups":{"user_device": {"iPad": 0.7, "iPhone": 0.9, "default": 1.0}}}' \
  -F 'status=PAUSED' \
  -F 'access_token='$access_token \
  https://graph.facebook.com/<API_VERSION>/act_1653439931385336/adsets

Beispiel

curl
  -F 'name=Test BM Adset '$(date +%s) \
  -F 'bid_amount=3000' \
  -F 'billing_event=IMPRESSIONS' \
  -F 'optimization_goal=OFFSITE_CONVERSIONS' \
  -F 'daily_budget=15000' \
  -F 'campaign_id=23843038336220329' \
  -F 'promoted_object={"product_set_id":"267888283975766"}' \
  -F 'targeting={
     "geo_locations": {"countries":["AQ"]},
     "dynamic_audience_ids": ["23842885952670329"],
     "publisher_platforms": ["facebook"]
     }' \
  -F 'bid_adjustments={"user_groups":{"user_device": {"iPad": 0.7, "iPhone": 0.9, "default": 1.0}}}' \
  -F 'status=PAUSED' \
  -F 'access_token='$access_token \
   https://graph.facebook.com/<API_VERSION>/act_1653439931385336/adsets
   {"id":"23843038339320329"}

Beispiel

curl
  -F 'access_token='$access_token \
  https://graph.facebook.com/VERSION/ID?fields=bid_adjustments
  {"bid_adjustments":{"user_groups":"{\"user_device\":    {\"default\":1,\"iPad\":0.7,\"iPhone\":0.9}}"},"id":"ID"}

Siehe auch Erweitertes Beispiel.

user_group_weight_spec

Mögliche Aufschlüsselungswerte:

• age
• gender
• device_platform
• publisher_platform
• user_device
• user_os

Siehe auch Erweitertes Beispiel.

Beispiel: user_group_weight_spec ist eine JSON-Struktur, die wie folgt aussieht:

{
  <BREAKDOWN_NAME>: {
    <BREAKDOWN_VALUE_1>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    <BREAKDOWN_VALUE_2>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    <BREAKDOWN_VALUE_3>: <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>,
    ...
    "default": <WEIGHT_VALUE> OR <NESTED_USER_GROUP_WEIGHT_SPEC>, // optional, if not specified, we'll use 1.0
  }
}
{
  "age": {
    "18-25": 0.7,
    "26-35": {
      "gender": {
        "male": 0.9,
        "female": 1.0
      }
    },
    "default": 0.85
  }
}

* For users between the ages of 18 and 25, we apply bid multiplier 0.7.
* For male users between the ages of 26 and 35, we apply bid multiplier 0.9.
* For female users between the ages of 26 and 35, we apply bid multiplier 1.0.
* For all other users, we apply bid multiplier 0.85.

Aufschlüsselungswerte sind ganzzahlige Altersgruppen. Du könntest beispielsweise 18–25 angeben, wobei das Mindestalter 18 ist und die Gruppen sich nicht überschneiden dürfen.

Beispiel

{
  "user_groups": {
    "age": {
      "18-25": 0.7,
      "30-40": 1.0,
      "default": 0.3
    }
  }
}

Erweitertes Beispiel

> curl 
    -F 'bid_adjustments={"user_groups":{"user_device":{"iPad":0.3,"iPhone":{"user_os":{"Android":0.3,"iOS":{"age":{"18-35":0.3,"35-45":0.4}}}}}}}' -F access_token=$token https://graph.intern.facebook.com/v2.12/6089875504114
{"success":true}%
> curl -G 
   -d access_token=$token https://graph.intern.facebook.com/v2.12/6089875504114\?  fields\=bid_adjustments
{"bid_adjustments":{"user_groups":"{\"user_device\":{\"iPad\":0.3,\"iPhone\":{\"user_os\":{\"Android\":0.3,\"iOS\":{\"age\":{\"18-35\":0.3,\"35-45\":0.4}}}}}}"},"id":"6089875504114"}%

Beispiel für Reisen-Multiplikator

curl -X POST \
  -F 'bid_adjustments={"user_groups":{"travel_start_day_of_week":{"event_sources":["1862565504034757"],"1":0.1,"3":0.1,"default":0.9}}}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<ADSET_ID>

  Length of Stay 'bid_adjustments={"user_groups":{"length_of_stay":{"event_sources":["1862565504034757"],"1-2":0.1,"3-7":0.2,"default":0.5}}}'
  Booking window 'bid_adjustments={"user_groups":{"booking_window":{"event_sources":["1862565504034757"],"1-2":0.1,"3-7":0.2,"default":0.5}}}'
  Travel start date: 'bid_adjustments={"user_groups":{"travel_start_date":{"event_sources":["1862565504034757"],"20180918-20190101":0.1,"default":0.5}}}'
  Day of week: 'bid_adjustments={"user_groups":{"travel_start_day_of_week":{"event_sources":["1862565504034757"],"1":0.1,"2":0.1,"0":0.2,"default":0.5}}}'

user_os

Mögliche Aufschlüsselungswerte:

• iOS
• Windows

Weitere mögliche Werte findest du unter Targeting Search API mit type=adTargetingCategory und class=user_os.

Derzeit werden die folgenden Werte unterstützt:

• Android
• Windows
• Windows Phone
• iOS

Beispiel

{
  "user_groups": {
    "user_os": {
      "Android": 0.7,
      "iOS": 0.9,
      "default": 1.0
    }
  }
}

user_recency

Gruppiere Nutzer*innen nach der Zeit, zu der sie Pixel-Feuer-Events oder App-Events ausgelöst haben. Du musst Zeitfenster angeben und welche Event-Quellen du verfolgen möchtest.

Beispiel

Dieses Beispiel zeigt, wie du den Gebots-Multiplikator 1.0 für Nutzer*innen mit Pixel-Auslöse- oder App-Events innerhalb von 86400 Sekunden usw. anwendest.

{
  "user_groups": {
    "user_recency": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "0-86400": 1.0,
      "86401-172800": 0.7,
      "default": 0.5
    }
  }
}

Mehrere Aufschlüsselungen kaskadieren

Du kannst Nutzer*innengruppen auch mit mehreren Aufschlüsselungen definieren, indem du eine Gebots-Multiplikator-Gleitkommazahl durch eine weitere Aufschlüsselungsspezifikation ersetzt. Eine Anzeigengruppe mit einer Gebotsbegrenzung von 5 USD und der unten aufgeführten Konfiguration sähe wie folgt aus:

• biete 4,50 USD für männliche Nutzer
• biete 3,50 USD für Nutzerinnen zwischen 18 und 25 Jahren
• biete 4 USD für Nutzerinnen zwischen 26 und 35 Jahren
• biete 5 USD für alle anderen Nutzer*innen

{
  "user_groups": {
    "gender": {
      "male": 0.9,
      "female": {
        "age": {
          "18-25": 0.7,
          "26-35": 0.8
        }
      }
    }
  }
}

Voraussetzungen für die Verwendung

• Der Wert des Gebots-Multiplikators muss zwischen 0.09 und 1.0 liegen.

API-Aufrufe

Abrufen

curl -G \
  -d 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<ADSET_ID>?fields=bid_adjustments

Aktualisieren

curl \
  -F 'bid_adjustments={"user_groups":<USER_GROUP_WEIGHT_SPEC>}' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/<API_VERSION>/<PRODUCT_CATALOG_ID>/<ADSET_ID>

Gebots-Multiplikator für eine Anzeigengruppe erstellen oder aktualisieren

Unten siehst du ein Beispiel für einen API-Aufruf zum Aktualisieren einer vorhandenen Anzeigengruppe. (Du musst eine Anzeigengruppen-ID, das Zugriffstoken, Event-Quellen und die gewünschten Gebots-Multiplikatoren angeben.)

curl -X POST \
  -F 'bid_adjustments={
       "user_groups": {
         "user_bucket": {
           "event_sources": [
             "<PIXEL_ID>",
             "<APP_ID>"
           ],
           "1": 0.1,
           "2": 0.2,
           "3": 0.3,
           "default": {
             "gender": {
               "male": 0.99,
               "female": 0.12
             }
           }
         }
       }
     }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/<AD_SET_ID>/

Testkampagne einrichten

Erstelle deine Testkampagnen zusammen mit deinem Meta-Kontoteam und Messungs-Lead mit einem Conversion Lift oder Split-Test. Um die Leistung zu beurteilen, schlagen wir die folgenden Zellen für einen Drei-Wege-Split-Test vor:

• Zelle 1 (Kontrollgruppe A), Kampagne 1: Eine Anzeigengruppe mit einem Gebot für alle angesprochenen Nutzer*innen
• Zelle 2 (Kontrollgruppe B), Kampagne 2: Mehrere Anzeigengruppen mit einer Anzeigengruppe pro Nutzer*innengruppe. (Du kannst Regeln für Custom Audiences aus einer Website oder mobilen App verwenden, um nach Pixel-/App-Parametern zu segmentieren.)
• Zelle 3 (Testgruppe), Kampagne 3: Eine Anzeigengruppe mit unterschiedlichen Gebots-Multiplikatoren für verschiedene Nutzer*innengruppen. Das angepasste Gebot für jede Nutzer*innengruppe muss hierbei mit dem Gebot auf Anzeigengruppenebene für die entsprechende Anzeigengruppe in Zelle 2 identisch sein.

Split-Tests einrichten

An diesem Punkt solltest du Split-Tests und Kontrollgruppen einrichten, um die Performance bei Verwendung von Gebots-Multiplikatoren zu überprüfen. Wir führen die Tests für ein bis zwei Wochen durch und es ist kein Mindestbudget erforderlich. Richte die Split-Tests wie folgt ein:

• Zelle 1, Kontrollgruppe A Sollte eine Anzeigengruppe mit einem Gebotsbetrag enthalten mit Targeting, das auf allen user_buckets basiert.
• Zelle 2, Kontrollgruppe B Sollte mehrere Anzeigengruppen mit einer Anzeigengruppe pro user_bucket enthalten. Jede Anzeigengruppe sollte auf einen eigenen user_bucket und ein entsprechendes Gebot ausgerichtet sein. Du kannst Regeln für Website Custom Audiences oder Custom Audiences über die mobile App verwenden, um die Zielgruppe basierend auf anderen Meta-Pixel- oder App-Event-Parametern noch weiter zu segmentieren. Siehe Custom Audiences über Website und Custom Audiences über mobile App.
• Zelle 3, Testgruppe Enthält eine Anzeigengruppe mit der bid_adjustment-Eigenschaft, um unterschiedliche Gebote für jeden user_bucket zu bestimmen. Deine Multiplikatoren müssen mit den einzelnen Anzeigengruppengeboten für Zelle 2, Steuerung B übereinstimmen.

Mehr dazu erfährst du unter Split-Tests.

Testkampagne einrichten

Richte eine Anzeigenkampagne so ein, wie du eine normale Kampagne einrichtest. Wende dich an deine*n Ansprechpartner*in bei Meta, wenn du Hilfe bei der Gebotsanpassung benötigst.

Richte user_groups und unterschiedliche Gebots-Multiplikatoren für jede Gruppe ein. Deine Gruppen basieren auf demografischen Eigenschaften wie Alter, Geschlecht und spezifischen Eigenschaften wie Nutzer*innenbewertung und Treueprogramm. Zum Beispiel:

{
   "user_bucket":{
      "business_id":253286871795863,
      "1":0.7,
      "2":1.0,
      "3":{
         "gender":{
            "male":1.0,
            "female":0.8
         }
      },
      "default": 0.9
   }
}

Stelle in diesem Beispiel Folgendes ein:

• Wende für Personen mit dem loyalty_program-Wert 1 den Gebots-Multiplikator 0,7 an.
• Wende für Personen mit dem loyalty_program-Wert 2 den Gebots-Multiplikator 1,0 an.
• Wende für männliche Personen mit dem loyalty_program-Wert 3 den Gebots-Multiplikator 1,0 an.
• Wende für weibliche Personen mit dem loyalty_program-Wert 3 den Gebots-Multiplikator 0,8 an.
• Wende für Personen mit einem anderen loyalty_program-Wert als 1, 2 oder 3 den Gebots-Multiplikator 0,9 an.
• Wende für alle anderen den Gebots-Multiplikator 1,0 an.

Jetzt kannst du die Anzeigenkampagne erstellen:

curl -X POST \
  -F 'name="My Adset with bid multiplier"' \
  -F 'campaign_id="<AD_CAMPAIGN_ID>"' \
  -F 'daily_budget=3000' \
  -F 'billing_event="IMPRESSIONS"' \
  -F 'optimization_goal="OFFSITE_CONVERSIONS"' \
  -F 'bid_amount=500' \
  -F 'bid_adjustments={
       "user_groups": {
         "gender": {
           "male": 0.8,
           "female": 1
         }
       }
     }' \
  -F 'promoted_object={
       "product_set_id": "<PRODUCT_SET_ID>",
       "custom_event_type": "ADD_TO_CART"
     }' \
  -F 'targeting={
       "facebook_positions": [
         "feed"
       ],
       "geo_locations": {
         "countries": [
           "US"
         ]
       }
     }' \
  -F 'status="PAUSED"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  https://graph.facebook.com/v21.0/act_<AD_ACCOUNT_ID>/adsets

Wenn du die Anzeigengruppen erstellt hast, lege bid_adjustments über die API für die Anzeigengruppe fest. Der Parameter sollte in etwa wie folgt aussehen:

{
  "user_groups": {
    "user_bucket": {
      "event_sources": [<pixel_id>,<app_id>,...],
      "event_source_preference": "max"|"min"|"latest", //optional, useful when multiple event sources have user_bucket
      "events_dedup_mode": "max"|"min"|"latest", //optional, dedup user_bucket values sent from one single event source
      "event_retention": 604800, // optional, exclude old events
      "1":0.7, // these are the bid multipliers
      "2":1.0,
      "default": { // used in the case that we don't have user_bucket for that user
         gender:{ // this is a nested example, but you could just do "default": 1.0,
            "male": {
              home_location: {
                  cities: { // city id, can be found in search API, eg: search?type=adgeolocation&q=Menlo Park&limit=10
                    "2420605": 0.2,
                  },
                  regions: {
                    "3847": 0.5
                  },
                  countries: {
                    "US": 0.2
                  }
                }
              }
            },
            "female": {
              "user_recency": {
                "event_sources": [<pixel_id>,<app_id>,...],
                "0-86400": 0.5,
                "86400-172800": 0.7,
                "default": 0.2
              }
            }
         },
      },
   },
}

Dieser Parameter wird derzeit nicht validiert. Sende deine Anzeigengruppen-ID an deine*n Meta-Ansprechpartner*in, damit wir ihn manuell prüfen können.

Für jede Event-Quelle wird der zuletzt empfangene user_bucket für diese*n Nutzer*in verwendet. Wenn du aber mehrere Event-Quellen angibst (beispielsweise Pixel und App) und für mindestens zwei von ihnen ein eigener user_bucket erfasst ist, verwenden wir den höchsten aller Werte.

Unten siehst du einen Beispielaufruf zum Aktualisieren einer vorhandenen Anzeigengruppe. Du musst deine eigene Anzeigengruppen-ID, das Zugriffstoken, die Event-Quellen und die Gebots-Multiplikatoren angeben:

curl -X POST 
  -F access_token=<access_token> \
  -F 'bid_adjustments={"user_groups": {"user_bucket": {"event_sources": [<pixel_id>,  <app_id>,...], "1": 0.1, "2": 0.2, "3": 0.3, "default": {"gender": {"male": 0.99, "female": 0.1}} }} }' \ 
  https://graph.facebook.com/<VERSION>/<ad-set-id>