Aracılığıyla paylaş

GetHistoricalKeywordPerformance Hizmeti İşlemi - Ad Insight

  • Makale

Normalleştirilmiş arama teriminin geçmiş performansını alır. Sonuçlar cihaz türüne göre toplanır.

İstek Öğeleri

GetHistoricalKeywordPerformanceRequest 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 anahtar sözcük performans verilerini içerir.
Belirtilen cihaz türlerinde anahtar sözcüğün performansını belirlemek için kullanılır.		 dize dizisi
Anahtar Sözcükler Geçmiş performans istatistiklerini almak istediğiniz anahtar sözcükler 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 Danca, Felemenkçe, İngilizce, Fince, Fransızca, Almanca, İtalyanca, Norveççe, Portekizce, İspanyolca, İsveççe ve TraditionalChinese'dir.		 Dize
MatchTypes Geçmiş verileri almak istediğiniz eşleşme türleri.

İçerik eşleştirme türünü belirtemeyebilirsiniz.		 MatchType dizisi
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.

Aşağıdaki dil ve ülke/bölge birleşimleri desteklenir:
Danca: DK
Felemenkçe: NL
İngilizce: AU, CA, GB, ID, IN, MY, PH, SG, TH, US, VN
Fince: FI
Fransızca: CA, FR
Almanca: AT, CH, DE
İtalyanca: BT
Norveç dili: NB
Portekizce: BR
İspanyolca: AR, CL, CO, ES, MX, PE, VE
İsveççe: SE
TraditionalChinese: HK, TW

Bu öğe null ise, hizmet varsayılan olarak belirtilen dili destekleyen tüm ülkeleri/bölgeleri içerir.		 dize dizisi
TargetAdPosition Performans verilerini almak istediğiniz arama sonuçlarının konumu.

Örneğin, anahtar sözcüğünü ve eşleştirme türünü kullanarak reklamlar ana hattın ilk konumunda göründüğünde performans verilerini almak için bu öğeyi MainLine1 olarak ayarlayın. Anahtar sözcüğünü ve eşleşme türünü kullanarak arama sonuçlarının herhangi bir konumunda reklamlar göründüğünde performans verilerini almak için bu öğeyi Tümü olarak ayarlayın.

Varsayılan değer Tümü'dür.

Bu öğe için Tümü belirtirseniz, hizmet desteklenen her reklam konumu için anahtar sözcük başına birden çok sonuç döndürür. Toplama'yı belirtirseniz, hizmet toplanmış bir sonuç döndürür.

Kenar çubuğu reklamları artık Birleşik Devletler Bing'e ait ve işletilen sitelerde hizmet sunmaz. yalnızca Birleşik Devletler (ABD) için FirstPage1 gibi ilk sayfa verilerini isterseniz, sonuçtaki KeywordKPI'ler öğesi sıfır/boş olur. Aynı isteğe ABD ve CA gibi başka ülkeler/bölgeler eklerseniz, ilk sayfa sonuçları yalnızca Birleşik Devletler dışındaki ülkelere/bölgelere atfedilir.		 AdPosition
TimeInterval Belirtilen anahtar sözcüklerin anahtar performans dizinini belirlemek için kullanılacak verileri tanımlayan zaman aralığı. Örneğin, anahtar sözcük performansını belirlemek için önceki yedi güne veya önceki 30 güne ait verileri kullanın.

Varsayılan değer LastDay'dir.		 TimeInterval

İ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

GetHistoricalKeywordPerformanceResponse 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ü
KeywordHistoricalPerformances KeywordHistoricalPerformance veri nesneleri dizisi. Dizi, istekte belirtilen her anahtar sözcük, cihaz, eşleşme türü ve reklam konumu için bir öğe içerir. Anahtar sözcük geçerli değilse veya kullanılabilir veri yoksa, dizideki karşılık gelen öğe null olur. KeywordHistoricalPerformance 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">GetHistoricalKeywordPerformance</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>
    <GetHistoricalKeywordPerformanceRequest 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>
      <TimeInterval i:nil="false">ValueHere</TimeInterval>
      <TargetAdPosition i:nil="false">ValueHere</TargetAdPosition>
      <MatchTypes i:nil="false">
        <MatchType>ValueHere</MatchType>
      </MatchTypes>
      <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>
      <Devices i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:string>ValueHere</a1:string>
      </Devices>
    </GetHistoricalKeywordPerformanceRequest>
  </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>
    <GetHistoricalKeywordPerformanceResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordHistoricalPerformances d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordHistoricalPerformance>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <KeywordKPIs d4p1:nil="false">
            <KeywordKPI>
              <Device d4p1:nil="false">ValueHere</Device>
              <MatchType>ValueHere</MatchType>
              <AdPosition>ValueHere</AdPosition>
              <Clicks>ValueHere</Clicks>
              <Impressions>ValueHere</Impressions>
              <AverageCPC>ValueHere</AverageCPC>
              <CTR>ValueHere</CTR>
              <TotalCost>ValueHere</TotalCost>
              <AverageBid>ValueHere</AverageBid>
            </KeywordKPI>
          </KeywordKPIs>
        </KeywordHistoricalPerformance>
      </KeywordHistoricalPerformances>
    </GetHistoricalKeywordPerformanceResponse>
  </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<GetHistoricalKeywordPerformanceResponse> GetHistoricalKeywordPerformanceAsync(
	IList<string> keywords,
	TimeInterval? timeInterval,
	AdPosition? targetAdPosition,
	IList<MatchType> matchTypes,
	string language,
	IList<string> publisherCountries,
	IList<string> devices)
{
	var request = new GetHistoricalKeywordPerformanceRequest
	{
		Keywords = keywords,
		TimeInterval = timeInterval,
		TargetAdPosition = targetAdPosition,
		MatchTypes = matchTypes,
		Language = language,
		PublisherCountries = publisherCountries,
		Devices = devices
	};

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

static GetHistoricalKeywordPerformanceResponse getHistoricalKeywordPerformance(
	ArrayOfstring keywords,
	TimeInterval timeInterval,
	AdPosition targetAdPosition,
	ArrayOfMatchType matchTypes,
	java.lang.String language,
	ArrayOfstring publisherCountries,
	ArrayOfstring devices) throws RemoteException, Exception
{
	GetHistoricalKeywordPerformanceRequest request = new GetHistoricalKeywordPerformanceRequest();

	request.setKeywords(keywords);
	request.setTimeInterval(timeInterval);
	request.setTargetAdPosition(targetAdPosition);
	request.setMatchTypes(matchTypes);
	request.setLanguage(language);
	request.setPublisherCountries(publisherCountries);
	request.setDevices(devices);

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

static function GetHistoricalKeywordPerformance(
	$keywords,
	$timeInterval,
	$targetAdPosition,
	$matchTypes,
	$language,
	$publisherCountries,
	$devices)
{

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

	$request = new GetHistoricalKeywordPerformanceRequest();

	$request->Keywords = $keywords;
	$request->TimeInterval = $timeInterval;
	$request->TargetAdPosition = $targetAdPosition;
	$request->MatchTypes = $matchTypes;
	$request->Language = $language;
	$request->PublisherCountries = $publisherCountries;
	$request->Devices = $devices;

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

response=adinsight_service.GetHistoricalKeywordPerformance(
	Keywords=Keywords,
	TimeInterval=TimeInterval,
	TargetAdPosition=TargetAdPosition,
	MatchTypes=MatchTypes,
	Language=Language,
	PublisherCountries=PublisherCountries,
	Devices=Devices)

Gereksinimler

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