Reservierung

Durch Reservierungen kannst du deine Kampagnen mit festen Preisen planen und kaufen. So kannst du deine Reichweite optimieren und die Anzeigenfrequenz kontrollieren, während du die Leistung deiner Kampagne besser vorhersagen kannst. Dies ähnelt der Art und Weise, wie TV-Spots meist gebucht werden. Es handelt sich hierbei um eine spezielle Option für Fortgeschrittene, die die meisten Werbetreibenden nur nutzen, wenn ihre Werbeanzeigen mit besonders hoher Sicherheit eine bestimmte Anzahl von Kontenübersichtskonten erreichen sollen.

Die Reservierung funktioniert mit verschiedenen Anzeigenarten und Geräten. Da Meta für das Targeting echte Personen und nicht Cookies verwendet, können wir mit höherer Genauigkeit die Reichweite vorhersagen und die Frequenz geräteübergreifend kontrollieren.

Einschränkungen

  • Nur für bestimmte Werbekonten verfügbar. Prüfe den CAN_USE_REACH_AND_FREQUENCY-Parameter eines Werbekontos.
  • Die stop_time der Anzeigengruppe darf maximal 180 Tage nach einer Vorhersage liegen.
  • Für Konten gelten auch länderbasierte Einschränkungen. Überprüfe diese mit einem GET-API-Aufruf an https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>?fields=rf_spec.
  • Lege in target_spec nur ein Land auf einmal fest.
  • Für user_os ist keine minimale iOS-Version wie z. B. iOS_ver_2.0_and_above erforderlich.
  • Bei der Erstellung oder Aktualisierung einer Reservierungs-Kampagne kannst du kein Laufzeit- oder Tagesbudget, keinen Impression-Grenzwert für Laufzeit oder Tag, keinen Frequenzgrenzwert und kein externes Gebot und auch nicht das Feld PacingType festlegen.

Durchsuche rf_spec nach geltenden Einschränkungen:

Name Beschreibung

countries

Array

Länder, in denen Reservierung unterstützt wird

min_campaign_duration

Objekt

Mindestkampagnendauer in Tagen pro unterstütztem Land

max_campaign_duration

Objekt

Maximale Kampagnendauer in Tagen pro unterstütztem Land

max_days_to_finish

Objekt

Tage im Voraus, die die Kampagne zur Zeit der Voraussage beendet werden kann, pro unterstütztem Land

min_reach_limits

Objekt

Mindestreichweite als Anzahl der Kontenübersichtskonten pro unterstütztem Land

Ergebnisse sehen wie folgt aus:

{
  "rf_spec": {
    "min_reach_limits": {
      "US": 1000000,
      "CA": 1000000,
    },
    "countries": [
      "US",
      "CA",
    ],
    "min_campaign_duration": {
      "US": 3,
      "CA": 3,
    },
    "max_campaign_duration": {
      "US": 30,
      "CA": 30,
    },
    "max_days_to_finish": {
      "US": 56,
      "CA": 56,
    }
  }
}

Vorhersagen erstellen

Vorhersagen geben die Anzahl der Kontenübersichtskonten an, die deine Anzeige in einem bestimmten Datumsbereich bei bestimmten Werten für Reichweite, Frequenz, Zielgruppe und Budget erreichen kann. Mit Reservierungs-Vorhersagen kannst du die Ergebnisse über die gesamte Lebensdauer deiner Kampagne hinweg simulieren und sie basierend auf deinem Ziel, dem Budget, der Zielgruppe, dem Format und den Platzierungen, der Markensicherheit, den Leistungszielen und den Einstellungen zum Kontrollieren der Frequenz anpassen.

Änderungen an einer Reservierungs-Kampagne sind nach der Buchung möglich, aber sobald die Kampagne läuft, kannst du sie nicht mehr bearbeiten oder pausieren, außer um dein Anzeigenziel zu ersetzen. Falls du nur die Gestaltung einer Werbeanzeige bearbeitest, ändert sich deine Vorhersage nicht. Du kannst die Kampagne löschen, um sie abzubrechen und zu beenden. Möglicherweise musst du die Kampagne jedoch erneut buchen und erhältst eine neue CPM und Vorhersagen zu Kampagnenergebnissen. Buche nur Kampagnen, die du ausführen möchtest.** Reserviere für Tests die geringstmögliche Größe und Länge und stelle sicher, sie zu stornieren, da wir für dich echten Werbebestand reservieren.

Einschränkungen

Für Vorhersagen gelten standardmäßige Grenzwerte:

  • Zielgruppen mit mindestens 300.000 Kontenübersichtskonten.
  • Mindestreichweite von 200.000 Kontenübersichtskonten.
  • Anzeigengruppen müssen mindestens 1 Tag geschaltet werden und dürfen maximal 90 Tage geschaltet werden (Die Anzahl der Tage wird als die Anzahl der Tage berechnet, die die Kampagne abdeckt. Wenn eine Kampagne beispielsweise um 12:00 Uhr an Tag 1 beginnt und um 10:00 Uhr an Tag 2 beendet wird, beträgt ihre Laufzeit 2 Tage, obwohl die Dauer weniger als 24 Stunden beträgt.)
  • Das Enddatum der Anzeigengruppe darf maximal 180 Tage nach einer Vorhersage liegen.
  • Die Kampagne muss nach 6:00 Uhr am letzten Tag in der Zeitzone des Werbekontos beendet werden.

Vorhersagen erstellen

Gib Felder für Details an. Um alle reachfrequencypredictions für ein Konto abzurufen, führe eine HTTP GET-Anfrage an https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions?fields={COMMA_SEPERATED_FIELD_LIST} durch.

Um alle reachfrequencypredictions auf Grundlage einer reachfrequencyprediction-ID zu erreichen, führe eine HTTP GET-Anfrage mit den gewünschten Feldern durch: https://graph.facebook.com/{API_VERSION}/{RF_PREDICTION_ID}?fields={COMMA_SEPERATED_FIELD_LIST}.

Standardmäßig gibt Meta die ID zurück. Unter Vorhersage zu Reservierung, Lesen findest du Details zu den Feldern.

Statuscodes der Antwort

Dies sind die möglichen status-Ergebnisse für reachfrequencyprediction. Anfängliche Einschränkungen werden ggf. angezeigt. Sie können jedoch in Zukunft nach Werbekonto oder nach Land variieren:

Code Status Beschreibung

1

SUCCESS

Vorhersage erfolgreich.

2

PENDING

Vorhersage wird noch bearbeitet.

3

FAIL

Zielgruppe nicht erreichbar. Zu hohe Reichweite oder zu hohes Budget.

4

FAIL

Ungültige Vorhersageeinstellungen, z. B. Dauer.

5

FAIL

targeting_spec ungültig.

6

FAIL

Zu geringes Budget oder Gebot für angegebene Reichweite.

7

FAIL

Zu kurze Dauer der Anzeigengruppe.

8

FAIL

Zu lange Dauer der Anzeigengruppe.

9

FAIL

Enddatum der Anzeigengruppe zu weit in der Zukunft.

10

FAIL

Frequenzgrenzwert nicht angegeben.

11

FAIL

Werbeplatzierung nicht unterstützt, z. B. Kombination aus rechter Spalte und Feed.

12

FAIL

Probleme mit Datumsangaben der Anzeigengruppe (Startzeit und/oder Endzeit): Startzeit in der Vergangenheit, nicht Mitternacht oder nicht vollständiger Tag. Endzeit in der Vergangenheit, mehr als 90 Tage nach der Startzeit oder endet nicht nach 06:00 Uhr.

13

FAIL

Zielland noch nicht unterstützt.

14

FAIL

Datumsangaben der Anzeigengruppe umfassen gesperrte Tage.

15

FAIL

Nicht ausreichender Bestand, Reservierung nicht möglich. Siehe „Reservierung einer Vorhersage“.

16

FAIL

Für Konto erforderliche Mindestreichweite nicht erreicht. Siehe „Kontoeinschränkungen abrufen“.

17

FAIL

Tatsächliche für diese Vorhersage verfügbare Reichweite liegt unter der Mindestreichweite des Ziellandes. Diese beträgt für die meisten Länder 200.000.

18

FAIL

Ungültiger Tagestrennungszeitplan.

19

FAIL

Ziel-CPM nicht erreichbar.

20

FAIL

Frequenzgrenzwert zu niedrig für gemischte Auslieferung

21

FAIL

Der Werbebestand hat sich so stark geändert, dass die Vorhersage ungenau ist.

23

FAIL

Frequenzintervallgrenzwert im Zielland nicht unterstützt.

24

FAIL

Anzeigengruppe für die Holdout-Lift-Studie im Konto oder in der Kampagnengruppe nicht in Übereinstimmung mit Reservierungsvorhersage.

25

FAIL

Frequenzgrenzwert darf die Laufzeit der Kampagne nicht überschreiten.

26

FAILURE_EMPTY_AUDIENCE

Ausgewählte Zielgruppe leer und nicht verwendbar.

27

FAIL

An einer laufenden Kampagne sind keine Änderungen möglich.

28

FAIL

An einer laufenden Kampagne, die mit einem Insertionsauftrag erstellt wurde, sind keine Änderungen möglich.

29

FAIL

Laufende Kampagne kann wegen Zeitbeschränkungen nicht geändert werden.

30

FAIL

Wähle ein höheres Budget als die aktuellen Ausgaben aus, um eine laufende Reservierungs-Anzeigengruppe zu bearbeiten.

31

FAIL

Lift-Studie für Konto oder Kampagnengruppe beginnt nach dem Beginn der Kampagne.

32

FAIL

Lift-Studie für Konto oder Kampagnengruppe endet vor dem Ende der Kampagne.

35

FAIL

Startzeit für Reservierungs-Kampagne kann nicht auf einen Zeitpunkt in der Vergangenheit festgelegt werden.

36

FAIL

Vergewissere dich, dass die Dauer der Reservierungs-Anzeigengruppe mehr als einen Tag beträgt und dass die Start- und die Endzeit der Kampagne gültig sind.

37

FAIL

Das Ziel wird von Audience Network mit der Buchungsart „Reservierung“ nicht unterstützt.

39

FAIL

Die ausgewählte Platzierungskombination kann beim Buchen mit Reservierung nicht verwendet werden.

40

FAIL

Bei der Buchungsart „Reservierung“ können bestimmte Versionen mobiler Betriebssysteme nicht als Ziel angesprochen werden.

41

FAIL

Bei der Buchungsart „Reservierung“ können Freunde von Verbindungen nicht als Ziel angesprochen werden.

42

FAIL

Reservierungs-Kampagnen können nicht ausgeführt werden, wenn Audience Network als einzige Platzierung ausgewählt ist. Wähle Facebook Feed oder Instagram Feed als zusätzliche Platzierung aus, wenn du Audience Network als Platzierung verwenden möchtest.

44

FAIL

Reservierung unterstützt Facebook Stories nicht.

45

FAIL

Um Facebook Stories als Platzierung zu verwenden, wähle zusätzlich entweder Facebook Feeds oder Instagram Stories aus.

50

FAIL

Die ausgewählte Platzierungskombination kann beim Buchen mit Reservierung nicht verwendet werden. Stelle bei Verwendung der Buchungsart „Reservierungs-IO“ sicher, dass Videoaufrufe als Ziel festgelegt sind. Wähle andernfalls Facebook Feeds als Platzierung aus, wenn du Facebook In-Stream verwenden möchtest.

53

FAIL

Der Platzierungstyp „In-Stream-Video“ ist nur für Zielgruppen in den USA, im Vereinigten Königreich, in Australien, Neuseeland, Irland, Thailand, Mexiko, Peru, Frankreich, Deutschland, Argentinien, Kolumbien, Spanien, Chile, Ecuador, der Dominikanischen Republik, Guatemala, Bolivien, Honduras, El Salvador, Norwegen, Schweden, den Niederlanden, Belgien, Polen, Portugal, Dänemark, Indien, Malaysia, auf den Philippinen sowie in Indonesien und Vietnam verfügbar. Um fortzufahren, bearbeite deine Zielgruppe so, dass sie nur Personen in diesen Ländern enthält.

60

FAIL

Wenn du Facebook Marketplace verwenden möchtest, wähle Facebook Feeds als Platzierung aus.

66

FAIL

Die Platzierung in der rechten Spalte auf Facebook kann nicht mit anderen Platzierungen kombiniert werden.

69

FAIL

Wenn deine Werbeanzeige im Explore-Abschnitt von Instagram angezeigt werden soll, musst du auch Instagram Feed als Platzierung auswählen.

100+

FATAL

Systemfehler, kein Nutzerfehler. Versuche es erneut.

Vorhersagen nutzen

Gib deine Vorhersage-ID und ihre Daten als Eingabe ein, um eine neue ID zu erstellen, die als Reservierungs-ID dient. Hänge diese Reservierungs-ID anschließend an deine Anzeigengruppe an. Wenn du eine Reservierung erstellst, kann der Bestand nicht von anderen verwendet werden. Du solltest sie also anhängen, bevor sie abläuft.

Wenn die Reservierung erfolgreich ist, reservieren wir den Bestand temporär für dich. Du hast nach der Reservierung ungefähr eine Stunde Zeit, um einer Anzeigengruppe eine Werbeanzeige zuzuweisen.

Wenn die stündliche Beschränkung für Reservierungsanfragen überschritten wird, werden der folgende Fehlercode und die folgende Fehlermeldung angezeigt: 613: Calls to this API have exceeded the rate limit.

Reservieren

Reserviere Vorhersagen für deine Anzeigengruppen, um deinen Preis festzulegen und eine vorhersagbare Reichweite zu erhalten. Reserviere mit reserve für action für einen bestimmten Zeitraum eine Zielgruppe, die durch reachfrequencyprediction identifiziert wird. Du kannst mit einer Vorhersage-ID mehrere Reservierungen erstellen. Beispiel:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
// Response 
{"id":9876543210"}

Um Bestand auf Grundlage einer Prognose zu reservieren, führe eine POST-Anfrage an https://graph.facebook.com/{API_VERSION}/act_{AD_ACCOUNT_ID}/reachfrequencypredictions durch.

Für reach, budget und impression kannst du eine Vorhersage für einen bestimmten Punkt auf curve_budget_reach anstatt dem ursprünglichen Tupel aus vorhergesagter Reichweite und Budget reservieren. Verwende die folgenden Felder:

Name Beschreibung

rf_prediction_id

int

Erforderlich.

reachfrequencyprediction-ID.

action

string

Erforderlich für Reservierung und Stornierung.

Optionen:

  • reserve – Bestand mit vorheriger Vorhersage reservieren.
  • cancel – reservierte Vorhersage stornieren.

rf_prediction_id_to_release

int

Optional.

ID der reservierten Voraussage oder Reservierung. Eine neue Reservierung gibt eine reservierte Zielgruppe frei und verwendet sie für die neue Reservierung. Siehe Wiederverwendung reservierter Zielgruppen.

rf_prediction_id_to_share

int

Optional.

ID einer zuvor erstellten Voraussage. Neue Vorhersagen verwenden die Zielgruppe aus einer bestimmten Vorhersage.


Hinweis:rf_prediction_id_to_share muss auf eine gültige Voraussage-ID festgelegt sein, um entweder das TRAFFIC-Ziel oder die Optimierungen POST_ENGAGEMENT und LINK_CLICKS zu verwenden. Weitere Informationen findest du im Änderungsprotokoll.

reach

int

Optional. Wenn dieser Wert angegeben wird, gib budget und impression an.

Gib reach, budget und impression für diesen Punkt auf curve_budget_reach an. Du kannst diesen Wert überschreiben.

budget

int

Optional. Wenn dieser Wert angegeben wird, gib budget und impression an.

Gib reach, budget und impression für diesen Punkt auf curve_budget_reach an. Du kannst diesen Wert außer Kraft setzen.

impression

int

Optional. Wenn dieser Wert angegeben wird, gib reach und budget an.

Du kannst diesen Wert überschreiben. Gib dazu reach, budget und impression für diesen Punkt auf curve_budget_reach an.

Meta reserviert Voraussagen asynchron. Frage den Status der Voraussage ab und prüfe ihn. Anfänglich ist der Status der Vorhersage 2 (PENDING). Nach dem Abschluss lautet der Status 1, SUCCESS oder 15, FAIL. Letzteres bedeutet, dass wir nicht über den Bestand verfügen, diese Reservierung abzuschließen.

Da unser Reservierungssystem dynamisch ist, kann es zwischen der Vorhersage und der Reservierung zu kleinen Änderungen bei der Bestandsverfügbarkeit kommen. Meta hält sich jedoch an die Werte aus der Vorhersage, sofern die Änderungen nicht zu groß sind.

Zu Anzeigengruppen zuweisen

Nachdem du eine Voraussage erfolgreich reserviert hast, kannst du damit eine Anzeigengruppe erstellen:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Damit eine Voraussage erfolgreich zugewiesen werden kann, muss deine Anzeigengruppe folgende Kriterien erfüllen:

  • Folgende Werte nicht angeben:
  • start_time – aus Vorhersage abgeleitet.
  • end_time – aus Vorhersage abgeleitet.
  • targeting – aus Vorhersage abgeleitet.
  • bid_amount
  • optimization_goal
  • Entweder lifetime_budget oder daily_budget.
  • Du kannst Reservierungen auch Anzeigengruppen ohne aktive Werbeanzeigen zuweisen. Die Anzeigengruppe muss jedoch mindestens eine aktive Werbeanzeige umfassen, bevor sie startet.
  • Du musst rf_prediction_id einschließen, womit die Vorhersage an die neue Anzeigengruppe angehängt wird.
  • Das Werbekampagnenattribut von buying_type lautet RESERVED.

Du kannst Anzeigengruppen auch reachfrequencyprediction anhängen, um die Vorhersage zu ändern. Sende eine POST-Anfrage mit rf_prediction_id für die reachfrequencyprediction, die du verwenden möchtest, an https://graph.facebook.com/{ad_set_id}.

Folgende Einschränkungen gelten für die Anzeigengruppe:

  • Mögliche Publisher-Plattformen: facebook, instagram.
  • Mögliche Platzierungen auf Facebook: feed und rightcolumn.
  • Mögliche Platzierungen auf Instagram: stream, story, explore, explore_home und reels. Wenn die Platzierung instagram enthält, musst du destination_ids anstatt destination_id verwenden. Das Feld destination_ids sollte die Facebook-Seiten-ID als destination_id sowie die Instagram-Konto-ID enthalten.
  • Entweder Custom Audience oder Partner-Kategorien, nicht beides.
  • Custom Audiences durch Webseiten sowie Ausschluss-Targeting von Fans oder Video-Interaktionen sind nicht zulässig.
  • Das promoted_object der Anzeigengruppe muss mit der destination_id der Vorhersage-ID übereinstimmen. Bei Seitenbeiträgen muss es mit der angegebenen Seiten-ID und bei App Ads mit der App-ID übereinstimmen.
  • Herkömmliche und geplante Anzeigenfrequenz werden unterstützt, beschleunigte Auslieferung jedoch nicht.

Wir berechnen die Kosten für Reservierungs-Kampagnen auf Grundlage der tatsächlich ausgelieferten Impressionen. Wenn zum Startzeitpunkt der Kampagne die Anzeigengruppe keine aktiven Werbeanzeigen enthält, wird die Kampagne nicht ausgeliefert und es fallen keine Kosten an. Meta gibt den verbleibenden Bestand frei. Wenn dies jedoch wiederholt vorkommt, können wir das Werbekonto bestrafen.

Wenn du eine Kampagne mit der Meta-Buchungsart „Reservierung“ erstellst, erklärst du dich einverstanden, die vorgeschlagenen Kosten für das von dir reservierte Werbeinventar zu bezahlen. Wenn du die Größe deiner Zielgruppe oder die Anzeigenfrequenz ändern möchtest, ändert sich auch der Preis. Du kannst diese Änderungen jederzeit vor Beginn deiner Kampagne vornehmen. Du kannst den Inhalt der Werbeanzeige bearbeiten, bis deine Kampagne beginnt.

Anzeigen verwalten

Anzeigengruppen für Reservierungen können mehrere Werbeanzeigen enthalten. Du kannst jederzeit weitere Werbeanzeigen hinzufügen. Wenn die Anzeigengruppe aktiviert wird und keine aktiven Werbeanzeigen enthält, musst du deine erste Werbeanzeige bei Anzeigengruppen mit einer Dauer von 3 bis 30 Tagen innerhalb von 24 Stunden oder bei einer Dauer von 1 bis 2 Tagen innerhalb von 6 Stunden erstellen. Andernfalls löschen wir die Reservierung.

Voraussagen trennen, Anzeigengruppen ändern

Du kannst vor Beginn deiner Kampagne Änderungen daran vornehmen oder deine Reservierung pausieren. Sobald die Kampagne aktiv ist, kannst du nur deine Anzeigengestaltung und dein Budget bearbeiten oder das Enddatum aufschieben. Falls du nur die Gestaltung einer Werbeanzeige bearbeitest, ändert sich deine Vorhersage nicht.

Änderst du jedoch dein Budget oder das Enddatum, wird möglicherweise eine neue Voraussage für deine Kampagne erstellt, die du dann in den Schätzungen zu deiner Reservierung einsehen kannst.

Du kannst deine reservierte Kampagne nach Beginn zwar nicht mehr pausieren, aber du kannst sie jederzeit löschen, um sie abzubrechen.

Informationen dazu, wie du eine Gruppe nach dem Start anhalten oder bearbeiten kannst, findest du unter Anzeigengruppen pausieren und wieder starten und Laufende Anzeigengruppen bearbeiten. Siehe zum Löschen einer aktiven Anzeigengruppe Anzeigengruppe, Referenz. Alle ausgelieferten Impressionen werden dir in Rechnung gestellt.

Um potenzielle Ausfälle zu vermeiden, raten wir dir sehr davon ab, alle Anzeigen zu löschen, während eine Reservierungs-Anzeigegruppe live geschaltet ist.

Wenn du eine Reservierung einer Anzeigengruppe zuweist, bevor diese aktiv wird, kannst du die meisten Attribute nur ändern, wenn du die Reservierung trennst. Sende eine HTTP POST-Anfrage an die Anzeigengruppe und lege rf_prediction_id auf 0 fest. Du kannst für das Anzeigengruppenobjekt nur das name-Attribut bearbeiten.

So trennst du eine Reservierung:

curl \
-F "rf_prediction_id=0" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"

Sobald eine Anzeigengruppe aktiv ist, kannst du die Reservierung nicht mehr trennen und die Attribute der Anzeigengruppe nicht mehr bearbeiten. Einige Werbeanzeigen-Attribute auf der Positivliste sind hiervon ausgenommen:

  • name
  • creative_id
  • creative_spec
  • conversion_specs
  • tracking_specs
  • view_tags

Anzeigengruppen pausieren und wieder starten

Du kannst eine aktive Anzeigengruppe pausieren. Siehe dazu Anzeigengruppe, Referenz. Wenn du eine Anzeigengruppe länger als 30 Minuten pausierst, können wir die Vorhersage für diese Anzeigengruppe nicht mehr garantieren.

Um eine Anzeigengruppe erneut zu aktivieren, die länger als 30 Minuten pausiert wurde, benötigst du eine neue Vorhersage. Führe einen POST an reachfrequencypredictions durch. Siehe Eine Vorhersage erstellen und Die Vorhersage reservieren. Gib in der Anfrage eine existing_campaign_id weiter, damit die aktive Anzeigengruppe erneut aktiviert wird. Nachdem du eine neue Vorhersage erstellt und reserviert hast, füge reachfrequencyprediction an die Anzeigengruppe an. Sende dazu eine HTTP POST-Anfrage an https://graph.facebook.com/{ad_set_id} und gib rf_prediction_id für die Vorhersage an, die du verwenden möchtest.

Laufende Anzeigengruppen bearbeiten

Du kannst nach dem Start einer Anzeigengruppe folgende Änderungen vornehmen.

  • Das Budget und die Reichweite der Anzeigengruppe erhöhen oder verringern. Das Budget bzw. die Reichweite müssen die bisherigen Ausgaben bzw. die bereits ausgelieferte Reichweite überschreiten.
  • Den Zeitplan der Anzeigengruppe auf 90 Tage verlängern.

Du kannst eine aktive Anzeigengruppe nicht bearbeiten oder pausieren, wenn sie eine der folgenden Kriterien erfüllt:

  • Äußerst geringe Auslieferung. Weniger als 10 % der Vorhersage ausgeliefert. Ausgaben überschreiten das Budget.
  • Die Anzeigengruppe läuft nur für einen Tag.
  • Die Anzeigengruppe wird innerhalb der nächsten 24 Stunden beendet.

Um eine laufende Anzeigengruppe zu bearbeiten, benötigst du eine neue Vorhersage. Siehe Eine Vorhersage erstellen und Die Vorhersage reservieren. Gib in der Anfrage eine existing_campaign_id weiter, damit die aktive Anzeigengruppe erneut aktiviert wird.

Nachdem du eine neue Vorhersage erstellt und reserviert hast, kannst du reachfrequencyprediction an die Anzeigengruppe anhängen. Sende dazu eine HTTP POST-Anfrage an https://graph.facebook.com/{ad_set_id} und gib rf_prediction_id als die ID für die Vorhersage an, die du verwenden möchtest.

Reservierte Zielgruppen erneut verwenden

Wenn du eine Reservierung stornierst, wird der reservierte Bestand für andere Werbetreibende freigegeben. Du kannst eine Zielgruppe aus einer zuvor reservierten Vorhersage erneut verwenden, wenn du sie nicht bereits verwendest. So können wir bei der Vorhersage weiteren Bestand berücksichtigen, ohne dass du eine bestehende Reservierung stornieren musst.

Füge rf_prediction_id_to_share hinzu, wenn du eine Reservierung erstellst. Dabei handelt es sich um die ID einer älteren Vorhersage. Damit wird die vorherige Reservierung ungültig gemacht, sodass du den Bestand für die neu erstellte Reservierung verwenden kannst.

Um die neue Vorhersage zu reservieren, musst du außerdem die ID der alten Vorhersage im zusätzlichen Parameter rf_prediction_id_to_release weitergeben.

Anzeigenrotation und Sequenzierung

Du kannst die Werbeanzeigen in der Anzeigengruppe, die du verwendest, drehen. Dazu musst du die Reservierung nicht aus der Anzeigengruppe entfernen. Füge der Anzeigengruppe Werbeanzeigen hinzu und warte, bis sie aktiv wird. Anschließend kannst du den Status der anfänglichen Werbeanzeige auf „pausiert“ setzen. Die Anzeigengruppe muss mindestens eine aktive Werbeanzeige umfassen.

Du kannst eine Sequenz aus Anzeigen erstellen, die in der ausgewählten Reihenfolge ausgeliefert werden. Erstelle zunächst die Anzeigengruppe und die Werbeanzeigen. Gib dann die Sequenz auf Anzeigengruppenebene in creative_sequence an. Jede Werbeanzeige in dieser Anzeigengruppe kann in der Sequenz einmal, mehrmals oder überhaupt nicht vorkommen.

Wenn die Array-Länge von creative_sequence Null beträgt, verwendest du keine Sequenzierung. Wenn die Länge nicht Null beträgt, empfehlen wir dir, sie auf den gleichen Wert wie frequency_cap in rf_prediction_id zu setzen. Wenn die Länge größer als frequency_cap ist, entfernen wir die letzten Anzeigen aus dem Array. Wenn die Länge geringer als frequency_cap ist, füllen wir das Array automatisch auf, indem wir die Sequenz vom Anfang wiederholen. Um klare Ergebnisse zu erhalten, solltest du die Länge von creative_sequence auf denselben Wert wie frequency_cap setzen.

Jede Anzeige in der Sequenz hat den Status ACTIVE, PENDING_REVIEW oder CREDIT_CARD_NEEDED. Eine Anzeige in der Sequenz wird erst ausgeliefert, nachdem alle Anzeigen davor ausgeliefert wurden. Werbeanzeigen, die nicht in der creative_sequence vorkommen, werden nicht ausgeliefert.

Werbeanzeigen in einer Anzeigengruppe, die Sequenzierung verwendet, können nicht pausiert, archiviert oder gelöscht werden – egal, ob sie in der Sequenz vorkommen oder nicht.

Diese Funktion ist nur für Reservierungs-Anzeigengruppen verfügbar, d. h. der buying_type der übergeordneten Kampagne ist RESERVED und für die Anzeigengruppe ist rf_prediction_id festgelegt.

Weitere Details findest du im Dokument zu Anzeigengruppen.

Instagram-Reservierung

Für eine voraussagbare Reichweite auf Instagram, kannst du eine Reservierungs-Kampagne erstellen und dabei buying_type auf RESERVED festlegen.

Reservierungen können dir beim Planen und Buchen von Bekanntheits- und Interaktionskampagnen, Optimieren der Reichweite und bei der Steigerung der Werbeerinnerung und beim ThruPlay helfen.

Reichweiten-Schätzungen im Werbeanzeigenmanager und der API können Partnern Orientierung bezüglich realistisch zu erwartenden Werten bieten. Die Instagram-Community steht an erster Stelle und wir versuchen, zunächst realistische Reichweiteziele zu erreichen und diese mit der Zeit zu erhöhen. Alle Richtlinien zu Schätzwerten für Reservierungen auf Facebook gelten auch für Instagram.

Fehlercodes

Code Beschreibung

1487583

Du kannst einer Anzeigengruppe ohne Werbeanzeigen keine Reservierungs-Vorhersage zuweisen.

1487055

Ungültiger Status der Anzeigengruppe.

1487600

Der Anzeigengruppe ist bereits eine Reservierung zugewiesen. Wenn du eine andere Vorhersage verwenden möchtest, entferne zunächst die aktuelle Vorhersage aus der Anzeigengruppe, indem du einen Nullwert zuweist, und weise anschließend die neue Vorhersage zu.

1487578

Die angegebene reachandfrequencyprediction-ID existiert nicht oder gehört nicht zum Konto.

1487581

Die Reservierungs-Vorhersage einer aktiven Anzeigengruppe kann nicht bearbeitet werden.

1487594

Keine Anzeigen in der Reservierungs-Anzeigengruppe

1487595

Ungültige Zielgruppe in der Reservierungs-Anzeigengruppe

1487614

Startzeitpunkt der Anzeigengruppe stimmt nicht mit der Vorhersage überein

1487615

Endzeitpunkt der Anzeigengruppe stimmt nicht mit der ursprünglichen Voraussage überein.

1487616

Anzeigengruppe kann nicht mit ungültiger Voraussage verknüpft werden.

1487671

Ein direkter Wechsel der Anzeigengruppe von einer Vorhersage auf eine andere ist nicht zulässig.

1487244

Update der Anzeigengruppe fehlgeschlagen – Grund sollte in Antwort angegeben sein.

1487672

Vorhersage konnte der Anzeigengruppe nicht zugewiesen werden.

1487680

Du hast keine Berechtigung, Reservierungs-Anzeigengruppen zu verwenden.

Beispiele

Erstellen einer reachfrequencyprediction für eine App-destination_id:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<APP_ID>' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Erstellen einer reachfrequencyprediction für eine Seiten-destination_id:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook"], "facebook_positions":["feed"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_id=<PAGE_ID>' \
-F 'prediction_mode=1' \
-F "objective=POST_ENGAGEMENT" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Erstellen einer reachfrequencyprediction für eine App-destination_id mit Instagram-Platzierung:

curl \
-F 'target_spec={"geo_locations": {"countries":["US"]}, "age_max":35, "age_min":26, "genders":[2], "publisher_platforms":["facebook","instagram"], "device_platforms":["mobile"]}' \
-F 'start_time=1388534400' \
-F 'end_time=1389312000' \
-F 'frequency_cap=4' \
-F 'reach=1000000' \
-F 'budget=3000000' \
-F 'destination_ids=[<APP_ID>,<INSTAGRAM_ACCOUNT_ID>]' \
-F 'prediction_mode=1' \
-F "objective=MOBILE_APP_INSTALLS" \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'

{"id":"67890123456"}

Frage den folgenden Endpunkt durch HTTP-GET-Anfragen zum Abruf des Status ab, bis er nicht mehr 2 lautet:

https://graph.facebook.com/67890123456?fields=status

Wenn der Status 1 (erfolgreich) ist, kann die Voraussage an eine Anzeigengruppe angehängt oder reserviert werden.

Reservierung einer Voraussage:

curl \
-F 'action=reserve' \
-F 'rf_prediction_id=<RF_PREDICTION_ID>' \
-F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/reachfrequencypredictions'
 
{"id":"9876543210"}

Frage den folgenden Endpunkt durch HTTP-GET-Anfragen zum Abruf des Status ab, bis er nicht mehr 2 lautet:

https://graph.facebook.com/<API_VERSION>/<PREDICTION_ID>?fields=status

Wenn der Status 1 (erfolgreich) ist, kann die Voraussage an eine Anzeigengruppe angehängt werden. Richten wir nun deine Kampagnenstruktur ein. Dazu erstellen wir eine Kampagne, eine Anzeigengruppe, den Inhalt der Werbeanzeige und die Werbeanzeige und weisen die Reservierung der Anzeigengruppe zu.

Erstelle eine Werbekampagne:

curl \
-F "name=Test" \
-F "buying_type=RESERVED" \
-F "status=ACTIVE" \
-F "objective=POST_ENGAGEMENT" \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/campaigns

{"id":"1122334455"}

Erstelle eine Anzeigengruppe:

curl  \
-F "name=TestReachSet" \
-F "status=1" \
-F "campaign_id=<CAMPAIGN_ID>" \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adsets"

{"id":"09876543"}

Gestalte die Anzeige:

curl \
-F "name=sample creative" \
-F "type=1" \
-F "title=hello world" \
-F "body=hi i'm an ad" \
-F "link_url="https://www.facebook.com/" \
-F "image_hash=4aca812b4eadb72818a2c4124abd121a" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/adcreatives"

{"id":"1323123123123"}

Erstelle eine Werbeanzeige:

// Create an ad
curl \
-F "name=my ad" \
-F "adset_id=<AD_SET_ID>" \
-F "creative={'creative_id':<CREATIVE_ID>}" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/act_<AD_ACCOUNT_ID>/ads"

{"id":"3213213123"}

Weise der der Anzeigengruppe eine neue Voraussage zu:

curl \
-F "rf_prediction_id=<RF_PREDICTION_ID>" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<AD_SET_ID>"