Zum Hauptinhalt springen
POST
Bewerben Sie einen bestehenden Facebook-Beitrag, um eine Anzeige zu erstellen. Dieser Endpunkt ermöglicht es Ihnen, Ihre organischen Beiträge mit benutzerdefinierten Targeting-, Budget- und Zeitplanparametern in bezahlte Anzeigen umzuwandeln.
  • Budget- und Gebotsbeträge müssen in USD mit bis zu zwei Dezimalstellen angegeben werden.
  • Die Anzeige muss mindestens 30 Stunden laufen, um die Facebook-Anforderung zu erfüllen.
  • Sie können den Interessen-Endpunkt verwenden, um Interessen-IDs für das Targeting zu finden.
  • Facebook kann bis zu 24 Stunden benötigen, um beworbene Beiträge zu prüfen und freizugeben.
  • Wenn Sie fbPostId direkt verwenden (anstelle der Ayrshare-postId), stellen Sie sicher, dass es sich um eine gültige Facebook-Post-ID handelt.

Anzeigenziele

Jede Anzeige muss ein Ziel haben. Das Ziel bestimmt, wie die Anzeige für die Anzeige optimiert wird.
  • engagement: Dieses Ziel zielt darauf ab, die Interaktion zu steigern und gleichzeitig sicherzustellen, dass die Anzeige die maximale Anzahl eindeutiger Nutzer erreicht. Es schafft ein Gleichgewicht zwischen Sichtbarkeit und Interaktion, indem die Anzeige möglichst vielen unterschiedlichen Personen gezeigt wird, die mit ihr interagieren könnten.
  • interactions: Darauf ausgelegt, Interaktionen wie Likes, Kommentare und Shares mit der Anzeige zu steigern. Facebook priorisiert die Anzeige gegenüber Nutzern, die am ehesten mit ihr interagieren.
  • awareness_views: Konzentriert sich auf die Steigerung der Markenbekanntheit, indem die Anzahl der Anzeigen-Einblendungen maximiert wird. Es priorisiert, die Anzeige innerhalb des Budgets so oft wie möglich zu zeigen, unabhängig von der eindeutigen Reichweite.
  • awareness_audience: Zielt darauf ab, die Markenbekanntheit zu steigern, indem die Anzahl der eindeutigen Personen maximiert wird, die die Anzeige sehen. Es stellt sicher, dass die Anzeige möglichst viele verschiedene Nutzer erreicht und die eindeutige Zielgruppengröße maximiert, anstatt sie mehrfach derselben Zielgruppe zu zeigen.
Erfahren Sie mehr über die Integration der Facebook Marketing API mit Ayrshare in unserem Facebook Marketing API-Integrationsleitfaden.

Header-Parameter

Body-Parameter

accountId
string
erforderlich
Die ID des Facebook-Werbekontos, auf dem der Beitrag beworben werden soll. Die Konto-ID kann über den Werbekonten-Endpunkt abgerufen werden.
adName
string
erforderlich
Name für Ihre Anzeige (wird im Facebook Ad Manager angezeigt) im Format {adName} - {postId oder fbPostId} - {aktuelles Datum}.
bidAmount
number
erforderlich
Maximaler Gebotsbetrag in USD. Der Mindestgebotsbetrag beträgt 1,00 $.
budget
number
erforderlich
Tagesbudget in USD. Das Mindestbudget beträgt 1,00 $.
fbPostId
string
erforderlich
Die Facebook-Social-Post-ID des zu bewerbenden Beitrags, die es Ihnen ermöglicht, eine Anzeige aus einem direkt auf Facebook erstellten Beitrag zu erstellen. Dies ist die ID des Beitrags auf Facebook, nicht von Ayrshare. Erforderlich, wenn postId nicht gesetzt ist.
goal
string
Standard:"engagement"
erforderlich
Das Ziel der Anzeige. Werte: engagement, interactions, awareness_views und awareness_audience. Weitere Informationen finden Sie oben in den Anzeigenziel-Details.
locations
object
erforderlich
Zielorte der Anzeige mit einem Objekt aus Arrays: countries, regions, cities.
postId
string
erforderlich
Die Ayrshare-Post-ID des zu bewerbenden Beitrags. Erforderlich, wenn fbPostId nicht gesetzt ist.
status
string
Standard:"active"
erforderlich
Der Status der Anzeige. Werte: active und paused.Sie können den Status der Anzeige später über den Anzeige aktualisieren-Endpunkt ändern.
adSetBudgetSharingEnabled
boolean
Standard:false
Steuert die Budget-Freigabe von Meta auf Kampagnenebene für Anzeigengruppen. Meta verlangt dieses Wire-Feld jetzt in jeder Kampagne, die ohne Budget auf Kampagnenebene erstellt wird, weshalb Ayrshare es immer sendet – standardmäßig auf false gesetzt, um die Abwärtskompatibilität zu wahren.Setzen Sie es auf true, damit Meta bis zu ~20 % des Budgets einer Anzeigengruppe an andere Anzeigengruppen derselben Kampagne verteilen kann, um die Gesamtperformance zu optimieren. Details finden Sie in der Referenz zu Anzeigenkampagnen-Gruppen von Meta.
tracking
object
Verfolgen Sie die Anzeige mit einem Facebook-Pixel.
urlTags
array
Fügen Sie UTM-Tags zur Anzeigen-URL hinzu.
Zum Beispiel, wenn die Link-URL https://www.mysite.com/my-post lautet und die hinzugefügten URL-Tags:utm_source=ayrshare, utm_medium=social und utm_campaign=ayrshare-social sind.Die Anzeigen-URL lautet dann: https://www.mysite.com/my-post?utm_source=ayrshare&utm_medium=social&utm_campaign=ayrshare-social.
specialAdCategories
array
Meta verlangt von Werbetreibenden in speziellen Anzeigenkategorien, dass sie ihre Kampagnenkategorie selbst deklarieren.Wenn Ihr Unternehmen in eine dieser Kategorien fällt, müssen Sie beim Bewerben Ihres Beitrags die entsprechende Kategorie auswählen.Die folgenden Werte werden unterstützt:
  • housing: Anzeigen, die für eine Wohnmöglichkeit oder einen damit verbundenen Service werben oder direkt darauf verlinken, einschließlich, aber nicht beschränkt auf Inserate zum Verkauf oder zur Vermietung einer Wohnung oder eines Hauses, Wohngebäudeversicherungen, Hypothekenversicherungen, Hypothekendarlehen, Wohnungsreparaturen sowie Home-Equity- oder Wertermittlungsdienste.
  • financial_product_services: Anzeigen, die für Finanzprodukte und -dienstleistungen werben oder direkt darauf verlinken, einschließlich Krediten.
  • employment: Anzeigen, die für eine Beschäftigungsmöglichkeit werben oder direkt darauf verlinken, einschließlich, aber nicht beschränkt auf Teil- oder Vollzeitjobs, Praktika oder berufliche Zertifizierungsprogramme. Verwandte Anzeigen, die in diese Kategorie fallen, umfassen Werbung für Jobbörsen oder Jobmessen, Aggregations- dienste oder Anzeigen, die Vorteile eines Unternehmens beschreiben, unabhängig von einem konkreten Stellenangebot.
  • issues_elections_politics: Anzeigen, die von, im Namen von oder über einen Kandidaten für ein öffentliches Amt, eine politische Persönlichkeit, eine politische Partei geschaltet werden oder für ein bestimmtes Wahlergebnis werben. Dazu gehören auch Anzeigen über Wahlen, Referenden oder Volksabstimmungen, einschließlich Kampagnen wie „Geh wählen“. Anzeigen, die als politische Werbung oder als Werbung zu gesellschaftlichen Themen an dem Ort reguliert sind, an dem die Anzeige geschaltet wird. Wenn Sie Themen, Wahlen oder Politik auswählen, müssen Sie das Land angeben, in dem Sie diese Anzeigen schalten möchten. Sie müssen berechtigt sein, Anzeigen zu gesellschaftlichen Themen, Wahlen oder Politik im angegebenen Land zu schalten.
Meta verlangt, dass Werbetreibende ihre Kampagnenkategorie selbst deklarieren. Meta setzt menschliche Prüfer und maschinelles Lernen ein, um solche Anzeigen zu identifizieren. Wenn Sie uns eine falsche specialAdCategory senden, besteht das Risiko, dass Ihre Anzeigen pausiert werden, bis die Kampagne angepasst ist.
endDate
string
Enddatum und -uhrzeit im ISO-8601-Format (muss mindestens 30 Stunden nach dem Start liegen), zum Beispiel 2025-03-01T00:00:00Z.Wenn nicht gesetzt, läuft die Anzeige unbegrenzt und hat ein Enddatum von ongoing.
excludedLocations
object
Schließen Sie Standorte mit einem Objekt aus, das Arrays von countries, regions und cities enthält.
gender
string
Standard:"all"
Das Geschlecht der Zielgruppe. Werte: all, male, female.
interests
array
Die Ziel-Interessen der Anzeige als Array von Facebook-Interessen-IDs.
maxAge
number
Standard:65
Maximales Alter für das Targeting der Anzeige (Standard: 65).
minAge
number
Standard:18
Mindestalter für das Targeting der Anzeige (Standard: 18).
startDate
string
Startdatum und -uhrzeit im ISO-8601-Format, zum Beispiel 2025-03-01T00:00:00Z.Wenn nicht gesetzt, startet die Anzeige sofort.
dsaBeneficiary
string
Der Begünstigte der Anzeige für die Einhaltung des Digital Services Act (DSA) in EU-Ländern. Muss zusammen mit dsaPayor gesetzt werden, wenn einer der beiden angegeben wird. Weitere Informationen finden Sie in unserem DSA-Leitfaden.
dsaPayor
string
Der Zahler der Anzeige für die Einhaltung des Digital Services Act (DSA) in EU-Ländern. Muss zusammen mit dsaBeneficiary gesetzt werden, wenn einer der beiden angegeben wird.