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.

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 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.