Pinterest-Tools
Pinterest-Werbekonten, Kampagnen und Leistungsberichte; Status- und Budgetänderungen laufen über Vorschau und Freigabe und lassen sich rückgängig machen.
Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.
Lese-Tools4 Tools
list_pinterest_ad_accounts
Lesen1 CreditsÜber die verbundene Pinterest-Anmeldung erreichbare Pinterest Ads-Konten: account_id, Name, Währung, Land, Zeitzone, Berechtigungen und welches ausgewählt ist. Nur lesend; connected=false, wenn Pinterest nicht verbunden ist.
Dieses Tool hat keine Parameter.
list_pinterest_campaigns
Lesen1 CreditsPinterest Ads-Kampagnen des Kontos: ID, Name, Status, Ziel, Tages- und Gesamtbudget (Kontowährung) sowie Ausgaben, bezahlte Impressionen, bezahlte Klicks und Conversions der letzten N Tage (max. 90). Standardmäßig aktive und pausierte Kampagnen. Nur lesend; eine null-Kennzahl bedeutet, dass Pinterest keinen Wert geliefert hat, Zahlen werden nie erfunden.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
daysOptional | integer (1–90) | letzte N Tage in UTC, einschließlich heute (Standard 30) |
statusOptional | active | paused | archived | draft | — |
pinterest_performance_report
Lesen1 CreditsPinterest Ads-Leistung für das Konto oder pro Kampagne: Ausgaben (Kontowährung), bezahlte Impressionen, bezahlte Klicks, Conversions, CTR und CPC, als Summe oder nach Tag, Woche oder Monat, bis zu 90 Tage. Nur lesend; Zahlen werden nie erfunden.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
daysOptional | integer (1–90) | letzte N Tage in UTC, einschließlich heute (Standard 30) |
start_dateOptional | string | YYYY-MM-DD (UTC), höchstens 90 Tage zurück; mit end_date verwenden |
end_dateOptional | string | YYYY-MM-DD (UTC), höchstens 90 Tage nach start_date |
levelOptional | account | campaign | — |
granularityOptional | total | day | week | month | — |
campaign_idsOptional | array<string> | nur mit level=campaign; Standard: die aktiven und pausierten Kampagnen des Kontos |
diagnose_pinterest_delivery
Lesen1 CreditsLIVE-Auslieferungsdiagnose einer Pinterest Ads-Kampagne. Zuerst aufrufen, wenn der Nutzer meldet, dass die Kampagne nicht ausgeliefert wird, pausiert, ausstehend oder abgelehnt ist. Liest die Kampagne, ihre Anzeigengruppen (Sammelstatus, Budget, Gebotsstrategie, Gebot, CPA-Ziel, Lernmodus) und Anzeigen (Prüfstatus, Ablehnungsgründe); liefert eine Befundliste (Ebene, Code von Pinterest, Kategorie, Beleg) und cannot_read für das, was die API nicht bereitstellt. Nur lesend.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
campaign_idPflicht | string | Pinterest-Kampagnen-ID (list_pinterest_campaigns) |
Schreib-Tools5 Tools
update_pinterest_campaign_status
Schreiben2 CreditsPausiert oder aktiviert eine Pinterest Ads-Kampagne. Wird auf Wunsch des Nutzers angewendet, im Prüfprotokoll erfasst und ist mit undo_action rückgängig machbar.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
campaign_idPflicht | string | — |
statusPflicht | pause | activate | — |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
update_pinterest_campaign_budget
Schreiben2 CreditsLegt das Tagesbudget einer Pinterest Ads-Kampagne fest (Kontowährung). Funktioniert nur bei Kampagnen mit Tagesbudget auf Kampagnenebene; Kampagnen mit Gesamtbudget oder Budget auf Anzeigengruppenebene werden abgelehnt. Erhöhungen über 50 % pro Änderung oder 2× innerhalb von 24 Stunden werden blockiert; mit undo_action rückgängig machbar.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
campaign_idPflicht | string | — |
daily_budgetPflicht | number | neues Tagesbudget in der Kontowährung |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
create_pinterest_campaign
Schreiben5 CreditsErstellt eine Pinterest-Kampagne mit Anzeigengruppe und, wenn eine Pin-ID angegeben ist, der Anzeige – alle pausiert. Das Tagesbudget liegt auf der Anzeigengruppe (Pinterests Nicht-CBO-Ablauf). Wird auf Wunsch angewendet; zum Schalten update_pinterest_campaign_status.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
namePflicht | string | — |
daily_budgetPflicht | number | — |
objective_typeOptional | AWARENESS | CONSIDERATION | WEB_CONVERSION | CATALOG_SALES | VIDEO_COMPLETION | SALES | LEADS | — |
billable_eventOptional | CLICKTHROUGH | IMPRESSION | VIDEO_V_50_MRC | — |
pin_idOptional | string | zu bewerbender Pin; ohne ihn werden nur Kampagne und Anzeigengruppe erstellt |
creative_typeOptional | REGULAR | VIDEO | SHOPPING | CAROUSEL | IDEA | COLLECTION | — |
destination_urlOptional | string | — |
bidOptional | number | — |
placement_groupOptional | ALL | SEARCH | BROWSE | OTHER | — |
ad_group_nameOptional | string | — |
ad_nameOptional | string | — |
audienceOptional | object | countries, age_min, age_max, genders, locales |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
send_pinterest_conversion_event
Schreiben1 CreditsSendet ein serverseitiges Conversion-Ereignis an Pinterest (Conversions API): Käufe und Leads werden auch gemessen, wenn das Browser-Tag blockiert ist. E-Mail und Telefonnummer werden in Tecrübe normalisiert und mit SHA-256 gehasht; dieselbe event_id wie im Tag verhindert Doppelzählung.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
event_namePflicht | add_to_cart | checkout | custom | lead | page_visit | search | signup | view_category | watch_video | add_payment_info | initiate_checkout | subscribe | — |
action_sourceOptional | web | app_android | app_ios | offline | — |
emailOptional | string | — |
phoneOptional | string | — |
external_idOptional | string | — |
client_ip_addressOptional | string | — |
client_user_agentOptional | string | — |
event_idOptional | string | mit dem Pinterest-Tag geteilte ID zur Vermeidung von Doppelzählungen |
event_timeOptional | integer | — |
event_source_urlOptional | string | — |
valueOptional | number | — |
currencyOptional | string | — |
order_idOptional | string | — |
testOptional | boolean | prüft die Anfrage, zeichnet das Ereignis aber nicht auf |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.
manage_pinterest_audience
Schreiben2 CreditsErstellt oder löscht eine Pinterest-Zielgruppe: Websitebesucher aus dem Tag, Personen mit Interaktion, eine Kundenliste oder eine Actalike-(Lookalike-)Zielgruppe. Die Befüllung dauert Stunden. Wird auf Wunsch angewendet.
| Parameter | Typ | Beschreibung |
|---|---|---|
account_idOptional | string | Pinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto |
actionOptional | create | delete | — |
nameOptional | string | — |
audience_typeOptional | VISITOR | ENGAGEMENT | CUSTOMER_LIST | ACTALIKE | — |
descriptionOptional | string | — |
audience_idOptional | string | — |
ruleOptional | object | audience rule, e.g. {"visitor_source_id": "<tag id>"} |
Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.