Kampanya Verileri Nesnesi - Kampanya Yönetimi
Kampanyayı tanımlar.
Not
Artık yalnızca dinamik arama reklamlarını destekleyen kampanyalar ekleyemez, güncelleştiremez veya alamazsınız. Mevcut kampanyalarınızın kampanya türü "DynamicSearchAds" olan "Search" olarak güncelleştirildi. Reklam grupları artık "dinamik" reklam grupları olarak kabul edilir, ancak yapısal bir değişiklik yoktur; bunlar daha önce olduğu gibi aynı otomatik hedefleri ve dinamik arama reklamlarını içerir.
Not
Nisan 2021 itibarıyla el ile CPC teklif stratejisi yalnızca kitle kampanyaları ve Konaklama kampanyaları (eski adıyla Otel kampanyaları) ile kullanılabilir. Başka bir kampanya türü için el ile CPC ayarlamaya çalışırsanız istek hatasız olarak yoksayılır ve teklif stratejisi gelişmiş CPC olarak ayarlanır.
Nisan 2021 itibarıyla reklam grupları veya anahtar sözcükler için herhangi bir teklif stratejisi ayarlayamazsınız. Teklif stratejileri yalnızca kampanya düzeyinde ayarlanabilir. Reklam grupları veya anahtar sözcükler için teklif stratejileri ayarlamaya çalışırsanız istek hatasız olarak yoksayılır. Reklam grupları ve anahtar sözcükler, kampanyalarının teklif stratejisini devralır.
Sözdizimi
<xs:complexType name="Campaign" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
<xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
<xs:element minOccurs="0" name="BudgetType" nillable="true" type="tns:BudgetLimitType" />
<xs:element minOccurs="0" name="DailyBudget" nillable="true" type="xs:double" />
<xs:element xmlns:q8="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="DealIds" nillable="true" type="q8:ArrayOflong">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="ExperimentId" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q9="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q9:ArrayOfKeyValuePairOfstringstring" />
<xs:element xmlns:q10="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="GoalIds" nillable="true" type="q10:ArrayOflong">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
<xs:element minOccurs="0" name="IsDealCampaign" nillable="true" type="xs:boolean">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="MultimediaAdsBidAdjustment" nillable="true" type="xs:int">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="Status" nillable="true" type="tns:CampaignStatus" />
<xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
<xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
<xs:element minOccurs="0" name="CampaignType" nillable="true" type="tns:CampaignType" />
<xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
<xs:element minOccurs="0" name="BudgetId" nillable="true" type="xs:long" />
<xs:element xmlns:q11="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Languages" nillable="true" type="q11:ArrayOfstring" />
<xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" nillable="true" type="xs:boolean">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
<xs:element minOccurs="0" name="BidStrategyId" nillable="true" type="xs:long">
<xs:annotation>
<xs:appinfo>
<DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
</xs:appinfo>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
Öğe
Campaign nesnesi şu öğelere sahiptir: AdScheduleUseSearcherTimeZone, AudienceAdsBidAdjustment, BiddingScheme, BidStrategyId, BudgetId, BudgetType, CampaignType, DailyBudget, DealIds, ExperimentId, FinalUrlSuffix, ForwardCompatibilityMap, GoalIds, Id, IsDealCampaign, Languages, MultimediaAdsBidAdjustment, Name, Settings, Status, SubType, TimeZone, TrackingUrlTemplate, UrlCustomParameters.
Öğe | Açıklama | Veri Türü |
---|---|---|
AdScheduleUseSearcherTimeZone | Hesap saat diliminin mi yoksa reklamların gönderilebileceği arama kullanıcısının saat diliminin mi kullanılacağını belirler. Reklamların arama kullanıcısının saat diliminde gösterilmesini istiyorsanız bu özelliği true olarak ayarlayın ve aksi takdirde false olarak ayarlayın. Bu öğe varsayılan olarak döndürülmedi. Bu öğeyi almak için GetCampaignsByAccountId ve GetCampaignsByIds hizmet işlemlerini çağırdığınızda ReturnAdditionalFields öğesine AdScheduleUseSearcherTimeZone değerini ekleyin. Eklemek: Opsiyonel. Bu öğeyi belirtmezseniz veya boş bırakırsanız varsayılan false değeri ayarlanır ve hesap saat dilimi kullanılır. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
Boolean |
AudienceAdsBidAdjustment | Hedef kitle reklamları için teklifinizi temel reklam grubunun veya anahtar sözcük teklifinin üzerinde veya altında ayarlayabileceğiniz yüzde tutarı. Bu özellik, müşteri Microsoft Audience Network için etkinleştirildiyse Arama kampanyalarında kullanılabilir. Bu tesis akıllı alışveriş kampanyalarıyla kullanılamaz. Desteklenen değerler negatif yüz (-100) ile pozitif dokuz yüz (900) arasındadır. Teklif ayarlamasının -100 olarak ayarlanması, bu kampanya için hedef kitle reklamlarının gösterilmesini engeller. Hedef kitle reklamları için herhangi bir teklif ayarlaması belirtmek yerine temel reklam grubunu veya anahtar sözcük teklifini kullanmak istiyorsanız bu öğeyi sıfır (0) olarak ayarlayın. En iyi yöntem olarak her zaman bir teklif ayarlama değeri belirtmeniz gerekir. Bu öğeyi null olarak ayarlarsanız sistem varsayılan teklif ayarlaması kullanılır. Sistem varsayılan teklif ayarlaması şu anda sıfırdır (0) ve değiştirilebilir. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
Int |
BiddingScheme | Tekliflerinizi nasıl yönetmek istediğinize ilişkin teklif stratejisi türü. Kampanya türü başına desteklenen teklif stratejileri hakkında ayrıntılı bilgi için bkz. Bütçe ve Teklif Stratejileri. ÖNEMLİ: Bazı teklif stratejisi türleri için teklif ve reklam döndürme ayarlarınız yoksayılır ve dönüşüm izleme ( Evrensel Olay İzleme etiketi ve dönüştürme hedefi aracılığıyla) gerekir. Desteklenen konumlar da dahil olmak üzere daha fazla bilgi için bkz. Teklif stratejileriyle tekliflerinizi Microsoft Advertising'in yönetmesine izin verme. Kampanya MaxConversionValueBiddingScheme veya TargetImpressionShareBiddingScheme teklif stratejisini kullanıyorsa, bu öğe varsayılan olarak sıfır veya boş olur. MaxConversionValueBiddingScheme veya TargetImpressionShareBiddingScheme nesnelerini almak için, GetCampaignsByAccountId ve GetCampaignsByIds hizmet işlemlerini çağırdığınızda ReturnAdditionalFields öğesine ilgili MaxConversionValueBiddingScheme ve TargetImpressionShareBiddingScheme değerlerini ekleyin. Eklemek: Opsiyonel. Search ve DynamicSearchAds kampanyaları için varsayılan teklif stratejisi türü EnhancedCpcBiddingScheme'dir. Çoğu Alışveriş kampanyası için varsayılan teklif stratejisi türü EnhancedCpcBiddingScheme'dir; ancak akıllı alışveriş kampanyaları için desteklenen tek teklif stratejisi türleri MaxConversionsBiddingScheme ve MaxConversionValueBiddingScheme'dır. İzleyici kampanyaları için desteklenen teklif stratejisi türleri EnhancedCpcBiddingScheme, ManualCpcBiddingScheme, ManualCpmBiddingScheme ve TargetCpaBiddingScheme'dır. Konaklama kampanyaları için desteklenen teklif stratejisi türleri CommissionBiddingScheme, ManualCpcBiddingScheme ve PercentCpcBiddingScheme'dir. En Yüksek Performans kampanyaları için desteklenen teklif stratejileri MaxConversionsBiddingScheme (isteğe bağlı TCPA ile) ve MaxConversionValueBiddingScheme (isteğe bağlı TROAS ile). Yeni Video kampanyaları için desteklenen teklif stratejileri ManualCpmBiddingScheme ve ManualCpvBiddingScheme'dır. NOT: Mayıs 2024 itibarıyla hedef kitleye özel kampanyalar için el ile CPC teklif stratejisini kullanamazsınız. El ile CPC'yi yalnızca izleyici görüntüleme ve video kampanyaları ve konaklama kampanyaları için kullanabilirsiniz. Mevcut tüm el ile CPC hedef kitlesi yerel kampanyalarını otomatik olarak geliştirilmiş CPC'ye dönüştüreceğiz. Başka bir kampanya türü için el ile CPC ayarlamaya çalışırsanız istek hatasız olarak yoksayılır ve teklif stratejisi gelişmiş CPC olarak ayarlanır. Nisan 2021 itibarıyla reklam grupları veya anahtar sözcükler için herhangi bir teklif stratejisi ayarlayamazsınız. Teklif stratejileri yalnızca kampanya düzeyinde ayarlanabilir. Reklam grupları veya anahtar sözcükler için teklif stratejileri ayarlamaya çalışırsanız istek hatasız olarak yoksayılır. Reklam grupları ve anahtar sözcükler, kampanyalarının teklif stratejisini devralır. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
BiddingScheme |
BidStrategyId | Bu kampanyanın hesaptaki diğer kampanyalarla paylaştığı BidStrategy'nin sistem tarafından oluşturulan tanımlayıcısı. Alan boşsa, kampanya portföy teklifi stratejisi kullanmıyor demektir. Alan boş değilse ve değer sıfırdan büyükse, kampanya bir portföy teklifi stratejisi kullanıyor demektir. Kampanya bir portföy teklifi stratejisi kullanıyorsa ve kendi teklif stratejisini kullanmasını tercih ediyorsanız, bu alanı '0' (sıfır) olarak ayarlayın. Not: Portföy teklifi stratejileri akıllı alışveriş kampanyaları veya Performans Maksimum kampanyaları ile desteklenmez. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
uzun |
BudgetId | Bu kampanyanın hesaptaki diğer kampanyalarla paylaştığı Bütçe'nin benzersiz Microsoft Advertising tanımlayıcısı. Değer null değilse ve sıfırdan büyükse, kampanya paylaşılan bir bütçe kullanıyor demektir. Değer null ise, kampanya paylaşılan bütçe kullanmıyor demektir. Kampanya paylaşılan bütçe kullanıyorsa ve kendi bütçesini kullanmasını tercih ediyorsanız (örneğin , DailyBudget tutarı), bu öğeyi '0' (sıfır) olarak ayarlayın ve DailyBudget değerini geçerli bir bütçe tutarına ayarlayın. Not: Paylaşılan bütçeler akıllı alışveriş kampanyaları veya Performans Maksimum kampanyaları ile desteklenmez. Akıllı alışveriş kampanyaları ile DailyBudget tutarını ayarlamanız gerekir. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
uzun |
BudgetType | Bütçenin nasıl harcandığını bütçe türü belirler. Olası değerler DailyBudgetAccelerated ve DailyBudgetStandard'dır. DailyBudgetAccelerated bütçe türü yalnızca paylaşılmayan kampanya düzeyinde bütçeler kullanan hedef kitle kampanyalarında kullanılabilir. Paylaşılan bütçeler bağlamında bütçe türü, kampanyanın paylaşılan bütçe kullanıp kullanmadığına bakılmaksızın her zaman döndürülen salt okunur bir özelliktir. Kampanyanın paylaşılan bütçe kullanıp kullanmadığını belirlemek için yukarıda açıklandığı gibi BudgetId öğesinin değerini denetleyin. Deneme kampanyalarında Bütçe, Bütçe Türü veya Durum ayarlayamazsınız. Deneme kampanyasının bütçesi ve durumu her zaman temel kampanya ayarlarından devralınır. Eklemek:BudgetId ayarlanmadıysa gereklidir. Kampanya paylaşılan bütçe kullanıyorsa salt okunur. Güncelleştirmek:BudgetId ayarlanmadıysa isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Kampanya paylaşılan bütçe kullanıyorsa izin verilmez. Paylaşılan bütçesi olan bir kampanyanın bütçe türünü güncelleştirmeye çalışırsanız, hizmet CampaignServiceCannotUpdateSharedBudget hata kodunu döndürür. |
BudgetLimitType |
CampaignType | Kampanya türü, kampanyanın Hedef Kitle, Dinamik Arama Reklamları, Arama, Alışveriş kampanyası, Otel Reklamları veya Performance Max olup olmadığını belirler. Eklemek: Opsiyonel. Belirtilmezse, Varsayılan Arama değeri kullanılır. Güncelleştirmek: İzin verilmiyor. |
CampaignType |
DailyBudget | Kampanyaya günlük harcama tutarı. BudgetId ayarlanmadıysa günlük bütçe tutarını ayarlamanız gerekir. Bütçeniz bir hedeftir; gerçek harcamanız daha yüksek veya daha düşük olabilir. Varyasyonlar, haftanın farklı günlerindeki farklı trafik hacimleri veya tıklamadan sonraki birkaç saat içinde kampanyaya para verebilen sahtekarlık tıklamalarının otomatik olarak algılanması ve para iadesi gibi çeşitli faktörlerden kaynaklanmaktadır. Microsoft Advertising dalgalanmaları tahmin eder ve otomatik olarak telafi eder ve genellikle günlük sınırınızın %100'den daha az bir bölümüne fazla ödeme yapmaya devam eder. Ayrıca Microsoft Advertising'in kampanya bütçenizin reklam grubundan ve anahtar sözcük tekliflerinden yüksek olmasını gerektirmediğini unutmayın. Başka bir deyişle reklam grubu ve anahtar sözcük teklifleri kampanya bütçelerinden bağımsız olarak doğrulanır. Paylaşılan bütçeler bağlamında bütçe tutarı, kampanyanın paylaşılan bütçe kullanıp kullanmadığına bakılmaksızın her zaman döndürülen salt okunur bir özelliktir. Bir kampanya paylaşılan bütçeyle ilişkilendirildiğinde, döndürülen tutar paylaşılan bütçenin tutarıdır. Kampanyanın paylaşılan bütçe kullanıp kullanmadığını belirlemek için yukarıda açıklandığı gibi BudgetId öğesinin değerini denetleyin. Deneme kampanyalarında Bütçe, Bütçe Türü veya Durum ayarlayamazsınız. Deneme kampanyasının bütçesi ve durumu her zaman temel kampanya ayarlarından devralınır. Eklemek:BudgetId ayarlanmadıysa gereklidir. Kampanya paylaşılan bütçe kullanıyorsa salt okunur. Güncelleştirmek:BudgetId ayarlanmadıysa isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Kampanya paylaşılan bütçe kullanıyorsa izin verilmez. Paylaşılan bütçesi olan bir kampanyanın bütçe miktarını güncelleştirmeye çalışırsanız, hizmet CampaignServiceCannotUpdateSharedBudget hata kodunu döndürür. |
çift |
DealId'ler | Eklenen anlaşmalara karşılık gelen benzersiz sistem tanımlayıcılarının listesi. Tanımlayıcı listesi doğrudan istekteki anlaşma listesine karşılık gelir. Listedeki öğeler null olarak döndürülebilir. Bir anlaşmanın eklenmediği her liste dizini için karşılık gelen öğe null olur. |
uzun dizi |
ExperimentId |
Denemenin sistem tarafından oluşturulan tanımlayıcısı. Bu öğe yalnızca başka bir Arama kampanyasına göre A/B testi için oluşturulmuş olan deneme kampanyaları için ayarlanır. Temel kampanyalar deneme kimliği içermez. Benzer şekilde, bir deneme bağımsız bir kampanyaya mezun olduktan sonra, kampanya daha önce bir deneme kampanyası olsa bile bu öğe boş kalır. Deneme kampanyalarında Bütçe, Bütçe Türü veya Durum ayarlayamazsınız. Deneme kampanyasının bütçesi ve durumu her zaman temel kampanya ayarlarından devralınır. Bir denemenin bütçesini değiştirmek istiyorsanız, temel kampanyanın bütçesini değiştirmeniz gerekir. Daha sonra değerdeki değişiklik, deneme TrafficSplitPercent ayarınıza göre bölünür. Eklemek: Salt okunur Güncelleştirmek: Salt okunur |
uzun |
FinalUrlSuffix | Son URL soneki, giriş sayfası URL'nizin sonuna eklenecek izleme parametrelerini içerebilir. Müşterilerinizin her zaman giriş sayfanıza gönderilmesi için giriş sayfanızın gerektirdiği izleme parametrelerini son URL son ekine yerleştirmenizi öneririz. Daha fazla ayrıntı ve doğrulama kuralları için teknik kılavuzlardaki Son URL Son Eki'ne bakın. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu öğeyi boş bir dize (""" olarak ayarlarsanız, önceki ayar silinir. |
dize |
İletme Uyumluluğu Haritası | Geçerli API sürümüne yeni öğeler eklendiğinde başka değişikliklerden kaçınmak için ileriye dönük uyumluluk için anahtar ve değer dizelerinin listesi. İleriye dönük uyumluluk değişiklikleri gelecek sürümlerde burada not alınacaktır. Şu anda bu nesne için ileriye dönük uyumluluk değişikliği yok. |
KeyValuePairOfstringstring dizisi |
GoalId'ler | Hedef kimliklerinin listesi. | uzun dizi |
Kimliği | Kampanyanın benzersiz Microsoft Advertising tanımlayıcısı. Eklemek: Salt okunur Güncelleştirmek: Gerekli |
uzun |
IsDealCampaign | Kampanya , doğruysa bir anlaşma kampanyasıdır. | Boolean |
Diller |
Reklam dili ayarınız, reklamlarınızı yazarken kullanacağınız dili belirler ve müşterilerinizin dili olmalıdır. ÖNEMLİ: Diller hem reklam grubu hem de kampanya düzeyinde ayarlanırsa, reklam grubu düzeyi dili kampanya düzeyi dilini geçersiz kılar. Listede tek tek birden çok dil belirtebilir veya tüm dilleri hedeflemek istiyorsanız tümü olarak ayarlanmış yalnızca bir liste öğesi ekleyebilirsiniz. Arama ve Alışveriş kampanyaları için desteklenen dil dizeleri şunlardır: Arnavut, Bulgarca, Hırvatçe, Çekçe, Danca, Felemenkçe, İngilizce, Estonca, Fince, Fransızca, Almanca, Yunanca, Macarca, İtalyanca, Japonca, Letonca, Litvanca, Malta dili, Norveççe, Lehçe, Portekizce, Rumence, Slovakça, Slovence, İspanyolca, İsveççe ve GelenekselÇinez. NOT: Şu diller henüz herkes tarafından kullanılamamaktadır: Bulgarca, Hırvatçe, Çekçe, Estonca, Yunanca, Macarca, Japonca, Letonca, Litvanca, Malta dili, Lehçe, Rumence, Slovakça, Slovence. hedef kitle kampanyaları için tüm dilleri eklemeniz gerekir; örneğin, bu öğeyi Tümü olarak ayarlayın. Dinamik Arama Reklamları kampanyaları için kampanya ve reklam grubu düzeyindeki dil ayarları, web sitesi etki alanı diline göre yoksayılır. Kampanya dillerini "Tümü" olarak ayarlamanız ve reklam grubu düzeyindeki dili boş bırakmanız gerekir. Eklemek: hedef kitle kampanyaları için gereklidir ve aksi takdirde bu öğe isteğe bağlıdır. Kampanya dil kümesi yoksa, kampanya içindeki her bir reklam grubunun dili gereklidir. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Kampanya dilleri ayarlandıktan sonra tümünü silemezsiniz. Güncelleştirme sırasında belirttiğiniz dillerin listesi önceki ayarların yerini alır; örneğin, mevcut dil kümesinin sonuna eklenmez. |
dize dizisi |
MultimediaAdsBidAdjustment | Multimedya reklamları için teklifinizi temel reklam grubunun veya anahtar sözcük teklifinin üzerinde veya altında ayarlamanız gereken yüzde tutarı | Int |
Ad | Kampanyanın adı. Ad, hesaptaki tüm etkin veya duraklatılmış kampanyalar arasında benzersiz olmalıdır. Ad en fazla 128 karakter içerebilir. Hizmet, adı mevcut kampanya adlarıyla karşılaştırdığında büyük/küçük harfe duyarlı olmayan bir karşılaştırma gerçekleştirir. Eklemek: Gerekli Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
dize |
Ayarlar | Kampanya türüne göre değişen desteklenen ayarlar. Not: VerifiedTrackingSetting şu anda kullanılamıyor. Ayarlar listesine ayar türü başına en fazla bir nesne ekleyebilirsiniz; örneğin, bir TargetSetting. CampaignTypeSearch olarak ayarlanmışsa ve ExperimentId öğesi ayarlanmadıysa, bu liste isteğe bağlı olarak bir DynamicSearchAdsSetting nesnesi içerebilir. Deneme kampanyaları ve temel deneme kampanyaları dinamik arama reklamları ayarlarını içeremez. Bu kampanyayı denemeler için kullanmayı planlıyorsanız dinamik arama reklamları ayarlarını eklemeyin. Mevcut bir deneme zaten bu kampanyayı temel alıyorsa, kampanyayı dinamik arama reklamları ayarlarını içerecek şekilde güncelleştiremezsiniz. CampaignTypeShopping olarak ayarlandıysa, bu liste bir ShoppingSetting nesnesi içermelidir. CampaignTypeHedef Kitle olarak ayarlandıysa, hedef kitle kampanyasının ürün reklamlarını destekleyip desteklemediğine bağlı olarak bu liste bir ShoppingSetting nesnesi içerebilir veya içermeyebilir. CampaignTypeDynamicSearchAds olarak ayarlandıysa, bu liste bir DynamicSearchAdsSetting nesnesi içermelidir. CampaignTypeHotel olarak ayarlandıysa, bu liste bir HotelSetting nesnesi içermelidir. CampaignTypePerformanceMax olarak ayarlandıysa, bu liste bir PerformanceMaxSetting nesnesi içermelidir. Performance Max kampanyası bir mağazayla ilişkilendirilirse ShoppingSetting'i de destekler. TargetSetting, Performace Max dışında herhangi bir kampanya türüyle kullanılabilir ve bu kampanyayla ilişkili Hedef Kitle ölçütlerinin "hedef ve teklif" seçeneğini mi yoksa "yalnızca teklif" hedef seçeneğini mi kullandığını belirler. TargetSetting içinde, desteklenen CriterionTypeGroup başına bir TargetSettingDetail nesnesine sahip olabilirsiniz. Kampanya düzeyi hedef ayarı için şu anda desteklenen tek ölçüt türü değeri "Hedef Kitle"dir. TargetSetting nesnesi varsayılan olarak döndürülmedi. Bu nesneyi almak için, GetCampaignsByAccountId ve GetCampaignsByIds hizmet işlemlerini çağırdığınızda ReturnAdditionalFields öğesine TargetSetting değerini ekleyin. Eklemek:CampaignTypeDynamicSearchAds veya Shopping olarak ayarlandıysa ve aksi takdirde bu öğe isteğe bağlıysa gereklidir. Bu öğe bir TargetSetting nesnesi içermiyorsa, tüm ölçüt türü grupları için varsayılan teklif seçeneği etkin bir şekilde "yalnızca teklif" olur. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. DynamicSearchAdsSetting ve ShoppingSetting nesneleri güncelleştirme sırasında kaldırılamaz. |
Diziyi ayarlama |
Durum | Kampanyanın durumu. Olası değerler Etkin ve Duraklatıldı değerleridir. Bütçe tükenirse hizmet kampanyayı otomatik olarak duraklatır. Deneme kampanyalarıyla Bütçe, Bütçe Türü veya Durum Bir deneme kampanyasının bütçesi ve durumu her zaman temel kampanya ayarlarından devralınır. Eklemek: Opsiyonel. Varsayılan değer Duraklatıldı'dır. Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. |
CampaignStatus |
Alt | Kampanya alt türü. Alt tür ayarlanmadıysa kampanya, kampanya türüne göre oluşturulur. Alt tür AudienceVideoAds olarak ayarlandıysa ve kampanya türü İzleyici ise, kampanya bir video kitlesi kampanyasıdır. Alt tür ShoppingSmartAds olarak ayarlandıysa, kampanya bir Microsoft Akıllı Alışveriş kampanyasıdır. Alt tür ShoppingSponsoredProductAd olarak ayarlandıysa kampanya, markalara yönelik bir Microsoft alışveriş kampanyalarıdır. Eklemek: İsteğe bağlı ve çoğu kampanya türü için geçerli değildir. Microsoft akıllı alışveriş kampanyaları için alt türü ShoppingSmartAds olarak ayarlamanız gerekir. Markalar için Microsoft alışveriş kampanyaları için alt türü ShoppingSponsoredProductAd olarak ayarlamanız gerekir. Güncelleştirmek: Salt okunur |
dize |
Saat Dilimi |
Bu sütun kullanım dışıdır. Kampanyanın çalıştığı saat dilimi. Saat dilimi, bir reklam grubunun başlangıç ve bitiş tarihini raporlamak ve uygulamak için kullanılır. Olası değerler için bkz. Saat Dilimleri. Deneme kampanyalarında Bütçe, Bütçe Türü, Durum veya Saat Dilimi ayarlayamazsınız. Deneme kampanyasının bütçesi, durumu ve saat dilimi her zaman temel kampanya ayarlarından devralınır. Eklemek: Gerekli Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Kampanya Etkin veya Duraklatılmış durumunda reklam grupları içeriyorsa veya içermediyse saat dilimini güncelleştiremeyebilirsiniz. |
dize |
TrackingUrlTemplate | Kampanyanızdaki tüm URL'ler için varsayılan olarak kullanılacak izleme şablonu. Aşağıdaki doğrulama kuralları, izleme şablonları için geçerlidir. Desteklenen şablonlar ve parametreler hakkında daha fazla ayrıntı için Hangi izleme veya URL parametrelerini kullanabilirim? Microsoft Advertising yardım makalesine bakın. - Daha düşük düzeyli varlıklar için tanımlanan izleme şablonları (ör. reklamlar, kampanya gibi daha üst düzey varlıklar için bu kümeleri geçersiz kılar). Daha fazla bilgi için bkz . Varlık Sınırları. - İzleme şablonunun uzunluğu 2.048 karakterle sınırlıdır. HTTP veya HTTPS protokol dizesi 2.048 karakter sınırına doğru sayılır. - İzleme şablonu aşağıdakilerden biriyle başlayan iyi biçimlendirilmiş bir URL olmalıdır: http://, https://, {lpurl} veya {unescapedlpurl}. - Microsoft Advertising, özel parametrelerin mevcut olup olmadığını doğrulamaz. İzleme şablonunuzda özel parametreler kullanıyorsanız ve bunlar yoksa, giriş sayfası URL'si değiştirme olmadan özel parametrelerinizin anahtar ve değer yer tutucularını içerir. Örneğin, izleme şablonunuz kampanya https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} , reklam grubu, ölçüt, anahtar sözcük veya reklam düzeyinde tanımlanmamışsa ve {_season} veya {_promocode} tanımlanmamışsa, giriş sayfası URL'si aynı olur.Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Bu öğeyi boş bir dize (""" olarak ayarlarsanız, önceki ayar silinir. |
dize |
UrlCustomParameters | URL izleme için özel anahtar ve değer parametreleri koleksiyonunuz. Microsoft Advertising, CustomParameters nesnesine eklediğiniz ilk 8 CustomParameter nesnesini kabul eder ve 8'den fazla özel parametre eklerseniz bir hata döndürülür. Her CustomParameterAnahtar ve Değer öğelerini içerir. Eklemek: Opsiyonel Güncelleştirmek: Opsiyonel. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Mevcut özel parametreleri korumak için UrlCustomParameters öğesini null veya boş olarak ayarlayın. Tüm özel parametreleri kaldırmak için CustomParameters nesnesinin Parameters öğesini null veya boş olarak ayarlayın. Özel parametrelerin bir alt kümesini kaldırmak için, CustomParameters nesnesinin Parameters öğesinde tutmak istediğiniz özel parametreleri belirtin. |
CustomParameters |
Gereksinimler
Hizmet: CampaignManagementService.svc v13
Ad alanı: https://bingads.microsoft.com/CampaignManagement/v13
Kullanan
AddCampaigns
GetCampaignsByAccountId
GetCampaignsByIds
UpdateCampaigns