Anahtar Sözcük Veri Nesnesi - Kampanya Yönetimi

Bir anahtar sözcük tanımlar.

Anahtar sözcükler, ürün veya hizmet ararken aranan sözcükler veya tümceciklerdir. Örneğin, anahtar sözcükler aşağıdakilerden biri olabilir:

• Ayakkabı
• Tekne turu tatili
• New York'ta tenis dersleri

Yukarıda gösterildiği gibi, anahtar sözcük yalnızca tek bir sözcük, birkaç sözcük ve hatta bir tümcecik olabilir. Arama reklamları bağlamında bunların tümü yalnızca anahtar sözcük olarak adlandırılır.

Önemli

Nisan 2021 itibarıyla reklam grupları veya anahtar sözcükler için herhangi bir teklif stratejisi ayarlayamazsınız. 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="Keyword" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Bid" nillable="true" type="tns:Bid" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="DestinationUrl" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="EditorialStatus" nillable="true" type="tns:KeywordEditorialStatus" />
    <xs:element minOccurs="0" name="FinalAppUrls" nillable="true" type="tns:ArrayOfAppUrl" />
    <xs:element xmlns:q32="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalMobileUrls" nillable="true" type="q32:ArrayOfstring" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q33="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="FinalUrls" nillable="true" type="q33:ArrayOfstring" />
    <xs:element xmlns:q34="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q34:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MatchType" nillable="true" type="tns:MatchType" />
    <xs:element minOccurs="0" name="Param1" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param2" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Param3" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:KeywordStatus" />
    <xs:element minOccurs="0" name="Text" 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:sequence>
</xs:complexType>

Öğe

Anahtar Sözcük nesnesi şu öğelere sahiptir: Bid, BiddingScheme, DestinationUrl, EditorStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, MatchType, Param1, Param2, Param3, Status, Text, TrackingUrlTemplate, UrlCustomParameters.

Öğe	Açıklama	Veri Türü
Teklif	Birisi reklamınıza her tıklayışında ödemek istediğiniz maksimum tutar. Aynı anahtar sözcüğü kullanarak diğer reklamverenlere karşı teklif ve edersiniz, bu nedenle genel olarak yüksek teklifler reklamınızın arama sonuçları sayfasında daha çok istenen konumlarda görüntülenmesine yardımcı olur. Varsayılan reklam grubu düzeyi teklifini kullanmak yerine her anahtar sözcük için özel teklifler ayarlayabilirsiniz. Anahtar sözcükler için özel teklifler, söz konusu anahtar sözcükler için reklam grubu varsayılan teklifini geçersiz kılar. Özel tekliflerle, zamanınızı ve paranızı en kârlı anahtar sözcüklere odaklayabilirsiniz, ancak tek tek teklifleri yönetmek için daha fazla zaman harcamanız gerekir. Anahtar sözcük düzeyi teklifi ayarlanmadıysa Ad Grubu CpcBid kullanılır. Daha fazla bilgi için bkz. Bütçe ve Teklif Stratejileri. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez. Anahtar sözcük teklifini silmek ve AdGroup varsayılan eşleşme türü teklifini kullanmak için Bid nesnesinin Amount öğesini null olarak ayarlayın.	Teklif
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. NOT: Nisan 2021 itibarıyla reklam grupları veya anahtar sözcükler için herhangi bir teklif stratejisi ayarlayamazsınız. 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. Ekle: Isteğe bağlı. Bu öğeyi ayarlamazsanız, varsayılan olarak InheritFromParentBiddingScheme kullanılır. Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	BiddingScheme
DestinationUrl	Kullanıcıyı reklama tıkladığında götürecek web sayfasının URL'si. Anahtar sözcüğün hedef URL'si belirtilirse kullanılır; aksi takdirde, reklamın hedef URL'si kullanılır. Önemli: Kasım 2018 itibarıyla anahtar sözcük hedef URL'si eklenemez veya güncelleştirilemez. Bunun yerine Son URL'leri kullanabilirsiniz. Daha fazla ayrıntı için bkz. Anahtar sözcük hedef URL'lerinizi son URL'lere geçirme. Ekle: İzin verilmiyor Güncelleştirme: İzin verilmiyor	Dize
EditoryalStatus	Anahtar sözcüğün gözden geçirmeyi beklemede olduğunu, onaylandığını veya onaylanmadığını belirten anahtar sözcüğün editoryal gözden geçirme durumu. Ekle: Salt okunur Güncelleştirme: Salt okunur	KeywordEditorialStatus
FinalAppUrls	Gelecekte kullanılmak üzere ayrılmıştır.	AppUrl dizisi
FinalMobileUrls	Mobil giriş sayfası URL'si. Anahtar sözcüğün son mobil URL'si belirtilirse kullanılır; aksi takdirde, reklamın son mobil URL'si kullanılır. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	dize dizisi
FinalUrls	Giriş sayfası URL'si. Anahtar sözcüğün son URL'si belirtilirse kullanılır; aksi takdirde, reklamın son URL'si kullanılır. Son URL'ler ve Son Mobil URL'ler için aşağıdaki doğrulama kuralları geçerlidir. - URL'nin 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. - Hem FinalUrls hem de FinalMobileUrls için en fazla 10 öğe belirtebilirsiniz; ancak, teslimat için her listedeki yalnızca ilk öğe kullanılır. Hizmet, olası ileriye dönük uyumluluk için en fazla 10'a kadar izin verir. - '{' ve '}' kullanımının yalnızca etiketleri (örneğin {lpurl}) belirtmesine izin verilir. - Son URL'lerin her biri http:// veya https:// ile başlayan iyi biçimlendirilmiş bir URL olmalıdır. - FinalMobileUrls değerini belirtirseniz FinalUrls değerini de belirtmeniz gerekir. - Cihaz tercihi mobil olarak ayarlandıysa FinalMobileUrls belirtemeyebilirsiniz. Ayrıca TrackingUrlTemplate veya UrlCustomParameters öğeleri ayarlanırsa en az bir son URL'nin gerekli olduğunu unutmayın. Daha fazla bilgi için bkz. Yükseltilen URL'lerle URL İzleme. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	dize dizisi
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. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. 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
Kimlik	Anahtar sözcüğün sistem tarafından oluşturulan tanımlayıcısı. Ekle: Salt okunur Güncelleştirme: Gerekli	Uzun
Matchtype	Anahtar sözcüğü ve kullanıcının arama terimini karşılaştırmak için eşleşme türü. Ekle: Gerekli Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	Matchtype
Param1	Reklamın başlığı, metni, görünen URL'si veya hedef URL'si {Param1} dinamik değiştirme dizesini içeriyorsa, reklamda değiştirme değeri olarak kullanılacak dize. Bir reklamın hedef URL'sini belirtmek için {Param1} kullanabilirsiniz ancak bunu yapılmaması tavsiye edilir. Bunun yerine, anahtar sözcüğün DestinationUrl öğesini ayarlamanız gerekir. Dize en fazla 1.022 karakter içerebilir. Gerçek sınır, değiştirme dizesine başvuran öğenin uzunluğuna bağlıdır. Örneğin, bir metin reklamının başlığının uzunluğu en fazla 25 karakter içerebilir. Reklam kopyanıza dinamik metin uygularken, bir anahtar sözcük için Param1 null veya boşsa sistemin kullanacağı varsayılan bir dize sağlamanız gerekir; param1 değiştirme değeri dahil edildiğinde genişletilmiş dize öğenin sınırını aşacaktır; aksi takdirde reklam bu anahtar sözcükle birlikte gösterilmez. Daha fazla bilgi için Reklamlarınızı dinamik metin parametreleriyle otomatik olarak özelleştirme Microsoft Advertising yardım makalesine bakın. Ayrıca, reklam grubunun yalnızca bir reklamı varsa ve bu reklam {Param1} kullanıyorsa ancak {Param1:default} gibi bir varsayılan dize sağlamıyorsa, bu değiştirme için geçerli bir Param1 değeri sağlamanız gerekir. Aksi takdirde bu anahtar sözcük eklenemez veya güncelleştirilemez. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. 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
Param2	Başlık, metin, görünen URL veya hedef URL {Param2} dinamik değiştirme dizesini içeriyorsa, reklamda değiştirme değeri olarak kullanılacak dize. Genellikle, bir reklamın başlık veya metin (reklam kopyası açıklaması) öğelerinde {Param2} değiştirme dizesini kullanırsınız. Dize en fazla 70 karakter içerebilir. Gerçek sınır, değiştirme dizesine başvuran öğenin uzunluğuna bağlıdır. Örneğin, bir metin reklamının başlığının uzunluğu en fazla 25 karakter içerebilir. Reklam kopyanıza dinamik metin uygularken, anahtar sözcük için Param2 null veya boşsa sistemin kullanacağı varsayılan bir dize sağlamanız gerekir; param2 değiştirme değeri dahil edildiğinde genişletilmiş dize öğenin sınırını aşacak; aksi takdirde reklam bu anahtar sözcükle birlikte gösterilmez. Daha fazla bilgi için Reklamlarınızı dinamik metin parametreleriyle otomatik olarak özelleştirme Microsoft Advertising yardım makalesine bakın. Ayrıca, reklam grubunun yalnızca bir reklamı varsa ve bu reklam {Param2} kullanıyorsa ancak {Param2:default} gibi bir varsayılan dize sağlamıyorsa, bu değiştirme için geçerli bir Param2 değeri sağlamanız gerekir. Aksi takdirde bu anahtar sözcük eklenemez veya güncelleştirilemez. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. 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
Param3	Başlık, metin, görünen URL veya hedef URL {Param3} dinamik değiştirme dizesini içeriyorsa, reklamda değiştirme değeri olarak kullanılacak dize. Genellikle, bir reklamın başlık veya metin (reklam kopyası açıklaması) öğelerinde {Param3} değiştirme dizesini kullanırsınız. Dize en fazla 70 karakter içerebilir. Gerçek sınır, değiştirme dizesine başvuran öğenin uzunluğuna bağlıdır. Örneğin, bir metin reklamının başlığının uzunluğu en fazla 25 karakter içerebilir. Reklam kopyanızda dinamik metin uygularken, bir anahtar sözcük için Param3 null veya boşsa sistemin kullanacağı varsayılan bir dize sağlamanız gerekir; param3 değiştirme değeri dahil edildiğinde genişletilmiş dize öğenin sınırını aşacaktır; aksi takdirde reklam bu anahtar sözcükle birlikte gösterilmez. Daha fazla bilgi için Reklamlarınızı dinamik metin parametreleriyle otomatik olarak özelleştirme Microsoft Advertising yardım makalesine bakın. Ayrıca, reklam grubunun yalnızca bir reklamı varsa ve bu reklam {Param3} kullanıyorsa ancak {Param3:default} gibi bir varsayılan dize sağlamıyorsa, bu değiştirme için geçerli bir Param3 değeri sağlamanız gerekir. Aksi takdirde bu anahtar sözcük eklenemez veya güncelleştirilemez. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. 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
Durum	Anahtar sözcüğün durumu. Varsayılan olarak, durum Etkin olarak ayarlanır. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. Güncelleştirme için hiçbir değer ayarlanmadıysa, bu ayar değiştirilmez.	KeywordStatus
Metin	Anahtar sözcük metni. Metin en fazla 100 karakter içerebilir. Anahtar sözcüğü, anahtar sözcüğün ait olduğu reklam grubu için belirttiğiniz Dil değerinin yerel ayarında belirtmelisiniz. Ekle: Gerekli Güncelleştirme: Salt okunur	Dize
TrackingUrlTemplate	Tüm FinalUrls ve FinalMobileUrls 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. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. 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. Ekle: Isteğe bağlı Güncelleştirme: Isteğe bağlı. 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

AddKeywords
GetKeywordsByAdGroupId
GetKeywordsByEditorialStatus
GetKeywordsByIds
UpdateKeywords