Zum Inhalt springen
Tecrübetecrube.com
Assistenten-Tools · Einrichtung und Kampagnen

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 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
daysOptionalinteger (1–90)letzte N Tage in UTC, einschließlich heute (Standard 30)
statusOptionalactive | paused | archived | draft—

pinterest_performance_report

Lesen1 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
daysOptionalinteger (1–90)letzte N Tage in UTC, einschließlich heute (Standard 30)
start_dateOptionalstringYYYY-MM-DD (UTC), höchstens 90 Tage zurück; mit end_date verwenden
end_dateOptionalstringYYYY-MM-DD (UTC), höchstens 90 Tage nach start_date
levelOptionalaccount | campaign—
granularityOptionaltotal | day | week | month—
campaign_idsOptionalarray<string>nur mit level=campaign; Standard: die aktiven und pausierten Kampagnen des Kontos

diagnose_pinterest_delivery

Lesen1 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstringPinterest-Kampagnen-ID (list_pinterest_campaigns)

Schreib-Tools5 Tools

update_pinterest_campaign_status

Schreiben2 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstring—
statusPflichtpause | activate—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_pinterest_campaign_budget

Schreiben2 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
campaign_idPflichtstring—
daily_budgetPflichtnumberneues 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 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
namePflichtstring—
daily_budgetPflichtnumber—
objective_typeOptionalAWARENESS | CONSIDERATION | WEB_CONVERSION | CATALOG_SALES | VIDEO_COMPLETION | SALES | LEADS—
billable_eventOptionalCLICKTHROUGH | IMPRESSION | VIDEO_V_50_MRC—
pin_idOptionalstringzu bewerbender Pin; ohne ihn werden nur Kampagne und Anzeigengruppe erstellt
creative_typeOptionalREGULAR | VIDEO | SHOPPING | CAROUSEL | IDEA | COLLECTION—
destination_urlOptionalstring—
bidOptionalnumber—
placement_groupOptionalALL | SEARCH | BROWSE | OTHER—
ad_group_nameOptionalstring—
ad_nameOptionalstring—
audienceOptionalobjectcountries, 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 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
event_namePflichtadd_to_cart | checkout | custom | lead | page_visit | search | signup | view_category | watch_video | add_payment_info | initiate_checkout | subscribe—
action_sourceOptionalweb | app_android | app_ios | offline—
emailOptionalstring—
phoneOptionalstring—
external_idOptionalstring—
client_ip_addressOptionalstring—
client_user_agentOptionalstring—
event_idOptionalstringmit dem Pinterest-Tag geteilte ID zur Vermeidung von Doppelzählungen
event_timeOptionalinteger—
event_source_urlOptionalstring—
valueOptionalnumber—
currencyOptionalstring—
order_idOptionalstring—
testOptionalbooleanprü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 Credits

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

ParameterTypBeschreibung
account_idOptionalstringPinterest-Werbekonto-ID; Standard: das in der Verbindung ausgewählte Konto
actionOptionalcreate | delete—
nameOptionalstring—
audience_typeOptionalVISITOR | ENGAGEMENT | CUSTOMER_LIST | ACTALIKE—
descriptionOptionalstring—
audience_idOptionalstring—
ruleOptionalobjectaudience 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.