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üğü metnin çevirisidir, araç ve parametre adları aynen kalır.
Okuma araçları16 araç
list_microsoft_accounts
Okuma1 krediBağlı kullanıcının erişebildiği Microsoft Advertising reklam hesapları (id, ad, numara, customer_id, para birimi, durum) ve hangisinin seçili olduğu. Yönetici/ajans kurulumlarında yazma işlemlerinden önce kullanılır. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
all_accessibleİsteğe bağlı | boolean | default true; false returns only the selected account |
list_microsoft_ad_groups
Okuma1 krediBir Microsoft Advertising kampanyasının reklam grupları (id, ad, durum, varsayılan CPC teklifi). Id'ler anahtar kelimeler, reklamlar ve reklam grubu düzeyinde hedefleme için kullanılır. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
list_microsoft_audiences
Okuma1 krediMicrosoft Advertising hesabındaki kitleler (yeniden pazarlama listeleri, pazar içi, özel) boyutları ve UET etiketiyle. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
list_microsoft_conversion_goals
Okuma1 krediMicrosoft Advertising hesabının dönüşüm hedefleri; tür, durum, izleme durumu, kategori ve gelir ayarlarıyla. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
list_microsoft_uet_tags
Okuma1 krediMicrosoft Advertising hesabının UET (Universal Event Tracking) etiketleri; izleme durumu ve betiğiyle. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
microsoft_search_terms_report
Okuma2 krediSon N güne ait harcama, tıklama, dönüşüm, anahtar kelime ve eşleme türü bilgileriyle Microsoft Advertising arama terimleri (reklamları tetikleyen sorgular) ve boşa giden (sıfır dönüşümlü) terimler. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
campaign_idİsteğe bağlı | string | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD (overrides days) |
end_dateİsteğe bağlı | string | YYYY-MM-DD, default today |
min_wasteİsteğe bağlı | number | only count zero-conversion terms spending at least this much as wasted |
limitİsteğe bağlı | integer (1–500) | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
microsoft_performance_report
Okuma2 krediKampanya, reklam grubu veya cihaza göre Microsoft Advertising performansı (harcama, tıklama, gösterim, dönüşüm, gelir, CTR, CPC, CPA, ROAS) ve toplamlar; compare_previous önceki dönemi ekler. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD (overrides days) |
end_dateİsteğe bağlı | string | YYYY-MM-DD, default today |
breakdownİsteğe bağlı | campaign | ad_group | device | — |
campaign_idİsteğe bağlı | string | — |
compare_previousİsteğe bağlı | boolean | aynı uzunluktaki önceki dönemi de döndürür |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
list_microsoft_campaigns
Okuma1 krediMicrosoft Advertising hesabından canlı okunan kampanyalar (id, ad, durum, tür, günlük bütçe, teklif). raw_status Microsoft'un kendi durumudur (Active, Paused, BudgetPaused, BudgetAndManualPaused, Suspended); bidding_settings, Microsoft döndürdüğünde stratejinin hedef EBM / hedef ROAS / azami TBM değerlerini taşır; budget_type ve shared_budget_id de gelir. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
statusİsteğe bağlı | string | isteğe bağlı süzgeç: live | paused | ended (ya da Microsoft durumu) |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
diagnose_microsoft_delivery
Okuma2 krediBir Microsoft Advertising kampanyasının CANLI yayın tanısı. Kullanıcı kampanyanın yayınlanmadığını, bütçe yüzünden durduğunu, askıya alındığını, sınırlı kaldığını ya da reddedildiğini bildirdiğinde ilk çağrılacak araçtır. Hesap durumunu, kampanyayı (durum, bütçe, hedef EBM / ROAS / azami TBM ile teklif stratejisi), reklam gruplarını (durum, tarihler, teklifler) ve reklamları (editoryal durum, Microsoft'un editoryal neden kodları ve itiraz durumu), son 14 günün değişiklik geçmişini ve Microsoft'un bütçe fırsatları ile önerilerini okur; bir bulgu listesi (kapsam, Microsoft'un kodu, kategori, kanıt) ve okunamayanlar için cannot_read döndürür. Salt okunur. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Microsoft kampanya id'si (list_microsoft_campaigns) ya da Tecrübe kampanya id'si |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
list_microsoft_ads
Okuma1 krediBir Microsoft Advertising reklam grubunun reklamları: tür, durum, editoryal durum, başlıklar, açıklamalar ve açılış URL'leri. Id'leri update_microsoft_ad_status / update_microsoft_responsive_search_ad için kullanın. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
list_microsoft_keywords
Okuma1 krediBir Microsoft Advertising reklam grubunun anahtar kelimeleri (id, metin, eşleme türü, durum, editoryal durum, teklif). Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
list_microsoft_negative_keywords
Okuma1 krediBir Microsoft Advertising kampanyasında ya da reklam grubunda şu an tanımlı negatif anahtar kelimeler — trafik düştüğünde ya da birini kaldırmadan önce buradan kontrol edin. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | — |
ad_group_idİsteğe bağlı | string | reklam grubu düzeyi; campaign_id de gerekir |
entity_idİsteğe bağlı | string | takma ad: entity_type ile birlikte kampanya ya da reklam grubu id'si |
entity_typeİsteğe bağlı | Campaign | AdGroup | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
list_microsoft_ad_extensions
Okuma1 krediMicrosoft Advertising kampanyalarına bağlı site bağlantısı ve açıklama metni uzantıları (id, metin, URL'ler, durum, editoryal durum). Yinelenmeyi önlemek için eklemeden önce kontrol edin; id'ler remove_microsoft_ad_extensions'a girer. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | isteğe bağlı; varsayılan hesaptaki tüm kampanyalar |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
microsoft_entity_performance_report
Okuma2 krediKampanya düzeyinin altında Microsoft Advertising performansı — reklam grubu, reklam, anahtar kelime (kalite puanıyla), konum, cihaz ya da yaş/cinsiyet bazında — harcama, tıklama, dönüşüm, gelir, TO, TBM, EBM, ROAS ve toplamlarla. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
levelİsteğe bağlı | ad_group | ad | keyword | location | device | age_gender | — |
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD (days değerini geçersiz kılar) |
end_dateİsteğe bağlı | string | YYYY-MM-DD, varsayılan bugün |
campaign_idİsteğe bağlı | string | — |
limitİsteğe bağlı | integer (1–500) | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
microsoft_location_search
Okuma1 krediadd_microsoft_location_target için Microsoft Advertising konum id'lerini ada göre (Microsoft'un resmi coğrafi dosyasından) tür ve tam görünen adla birlikte arar. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
queryZorunlu | string | — |
location_typeİsteğe bağlı | Country | State | City | MetroArea | County | PostalCode | — |
limitİsteğe bağlı | integer (1–50) | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
microsoft_report_query
Okuma2 krediMicrosoft Advertising Reporting API'nin (v13) serbest biçimli okuması: seçtiğiniz sütunlarla her rapor türü; satırlar Microsoft'un döndürdüğü gibi gelir. Sabit raporlarda ihtiyaç duyduğunuz kırılım yoksa kullanın. Bağlı bir Microsoft Advertising hesabı gerektirir; aksi halde uydurma sayılar değil connected=false döndürür.
| Parametre | Tip | Açıklama |
|---|---|---|
report_typeZorunlu | string | Reporting v13 raporu, ör. KeywordPerformanceReport, AdPerformanceReport, GeographicPerformanceReport |
columnsZorunlu | array<string> | o raporun sütun adları, ör. CampaignName, Clicks, Spend |
aggregationİsteğe bağlı | Summary | Hourly | Daily | Weekly | Monthly | Yearly | HourOfDay | DayOfWeek | WeeklyStartingMonday | — |
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD (days değerini geçersiz kılar) |
end_dateİsteğe bağlı | string | YYYY-MM-DD, varsayılan bugün |
limitİsteğe bağlı | integer (1–2000) | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
Yazma araçları27 araç
select_microsoft_account
Yazma1 krediSonraki tüm okuma ve yazma işlemlerinin hangi Microsoft Advertising reklam hesabını kullanacağını seçer (yönetici/ajans kurulumları). Yerel ayardır; Microsoft tarafında hiçbir şey değişmez.
| 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 krediReklam grupları, anahtar kelimeleri ve duyarlı arama reklamı metniyle birlikte tek seferde bir Microsoft Advertising arama kampanyası TASLAĞI oluşturur (ör. bir Google Ads yapısını kopyalamak için). Yapının tamamı önizleme olarak gösterilir; onaydan sonra Microsoft'ta DURAKLATILMIŞ olarak oluşturulur. Yayına almak için update_microsoft_campaign_status(resume) kullanılır. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | hesap para biriminde günlük bütçe |
kindİsteğe bağlı | string | search (varsayılan) | local_search | sales | traffic |
goalİsteğe bağlı | string | — |
languageİsteğe bağlı | string | reklam dili, ör. Turkish, English (varsayılan Turkish) |
campaign_typeİsteğe bağlı | Search | only Search is supported |
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 | reklamların açılış sayfası; varsayılan olarak marka web sitesi |
ad_groupsİsteğe bağlı | array<object> | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_ad_group
Yazma2 krediMevcut bir Microsoft Advertising kampanyasına, isteğe bağlı olarak anahtar kelimeler ve bir duyarlı arama reklamıyla (başlıklar + açıklamalar + final_url) birlikte reklam grubu ekler. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| 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 | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_keywords
Yazma2 krediBir Microsoft Advertising reklam grubuna anahtar kelimeler ekler (metin, eşleme türü BROAD|PHRASE|EXACT, isteğe bağlı teklif). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
campaign_idİsteğe bağlı | string | — |
keywordsZorunlu | array<any> | — |
match_typeİsteğe bağlı | BROAD | PHRASE | EXACT | default for plain-text keywords (PHRASE) |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_negative_keywords
Yazma2 krediBir Microsoft Advertising kampanyasına (veya reklam grubuna) negatif anahtar kelimeler ekler. Microsoft, PHRASE ve EXACT negatifleri destekler. microsoft_search_terms_report sonrasındaki tipik adımdır. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | — |
ad_group_idİsteğe bağlı | string | isteğe bağlı: reklam grubu düzeyinde negatifler |
keywordsZorunlu | array<string> | — |
match_typeİsteğe bağlı | PHRASE | EXACT | — |
entity_idİsteğe bağlı | string | alias: campaign or ad group id, with entity_type |
entity_typeİsteğe bağlı | Campaign | AdGroup | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
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 krediBir Microsoft Advertising reklam grubunda duyarlı arama reklamı oluşturur (3-15 başlık ≤30 karakter, 2-4 açıklama ≤90 karakter, açılış URL'si). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| 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 | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_campaign_budget
Yazma2 krediBir Microsoft Advertising kampanyasının günlük bütçesini değiştirir. Önizleme eski → yeni değeri gösterir. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
amountİsteğe bağlı | number | hesap para biriminde yeni günlük bütçe |
daily_budgetİsteğe bağlı | number | alias of amount |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_campaign_status
Yazma2 krediBir Microsoft Advertising kampanyasını duraklatır veya sürdürür (resume, duraklatılmış oluşturulan bir kampanyayı da yayınlar). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
statusZorunlu | pause | resume | paused | active | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
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 krediBir Microsoft Advertising reklam grubunu duraklatır veya etkinleştirir. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
ad_group_idZorunlu | string | — |
statusZorunlu | pause | resume | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_keyword
Yazma2 krediBir Microsoft Advertising anahtar kelimesini değiştirir: teklif, duraklatma/sürdürme, eşleme türü (anahtar kelime metni değiştirilemez). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| 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 | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
set_microsoft_bid_strategy
Yazma2 krediBir Microsoft Advertising kampanyasının teklif stratejisini belirler: manuel/geliştirilmiş CPC, tıklama/dönüşüm maksimizasyonu (isteğe bağlı hedef CPA), dönüşüm değeri maksimizasyonu (isteğe bağlı hedef ROAS), hedef gösterim payı. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| 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 | ör. %400 için 4.0 |
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 | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_location_target
Yazma2 krediBir Microsoft Advertising kampanyasında veya reklam grubunda konumları hedefler (veya hariç tutar). Hesap bağlıyken adlar resmi coğrafi dosyadan Microsoft konum id'lerine çözümlenir. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi) |
ad_group_idİsteğe bağlı | string | Microsoft reklam grubu id'si (reklam grubu düzeyi kampanya düzeyini geçersiz kılar) |
locationsİsteğe bağlı | array<string> | şehir/bölge/ülke adları, ör. İstanbul, Ankara |
location_idsİsteğe bağlı | array<string> | zaten biliniyorsa Microsoft konum id'leri |
countryİsteğe bağlı | string | belirsizliği gidermek için ipucu, varsayılan Türkiye |
bid_adjustmentİsteğe bağlı | number | yüzde -100..900 |
bid_multiplierİsteğe bağlı | number | alias of bid_adjustment |
excludeİsteğe bağlı | boolean | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_device_target
Yazma2 krediBir Microsoft Advertising kampanyasında veya reklam grubunda cihaz teklif ayarlamaları belirler (yüzde -100..900; -100 hariç tutar). Microsoft üç cihazın da verilmesini ister; eksik olanlar 0 olarak gönderilir. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi) |
ad_group_idİsteğe bağlı | string | Microsoft reklam grubu id'si (reklam grubu düzeyi kampanya düzeyini geçersiz kılar) |
computersİsteğe bağlı | number | — |
smartphonesİsteğe bağlı | number | — |
tabletsİsteğe bağlı | number | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_demographic_target
Yazma2 krediBir Microsoft Advertising kampanyasında veya reklam grubunda yaş ve cinsiyet teklif ayarlamaları belirler (yüzde -100..900). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi) |
ad_group_idİsteğe bağlı | string | Microsoft reklam grubu id'si (reklam grubu düzeyi kampanya düzeyini geçersiz kılar) |
agesİsteğe bağlı | array<object> | — |
gendersİsteğe bağlı | array<object> | — |
criterion_typeİsteğe bağlı | age | gender | single-criterion form |
valueİsteğe bağlı | string | single-criterion form: age range (e.g. 25-34) or gender |
bid_multiplierİsteğe bağlı | number | single-criterion form: percent -100..900 |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_ad_schedule
Yazma2 krediBir Microsoft Advertising kampanyasına veya reklam grubuna reklam programı ekler (teklif ayarlamalı gün/saat dilimleri); reklamlar dilimlerin dışında yayınlanmaz. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi) |
ad_group_idİsteğe bağlı | string | Microsoft reklam grubu id'si (reklam grubu düzeyi kampanya düzeyini geçersiz kılar) |
scheduleİsteğe bağlı | array<object> | — |
daysİsteğe bağlı | any | short form (instead of schedule): weekdays | weekend | all or a list of day names |
from_hourİsteğe bağlı | integer | — |
to_hourİsteğe bağlı | integer | — |
bid_adjustmentİsteğe bağlı | number | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_remarketing_list
Yazma2 krediMicrosoft Advertising hesabında yeniden pazarlama listesi oluşturur (UET etiketi üzerinde sayfa ziyaretçisi kuralı). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
descriptionİsteğe bağlı | string | — |
url_containsZorunlu | string | URL'si eşleşen sayfaların ziyaretçileri |
operatorİsteğe bağlı | Contains | Equals | BeginsWith | EndsWith | DoesNotContain | — |
membership_durationİsteğe bağlı | integer | gün 1-180, varsayılan 30 |
tag_idİsteğe bağlı | string | UET etiket id'si; varsayılan ilk etiket |
uet_tag_idİsteğe bağlı | string | alias of tag_id |
valueİsteğe bağlı | string | Alias of url_contains |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_conversion_goal
Yazma2 krediMicrosoft Advertising hesabında dönüşüm hedefi oluşturur (URL hedefi: teşekkür sayfası; olay hedefi: özel UET olayı). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| 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 | — |
action_operatorİsteğe bağlı | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
category_expression_operatorİsteğe bağlı | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
label_operatorİsteğe bağlı | string | event goals: Equals | BeginsWith | Contains | RegularExpression |
value_operatorİsteğe bağlı | string | event goals: Equals | GreaterThan | LessThan |
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 | — |
uet_tag_idİsteğe bağlı | string | alias of tag_id |
operatorİsteğe bağlı | string | alias of url_operator |
goal_categoryİsteğe bağlı | string | alias of category |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
create_microsoft_uet_tag
Yazma2 krediUET etiketi oluşturur; sonuç, web sitesine eklenecek izleme betiğini içerir. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
descriptionİsteğe bağlı | string | — |
account_idİsteğe bağlı | string | optional: run in this Microsoft ad account for this call only (agency setups) |
customer_idİsteğe bağlı | string | optional: manager account (customer) id of account_id |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_microsoft_campaign
YazmaGeri alınamaz2 krediBir Microsoft Advertising kampanyasını KALICI olarak siler (geri alınamaz; emin değilseniz duraklatın). Onay politikası ne olursa olsun her zaman kullanıcının açık onayını bekler. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
delete_microsoft_audience
YazmaGeri alınamaz2 krediBir Microsoft Advertising kitlesini (ör. yeniden pazarlama listesi) KALICI olarak siler. Her zaman kullanıcının açık onayını bekler. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).
| Parametre | Tip | Açıklama |
|---|---|---|
audience_idZorunlu | string | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_ad_status
Yazma2 krediTek bir Microsoft Advertising reklamını duraklatır ya da etkinleştirir. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
ad_idZorunlu | string | — |
statusZorunlu | pause | resume | paused | active | — |
ad_typeİsteğe bağlı | ResponsiveSearch | ExpandedText | Text | DynamicSearch | ResponsiveAd | Image | Product | AppInstall | Hotel | varsayılan ResponsiveSearch (bkz. list_microsoft_ads) |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_responsive_search_ad
Yazma2 krediMevcut bir Microsoft Advertising duyarlı arama reklamının metnini yerinde değiştirir (yeniden oluşturmanın aksine reklam id'sini ve performans geçmişini korur). Verilen listeler mevcut olanların yerini alır. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
ad_idZorunlu | string | — |
headlinesİsteğe bağlı | array<string> | tam yeni set, 3-15 adet, ≤30 karakter |
descriptionsİsteğe bağlı | array<string> | tam yeni set, 2-4 adet, ≤90 karakter |
final_urlİsteğe bağlı | string | — |
path1İsteğe bağlı | string | — |
path2İsteğe bağlı | string | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
update_microsoft_ad_group
Yazma2 krediBir Microsoft Advertising reklam grubunu düzenler: ad, varsayılan TBM teklifi, başlangıç/bitiş tarihi, durum, arama ağı. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
ad_group_idZorunlu | string | — |
nameİsteğe bağlı | string | — |
cpc_bidİsteğe bağlı | number | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
statusİsteğe bağlı | pause | resume | paused | active | — |
networkİsteğe bağlı | all | microsoft_only | syndicated_only | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
add_microsoft_ad_extensions
Yazma2 krediBir Microsoft Advertising kampanyasına site bağlantısı ve/veya açıklama metni uzantıları ekler (hesap kitaplığında oluşturulur, sonra kampanyaya bağlanır). Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | — |
sitelinksİsteğe bağlı | array<object> | — |
calloutsİsteğe bağlı | array<string> | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştırır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (customer) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
remove_microsoft_ad_extensions
YazmaGeri alınamaz2 krediSite bağlantısı/açıklama metni uzantılarını kaldırır: kampanyadan ayırır ve hesap kütüphanesinden siler (kalıcıdır; tüm kampanyalardan düşerler). Her zaman kullanıcının açık onayını bekler. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
extension_idsZorunlu | array<string> | — |
campaign_idİsteğe bağlı | string | önce bu kampanyadan ayır (isteğe bağlı) |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
remove_microsoft_negative_keywords
YazmaGeri alınamaz2 krediBir Microsoft Advertising kampanyasından ya da reklam grubundan negatif anahtar kelimeleri (metne göre, isteğe bağlı tek eşleme türüyle) kaldırır — ör. iyi trafiği engelleyen bir negatifi geri almak için. Yalnızca gerçekten var olan negatifler kaldırılır. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | — |
ad_group_idİsteğe bağlı | string | reklam grubu düzeyi; campaign_id de gerekir |
keywordsZorunlu | array<string> | — |
match_typeİsteğe bağlı | PHRASE | EXACT | — |
entity_idİsteğe bağlı | string | takma ad: entity_type ile birlikte kampanya ya da reklam grubu id'si |
entity_typeİsteğe bağlı | Campaign | AdGroup | — |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.
upload_microsoft_offline_conversions
Yazma2 krediÇevrimdışı dönüşümleri (ör. CRM satışları) tıklama id'sine göre Microsoft Advertising'e gönderir; böylece teklif sistemi gerçek sonuçlardan öğrenir. Çağrı başına en fazla 1000 satır; hedef mevcut olmalı ve tıklamalar 90 günden eski olmamalı. Önizlemeli bir onay öğesi oluşturur; Microsoft'a yalnızca onaydan sonra ve yalnızca bağlı bir hesapla uygulanır (aksi halde deneme çalıştırması).
| Parametre | Tip | Açıklama |
|---|---|---|
conversion_nameZorunlu | string | hesaptaki bir çevrimdışı dönüşüm hedefinin adı |
conversionsZorunlu | array<object> | — |
currencyİsteğe bağlı | string | para birimi belirtilmeyen satırlar için varsayılan para birimi |
account_idİsteğe bağlı | string | isteğe bağlı: yalnızca bu çağrı için bu Microsoft reklam hesabında çalıştır (ajans kurulumları) |
customer_idİsteğe bağlı | string | isteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si |
Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.