GetKeywordTrafficEstimates Hizmet İşlemi - Ad Insight

Makale
12/21/2023

Anahtar sözcükler için ortalama CPC, ortalama konum, tıklama sayısı, CTR, gösterimler ve toplam maliyet gibi trafik tahminleri sağlar. Giriş olarak teklif, dil, konum ve ağı isteğe bağlı kampanya bütçesi ve negatif anahtar sözcük filtreleri ile sağlarsınız.

İpucu

Genel bakış için Anahtar Sözcük Fikirleri ve Trafik Tahminleri teknik kılavuzuna bakın.

İstek Öğeleri

GetKeywordTrafficEstimatesRequest 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ü
CampaignEstimators	İstenen anahtar sözcük trafiği tahminleri için kampanyanızı, reklam grubunuzu ve anahtar sözcük düzeyi ölçütlerinizi ve filtrelerinizi tanımlar.	CampaignEstimator dizisi

İ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

GetKeywordTrafficEstimatesResponse 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ü
CampaignEstimates	Kampanya tahminleri listesi. Her kampanya tahmini içinde, her reklam grubu için anahtar sözcük trafiği tahminlerinin iç içe bir listesi bulunur. İstenen liste öğelerinden hangisinin başarısız olduğunu bulmak için BatchError Details öğesini inceleyebilirsiniz. Örneğin Ayrıntılar "CampaignEstimators[0], AdGroupEstimators[1], KeywordEstimators null veya değer içermiyor" içeriyorsa, gönderilen listede 2. AdGroupEstimator için hata oluştu. BatchError'ın Index öğesi yalnızca döndürülen toplu iş hatalarının sıralı sayısıdır ve isteğin neresinde hata oluştuğunun belirlenmesi için kullanılamaz.	CampaignEstimate 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">GetKeywordTrafficEstimates</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>
    <GetKeywordTrafficEstimatesRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <CampaignEstimators i:nil="false">
        <CampaignEstimator>
          <AdGroupEstimators i:nil="false">
            <AdGroupEstimator>
              <AdGroupId i:nil="false">ValueHere</AdGroupId>
              <KeywordEstimators i:nil="false">
                <KeywordEstimator>
                  <Keyword i:nil="false">
                    <Id i:nil="false">ValueHere</Id>
                    <MatchType>ValueHere</MatchType>
                    <Text i:nil="false">ValueHere</Text>
                  </Keyword>
                  <MaxCpc i:nil="false">ValueHere</MaxCpc>
                </KeywordEstimator>
              </KeywordEstimators>
              <MaxCpc>ValueHere</MaxCpc>
            </AdGroupEstimator>
          </AdGroupEstimators>
          <CampaignId i:nil="false">ValueHere</CampaignId>
          <Criteria i:nil="false">
            <Criterion i:type="-- derived type specified here with the appropriate prefix --">
              <!--This field is applicable if the derived type attribute is set to LocationCriterion-->
              <LocationId>ValueHere</LocationId>
              <!--This field is applicable if the derived type attribute is set to LanguageCriterion-->
              <Language i:nil="false">ValueHere</Language>
              <!--This field is applicable if the derived type attribute is set to NetworkCriterion-->
              <Network>ValueHere</Network>
              <!--This field is applicable if the derived type attribute is set to DeviceCriterion-->
              <DeviceName i:nil="false">ValueHere</DeviceName>
            </Criterion>
          </Criteria>
          <DailyBudget i:nil="false">ValueHere</DailyBudget>
          <NegativeKeywords i:nil="false">
            <NegativeKeyword>
              <Id i:nil="false">ValueHere</Id>
              <MatchType>ValueHere</MatchType>
              <Text i:nil="false">ValueHere</Text>
            </NegativeKeyword>
          </NegativeKeywords>
        </CampaignEstimator>
      </CampaignEstimators>
    </GetKeywordTrafficEstimatesRequest>
  </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>
    <GetKeywordTrafficEstimatesResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <CampaignEstimates d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <CampaignEstimate>
          <AdGroupEstimates d4p1:nil="false">
            <AdGroupEstimate>
              <AdGroupId d4p1:nil="false">ValueHere</AdGroupId>
              <KeywordEstimates d4p1:nil="false">
                <KeywordEstimate>
                  <Keyword d4p1:nil="false">
                    <Id d4p1:nil="false">ValueHere</Id>
                    <MatchType>ValueHere</MatchType>
                    <Text d4p1:nil="false">ValueHere</Text>
                  </Keyword>
                  <Maximum d4p1:nil="false">
                    <AverageCpc>ValueHere</AverageCpc>
                    <AveragePosition>ValueHere</AveragePosition>
                    <Clicks>ValueHere</Clicks>
                    <Ctr>ValueHere</Ctr>
                    <Impressions>ValueHere</Impressions>
                    <TotalCost>ValueHere</TotalCost>
                  </Maximum>
                  <Minimum d4p1:nil="false">
                    <AverageCpc>ValueHere</AverageCpc>
                    <AveragePosition>ValueHere</AveragePosition>
                    <Clicks>ValueHere</Clicks>
                    <Ctr>ValueHere</Ctr>
                    <Impressions>ValueHere</Impressions>
                    <TotalCost>ValueHere</TotalCost>
                  </Minimum>
                </KeywordEstimate>
              </KeywordEstimates>
            </AdGroupEstimate>
          </AdGroupEstimates>
          <CampaignId d4p1:nil="false">ValueHere</CampaignId>
        </CampaignEstimate>
      </CampaignEstimates>
    </GetKeywordTrafficEstimatesResponse>
  </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<GetKeywordTrafficEstimatesResponse> GetKeywordTrafficEstimatesAsync(
	IList<CampaignEstimator> campaignEstimators)
{
	var request = new GetKeywordTrafficEstimatesRequest
	{
		CampaignEstimators = campaignEstimators
	};

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

static GetKeywordTrafficEstimatesResponse getKeywordTrafficEstimates(
	ArrayOfCampaignEstimator campaignEstimators) throws RemoteException, Exception
{
	GetKeywordTrafficEstimatesRequest request = new GetKeywordTrafficEstimatesRequest();

	request.setCampaignEstimators(campaignEstimators);

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

static function GetKeywordTrafficEstimates(
	$campaignEstimators)
{

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

	$request = new GetKeywordTrafficEstimatesRequest();

	$request->CampaignEstimators = $campaignEstimators;

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

response=adinsight_service.GetKeywordTrafficEstimates(
	CampaignEstimators=CampaignEstimators)

Gereksinimler

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

Aracılığıyla paylaş