Aller au contenu
Tecrübetecrube.com
Outils de l'assistant · Création et campagnes

Outils Pinterest

Comptes publicitaires, campagnes et rapports de performance Pinterest ; les changements de statut et de budget passent par l'aperçu et l'approbation et peuvent être annulés.

Les noms et descriptions des outils sont générés directement depuis le code du serveur ; les descriptions sont la traduction du texte vu par l'assistant, les noms d'outils et de paramètres restent inchangés.

Outils de lecture4 outils

list_pinterest_ad_accounts

Lecture1 crédits

Comptes Pinterest Ads accessibles via la connexion Pinterest liée : account_id, nom, devise, pays, fuseau horaire, autorisations et compte sélectionné. Lecture seule ; connected=false si Pinterest n'est pas connecté.

Cet outil ne prend aucun paramètre.

list_pinterest_campaigns

Lecture1 crédits

Campagnes Pinterest Ads du compte : id, nom, statut, objectif, budget quotidien et total (devise du compte), ainsi que dépenses, impressions payantes, clics payants et conversions des N derniers jours (max. 90). Actives et en pause par défaut. Lecture seule ; une métrique null signifie que Pinterest n'a renvoyé aucune valeur, les chiffres ne sont jamais inventés.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
daysFacultatifinteger (1–90)N derniers jours en UTC, aujourd'hui inclus (30 par défaut)
statusFacultatifactive | paused | archived | draft—

pinterest_performance_report

Lecture1 crédits

Performances Pinterest Ads du compte ou par campagne : dépenses (devise du compte), impressions payantes, clics payants, conversions, CTR et CPC, au total ou par jour, semaine ou mois, jusqu'à 90 jours. Lecture seule ; les chiffres ne sont jamais inventés.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
daysFacultatifinteger (1–90)N derniers jours en UTC, aujourd'hui inclus (30 par défaut)
start_dateFacultatifstringYYYY-MM-DD (UTC), 90 jours en arrière au maximum ; à utiliser avec end_date
end_dateFacultatifstringYYYY-MM-DD (UTC), 90 jours au maximum après start_date
levelFacultatifaccount | campaign—
granularityFacultatiftotal | day | week | month—
campaign_idsFacultatifarray<string>uniquement avec level=campaign ; par défaut : les campagnes actives et en pause du compte

diagnose_pinterest_delivery

Lecture1 crédits

Diagnostic de diffusion EN DIRECT d'une campagne Pinterest Ads. À appeler en premier lorsque l'utilisateur signale que la campagne n'est pas diffusée, est en pause, en attente ou refusée. Lit la campagne, ses groupes d'annonces (statut résumé, budget, stratégie d'enchères, enchère, objectif de CPA, mode d'apprentissage) et ses annonces (statut d'examen, motifs de refus) ; renvoie une liste de constats (niveau, code Pinterest, catégorie, preuve) et cannot_read pour ce que l'API n'expose pas. Lecture seule.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
campaign_idObligatoirestringid de campagne Pinterest (list_pinterest_campaigns)

Outils d'écriture5 outils

update_pinterest_campaign_status

Écriture2 crédits

Met en pause ou active une campagne Pinterest Ads. Appliqué à la demande de l'utilisateur, consigné dans le journal d'audit et annulable avec undo_action.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
campaign_idObligatoirestring—
statusObligatoirepause | activate—

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

update_pinterest_campaign_budget

Écriture2 crédits

Définit le budget quotidien d'une campagne Pinterest Ads (devise du compte). Fonctionne uniquement sur les campagnes avec un budget quotidien au niveau de la campagne ; les campagnes à budget total ou à budget au niveau du groupe d'annonces sont refusées. Les hausses de plus de 50 % par modification ou 2× en 24 heures sont bloquées ; annulable avec undo_action.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
campaign_idObligatoirestring—
daily_budgetObligatoirenumbernouveau budget quotidien dans la devise du compte

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

create_pinterest_campaign

Écriture5 crédits

Crée une campagne Pinterest avec son groupe d'annonces et, si un identifiant de pin est fourni, l'annonce ; les trois sont créés en pause. Le budget quotidien est sur le groupe d'annonces (flux sans CBO de Pinterest). Appliqué à la demande ; pour diffuser, update_pinterest_campaign_status.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
nameObligatoirestring—
daily_budgetObligatoirenumber—
objective_typeFacultatifAWARENESS | CONSIDERATION | WEB_CONVERSION | CATALOG_SALES | VIDEO_COMPLETION | SALES | LEADS—
billable_eventFacultatifCLICKTHROUGH | IMPRESSION | VIDEO_V_50_MRC—
pin_idFacultatifstringpin à promouvoir ; sans lui, seuls la campagne et le groupe d'annonces sont créés
creative_typeFacultatifREGULAR | VIDEO | SHOPPING | CAROUSEL | IDEA | COLLECTION—
destination_urlFacultatifstring—
bidFacultatifnumber—
placement_groupFacultatifALL | SEARCH | BROWSE | OTHER—
ad_group_nameFacultatifstring—
ad_nameFacultatifstring—
audienceFacultatifobjectcountries, age_min, age_max, genders, locales

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

send_pinterest_conversion_event

Écriture1 crédits

Envoie à Pinterest un événement de conversion côté serveur (Conversions API) : les achats et les leads sont mesurés même si la balise du navigateur est bloquée. E-mail et téléphone sont normalisés et hachés en SHA-256 dans Tecrübe ; le même event_id que la balise évite le double comptage.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
event_nameObligatoireadd_to_cart | checkout | custom | lead | page_visit | search | signup | view_category | watch_video | add_payment_info | initiate_checkout | subscribe—
action_sourceFacultatifweb | app_android | app_ios | offline—
emailFacultatifstring—
phoneFacultatifstring—
external_idFacultatifstring—
client_ip_addressFacultatifstring—
client_user_agentFacultatifstring—
event_idFacultatifstringidentifiant partagé avec la balise Pinterest pour éviter le double comptage
event_timeFacultatifinteger—
event_source_urlFacultatifstring—
valueFacultatifnumber—
currencyFacultatifstring—
order_idFacultatifstring—
testFacultatifbooleanvalide la requête sans enregistrer l'événement

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.

manage_pinterest_audience

Écriture2 crédits

Crée ou supprime une audience Pinterest : visiteurs du site via la balise, personnes ayant interagi avec le compte, liste de clients ou audience similaire (actalike). Son remplissage prend des heures. Appliqué à la demande.

ParamètreTypeDescription
account_idFacultatifstringid du compte publicitaire Pinterest ; par défaut : le compte sélectionné dans la connexion
actionFacultatifcreate | delete—
nameFacultatifstring—
audience_typeFacultatifVISITOR | ENGAGEMENT | CUSTOMER_LIST | ACTALIKE—
descriptionFacultatifstring—
audience_idFacultatifstring—
ruleFacultatifobjectaudience rule, e.g. {"visitor_source_id": "<tag id>"}

Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.