Zum Hauptinhalt springen
POST
Bewerben Sie einen bestehenden Instagram-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 gelten in der Währung des Werbekontos. Verwenden Sie bis zu zwei Dezimalstellen oder ganze Zahlen für die Währungen, die Meta nur in ganzen Einheiten annimmt: CLP, COP, CRC, HUF, IDR, ISK, JPY, KRW, PYG, TWD und VND.
  • Die Anzeige muss mindestens 30 Stunden laufen, um die Instagram-Anforderung zu erfüllen.
  • Sie können den Interessen-Endpunkt verwenden, um Interessen-IDs für das Targeting zu finden.
  • Instagram kann bis zu 24 Stunden benötigen, um beworbene Beiträge zu prüfen und freizugeben.
  • Wenn Sie socialPostId direkt verwenden (anstelle der Ayrshare-postId), stellen Sie sicher, dass es sich um eine gültige Instagram-Post-ID handelt.
  • Wenn ein Boost fehlschlägt, nachdem Facebook die zugehörige Kampagne erstellt hat (beim Creative-, Anzeigengruppen- oder Anzeigenschritt), versuchen wir, diese Kampagne zu löschen. Schlägt auch das Löschen fehl, bleibt die leere Kampagne in Ihrem Werbekonto. Sie können sie im Ads Manager finden und löschen.
Meta lehnt die Anzeige ab, bis beides erfüllt ist:
  • Eine Zahlungsmethode im Werbekonto. Fügen Sie in Metas Abrechnung & Zahlungen eine hinzu und verknüpfen Sie sie mit dem Werbekonto, das Sie als accountId senden. Eine Zahlungsmethode, die nur im Business-Portfolio gespeichert ist, reicht nicht aus.
  • Personalisierte Werbung ist aktiviert (EU, EWR und Schweiz). Hat der Inhaber des mit Ihrer Facebook-Seite verknüpften Facebook- oder Instagram-Kontos weniger personalisierte Werbung gewählt oder Meta ohne Werbung abonniert, lässt Meta dieses Konto und die Seite keine Anzeigen schalten. Der Inhaber kann unter Kontenübersicht → Werbepräferenzen → Werbeerlebnis wieder personalisierte Werbung wählen oder das Abo kündigen. Mehr erfahren.

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. Instagram 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.
Instagram-Anzeigen erfordern ein Instagram-Business-Konto, das über Facebook verbunden ist, eine zugehörige Facebook-Seite und die Berechtigung ads_management. Verknüpfen Sie das Konto erneut über Facebook, um diese Berechtigung zu erteilen. Konten, die mit Instagram Login verbunden sind, können diese Ads-Endpunkte nicht verwenden. Die Medien-ID und die Instagram-Konto-ID werden aus Ihrem verknüpften Konto ermittelt; senden Sie kein instagram_user_id.
Der socialPostId-Selektor akzeptiert auch den Instagram-spezifischen Alias igPostId. fbPostId gilt nur für Facebook. Erfolgreiche Antworten enthalten platform: "instagram", socialPostId und igPostId.

Header-Parameter

Body-Parameter

string
Ein eindeutiger, nicht leerer Schlüssel für diese Boost-Anfrage. Wiederholen Sie dieselbe Payload mit demselben Schlüssel, um das Erstellen einer doppelten Anzeige zu vermeiden. Die Wiederverwendung des Schlüssels mit einer anderen Payload oder für einen Facebook-Boost gibt HTTP 409 zurück. Auf jeder anderen Plattform startet derselbe Schlüssel einen separaten Boost. Eine noch laufende Anfrage gibt ebenfalls 409 zurück; eine nicht verfügbare Reservierung gibt 503 zurück, ohne eine Anzeige zu erstellen.
boolean
Standard:false
Erlauben Sie Meta, das Budget zwischen Anzeigengruppen der Kampagne aufzuteilen.
string
erforderlich
Die ID des Instagram-Werbekontos, auf dem der Beitrag beworben werden soll. Die Konto-ID kann über den Werbekonten-Endpunkt abgerufen werden.
string
erforderlich
Name für Ihre Anzeige (wird im Instagram Ad Manager angezeigt) im Format {adName} - {postId oder socialPostId} - {aktuelles Datum}. Wenn Sie einen idempotencyKey senden, endet der Name zusätzlich mit - {Anfragereferenz}, einer kurzen Referenz, die für diesen Schlüssel gleich bleibt.
number
erforderlich
Maximaler Gebotsbetrag in der Währung des Werbekontos, als positiver Betrag.
number
erforderlich
Tagesbudget in der Währung des Werbekontos, als positiver Betrag. Meta kann Mindestbeträge für Ihr Konto und Ziel durchsetzen.
string
Die Instagram-Social-Post-ID des zu bewerbenden Beitrags, die es Ihnen ermöglicht, eine Anzeige aus einem direkt auf Instagram erstellten Beitrag zu erstellen. Dies ist die ID des Beitrags auf Instagram, nicht von Ayrshare. Erforderlich, wenn postId nicht gesetzt ist.
string
Standard:"engagement"
Das Ziel der Anzeige. Werte: engagement, interactions, awareness_views und awareness_audience. Weitere Informationen finden Sie oben in den Anzeigenziel-Details.
object
Zielländer mit {"countries": ["US", "CA"]} unter Verwendung von Ländercodes. Sie können auch regions- und cities-Arrays angeben; siehe Regionen und Städte. Ein Objekt, das weder ein Land noch eine Region oder Stadt angibt, etwa {}, wird mit dem Code 101 abgelehnt; lassen Sie locations weg, um die USA anzusprechen.
string
Die Ayrshare-Post-ID des zu bewerbenden Beitrags. Erforderlich, wenn socialPostId nicht gesetzt ist.
string
Standard:"active"
Der Status der Anzeige. Werte: active und paused.Sie können den Status der Anzeige später über den Anzeige aktualisieren-Endpunkt ändern.
object
Verfolgen Sie die Anzeige mit einem Meta-Pixel.
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.
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 benötigt außerdem die Länder, in denen eine Anzeige einer speziellen Kategorie ausgeliefert wird. Ayrshare übernimmt sie aus locations: die von Ihnen angegebenen Länder sowie das Land jeder Region und jeder Stadt. Ein housing-Boost, der auf eine Stadt in Großbritannien abzielt, wird also für Großbritannien eingerichtet, ohne zusätzliche Angaben in Ihrer Anfrage. Ohne locations wird die Anzeige in den USA ausgeliefert, und die Kampagne wird für die USA eingerichtet.Meta legt für diese Kategorien außerdem einen Mindestradius um jede Stadt fest. Eine britische Stadt mit einem Radius von 17 Kilometern wurde mit #2909039 abgelehnt, was mindestens 25 Kilometer (15 Meilen) verlangt. Verwenden Sie daher 25 Kilometer oder mehr.
Meta verlangt, dass Werbetreibende ihre Kampagnenkategorie korrekt angeben. Meta setzt menschliche Prüfer und maschinelles Lernen ein, um solche Anzeigen zu identifizieren. Wenn Sie uns eine falsche specialAdCategories senden, besteht das Risiko, dass Ihre Anzeigen pausiert werden, bis die Kampagne angepasst ist.
string
Die Person oder Organisation, die von der Anzeige profitiert. Muss zusammen mit dsaPayor gesetzt werden. Verwenden Sie den DSA-Empfehlungen-Endpunkt für Vorschläge.
string
Die Person oder Organisation, die für die Anzeige bezahlt. Muss zusammen mit dsaBeneficiary gesetzt werden.
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.
object
Schließen Sie Standorte mit derselben countries-, regions- und cities-Struktur wie bei locations aus.
string
Standard:"all"
Das Geschlecht der Zielgruppe. Werte: all, male, female.
array
Die Ziel-Interessen der Anzeige als Array von Instagram-Interessen-IDs.
number
Standard:65
Maximales Alter für das Targeting der Anzeige (Standard: 65).
number
Standard:18
Mindestalter für das Targeting der Anzeige (Standard: 18).
string
Startdatum und -uhrzeit im ISO-8601-Format, zum Beispiel 2025-03-01T00:00:00Z.Wenn nicht gesetzt, startet die Anzeige sofort.
Ersetzen Sie die Beispiel-IDs durch Ihre eigenen. Setzen Sie startDate und endDate auf Ihren geplanten Zeitplan; die Beispieldaten dienen nur zur Veranschaulichung.

Laufzeitbudgets

Der obige Body legt ein Tagesbudget für die Anzeigengruppe fest. Für ein Laufzeitbudget senden Sie stattdessen die verschachtelte Form des Boost-Bodys. In der verschachtelten Form bleiben accountId, postId (oder socialPostId anstelle von igPostId), goal, status und callToAction auf der obersten Ebene. Drei Objekte ersetzen die flachen Budget-, Datums- und Targeting-Felder: budget, schedule (start, end) und targeting (locations, excludedLocations, ageMin, ageMax, genders, interests). Die übrigen Felder, adName, bidAmount, specialAdCategories, adSetBudgetSharingEnabled, link, tracking, urlTags, dsaBeneficiary und dsaPayor, wandern unter platformOptions.instagram.
  • budget.type: daily (Standard) oder lifetime. Ein Laufzeitbudget wird zwischen Start- und Enddatum ausgegeben und erfordert daher schedule.end. Ohne dieses Feld wird die Anfrage mit einem 400 und code: 101 abgelehnt. Die Budgetteilung von Anzeigengruppen bei Meta funktioniert nur mit Tagesbudgets, daher wird ein Laufzeitbudget mit adSetBudgetSharingEnabled: true ebenfalls mit code: 101 abgelehnt.
Die Antwort enthält bei einem Laufzeitbudget zusätzlich budgetType: "lifetime". Ein Tagesbudget gibt kein budgetType zurück, behandeln Sie ein fehlendes Feld also als daily.

Kampagnenbudgets

Um das Budget auf der Kampagne statt auf der Anzeigengruppe zu halten, senden Sie budget.level: "campaign" in der oben gezeigten verschachtelten Form. Die Anzeigengruppe hat dann kein eigenes Budget. Das funktioniert mit Tages- und Laufzeitbudgets.
  • budget.level: adSet (Standard) oder campaign. Ein Kampagnenbudget kann nicht mit adSetBudgetSharingEnabled kombiniert werden. Wenn Sie beides senden, wird die Anfrage mit einem 400 und code: 101 abgelehnt.
  • Die Antwort enthält bei einem Kampagnenbudget zusätzlich budgetLevel: "campaign". Ein Anzeigengruppenbudget gibt kein budgetLevel zurück, behandeln Sie ein fehlendes Feld also als adSet.
  • Im Verlauf zeigt budgetDaily bei einer Anzeige mit Tages-Kampagnenbudget das Tagesbudget der Kampagne. Wenn sich mehrere Anzeigen ein Kampagnenbudget teilen, zeigt jede das gesamte Kampagnenbudget, nicht ihren Anteil. Der Verlauf zeigt keine Laufzeitbudgets an, weder auf der Kampagne noch auf der Anzeigengruppe. Sobald ein Laufzeit-Kampagnenbudget ausgegeben ist, zeigt jede Anzeige in dieser Kampagne nach der nächsten nächtlichen Aktualisierung deliveryStatus: "COMPLETED", auch eine Anzeige, die geplant ist oder sich in Prüfung befindet. Eine abgelehnte Anzeige bleibt REJECTED.

Zu einer bestehenden Kampagne oder Anzeigengruppe hinzufügen

Standardmäßig erstellt jeder Boost seine eigene Kampagne, Anzeigengruppe und Anzeige. Um den Boost zu einer Kampagne oder Anzeigengruppe hinzuzufügen, die Sie bereits in Meta betreiben, senden Sie die verschachtelte Form mit attachTo.
  • attachTo.campaignId: Der Boost erstellt eine neue Anzeigengruppe und Anzeige innerhalb dieser Kampagne. Senden Sie budget, targeting und bidAmount wie gewohnt: Sie gelten für die neue Anzeigengruppe.
  • attachTo.adSetId: Der Boost erstellt nur die Anzeige, innerhalb dieser Anzeigengruppe. Senden Sie außerdem attachTo.campaignId, die Kampagne, zu der die Anzeigengruppe gehört. Lassen Sie budget, targeting und platformOptions.instagram.bidAmount weg: Die Anzeigengruppe behält ihre eigenen Werte. Wenn Sie einen davon senden, wird ein 400 mit code: 101 zurückgegeben.
  • Die Kampagne oder Anzeigengruppe muss sich in dem durch accountId angegebenen Werbekonto befinden und darf nicht zu den Boosts eines anderen Benutzers gehören. Andernfalls gibt die Anfrage einen 400 zurück. Ein Instagram-Boost kann sich außerdem nicht an eine Kampagne anhängen, die ein Facebook-Boost erstellt hat, und umgekehrt.
  • attachTo kann nicht mit budget.level: "campaign", specialAdCategories oder adSetBudgetSharingEnabled kombiniert werden, da diese für eine neue Kampagne gesetzt werden. Wenn Sie sie senden, wird code: 101 zurückgegeben.
  • Das Pausieren oder Aktivieren des Boosts ändert nur, was der Boost erstellt hat: die Anzeige und die Anzeigengruppe, wenn der Boost sie erstellt hat. Die Kampagne oder Anzeigengruppe, die Sie in attachTo angegeben haben, behält ihren eigenen Status. Die Anzeige läuft nur, solange die übergeordnete Kampagne und Anzeigengruppe aktiv sind. Das gilt auch, wenn Ayrshare Ihre Anzeigen pausiert, zum Beispiel wenn ein Profil gelöscht wird.
  • Wenn der Boost fehlschlägt, wird die in attachTo angegebene Kampagne oder Anzeigengruppe nie gelöscht.
  • Wenn die Anzeigengruppe, an die Sie anhängen, in einer Kampagne liegt, die das Budget hält (ein Kampagnenbudget), meldet der Verlauf den Boost wie jede Anzeige mit Kampagnenbudget: budgetDaily zeigt das gesamte Kampagnenbudget, nicht den Anteil des Boosts, und sobald ein Laufzeit-Kampagnenbudget ausgegeben ist, zeigt jede Anzeige, die Ayrshare in dieser Kampagne verfolgt, nach der nächsten nächtlichen Aktualisierung deliveryStatus: "COMPLETED", auch eine Anzeige, die geplant ist oder sich in Prüfung befindet. Eine abgelehnte Anzeige bleibt REJECTED.

Eine Unterhaltung statt eines Links öffnen

Der Button eines Boosts kann statt einer Webseite einen Chat mit Ihrem Unternehmen öffnen. Senden Sie die verschachtelte Form mit callToAction.destination und lassen Sie callToAction.link weg.
  • Verwenden Sie das Anzeigenziel engagement oder interactions. Die Anzeige wird dann auf Unterhaltungen optimiert: Meta zeigt sie Personen, die wahrscheinlich einen Chat beginnen. Andere Ziele geben einen 400 mit code: 101 zurück.
  • callToAction.type muss wie in der Tabelle zum Ziel passen. Jede Groß- und Kleinschreibung wird akzeptiert.
  • callToAction.link und callToAction.linkTitle können nicht zusammen mit destination gesendet werden, da der Button einen Chat und keine Seite öffnet. Ohne destination ist link weiterhin erforderlich.
  • Personen schreiben dem Konto, das mit Ihrem Profil verknüpft ist. Für whatsapp muss in Meta eine WhatsApp-Business-Nummer mit dessen Facebook Page verbunden sein.
  • destination kann nicht mit attachTo.adSetId kombiniert werden: Die bestehende Anzeigengruppe behält das Ziel, das sie bereits hat. Bei attachTo.campaignId muss die Kampagne das Meta-Ziel OUTCOME_ENGAGEMENT haben; andernfalls gibt die Anfrage einen 400 mit code: 101 zurück.
  • Die Antwort und Beworbene Anzeigen abrufen geben callToAction mit seinem destination zurück. Meta speichert für beide Ziele dieselben Einstellungen, daher kann ein mit interactions beworbener Chat-Button mit dem Ziel engagement aufgeführt werden, wenn die Anzeige von Meta zurückgelesen wird.