Tecrübetecrube.com
Araç referansı — Reklam

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 kredi

Microsoft 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 kredi

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

ParametreTipAçıklama
campaign_idZorunlustring—

list_microsoft_audiences

Okuma1 kredi

Audiences 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 kredi

Conversion 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 kredi

UET (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 kredi

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

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–90)—
campaign_idİsteğe bağlıstring—

microsoft_performance_report

Okuma2 kredi

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

ParametreTipAçı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ıbooleanalso return the previous period of the same length

Yazma araçları18 araç

select_microsoft_account

Yazma1 kredi

Choose which Microsoft Advertising ad account all further reads and writes use (manager/agency setups). Local setting; nothing is changed on Microsoft.

ParametreTipAçıklama
account_idZorunlustring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_microsoft_campaign

Yazma2 kredi

Create 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).

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumberdaily budget in the account currency
kindİsteğe bağlıstringsearch (default) | local_search | sales | traffic
goalİsteğe bağlıstring—
languageİsteğe bağlıstringad 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ıstringlanding 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 kredi

Add 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).

ParametreTipAçıklama
campaign_idZorunlustring—
nameZorunlustring—
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 kredi

Add 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).

ParametreTipAçıklama
ad_group_idZorunlustring—
campaign_idİsteğe bağlıstring—
keywordsZorunluarray<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 kredi

Add 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).

ParametreTipAçıklama
campaign_idİsteğe bağlıstring—
ad_group_idİsteğe bağlıstringoptional: ad-group-level negatives
keywordsZorunluarray<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 kredi

Create 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).

ParametreTipAçıklama
ad_group_idZorunlustring—
headlinesZorunluarray<string>—
descriptionsZorunluarray<string>—
final_urlZorunlustring—
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 kredi

Change 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).

ParametreTipAçıklama
campaign_idZorunlustring—
amountZorunlunumbernew 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 kredi

Pause 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).

ParametreTipAçıklama
campaign_idZorunlustring—
statusZorunlupause | 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 kredi

Pause 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).

ParametreTipAçıklama
campaign_idZorunlustring—
ad_group_idZorunlustring—
statusZorunlupause | resume—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_microsoft_keyword

Yazma2 kredi

Change 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).

ParametreTipAçıklama
ad_group_idZorunlustring—
keyword_idZorunlustring—
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 kredi

Set 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).

ParametreTipAçıklama
campaign_idZorunlustring—
strategyZorunlumanual_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ınumbere.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 kredi

Target (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).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe campaign id or Microsoft campaign id (campaign level)
ad_group_idİsteğe bağlıstringMicrosoft 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ıstringdisambiguation hint, default Türkiye
bid_adjustmentİsteğe bağlınumberpercent -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 kredi

Set 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).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe campaign id or Microsoft campaign id (campaign level)
ad_group_idİsteğe bağlıstringMicrosoft 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 kredi

Set 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).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe campaign id or Microsoft campaign id (campaign level)
ad_group_idİsteğe bağlıstringMicrosoft 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 kredi

Add 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).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe campaign id or Microsoft campaign id (campaign level)
ad_group_idİsteğe bağlıstringMicrosoft ad group id (ad group level overrides campaign level)
scheduleZorunluarray<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 kredi

Create 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).

ParametreTipAçıklama
nameZorunlustring—
descriptionİsteğe bağlıstring—
url_containsZorunlustringvisitors of pages whose URL matches
operatorİsteğe bağlıContains | Equals | BeginsWith | EndsWith | DoesNotContain—
membership_durationİsteğe bağlıintegerdays 1-180, default 30
tag_idİsteğe bağlıstringUET 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 kredi

Create 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).

ParametreTipAçıklama
nameZorunlustring—
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 kredi

Create 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).

ParametreTipAçıklama
nameZorunlustring—
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.