Microsoft Advertising araçları
Bing arama kampanyaları, anahtar kelimeler, hedefleme, UET etiketleri, dönüşüm hedefleri ve raporlar.
Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü özgün İngilizce metinlerdir.
Okuma araçları7 araç
list_microsoft_accounts
Okuma1 krediMicrosoft Advertising ad accounts the connected user can access (id, name, number, customer_id, currency, status) and which one is selected. Use it in manager/agency setups before writing. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.
Bu araç parametre almaz.
list_microsoft_ad_groups
Okuma1 krediAd groups of a Microsoft Advertising campaign (id, name, status, default CPC bid). Use the ids for keywords, ads and ad-group-level targeting. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
list_microsoft_audiences
Okuma1 krediAudiences in the Microsoft Advertising account (remarketing lists, in-market, custom) with sizes and UET tag. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.
Bu araç parametre almaz.
list_microsoft_conversion_goals
Okuma1 krediConversion goals of the Microsoft Advertising account with type, status, tracking status, category, revenue settings. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.
Bu araç parametre almaz.
list_microsoft_uet_tags
Okuma1 krediUET (Universal Event Tracking) tags of the Microsoft Advertising account with tracking status and script. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.
Bu araç parametre almaz.
microsoft_search_terms_report
Okuma2 krediMicrosoft Advertising search terms (queries that triggered ads) with spend, clicks, conversions, keyword and match type for the last N days, plus the wasted (zero-conversion) terms. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
campaign_idİsteğe bağlı | string | — |
microsoft_performance_report
Okuma2 krediMicrosoft Advertising performance by campaign, ad group or device (spend, clicks, impressions, conversions, revenue, CTR, CPC, CPA, ROAS) with totals; compare_previous adds the prior period. Requires a connected Microsoft Advertising account; otherwise returns connected=false, never invented numbers.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
breakdownİsteğe bağlı | campaign | ad_group | device | — |
campaign_idİsteğe bağlı | string | — |
compare_previousİsteğe bağlı | boolean | also return the previous period of the same length |
Yazma araçları18 araç
select_microsoft_account
Yazma1 krediChoose which Microsoft Advertising ad account all further reads and writes use (manager/agency setups). Local setting; nothing is changed on Microsoft.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idZorunlu | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_campaign
Yazma2 krediCreate a Microsoft Advertising search campaign DRAFT with its ad groups, keywords and responsive search ad copy in one go (e.g. replicate a Google Ads structure). The whole structure is shown as a preview; after approval it is created PAUSED on Microsoft. Go live with update_microsoft_campaign_status(resume). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | daily budget in the account currency |
kindİsteğe bağlı | string | search (default) | local_search | sales | traffic |
goalİsteğe bağlı | string | — |
languageİsteğe bağlı | string | ad language, e.g. Turkish, English (default Turkish) |
bid_strategyİsteğe bağlı | manual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share | — |
target_cpaİsteğe bağlı | number | — |
target_roasİsteğe bağlı | number | — |
max_cpcİsteğe bağlı | number | — |
final_urlİsteğe bağlı | string | landing page for the ads; defaults to the brand website |
ad_groupsİsteğe bağlı | array<object> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_ad_group
Yazma2 krediAdd an ad group to an existing Microsoft Advertising campaign, optionally with keywords and a responsive search ad (headlines + descriptions + final_url). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
nameZorunlu | string | — |
cpc_bidİsteğe bağlı | number | — |
keywordsİsteğe bağlı | array<any> | — |
headlinesİsteğe bağlı | array<string> | — |
descriptionsİsteğe bağlı | array<string> | — |
final_urlİsteğe bağlı | string | — |
path1İsteğe bağlı | string | — |
path2İsteğe bağlı | string | — |
languageİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_keywords
Yazma2 krediAdd keywords (text, match type BROAD|PHRASE|EXACT, optional bid) to a Microsoft Advertising ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
campaign_idİsteğe bağlı | string | — |
keywordsZorunlu | array<any> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_negative_keywords
Yazma2 krediAdd negative keywords to a Microsoft Advertising campaign (or ad group). Microsoft supports PHRASE and EXACT negatives. Typical follow-up of microsoft_search_terms_report. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | — |
ad_group_idİsteğe bağlı | string | optional: ad-group-level negatives |
keywordsZorunlu | array<string> | — |
match_typeİsteğe bağlı | PHRASE | EXACT | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_responsive_search_ad
Yazma2 krediCreate a responsive search ad (3-15 headlines ≤30 chars, 2-4 descriptions ≤90 chars, landing URL) in a Microsoft Advertising ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
headlinesZorunlu | array<string> | — |
descriptionsZorunlu | array<string> | — |
final_urlZorunlu | string | — |
path1İsteğe bağlı | string | — |
path2İsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_campaign_budget
Yazma2 krediChange the daily budget of a Microsoft Advertising campaign. The preview shows old → new. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
amountZorunlu | number | new daily budget in the account currency |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_campaign_status
Yazma2 krediPause or resume a Microsoft Advertising campaign (resume also publishes a campaign created paused). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
statusZorunlu | pause | resume | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_ad_group_status
Yazma2 krediPause or enable a Microsoft Advertising ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
ad_group_idZorunlu | string | — |
statusZorunlu | pause | resume | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_keyword
Yazma2 krediChange a Microsoft Advertising keyword: bid, pause/resume, match type (keyword text cannot change). Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
keyword_idZorunlu | string | — |
bidİsteğe bağlı | number | — |
statusİsteğe bağlı | pause | resume | — |
match_typeİsteğe bağlı | BROAD | PHRASE | EXACT | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
set_microsoft_bid_strategy
Yazma2 krediSet the bid strategy of a Microsoft Advertising campaign: manual/enhanced CPC, maximize clicks/conversions (optional target CPA), maximize conversion value (optional target ROAS), target impression share. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
strategyZorunlu | manual_cpc | enhanced_cpc | max_clicks | max_conversions | target_cpa | max_conversion_value | target_roas | target_impression_share | — |
target_cpaİsteğe bağlı | number | — |
target_roasİsteğe bağlı | number | e.g. 4.0 for 400% |
max_cpcİsteğe bağlı | number | — |
target_impression_shareİsteğe bağlı | number | — |
target_ad_positionİsteğe bağlı | AbsoluteTopOfPage | TopOfPage | MainLine1 | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_location_target
Yazma2 krediTarget (or exclude) locations on a Microsoft Advertising campaign or ad group. Names are resolved to Microsoft location ids from the official geo file when the account is connected. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe campaign id or Microsoft campaign id (campaign level) |
ad_group_idİsteğe bağlı | string | Microsoft ad group id (ad group level overrides campaign level) |
locationsİsteğe bağlı | array<string> | city/region/country names, e.g. İstanbul, Ankara |
location_idsİsteğe bağlı | array<string> | Microsoft location ids if already known |
countryİsteğe bağlı | string | disambiguation hint, default Türkiye |
bid_adjustmentİsteğe bağlı | number | percent -100..900 |
excludeİsteğe bağlı | boolean | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_device_target
Yazma2 krediSet device bid adjustments (percent -100..900; -100 excludes) on a Microsoft Advertising campaign or ad group. Microsoft requires all three devices; missing ones are sent as 0. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe campaign id or Microsoft campaign id (campaign level) |
ad_group_idİsteğe bağlı | string | Microsoft ad group id (ad group level overrides campaign level) |
computersİsteğe bağlı | number | — |
smartphonesİsteğe bağlı | number | — |
tabletsİsteğe bağlı | number | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_demographic_target
Yazma2 krediSet age and gender bid adjustments (percent -100..900) on a Microsoft Advertising campaign or ad group. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe campaign id or Microsoft campaign id (campaign level) |
ad_group_idİsteğe bağlı | string | Microsoft ad group id (ad group level overrides campaign level) |
agesİsteğe bağlı | array<object> | — |
gendersİsteğe bağlı | array<object> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_ad_schedule
Yazma2 krediAdd an ad schedule (day/time slots with bid adjustment) to a Microsoft Advertising campaign or ad group; ads do not serve outside the slots. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe campaign id or Microsoft campaign id (campaign level) |
ad_group_idİsteğe bağlı | string | Microsoft ad group id (ad group level overrides campaign level) |
scheduleZorunlu | array<object> | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_remarketing_list
Yazma2 krediCreate a remarketing list (page visitors rule on the UET tag) in the Microsoft Advertising account. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
descriptionİsteğe bağlı | string | — |
url_containsZorunlu | string | visitors of pages whose URL matches |
operatorİsteğe bağlı | Contains | Equals | BeginsWith | EndsWith | DoesNotContain | — |
membership_durationİsteğe bağlı | integer | days 1-180, default 30 |
tag_idİsteğe bağlı | string | UET tag id; default first tag |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_conversion_goal
Yazma2 krediCreate a conversion goal (URL goal: thank-you page; event goal: custom UET event) in the Microsoft Advertising account. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
goal_typeİsteğe bağlı | url | event | — |
categoryİsteğe bağlı | Purchase | Signup | Contact | SubmitLeadForm | RequestQuote | BookAppointment | AddToCart | BeginCheckout | Subscribe | PageView | OutboundClick | GetDirections | Other | — |
url_expressionİsteğe bağlı | string | — |
url_operatorİsteğe bağlı | Contains | Equals | BeginsWith | RegularExpression | — |
actionİsteğe bağlı | string | — |
category_expressionİsteğe bağlı | string | — |
labelİsteğe bağlı | string | — |
valueİsteğe bağlı | number | — |
count_typeİsteğe bağlı | all | unique | — |
conversion_window_daysİsteğe bağlı | number | — |
revenue_valueİsteğe bağlı | number | — |
revenue_typeİsteğe bağlı | fixed | variable | — |
currencyİsteğe bağlı | string | — |
tag_idİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_uet_tag
Yazma2 krediCreate a UET tag; the result carries the tracking script to add to the website. Creates an approval item with a preview; applied to Microsoft only after approval and only with a connected account (dry run otherwise).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
descriptionİsteğe bağlı | string | — |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.