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

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édits

Comptes 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ètreTypeDescription
all_accessibleFacultatifbooleandefault true; false returns only the selected account

list_microsoft_ad_groups

Lecture1 crédits

Groupes 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ètreTypeDescription
campaign_idObligatoirestring—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: manager account (customer) id of account_id

list_microsoft_audiences

Lecture1 crédits

Audiences 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ètreTypeDescription
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: manager account (customer) id of account_id

list_microsoft_conversion_goals

Lecture1 crédits

Objectifs 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ètreTypeDescription
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: manager account (customer) id of account_id

list_microsoft_uet_tags

Lecture1 crédits

Tags 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ètreTypeDescription
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: manager account (customer) id of account_id

microsoft_search_terms_report

Lecture2 crédits

Termes 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ètreTypeDescription
daysFacultatifinteger (1–90)—
campaign_idFacultatifstring—
start_dateFacultatifstringYYYY-MM-DD (overrides days)
end_dateFacultatifstringYYYY-MM-DD, default today
min_wasteFacultatifnumberonly count zero-conversion terms spending at least this much as wasted
limitFacultatifinteger (1–500)—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: manager account (customer) id of account_id

microsoft_performance_report

Lecture2 crédits

Performances 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ètreTypeDescription
daysFacultatifinteger (1–365)—
start_dateFacultatifstringYYYY-MM-DD (overrides days)
end_dateFacultatifstringYYYY-MM-DD, default today
breakdownFacultatifcampaign | ad_group | device—
campaign_idFacultatifstring—
compare_previousFacultatifbooleanrenvoie aussi la période précédente de même durée
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: manager account (customer) id of account_id

list_microsoft_campaigns

Lecture1 crédits

Campagnes 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ètreTypeDescription
statusFacultatifstringfiltre facultatif : live | paused | ended (ou statut Microsoft)
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (customer) de account_id

diagnose_microsoft_delivery

Lecture2 crédits

Diagnostic 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ètreTypeDescription
campaign_idObligatoirestringid de campagne Microsoft (list_microsoft_campaigns) ou id de campagne Tecrübe
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (customer) de account_id

list_microsoft_ads

Lecture1 crédits

Annonces 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ètreTypeDescription
ad_group_idObligatoirestring—
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (customer) de account_id

list_microsoft_keywords

Lecture1 crédits

Mots-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ètreTypeDescription
ad_group_idObligatoirestring—
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (customer) de account_id

list_microsoft_negative_keywords

Lecture1 crédits

Mots-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ètreTypeDescription
campaign_idFacultatifstring—
ad_group_idFacultatifstringniveau groupe d'annonces ; campaign_id est aussi requis
entity_idFacultatifstringalias : id de campagne ou de groupe d'annonces, avec entity_type
entity_typeFacultatifCampaign | AdGroup—
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (customer) de account_id

list_microsoft_ad_extensions

Lecture1 crédits

Extensions 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ètreTypeDescription
campaign_idFacultatifstringfacultatif ; par défaut toutes les campagnes du compte
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (customer) de account_id

microsoft_entity_performance_report

Lecture2 crédits

Performances 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ètreTypeDescription
levelFacultatifad_group | ad | keyword | location | device | age_gender—
daysFacultatifinteger (1–365)—
start_dateFacultatifstringYYYY-MM-DD (remplace days)
end_dateFacultatifstringYYYY-MM-DD, aujourd'hui par défaut
campaign_idFacultatifstring—
limitFacultatifinteger (1–500)—
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (client) de account_id

microsoft_report_query

Lecture2 crédits

Lecture 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ètreTypeDescription
report_typeObligatoirestringrapport Reporting v13, p. ex. KeywordPerformanceReport, AdPerformanceReport, GeographicPerformanceReport
columnsObligatoirearray<string>noms de colonnes de ce rapport, p. ex. CampaignName, Clicks, Spend
aggregationFacultatifSummary | Hourly | Daily | Weekly | Monthly | Yearly | HourOfDay | DayOfWeek | WeeklyStartingMonday—
daysFacultatifinteger (1–365)—
start_dateFacultatifstringYYYY-MM-DD (remplace days)
end_dateFacultatifstringYYYY-MM-DD, aujourd'hui par défaut
limitFacultatifinteger (1–2000)—
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : id du compte gestionnaire (client) de account_id

Outils d'écriture27 outils

select_microsoft_account

Écriture1 crédits

Choisit 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ètreTypeDescription
account_idObligatoirestring—

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édits

Cré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ètreTypeDescription
nameObligatoirestring—
daily_budgetObligatoirenumberbudget quotidien dans la devise du compte
kindFacultatifstringsearch (par défaut) | local_search | sales | traffic
goalFacultatifstring—
languageFacultatifstringlangue des annonces, par ex. Turkish, English (par défaut Turkish)
campaign_typeFacultatifSearchonly Search is supported
bid_strategyFacultatifmanual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share—
target_cpaFacultatifnumber—
target_roasFacultatifnumber—
max_cpcFacultatifnumber—
final_urlFacultatifstringpage de destination des annonces ; par défaut le site web de la marque
ad_groupsFacultatifarray<object>—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Ajoute 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ètreTypeDescription
campaign_idObligatoirestring—
nameObligatoirestring—
cpc_bidFacultatifnumber—
keywordsFacultatifarray<any>—
headlinesFacultatifarray<string>—
descriptionsFacultatifarray<string>—
final_urlFacultatifstring—
path1Facultatifstring—
path2Facultatifstring—
languageFacultatifstring—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Ajoute 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ètreTypeDescription
ad_group_idObligatoirestring—
campaign_idFacultatifstring—
keywordsObligatoirearray<any>—
match_typeFacultatifBROAD | PHRASE | EXACTdefault for plain-text keywords (PHRASE)
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Ajoute 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ètreTypeDescription
campaign_idFacultatifstring—
ad_group_idFacultatifstringfacultatif : négatifs au niveau du groupe d'annonces
keywordsObligatoirearray<string>—
match_typeFacultatifPHRASE | EXACT—
entity_idFacultatifstringalias: campaign or ad group id, with entity_type
entity_typeFacultatifCampaign | AdGroup—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Cré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ètreTypeDescription
ad_group_idObligatoirestring—
headlinesObligatoirearray<string>—
descriptionsObligatoirearray<string>—
final_urlObligatoirestring—
path1Facultatifstring—
path2Facultatifstring—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Modifie 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ètreTypeDescription
campaign_idObligatoirestring—
amountFacultatifnumbernouveau budget quotidien dans la devise du compte
daily_budgetFacultatifnumberalias of amount
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Met 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ètreTypeDescription
campaign_idObligatoirestring—
statusObligatoirepause | resume | paused | active—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Met 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ètreTypeDescription
campaign_idObligatoirestring—
ad_group_idObligatoirestring—
statusObligatoirepause | resume—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Modifie 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ètreTypeDescription
ad_group_idObligatoirestring—
keyword_idObligatoirestring—
bidFacultatifnumber—
statusFacultatifpause | resume—
match_typeFacultatifBROAD | PHRASE | EXACT—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Dé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ètreTypeDescription
campaign_idObligatoirestring—
strategyObligatoiremanual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share—
target_cpaFacultatifnumber—
target_roasFacultatifnumberpar ex. 4.0 pour 400 %
max_cpcFacultatifnumber—
target_impression_shareFacultatifnumber—
target_ad_positionFacultatifAbsoluteTopOfPage | TopOfPage | MainLine1—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Cible (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ètreTypeDescription
campaign_idFacultatifstringidentifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne)
ad_group_idFacultatifstringidentifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne)
locationsFacultatifarray<string>noms de villes/régions/pays, par ex. İstanbul, Ankara
location_idsFacultatifarray<string>identifiants de zone Microsoft s'ils sont déjà connus
countryFacultatifstringindice de désambiguïsation, par défaut Türkiye
bid_adjustmentFacultatifnumberpourcentage -100..900
bid_multiplierFacultatifnumberalias of bid_adjustment
excludeFacultatifboolean—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Dé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ètreTypeDescription
campaign_idFacultatifstringidentifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne)
ad_group_idFacultatifstringidentifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne)
computersFacultatifnumber—
smartphonesFacultatifnumber—
tabletsFacultatifnumber—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Dé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ètreTypeDescription
campaign_idFacultatifstringidentifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne)
ad_group_idFacultatifstringidentifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne)
agesFacultatifarray<object>—
gendersFacultatifarray<object>—
criterion_typeFacultatifage | gendersingle-criterion form
valueFacultatifstringsingle-criterion form: age range (e.g. 25-34) or gender
bid_multiplierFacultatifnumbersingle-criterion form: percent -100..900
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Ajoute 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ètreTypeDescription
campaign_idFacultatifstringidentifiant de campagne Tecrübe ou identifiant de campagne Microsoft (niveau campagne)
ad_group_idFacultatifstringidentifiant de groupe d'annonces Microsoft (le niveau groupe d'annonces prime sur le niveau campagne)
scheduleFacultatifarray<object>—
daysFacultatifanyshort form (instead of schedule): weekdays | weekend | all or a list of day names
from_hourFacultatifinteger—
to_hourFacultatifinteger—
bid_adjustmentFacultatifnumber—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Cré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ètreTypeDescription
nameObligatoirestring—
descriptionFacultatifstring—
url_containsObligatoirestringvisiteurs des pages dont l'URL correspond
operatorFacultatifContains | Equals | BeginsWith | EndsWith | DoesNotContain—
membership_durationFacultatifintegerjours 1-180, par défaut 30
tag_idFacultatifstringidentifiant du tag UET ; par défaut le premier tag
uet_tag_idFacultatifstringalias of tag_id
valueFacultatifstringAlias of url_contains
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Cré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ètreTypeDescription
nameObligatoirestring—
goal_typeFacultatifurl | event—
categoryFacultatifPurchase | Signup | Contact | SubmitLeadForm | RequestQuote | BookAppointment | AddToCart | BeginCheckout | Subscribe | PageView | OutboundClick | GetDirections | Other—
url_expressionFacultatifstring—
url_operatorFacultatifContains | Equals | BeginsWith | RegularExpression—
actionFacultatifstring—
category_expressionFacultatifstring—
labelFacultatifstring—
valueFacultatifnumber—
action_operatorFacultatifstringevent goals: Equals | BeginsWith | Contains | RegularExpression
category_expression_operatorFacultatifstringevent goals: Equals | BeginsWith | Contains | RegularExpression
label_operatorFacultatifstringevent goals: Equals | BeginsWith | Contains | RegularExpression
value_operatorFacultatifstringevent goals: Equals | GreaterThan | LessThan
count_typeFacultatifall | unique—
conversion_window_daysFacultatifnumber—
revenue_valueFacultatifnumber—
revenue_typeFacultatiffixed | variable—
currencyFacultatifstring—
tag_idFacultatifstring—
uet_tag_idFacultatifstringalias of tag_id
operatorFacultatifstringalias of url_operator
goal_categoryFacultatifstringalias of category
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Cré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ètreTypeDescription
nameObligatoirestring—
descriptionFacultatifstring—
account_idFacultatifstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idFacultatifstringoptional: 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édits

Supprime 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ètreTypeDescription
campaign_idObligatoirestring—
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Supprime 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ètreTypeDescription
audience_idObligatoirestring—
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Met 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ètreTypeDescription
ad_group_idObligatoirestring—
ad_idObligatoirestring—
statusObligatoirepause | resume | paused | active—
ad_typeFacultatifResponsiveSearch | ExpandedText | Text | DynamicSearch | ResponsiveAd | Image | Product | AppInstall | HotelResponsiveSearch par défaut (voir list_microsoft_ads)
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Modifie 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ètreTypeDescription
ad_group_idObligatoirestring—
ad_idObligatoirestring—
headlinesFacultatifarray<string>nouvel ensemble complet, 3-15, ≤30 caractères
descriptionsFacultatifarray<string>nouvel ensemble complet, 2-4, ≤90 caractères
final_urlFacultatifstring—
path1Facultatifstring—
path2Facultatifstring—
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Modifie 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ètreTypeDescription
campaign_idObligatoirestring—
ad_group_idObligatoirestring—
nameFacultatifstring—
cpc_bidFacultatifnumber—
start_dateFacultatifstringYYYY-MM-DD
end_dateFacultatifstringYYYY-MM-DD
statusFacultatifpause | resume | paused | active—
networkFacultatifall | microsoft_only | syndicated_only—
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Ajoute 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ètreTypeDescription
campaign_idObligatoirestring—
sitelinksFacultatifarray<object>—
calloutsFacultatifarray<string>—
account_idFacultatifstringfacultatif : exécute uniquement cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Supprime 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ètreTypeDescription
extension_idsObligatoirearray<string>—
campaign_idFacultatifstringdissocier d'abord de cette campagne (facultatif)
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Retire 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ètreTypeDescription
campaign_idFacultatifstring—
ad_group_idFacultatifstringniveau groupe d'annonces ; campaign_id est aussi requis
keywordsObligatoirearray<string>—
match_typeFacultatifPHRASE | EXACT—
entity_idFacultatifstringalias : id de campagne ou de groupe d'annonces, avec entity_type
entity_typeFacultatifCampaign | AdGroup—
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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édits

Envoie 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ètreTypeDescription
conversion_nameObligatoirestringnom d'un objectif de conversion hors ligne du compte
conversionsObligatoirearray<object>—
currencyFacultatifstringdevise par défaut pour les lignes qui n'en ont pas
account_idFacultatifstringfacultatif : exécuter uniquement pour cet appel dans ce compte publicitaire Microsoft (configurations d'agence)
customer_idFacultatifstringfacultatif : 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.