Skip to main content
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 müssen in USD mit bis zu zwei Dezimalstellen angegeben werden.
  • 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.

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 Plattform gibt HTTP 409 zurück. 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}.
number
erforderlich
Maximaler Gebotsbetrag in USD, als positiver Betrag mit bis zu zwei Dezimalstellen.
number
erforderlich
Tagesbudget in USD. Verwenden Sie einen positiven Betrag mit bis zu zwei Dezimalstellen. Meta kann zusätzliche 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.
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.

Kampagnenbudgets

Um das Budget auf der Kampagne statt auf der Anzeigengruppe zu halten, senden Sie budget.level: "campaign" in der 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.