Outils Microsoft Advertising
Campagnes de recherche Bing, mots-clés, ciblage, balises UET, objectifs de conversion et rapports.
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 lecture16 outils
list_microsoft_accounts
Lecture1 créditsComptes publicitaires Microsoft Advertising accessibles à l'utilisateur connecté (id, nom, numéro, customer_id, devise, statut) et celui qui est sélectionné. À utiliser dans les configurations gestionnaire/agence avant toute écriture. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
all_accessibleFacultatif | boolean | default true; false returns only the selected account |
list_microsoft_ad_groups
Lecture1 créditsGroupes d'annonces d'une campagne Microsoft Advertising (id, nom, statut, enchère CPC par défaut). Utilisez les identifiants pour les mots-clés, les annonces et le ciblage au niveau du groupe d'annonces. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
list_microsoft_audiences
Lecture1 créditsAudiences du compte Microsoft Advertising (listes de remarketing, intentions d'achat, personnalisées) avec leur taille et le tag UET. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
list_microsoft_conversion_goals
Lecture1 créditsObjectifs de conversion du compte Microsoft Advertising avec type, statut, état du suivi, catégorie, paramètres de revenu. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
list_microsoft_uet_tags
Lecture1 créditsTags UET (Universal Event Tracking) du compte Microsoft Advertising avec l'état du suivi et le script. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
microsoft_search_terms_report
Lecture2 créditsTermes de recherche Microsoft Advertising (requêtes ayant déclenché des annonces) avec dépenses, clics, conversions, mot-clé et type de correspondance des N derniers jours, ainsi que les termes gaspillés (zéro conversion). Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–90) | — |
campaign_idFacultatif | string | — |
start_dateFacultatif | string | YYYY-MM-DD (overrides days) |
end_dateFacultatif | string | YYYY-MM-DD, default today |
min_wasteFacultatif | number | only count zero-conversion terms spending at least this much as wasted |
limitFacultatif | integer (1–500) | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
microsoft_performance_report
Lecture2 créditsPerformances Microsoft Advertising par campagne, groupe d'annonces ou appareil (dépenses, clics, impressions, conversions, revenus, CTR, CPC, CPA, ROAS) avec totaux ; compare_previous ajoute la période précédente. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD (overrides days) |
end_dateFacultatif | string | YYYY-MM-DD, default today |
breakdownFacultatif | campaign | ad_group | device | — |
campaign_idFacultatif | string | — |
compare_previousFacultatif | boolean | renvoie aussi la période précédente de même durée |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
list_microsoft_campaigns
Lecture1 créditsCampagnes lues en direct dans le compte Microsoft Advertising (id, nom, statut, type, budget quotidien, enchères). raw_status est le statut propre à Microsoft (Active, Paused, BudgetPaused, BudgetAndManualPaused, Suspended) ; bidding_settings porte le CPA cible / ROAS cible / CPC max de la stratégie lorsque Microsoft les renvoie ; s'y ajoutent budget_type et shared_budget_id. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
statusFacultatif | string | filtre facultatif : live | paused | ended (ou statut Microsoft) |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
diagnose_microsoft_delivery
Lecture2 créditsDiagnostic de diffusion EN DIRECT d'une campagne Microsoft Advertising. À appeler en premier lorsque l'utilisateur signale que la campagne n'est pas diffusée, est en pause faute de budget, suspendue, limitée ou refusée. Lit l'état du compte, la campagne (statut, budget, stratégie d'enchères avec CPA cible / ROAS cible / CPC max), ses groupes d'annonces (statut, dates, enchères) et ses annonces (statut éditorial avec les codes de motif éditorial de Microsoft et l'état du recours), l'historique des modifications des 14 derniers jours ainsi que les opportunités de budget et les recommandations de Microsoft ; renvoie une liste de constats (niveau, code Microsoft, catégorie, preuve) et cannot_read pour ce qui n'a pas pu être lu. Lecture seule. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | id de campagne Microsoft (list_microsoft_campaigns) ou id de campagne Tecrübe |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
list_microsoft_ads
Lecture1 créditsAnnonces d'un groupe d'annonces Microsoft Advertising avec type, statut, statut éditorial, titres, descriptions et URL de destination. Utilisez les id pour update_microsoft_ad_status / update_microsoft_responsive_search_ad. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
list_microsoft_keywords
Lecture1 créditsMots-clés d'un groupe d'annonces Microsoft Advertising (id, texte, type de correspondance, statut, statut éditorial, enchère). Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
list_microsoft_negative_keywords
Lecture1 créditsMots-clés négatifs actuellement définis sur une campagne ou un groupe d'annonces Microsoft Advertising — à vérifier ici quand le trafic baisse ou avant d'en retirer un. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | — |
ad_group_idFacultatif | string | niveau groupe d'annonces ; campaign_id est aussi requis |
entity_idFacultatif | string | alias : id de campagne ou de groupe d'annonces, avec entity_type |
entity_typeFacultatif | Campaign | AdGroup | — |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
list_microsoft_ad_extensions
Lecture1 créditsExtensions de liens annexes et d'accroche associées aux campagnes Microsoft Advertising (id, texte, URL, statut, statut éditorial). À vérifier avant d'en ajouter pour éviter les doublons ; les id servent à remove_microsoft_ad_extensions. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | facultatif ; par défaut toutes les campagnes du compte |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
microsoft_entity_performance_report
Lecture2 créditsPerformances Microsoft Advertising sous le niveau campagne — par groupe d'annonces, annonce, mot-clé (avec niveau de qualité), lieu, appareil ou âge/genre — avec dépenses, clics, conversions, chiffre d'affaires, CTR, CPC, CPA, ROAS et totaux. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
levelFacultatif | ad_group | ad | keyword | location | device | age_gender | — |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD (remplace days) |
end_dateFacultatif | string | YYYY-MM-DD, aujourd'hui par défaut |
campaign_idFacultatif | string | — |
limitFacultatif | integer (1–500) | — |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
microsoft_location_search
Lecture1 créditsRecherche par nom les id de lieu Microsoft Advertising (depuis le fichier géographique officiel de Microsoft), avec type et nom d'affichage complet, pour add_microsoft_location_target. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
queryObligatoire | string | — |
location_typeFacultatif | Country | State | City | MetroArea | County | PostalCode | — |
limitFacultatif | integer (1–50) | — |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
microsoft_report_query
Lecture2 créditsLecture libre de l'API Microsoft Advertising Reporting (v13) : tout type de rapport avec les colonnes de votre choix ; les lignes sont renvoyées telles que Microsoft les fournit. À utiliser lorsque les rapports fixes n'ont pas la ventilation dont vous avez besoin. Nécessite un compte Microsoft Advertising connecté ; sinon renvoie connected=false, jamais de chiffres inventés.
| Paramètre | Type | Description |
|---|---|---|
report_typeObligatoire | string | rapport Reporting v13, p. ex. KeywordPerformanceReport, AdPerformanceReport, GeographicPerformanceReport |
columnsObligatoire | array<string> | noms de colonnes de ce rapport, p. ex. CampaignName, Clicks, Spend |
aggregationFacultatif | Summary | Hourly | Daily | Weekly | Monthly | Yearly | HourOfDay | DayOfWeek | WeeklyStartingMonday | — |
daysFacultatif | integer (1–365) | — |
start_dateFacultatif | string | YYYY-MM-DD (remplace days) |
end_dateFacultatif | string | YYYY-MM-DD, aujourd'hui par défaut |
limitFacultatif | integer (1–2000) | — |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
Outils d'écriture27 outils
select_microsoft_account
Écriture1 créditsChoisit le compte publicitaire Microsoft Advertising utilisé par toutes les lectures et écritures suivantes (configurations gestionnaire/agence). Réglage local ; rien n'est modifié chez Microsoft.
| Paramètre | Type | Description |
|---|---|---|
account_idObligatoire | string | — |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_microsoft_campaign
Écriture2 créditsCrée un BROUILLON de campagne de recherche Microsoft Advertising avec ses groupes d'annonces, ses mots-clés et le texte de l'annonce responsive sur le réseau de recherche en une seule fois (par ex. pour répliquer une structure Google Ads). Toute la structure est affichée en aperçu ; après approbation, elle est créée EN PAUSE chez Microsoft. Mise en ligne avec update_microsoft_campaign_status(resume). Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
daily_budgetObligatoire | number | budget quotidien dans la devise du compte |
kindFacultatif | string | search (par défaut) | local_search | sales | traffic |
goalFacultatif | string | — |
languageFacultatif | string | langue des annonces, par ex. Turkish, English (par défaut Turkish) |
campaign_typeFacultatif | Search | only Search is supported |
bid_strategyFacultatif | manual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share | — |
target_cpaFacultatif | number | — |
target_roasFacultatif | number | — |
max_cpcFacultatif | number | — |
final_urlFacultatif | string | page de destination des annonces ; par défaut le site web de la marque |
ad_groupsFacultatif | array<object> | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_microsoft_ad_group
Écriture2 créditsAjoute un groupe d'annonces à une campagne Microsoft Advertising existante, éventuellement avec des mots-clés et une annonce responsive sur le réseau de recherche (titres + descriptions + final_url). Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
nameObligatoire | string | — |
cpc_bidFacultatif | number | — |
keywordsFacultatif | array<any> | — |
headlinesFacultatif | array<string> | — |
descriptionsFacultatif | array<string> | — |
final_urlFacultatif | string | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
languageFacultatif | string | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_microsoft_keywords
Écriture2 créditsAjoute des mots-clés (texte, type de correspondance BROAD|PHRASE|EXACT, enchère facultative) à un groupe d'annonces Microsoft Advertising. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
campaign_idFacultatif | string | — |
keywordsObligatoire | array<any> | — |
match_typeFacultatif | BROAD | PHRASE | EXACT | default for plain-text keywords (PHRASE) |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_microsoft_negative_keywords
Écriture2 créditsAjoute des mots-clés négatifs à une campagne (ou un groupe d'annonces) Microsoft Advertising. Microsoft prend en charge les négatifs PHRASE et EXACT. Suite typique de microsoft_search_terms_report. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | — |
ad_group_idFacultatif | string | facultatif : négatifs au niveau du groupe d'annonces |
keywordsObligatoire | array<string> | — |
match_typeFacultatif | PHRASE | EXACT | — |
entity_idFacultatif | string | alias: campaign or ad group id, with entity_type |
entity_typeFacultatif | Campaign | AdGroup | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_microsoft_responsive_search_ad
Écriture2 créditsCrée une annonce responsive sur le réseau de recherche (3 à 15 titres ≤30 caractères, 2 à 4 descriptions ≤90 caractères, URL de destination) dans un groupe d'annonces Microsoft Advertising. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
headlinesObligatoire | array<string> | — |
descriptionsObligatoire | array<string> | — |
final_urlObligatoire | string | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_microsoft_campaign_budget
Écriture2 créditsModifie le budget quotidien d'une campagne Microsoft Advertising. L'aperçu affiche ancien → nouveau. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
amountFacultatif | number | nouveau budget quotidien dans la devise du compte |
daily_budgetFacultatif | number | alias of amount |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_microsoft_campaign_status
Écriture2 créditsMet en pause ou reprend une campagne Microsoft Advertising (resume publie aussi une campagne créée en pause). Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
statusObligatoire | pause | resume | paused | active | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_microsoft_ad_group_status
Écriture2 créditsMet en pause ou active un groupe d'annonces Microsoft Advertising. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
ad_group_idObligatoire | string | — |
statusObligatoire | pause | resume | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_microsoft_keyword
Écriture2 créditsModifie un mot-clé Microsoft Advertising : enchère, pause/reprise, type de correspondance (le texte du mot-clé ne peut pas changer). Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
keyword_idObligatoire | string | — |
bidFacultatif | number | — |
statusFacultatif | pause | resume | — |
match_typeFacultatif | BROAD | PHRASE | EXACT | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
set_microsoft_bid_strategy
Écriture2 créditsDéfinit la stratégie d'enchères d'une campagne Microsoft Advertising : CPC manuel/optimisé, maximiser les clics/conversions (CPA cible facultatif), maximiser la valeur de conversion (ROAS cible facultatif), taux d'impressions cible. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
strategyObligatoire | manual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share | — |
target_cpaFacultatif | number | — |
target_roasFacultatif | number | par ex. 4.0 pour 400 % |
max_cpcFacultatif | number | — |
target_impression_shareFacultatif | number | — |
target_ad_positionFacultatif | AbsoluteTopOfPage | TopOfPage | MainLine1 | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_microsoft_location_target
Écriture2 créditsCible (ou exclut) des zones géographiques sur une campagne ou un groupe d'annonces Microsoft Advertising. Les noms sont convertis en identifiants de zone Microsoft à partir du fichier géographique officiel lorsque le compte est connecté. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | identifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne) |
ad_group_idFacultatif | string | identifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne) |
locationsFacultatif | array<string> | noms de villes/régions/pays, par ex. İstanbul, Ankara |
location_idsFacultatif | array<string> | identifiants de zone Microsoft s'ils sont déjà connus |
countryFacultatif | string | indice de désambiguïsation, par défaut Türkiye |
bid_adjustmentFacultatif | number | pourcentage -100..900 |
bid_multiplierFacultatif | number | alias of bid_adjustment |
excludeFacultatif | boolean | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_microsoft_device_target
Écriture2 créditsDéfinit les ajustements d'enchères par appareil (pourcentage -100..900 ; -100 exclut) sur une campagne ou un groupe d'annonces Microsoft Advertising. Microsoft exige les trois appareils ; ceux qui manquent sont envoyés à 0. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | identifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne) |
ad_group_idFacultatif | string | identifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne) |
computersFacultatif | number | — |
smartphonesFacultatif | number | — |
tabletsFacultatif | number | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_microsoft_demographic_target
Écriture2 créditsDéfinit les ajustements d'enchères par âge et par genre (pourcentage -100..900) sur une campagne ou un groupe d'annonces Microsoft Advertising. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | identifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne) |
ad_group_idFacultatif | string | identifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne) |
agesFacultatif | array<object> | — |
gendersFacultatif | array<object> | — |
criterion_typeFacultatif | age | gender | single-criterion form |
valueFacultatif | string | single-criterion form: age range (e.g. 25-34) or gender |
bid_multiplierFacultatif | number | single-criterion form: percent -100..900 |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_microsoft_ad_schedule
Écriture2 créditsAjoute un calendrier de diffusion (créneaux jour/heure avec ajustement d'enchère) à une campagne ou un groupe d'annonces Microsoft Advertising ; les annonces ne sont pas diffusées en dehors des créneaux. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | identifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne) |
ad_group_idFacultatif | string | identifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne) |
scheduleFacultatif | array<object> | — |
daysFacultatif | any | short form (instead of schedule): weekdays | weekend | all or a list of day names |
from_hourFacultatif | integer | — |
to_hourFacultatif | integer | — |
bid_adjustmentFacultatif | number | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_microsoft_remarketing_list
Écriture2 créditsCrée une liste de remarketing (règle de visiteurs de pages sur le tag UET) dans le compte Microsoft Advertising. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
descriptionFacultatif | string | — |
url_containsObligatoire | string | visiteurs des pages dont l'URL correspond |
operatorFacultatif | Contains | Equals | BeginsWith | EndsWith | DoesNotContain | — |
membership_durationFacultatif | integer | jours 1-180, par défaut 30 |
tag_idFacultatif | string | identifiant du tag UET ; par défaut le premier tag |
uet_tag_idFacultatif | string | alias of tag_id |
valueFacultatif | string | Alias of url_contains |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_microsoft_conversion_goal
Écriture2 créditsCrée un objectif de conversion (objectif URL : page de remerciement ; objectif événement : événement UET personnalisé) dans le compte Microsoft Advertising. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
goal_typeFacultatif | url | event | — |
categoryFacultatif | Purchase | Signup | Contact | SubmitLeadForm | RequestQuote | BookAppointment | AddToCart | BeginCheckout | Subscribe | PageView | OutboundClick | GetDirections | Other | — |
url_expressionFacultatif | string | — |
url_operatorFacultatif | Contains | Equals | BeginsWith | RegularExpression | — |
actionFacultatif | string | — |
category_expressionFacultatif | string | — |
labelFacultatif | string | — |
valueFacultatif | number | — |
action_operatorFacultatif | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
category_expression_operatorFacultatif | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
label_operatorFacultatif | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
value_operatorFacultatif | string | event goals: Equals | GreaterThan | LessThan |
count_typeFacultatif | all | unique | — |
conversion_window_daysFacultatif | number | — |
revenue_valueFacultatif | number | — |
revenue_typeFacultatif | fixed | variable | — |
currencyFacultatif | string | — |
tag_idFacultatif | string | — |
uet_tag_idFacultatif | string | alias of tag_id |
operatorFacultatif | string | alias of url_operator |
goal_categoryFacultatif | string | alias of category |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
create_microsoft_uet_tag
Écriture2 créditsCrée un tag UET ; le résultat contient le script de suivi à ajouter au site web. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
nameObligatoire | string | — |
descriptionFacultatif | string | — |
account_idFacultatif | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idFacultatif | string | optional: manager account (customer) id of account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_microsoft_campaign
ÉcritureIrréversible2 créditsSupprime DÉFINITIVEMENT une campagne Microsoft Advertising (irréversible ; en cas de doute, mettez en pause). Attend toujours la validation explicite de l'utilisateur, quelle que soit la politique de validation. Crée un élément de validation avec aperçu ; appliqué chez Microsoft uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
delete_microsoft_audience
ÉcritureIrréversible2 créditsSupprime DÉFINITIVEMENT une audience Microsoft Advertising (p. ex. une liste de remarketing). Attend toujours la validation explicite de l'utilisateur. Crée un élément de validation avec aperçu ; appliqué chez Microsoft uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
audience_idObligatoire | string | — |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_microsoft_ad_status
Écriture2 créditsMet en pause ou active une seule annonce Microsoft Advertising. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
ad_idObligatoire | string | — |
statusObligatoire | pause | resume | paused | active | — |
ad_typeFacultatif | ResponsiveSearch | ExpandedText | Text | DynamicSearch | ResponsiveAd | Image | Product | AppInstall | Hotel | ResponsiveSearch par défaut (voir list_microsoft_ads) |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_microsoft_responsive_search_ad
Écriture2 créditsModifie sur place le texte d'une annonce responsive sur le Réseau de Recherche Microsoft Advertising existante (conserve l'id de l'annonce et son historique de performances, contrairement à une reconstruction). Les listes fournies remplacent les actuelles. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
ad_group_idObligatoire | string | — |
ad_idObligatoire | string | — |
headlinesFacultatif | array<string> | nouvel ensemble complet, 3-15, ≤30 caractères |
descriptionsFacultatif | array<string> | nouvel ensemble complet, 2-4, ≤90 caractères |
final_urlFacultatif | string | — |
path1Facultatif | string | — |
path2Facultatif | string | — |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
update_microsoft_ad_group
Écriture2 créditsModifie un groupe d'annonces Microsoft Advertising : nom, enchère CPC par défaut, date de début/fin, statut, réseau de recherche. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
ad_group_idObligatoire | string | — |
nameFacultatif | string | — |
cpc_bidFacultatif | number | — |
start_dateFacultatif | string | YYYY-MM-DD |
end_dateFacultatif | string | YYYY-MM-DD |
statusFacultatif | pause | resume | paused | active | — |
networkFacultatif | all | microsoft_only | syndicated_only | — |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
add_microsoft_ad_extensions
Écriture2 créditsAjoute des extensions de liens annexes et/ou d'accroche à une campagne Microsoft Advertising (créées dans la bibliothèque du compte, puis associées à la campagne). Crée un élément de validation avec aperçu ; appliqué chez Microsoft uniquement après validation et uniquement avec un compte connecté (sinon simulation).
| Paramètre | Type | Description |
|---|---|---|
campaign_idObligatoire | string | — |
sitelinksFacultatif | array<object> | — |
calloutsFacultatif | array<string> | — |
account_idFacultatif | string | facultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (customer) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
remove_microsoft_ad_extensions
ÉcritureIrréversible2 créditsSupprime des extensions de liens annexes/accroches : les dissocie de la campagne et les efface de la bibliothèque du compte (définitif ; elles disparaissent de toutes les campagnes). Attend toujours l'approbation explicite de l'utilisateur. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
extension_idsObligatoire | array<string> | — |
campaign_idFacultatif | string | dissocier d'abord de cette campagne (facultatif) |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
remove_microsoft_negative_keywords
ÉcritureIrréversible2 créditsRetire des mots-clés négatifs (par texte, éventuellement pour un seul type de correspondance) d'une campagne ou d'un groupe d'annonces Microsoft Advertising — p. ex. pour annuler un négatif qui bloque du bon trafic. Seuls les négatifs réellement existants sont retirés. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
campaign_idFacultatif | string | — |
ad_group_idFacultatif | string | niveau groupe d'annonces ; campaign_id est aussi requis |
keywordsObligatoire | array<string> | — |
match_typeFacultatif | PHRASE | EXACT | — |
entity_idFacultatif | string | alias : id de campagne ou de groupe d'annonces, avec entity_type |
entity_typeFacultatif | Campaign | AdGroup | — |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.
upload_microsoft_offline_conversions
Écriture2 créditsEnvoie des conversions hors ligne (p. ex. ventes CRM) à Microsoft Advertising par id de clic, afin que les enchères apprennent des résultats réels. Jusqu'à 1000 lignes par appel ; l'objectif doit exister et les clics doivent dater de moins de 90 jours. Crée un élément d'approbation avec un aperçu ; appliqué chez Microsoft uniquement après approbation et uniquement avec un compte connecté (simulation sinon).
| Paramètre | Type | Description |
|---|---|---|
conversion_nameObligatoire | string | nom d'un objectif de conversion hors ligne du compte |
conversionsObligatoire | array<object> | — |
currencyFacultatif | string | devise par défaut pour les lignes qui n'en ont pas |
account_idFacultatif | string | facultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence) |
customer_idFacultatif | string | facultatif : id du compte gestionnaire (client) de account_id |
Outil d'écriture : l'appel produit d'abord un aperçu ; la modification n'atteint la plateforme qu'après votre validation.