İçeriğe geç
Tecrübetecrube.com
Asistan araçları · Kurulum ve kampanya

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 kredi

Bağ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.

ParametreTipAçıklama
all_accessibleİsteğe bağlıbooleandefault true; false returns only the selected account

list_microsoft_ad_groups

Okuma1 kredi

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

ParametreTipAçıklama
campaign_idZorunlustring—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: manager account (customer) id of account_id

list_microsoft_audiences

Okuma1 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: manager account (customer) id of account_id

list_microsoft_conversion_goals

Okuma1 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: manager account (customer) id of account_id

list_microsoft_uet_tags

Okuma1 kredi

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

ParametreTipAçıklama
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: manager account (customer) id of account_id

microsoft_search_terms_report

Okuma2 kredi

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

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–90)—
campaign_idİsteğe bağlıstring—
start_dateİsteğe bağlıstringYYYY-MM-DD (overrides days)
end_dateİsteğe bağlıstringYYYY-MM-DD, default today
min_wasteİsteğe bağlınumberonly 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ıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: manager account (customer) id of account_id

microsoft_performance_report

Okuma2 kredi

Kampanya, 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.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
start_dateİsteğe bağlıstringYYYY-MM-DD (overrides days)
end_dateİsteğe bağlıstringYYYY-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ıbooleanaynı uzunluktaki önceki dönemi de döndürür
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: manager account (customer) id of account_id

list_microsoft_campaigns

Okuma1 kredi

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

ParametreTipAçıklama
statusİsteğe bağlıstringisteğe bağlı süzgeç: live | paused | ended (ya da Microsoft durumu)
account_idİsteğe bağlıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (customer) id'si

diagnose_microsoft_delivery

Okuma2 kredi

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

ParametreTipAçıklama
campaign_idZorunlustringMicrosoft kampanya id'si (list_microsoft_campaigns) ya da Tecrübe kampanya id'si
account_idİsteğe bağlıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (customer) id'si

list_microsoft_ads

Okuma1 kredi

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

ParametreTipAçıklama
ad_group_idZorunlustring—
account_idİsteğe bağlıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (customer) id'si

list_microsoft_keywords

Okuma1 kredi

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

ParametreTipAçıklama
ad_group_idZorunlustring—
account_idİsteğe bağlıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (customer) id'si

list_microsoft_negative_keywords

Okuma1 kredi

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

ParametreTipAçıklama
campaign_idİsteğe bağlıstring—
ad_group_idİsteğe bağlıstringreklam grubu düzeyi; campaign_id de gerekir
entity_idİsteğe bağlıstringtakma 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ıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (customer) id'si

list_microsoft_ad_extensions

Okuma1 kredi

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

ParametreTipAçıklama
campaign_idİsteğe bağlıstringisteğe bağlı; varsayılan hesaptaki tüm kampanyalar
account_idİsteğe bağlıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (customer) id'si

microsoft_entity_performance_report

Okuma2 kredi

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

ParametreTipAçı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ıstringYYYY-MM-DD (days değerini geçersiz kılar)
end_dateİsteğe bağlıstringYYYY-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ıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si

microsoft_report_query

Okuma2 kredi

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

ParametreTipAçıklama
report_typeZorunlustringReporting v13 raporu, ör. KeywordPerformanceReport, AdPerformanceReport, GeographicPerformanceReport
columnsZorunluarray<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ıstringYYYY-MM-DD (days değerini geçersiz kılar)
end_dateİsteğe bağlıstringYYYY-MM-DD, varsayılan bugün
limitİsteğe bağlıinteger (1–2000)—
account_idİsteğe bağlıstringisteğ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ıstringisteğe bağlı: account_id'nin yönetici hesap (müşteri) id'si

Yazma araçları27 araç

select_microsoft_account

Yazma1 kredi

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

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

Reklam 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ı).

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumberhesap para biriminde günlük bütçe
kindİsteğe bağlıstringsearch (varsayılan) | local_search | sales | traffic
goalİsteğe bağlıstring—
languageİsteğe bağlıstringreklam dili, ör. Turkish, English (varsayılan Turkish)
campaign_typeİsteğe bağlıSearchonly 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ıstringreklamların açılış sayfası; varsayılan olarak marka web sitesi
ad_groupsİsteğe bağlıarray<object>—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Mevcut 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ı).

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—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
ad_group_idZorunlustring—
campaign_idİsteğe bağlıstring—
keywordsZorunluarray<any>—
match_typeİsteğe bağlıBROAD | PHRASE | EXACTdefault for plain-text keywords (PHRASE)
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idİsteğe bağlıstring—
ad_group_idİsteğe bağlıstringisteğe bağlı: reklam grubu düzeyinde negatifler
keywordsZorunluarray<string>—
match_typeİsteğe bağlıPHRASE | EXACT—
entity_idİsteğe bağlıstringalias: campaign or ad group id, with entity_type
entity_typeİsteğe bağlıCampaign | AdGroup—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
ad_group_idZorunlustring—
headlinesZorunluarray<string>—
descriptionsZorunluarray<string>—
final_urlZorunlustring—
path1İsteğe bağlıstring—
path2İsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idZorunlustring—
amountİsteğe bağlınumberhesap para biriminde yeni günlük bütçe
daily_budgetİsteğe bağlınumberalias of amount
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idZorunlustring—
statusZorunlupause | resume | paused | active—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idZorunlustring—
ad_group_idZorunlustring—
statusZorunlupause | resume—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

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—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

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ı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ıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi)
ad_group_idİsteğe bağlıstringMicrosoft 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ıstringbelirsizliği gidermek için ipucu, varsayılan Türkiye
bid_adjustmentİsteğe bağlınumberyüzde -100..900
bid_multiplierİsteğe bağlınumberalias of bid_adjustment
excludeİsteğe bağlıboolean—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi)
ad_group_idİsteğe bağlıstringMicrosoft 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ıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi)
ad_group_idİsteğe bağlıstringMicrosoft 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 | gendersingle-criterion form
valueİsteğe bağlıstringsingle-criterion form: age range (e.g. 25-34) or gender
bid_multiplierİsteğe bağlınumbersingle-criterion form: percent -100..900
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si veya Microsoft kampanya id'si (kampanya düzeyi)
ad_group_idİsteğe bağlıstringMicrosoft 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ıanyshort 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ıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
nameZorunlustring—
descriptionİsteğe bağlıstring—
url_containsZorunlustringURL'si eşleşen sayfaların ziyaretçileri
operatorİsteğe bağlıContains | Equals | BeginsWith | EndsWith | DoesNotContain—
membership_durationİsteğe bağlıintegergün 1-180, varsayılan 30
tag_idİsteğe bağlıstringUET etiket id'si; varsayılan ilk etiket
uet_tag_idİsteğe bağlıstringalias of tag_id
valueİsteğe bağlıstringAlias of url_contains
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

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

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—
action_operatorİsteğe bağlıstringevent goals: Equals | BeginsWith | Contains | RegularExpression
category_expression_operatorİsteğe bağlıstringevent goals: Equals | BeginsWith | Contains | RegularExpression
label_operatorİsteğe bağlıstringevent goals: Equals | BeginsWith | Contains | RegularExpression
value_operatorİsteğe bağlıstringevent 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ıstringalias of tag_id
operatorİsteğe bağlıstringalias of url_operator
goal_categoryİsteğe bağlıstringalias of category
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

UET 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ı).

ParametreTipAçıklama
nameZorunlustring—
descriptionİsteğe bağlıstring—
account_idİsteğe bağlıstringoptional: run in this Microsoft ad account for this call only (agency setups)
customer_idİsteğe bağlıstringoptional: 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 kredi

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

ParametreTipAçıklama
campaign_idZorunlustring—
account_idİsteğe bağlıstringisteğ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ıstringisteğ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 kredi

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

ParametreTipAçıklama
audience_idZorunlustring—
account_idİsteğe bağlıstringisteğ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ıstringisteğ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 kredi

Tek 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ı).

ParametreTipAçıklama
ad_group_idZorunlustring—
ad_idZorunlustring—
statusZorunlupause | resume | paused | active—
ad_typeİsteğe bağlıResponsiveSearch | ExpandedText | Text | DynamicSearch | ResponsiveAd | Image | Product | AppInstall | Hotelvarsayılan ResponsiveSearch (bkz. list_microsoft_ads)
account_idİsteğe bağlıstringisteğ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ıstringisteğ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 kredi

Mevcut 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ı).

ParametreTipAçıklama
ad_group_idZorunlustring—
ad_idZorunlustring—
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ıstringisteğ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ıstringisteğ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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idZorunlustring—
ad_group_idZorunlustring—
nameİsteğe bağlıstring—
cpc_bidİsteğe bağlınumber—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-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ıstringisteğ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ıstringisteğ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 kredi

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

ParametreTipAçıklama
campaign_idZorunlustring—
sitelinksİsteğe bağlıarray<object>—
calloutsİsteğe bağlıarray<string>—
account_idİsteğe bağlıstringisteğ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ıstringisteğ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 kredi

Site 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ı).

ParametreTipAçıklama
extension_idsZorunluarray<string>—
campaign_idİsteğe bağlıstringönce bu kampanyadan ayır (isteğe bağlı)
account_idİsteğe bağlıstringisteğ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ıstringisteğ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 kredi

Bir 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ı).

ParametreTipAçıklama
campaign_idİsteğe bağlıstring—
ad_group_idİsteğe bağlıstringreklam grubu düzeyi; campaign_id de gerekir
keywordsZorunluarray<string>—
match_typeİsteğe bağlıPHRASE | EXACT—
entity_idİsteğe bağlıstringtakma 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ıstringisteğ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ıstringisteğ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ı).

ParametreTipAçıklama
conversion_nameZorunlustringhesaptaki bir çevrimdışı dönüşüm hedefinin adı
conversionsZorunluarray<object>—
currencyİsteğe bağlıstringpara birimi belirtilmeyen satırlar için varsayılan para birimi
account_idİsteğe bağlıstringisteğ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ıstringisteğ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.