GetHistoricalSearchCount Hizmet İşlemi - Ad Insight

Belirtilen süre boyunca bir aramada normalleştirilmiş terimin kaç kez kullanıldığını alır. Sonuçlar cihaz türüne göre toplanır.

İstek Öğeleri

GetHistoricalSearchCountRequest 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ü
Aygıtları	Aşağıdaki cihaz türlerinden birinin veya daha fazlasının listesi: Bilgisayarlar, Akıllı Olmayan telefonlar, Akıllı Telefonlar, Tabletler. Varsayılan değer Bilgisayarlar'dır. Yanıt, yalnızca varsa belirttiğiniz cihaz türleri için arama sayılarını içerir.	dize dizisi
Bitiştarihi	Geçmiş arama sayısını belirlemek için kullanmak istediğiniz verileri tanımlayan tarih aralığının bitiş tarihi. Tarih bugünün tarihinden sonra olamaz ve belirtilen başlangıç tarihinden sonra veya aynı olmalıdır. Belirtilen TimePeriodRollup Haftalık veya Aylık ise geçerli bitiş tarihi ayarlanabilir.	DayMonthAndYear
Anahtar Sözcükler	Arama sorgusunda anahtar sözcüğün kaç kez kullanıldığını belirlemek istediğiniz 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üklerin yazıldığı dil. PublisherCountries öğesinde belirttiğiniz ülkeler/bölgeler belirtilen dili desteklemelidir. Olası değerler için bkz . Desteklenen Diller.	Dize
PublisherCountries	Geçmiş verilerin kaynağı olarak kullanılacak ülkelerin/bölgelerin ülke kodları. Bir veya daha fazla ülke kodu belirtebilirsiniz. Belirttiğiniz her ülke/bölge , Language öğesinde belirtilen dili desteklemelidir. Olası değerler için bkz. Reklam Dilleri. Null ise, varsayılan değer belirtilen dili destekleyen tüm ülkeler/bölgelerdir.	dize dizisi
Startdate	Geçmiş arama sayısını belirlemek için kullanmak istediğiniz verileri tanımlayan tarih aralığının başlangıç tarihi. Bu tarih, belirtilen bitiş tarihinden önce veya aynı olmalıdır. Tarih, belirtilen TimePeriodRollup öğesine karşılık gelen kullanılabilir en yüksek geçmiş veri aralığından sonra olmalıdır. Belirtilen TimePeriodRollup Haftalık veya Aylık ise etkin başlangıç tarihi ayarlanabilir.	DayMonthAndYear
TimePeriodRollup	Günlük, haftalık veya aylık olarak toplanan verilerin döndürüleceğini belirtebilirsiniz. Desteklenen değerlerin listesi için aşağıdaki Açıklamalar bölümüne bakın.	Dize

İ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

GetHistoricalSearchCountResponse 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ü
KeywordSearchCounts	KeywordSearchCount veri nesneleri dizisi. Dizi, istekte belirtilen her anahtar sözcük için bir öğe içerir. Anahtar sözcük geçerli değilse, dizideki karşılık gelen öğe null olur. Her KeywordSearchCount bir SearchCountsByAttributes dizisi içerir. Dizi, istekte belirtilen her benzersiz cihaz için bir öğe içerir.	KeywordSearchCount 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">GetHistoricalSearchCount</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>
    <GetHistoricalSearchCountRequest 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>
      <StartDate i:nil="false">
        <Day>ValueHere</Day>
        <Month>ValueHere</Month>
        <Year>ValueHere</Year>
      </StartDate>
      <EndDate i:nil="false">
        <Day>ValueHere</Day>
        <Month>ValueHere</Month>
        <Year>ValueHere</Year>
      </EndDate>
      <TimePeriodRollup i:nil="false">ValueHere</TimePeriodRollup>
      <Devices i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Devices>
    </GetHistoricalSearchCountRequest>
  </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>
    <GetHistoricalSearchCountResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordSearchCounts d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordSearchCount>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <SearchCountsByAttributes d4p1:nil="false">
            <SearchCountsByAttributes>
              <Device d4p1:nil="false">ValueHere</Device>
              <HistoricalSearchCounts d4p1:nil="false">
                <HistoricalSearchCountPeriodic>
                  <SearchCount>ValueHere</SearchCount>
                  <DayMonthAndYear d4p1:nil="false">
                    <Day>ValueHere</Day>
                    <Month>ValueHere</Month>
                    <Year>ValueHere</Year>
                  </DayMonthAndYear>
                </HistoricalSearchCountPeriodic>
              </HistoricalSearchCounts>
            </SearchCountsByAttributes>
          </SearchCountsByAttributes>
        </KeywordSearchCount>
      </KeywordSearchCounts>
    </GetHistoricalSearchCountResponse>
  </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<GetHistoricalSearchCountResponse> GetHistoricalSearchCountAsync(
	IList<string> keywords,
	string language,
	IList<string> publisherCountries,
	DayMonthAndYear startDate,
	DayMonthAndYear endDate,
	string timePeriodRollup,
	IList<string> devices)
{
	var request = new GetHistoricalSearchCountRequest
	{
		Keywords = keywords,
		Language = language,
		PublisherCountries = publisherCountries,
		StartDate = startDate,
		EndDate = endDate,
		TimePeriodRollup = timePeriodRollup,
		Devices = devices
	};

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

static GetHistoricalSearchCountResponse getHistoricalSearchCount(
	ArrayOfstring keywords,
	java.lang.String language,
	ArrayOfstring publisherCountries,
	DayMonthAndYear startDate,
	DayMonthAndYear endDate,
	java.lang.String timePeriodRollup,
	ArrayOfstring devices) throws RemoteException, Exception
{
	GetHistoricalSearchCountRequest request = new GetHistoricalSearchCountRequest();

	request.setKeywords(keywords);
	request.setLanguage(language);
	request.setPublisherCountries(publisherCountries);
	request.setStartDate(startDate);
	request.setEndDate(endDate);
	request.setTimePeriodRollup(timePeriodRollup);
	request.setDevices(devices);

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

static function GetHistoricalSearchCount(
	$keywords,
	$language,
	$publisherCountries,
	$startDate,
	$endDate,
	$timePeriodRollup,
	$devices)
{

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

	$request = new GetHistoricalSearchCountRequest();

	$request->Keywords = $keywords;
	$request->Language = $language;
	$request->PublisherCountries = $publisherCountries;
	$request->StartDate = $startDate;
	$request->EndDate = $endDate;
	$request->TimePeriodRollup = $timePeriodRollup;
	$request->Devices = $devices;

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

response=adinsight_service.GetHistoricalSearchCount(
	Keywords=Keywords,
	Language=Language,
	PublisherCountries=PublisherCountries,
	StartDate=StartDate,
	EndDate=EndDate,
	TimePeriodRollup=TimePeriodRollup,
	Devices=Devices)

Açıklamalar

Aşağıdaki büyük/küçük harfe duyarlı değerler belirtilebilir ve veriler ilgili kullanılabilir en yüksek geçmiş veri aralığına kadar geri döndürülür.

TimePeriodRollup	Kullanılabilir Geçmiş Verileri
Günlük	En son tamamlanan günden en fazla 45 gün önce.
Hafta -lık	En son tamamlanan haftadan en fazla 15 hafta önce. Belirtilen BaşlangıçTarihi en yakın Pazar gününe, EndDate ise en yakın Cumartesi gününe doğru ayarlanır.
Aylık	En son tamamlanan aydan en fazla 24 ay önce. Belirtilen BaşlangıçTarihi ayın başına, EndDate ise ay sonuna doğru ayarlanır.

Desteklenen Diller

Language request body öğesi için desteklenen diller şunlardır:

Desteklenen Diller
Danish
Dutch
English
Finnish
French
German
Italian
Norveç dili
Portekizce
BasitleştirilmişÇinez
Spanish
Swedish
TraditionalChinese

Diller ve Ülke/Bölge Eşlemesi

Diller ve ülke/bölge eşlemesi tablosu aşağıdadır:

Dil	CountryCode	Ülke/Bölge	Language@Country
Danish	DK	Danimarka	Danish@Denmark
Dutch	NL	Hollanda	Dutch@Netherlands
English	AU	Avustralya	English@Australia
English	CA	Kanada	English@Canada
English	FR	Fransa	English@France
English	DE	Almanya	English@Germany
English	INÇ	Hindistan	English@India
English	Kimlik	Endonezya	English@Indonesia
English	IE	İrlanda	English@Ireland
English	IT	İtalya	English@Italy
English	BENİM	Malezya	English@Malaysia
English	NL	Hollanda	English@Netherlands
English	NZ	NewZealand	English@NewZealand
English	PH	Filipinler	English@Philippines
English	SG	Singapur	English@Singapore
English	ES	İspanya	English@Spain
English	SE	İsveç	English@Sweden
English	CANER	İsviçre	English@Switzerland
English	TH	Tayland	English@Thailand
English	GB	Birleşik Krallık	English@UK
English	US	Amerika Birleşik Devletleri	English@US
English	VN	Vietnam	English@Vietnam
Finnish	Fİ	Finlandiya	Finnish@Finland
French	CA	Kanada	French@Canada
French	FR	Fransa	French@France
French	CANER	İsviçre	French@Switzerland
French	GB	Birleşik Krallık	French@UK
French	US	Amerika Birleşik Devletleri	French@US
German	AU	Avustralya	German@Australia
German	AT	Avusturya	German@Austria
German	CA	Kanada	German@Canada
German	FR	Fransa	German@France
German	DE	Almanya	German@Germany
German	CANER	İsviçre	German@Switzerland
German	GB	Birleşik Krallık	German@UK
German	US	Amerika Birleşik Devletleri	German@US
Italian	IT	İtalya	Italian@Italy
Norveç dili	HAYIR	Norveç	Norwegian@Norway
Portekizce	BR	Brezilya	Portuguese@Brazil
BasitleştirilmişÇinez	CN	Çin	SimplifiedChinese@China
Spanish	AR	Arjantin	Spanish@Argentina
Spanish	CL	Şili	Spanish@Chile
Spanish	CO	Kolombiya	Spanish@Colombia
Spanish	MX	Meksika	Spanish@Mexico
Spanish	PE	Peru	Spanish@Peru
Spanish	ES	İspanya	Spanish@Spain
Spanish	US	US	Spanish@US
Spanish	VE	Venezuela	Spanish@Venezuela
Swedish	SE	İsveç	Swedish@Sweden
TraditionalChinese	HK	HongKongSAR	TraditionalChinese@HongKongSAR
TraditionalChinese	TW	Tayvan	TraditionalChinese@Taiwan

Gereksinimler

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