SuggestKeywordsFromExistingKeywords Hizmet İşlemi - Ad Insight

Makale
12/21/2023

Belirtilen anahtar sözcüklerden daha iyi performans gösterebilecek anahtar sözcükler önerir.

İstek Öğeleri

SuggestKeywordsFromExistingKeywordsRequest nesnesi, hizmet işlemi isteğinin gövde ve üst bilgi öğelerini tanımlar. Öğelerin İstek SOAP'sinde gösterildiği gibi aynı sırada olması gerekir.

Not

Aşağıda aksi belirtilmedikçe, tüm istek öğeleri gereklidir.

İstek Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
AdGroupId	Önerilen anahtar sözcükler için reklam grubunun tanımlayıcısı. Bu öğe henüz desteklenmiyor ve gelecekteki bir sürümde anahtar sözcük önerilerini etkilemek için kullanılabilir	Uzun
CampaignId	Önerilen anahtar sözcükler için kampanyanın tanımlayıcısı. Bu öğe henüz desteklenmiyor ve gelecekteki bir sürümde anahtar sözcük önerilerini etkilemek için kullanılabilir	Uzun
ExcludeBrand	Sonuçların marka anahtar sözcüklerini dışlayıp dışlamayacağını belirleyen bir değer. Sonuçtaki marka anahtar sözcüklerini dışlamak için true olarak ayarlayın. Varsayılan değer false'tur.	Boolean
Anahtar Sözcükler	Daha iyi performans gösterebilecek önerilen anahtar sözcükleri almak istediğiniz bir anahtar sözcük dizisi. Dizi en fazla 1.000 anahtar sözcük içerebilir ve her anahtar sözcük en fazla 100 karakter içerebilir.	dize dizisi
Dil	Anahtar sözcüğün yazıldığı dil. Büyük/küçük harfe duyarlı değerler İngilizce, Fransızca ve Almanca'dır. Her dil için desteklenen sağlayıcıların listesi için aşağıdaki Açıklamalar bölümüne bakın. Varsayılan değer İngilizce'dir.	Dize
MaxSuggestionsPerKeyword	Belirtilen anahtar sözcük başına döndürülecek en fazla anahtar sözcük önerisi sayısı. SuggestionType 4 olarak ayarlandıysa, anahtar sözcük başına en fazla 200 öneri isteyebilirsiniz; aksi takdirde, istekte bulunabileceğiniz en fazla öneri 100'dür. Varsayılan değer 50'dir.	Int
PublisherCountries	Önerilen anahtar sözcükleri belirlemek için veri kaynağı olarak kullanılacak ülkelerin/bölgelerin ülke kodları. Bir veya daha fazla ülke kodu belirtebilirsiniz. Belirttiğiniz her ülke/bölge , Language öğesinde belirttiğiniz dili desteklemelidir. Desteklenen değerler için aşağıdaki Açıklamalar bölümüne bakın. Varsayılan değer, belirtilen dili destekleyen tüm ülkeler/bölgelerdir.	dize dizisi
Removeduplicates	Yinelenen anahtar sözcüklerin önerilen anahtar sözcükler listesinden kaldırılıp kaldırılmayacağını belirleyen boole değeri. Yinelenenleri kaldırmak için true olarak ayarlayın. Varsayılan değer false'tur.	Boolean
SuggestionType	Anahtar sözcük önerilerini oluşturmak için kullanılacak sağlayıcı. Olası sağlayıcıların listesi, her sağlayıcının dil ve ülke/bölge kısıtlamaları ve ülkeye/bölgeye göre varsayılan sağlayıcı için aşağıdaki Açıklamalar bölümüne bakın.	Int

İstek Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
AuthenticationToken	Microsoft Advertising hesaplarına izinleri olan bir kullanıcının kimlik bilgilerini temsil eden OAuth erişim belirteci. Daha fazla bilgi için bkz. OAuth ile kimlik doğrulaması.	Dize
CustomerAccountId	İstekteki varlıklara sahip olan veya bunlarla ilişkilendirilmiş reklam hesabının tanımlayıcısı. Her ikisi de gerektiğinde bu üst bilgi öğesi AccountId gövde öğesiyle aynı değere sahip olmalıdır. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma.	Dize
Customerıd	Kullanıcının eriştiği veya faaliyette olduğu yönetici hesabının (müşteri) tanımlayıcısı. Bir kullanıcı birden çok yönetici hesabına erişebilir. Bu öğe çoğu hizmet işlemi için gereklidir ve en iyi yöntem olarak her zaman ayarlamanız gerekir. Daha fazla bilgi için bkz. Hesabınızı ve Müşteri Kimliklerinizi Alma.	Dize
DeveloperToken	Bing Ads API'sine erişmek için kullanılan geliştirici belirteci. Daha fazla bilgi için bkz . Geliştirici Belirteci Alma.	Dize
Password	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize
Username	Bu öğe iç kullanım için ayrılmıştır ve API'nin gelecekteki bir sürümünden kaldırılacaktır. Kullanıcı kimlik bilgilerini ayarlamak için AuthenticationToken öğesini kullanmanız gerekir.	Dize

Yanıt Öğeleri

SuggestKeywordsFromExistingKeywordsResponse nesnesi, hizmet işlemi yanıtının gövde ve üst bilgi öğelerini tanımlar. Öğeler , Yanıt SOAP'sinde gösterildiği gibi aynı sırada döndürülür.

Yanıt Gövdesi Öğeleri

Öğe	Açıklama	Veri Türü
KeywordSuggestions	KeywordSuggestion veri nesneleri dizisi. Dizi, istekte belirtilen her anahtar sözcük için bir öğe içerir. nesnesi, belirtilen anahtar sözcükten daha iyi performans gösterebilecek önerilen anahtar sözcüklerin listesini içerir. Önerilen her anahtar sözcük için nesne, anahtar sözcüğün kullanılmasıyla arama sorgusunun sonuçlarına bir reklamın eklenmesi olasılığını gösteren bir puan içerir. Bir anahtar sözcük için öneri yoksa , SuggestionsAndConfidence öğesi null olur.	KeywordSuggestion dizisi

Yanıt Üst Bilgisi Öğeleri

Öğe	Açıklama	Veri Türü
TrackingId	API çağrısının ayrıntılarını içeren günlük girdisinin tanımlayıcısı.	Dize

SOAP isteme

Bu şablon, SOAP isteği için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur. Bu hizmet işlemiyle kullanabileceğiniz desteklenen türler için yukarıdaki İstek Gövdesi Öğeleri başvurusuna bakın.

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <Action mustUnderstand="1">SuggestKeywordsFromExistingKeywords</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <SuggestKeywordsFromExistingKeywordsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <Keywords i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Keywords>
      <Language i:nil="false">ValueHere</Language>
      <PublisherCountries i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </PublisherCountries>
      <MaxSuggestionsPerKeyword i:nil="false">ValueHere</MaxSuggestionsPerKeyword>
      <SuggestionType i:nil="false">ValueHere</SuggestionType>
      <RemoveDuplicates i:nil="false">ValueHere</RemoveDuplicates>
      <ExcludeBrand i:nil="false">ValueHere</ExcludeBrand>
      <AdGroupId i:nil="false">ValueHere</AdGroupId>
      <CampaignId i:nil="false">ValueHere</CampaignId>
    </SuggestKeywordsFromExistingKeywordsRequest>
  </s:Body>
</s:Envelope>

Yanıt SOAP

Bu şablon, SOAP yanıtı için gövde ve üst bilgi öğelerinin sırasını gösteren bir araç tarafından oluşturulmuştur.

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/AdInsight/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <SuggestKeywordsFromExistingKeywordsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordSuggestions d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordSuggestion>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <SuggestionsAndConfidence d4p1:nil="false">
            <KeywordAndConfidence>
              <SuggestedKeyword d4p1:nil="false">ValueHere</SuggestedKeyword>
              <ConfidenceScore>ValueHere</ConfidenceScore>
            </KeywordAndConfidence>
          </SuggestionsAndConfidence>
        </KeywordSuggestion>
      </KeywordSuggestions>
    </SuggestKeywordsFromExistingKeywordsResponse>
  </s:Body>
</s:Envelope>

Kod Söz Dizimi

Örnek söz dizimi Bing Reklam SDK'ları ile kullanılabilir. Daha fazla örnek için bkz . Bing Ads API Kod Örnekleri .

public async Task<SuggestKeywordsFromExistingKeywordsResponse> SuggestKeywordsFromExistingKeywordsAsync(
	IList<string> keywords,
	string language,
	IList<string> publisherCountries,
	int? maxSuggestionsPerKeyword,
	int? suggestionType,
	bool? removeDuplicates,
	bool? excludeBrand,
	long? adGroupId,
	long? campaignId)
{
	var request = new SuggestKeywordsFromExistingKeywordsRequest
	{
		Keywords = keywords,
		Language = language,
		PublisherCountries = publisherCountries,
		MaxSuggestionsPerKeyword = maxSuggestionsPerKeyword,
		SuggestionType = suggestionType,
		RemoveDuplicates = removeDuplicates,
		ExcludeBrand = excludeBrand,
		AdGroupId = adGroupId,
		CampaignId = campaignId
	};

	return (await AdInsightService.CallAsync((s, r) => s.SuggestKeywordsFromExistingKeywordsAsync(r), request));
}

static SuggestKeywordsFromExistingKeywordsResponse suggestKeywordsFromExistingKeywords(
	ArrayOfstring keywords,
	java.lang.String language,
	ArrayOfstring publisherCountries,
	int maxSuggestionsPerKeyword,
	int suggestionType,
	boolean removeDuplicates,
	boolean excludeBrand,
	java.lang.Long adGroupId,
	java.lang.Long campaignId) throws RemoteException, Exception
{
	SuggestKeywordsFromExistingKeywordsRequest request = new SuggestKeywordsFromExistingKeywordsRequest();

	request.setKeywords(keywords);
	request.setLanguage(language);
	request.setPublisherCountries(publisherCountries);
	request.setMaxSuggestionsPerKeyword(maxSuggestionsPerKeyword);
	request.setSuggestionType(suggestionType);
	request.setRemoveDuplicates(removeDuplicates);
	request.setExcludeBrand(excludeBrand);
	request.setAdGroupId(adGroupId);
	request.setCampaignId(campaignId);

	return AdInsightService.getService().suggestKeywordsFromExistingKeywords(request);
}

static function SuggestKeywordsFromExistingKeywords(
	$keywords,
	$language,
	$publisherCountries,
	$maxSuggestionsPerKeyword,
	$suggestionType,
	$removeDuplicates,
	$excludeBrand,
	$adGroupId,
	$campaignId)
{

	$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];

	$request = new SuggestKeywordsFromExistingKeywordsRequest();

	$request->Keywords = $keywords;
	$request->Language = $language;
	$request->PublisherCountries = $publisherCountries;
	$request->MaxSuggestionsPerKeyword = $maxSuggestionsPerKeyword;
	$request->SuggestionType = $suggestionType;
	$request->RemoveDuplicates = $removeDuplicates;
	$request->ExcludeBrand = $excludeBrand;
	$request->AdGroupId = $adGroupId;
	$request->CampaignId = $campaignId;

	return $GLOBALS['AdInsightProxy']->GetService()->SuggestKeywordsFromExistingKeywords($request);
}

response=adinsight_service.SuggestKeywordsFromExistingKeywords(
	Keywords=Keywords,
	Language=Language,
	PublisherCountries=PublisherCountries,
	MaxSuggestionsPerKeyword=MaxSuggestionsPerKeyword,
	SuggestionType=SuggestionType,
	RemoveDuplicates=RemoveDuplicates,
	ExcludeBrand=ExcludeBrand,
	AdGroupId=AdGroupId,
	CampaignId=CampaignId)

Açıklamalar

Aşağıda, belirtebileceğiniz olası öneri sağlayıcıları yer alır.

Öneri Türü	Açıklama
1	Anahtar sözcüğünü içeren arama sorgularını döndürür.
2	Belirtilen anahtar sözcüğü içeren diğer reklam gruplarından anahtar sözcükleri döndürür.
3	Belirtilen anahtar sözcükle ilgili arama sorgularını döndürür.
4	Diğer sağlayıcılardan en iyi önerileri döndürür.

Her ülkenin/bölgenin desteklediği sağlayıcılar aşağıdadır.

Ülke/Bölge	Dil	Desteklenen Sağlayıcı Türleri	Varsayılan Sağlayıcı Türü
Avustralya (AU)	English	2,3,4	4
Kanada (CA)	English	2,3,4	4
Fransa (FR)	French	2,3,4	4
Almanya (DE)	German	1,2,3,4	4

Gereksinimler

Hizmet: AdInsightService.svc v13
Ad alanı: https://bingads.microsoft.com/AdInsight/v13

Aracılığıyla paylaş