Aracılığıyla paylaş

GetEstimatedBidByKeywords Hizmeti İşlemi - Ad Insight

  • Makale

Bir reklamın arama sonuçlarında hedeflenen konumda görünmesine neden olabilecek bir veya daha fazla anahtar sözcüğün tahmini teklif değerini alır.

Tahminler, gelecekteki performansın tahmini veya garantisi değildir.

Not

Bu işlem, gelişmiş CPC teklif stratejisini kullanan arama kampanyalarına yöneliktir.

İstek Öğeleri

GetEstimatedBidByKeywordsRequest 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 Performans verileri, anahtar sözcüğün reklam grubu bağlamında ne kadar iyi performans gösterebileceğini saptamaya yardımcı olmak için kullanılan reklam grubunun tanımlayıcısı. Bir reklam grubu belirtmek, önerilen teklifin doğruluğunu artırmaya yardımcı olur.

Bir reklam grubu belirtirseniz, ait olduğu kampanyayı belirtmeniz gerekir.		 Uzun
CampaignId AdGroupId içinde belirtilen reklam grubunun sahibi olan kampanyanın tanımlayıcısı. Bir reklam grubu belirtmezseniz, anahtar sözcüğün kampanya bağlamında ne kadar iyi performans gösterebileceğini saptamaya yardımcı olmak için kampanyanın performans verileri kullanılır.

Kampanya ve reklam grubu belirtmek, önerilen teklifin doğruluğunu artırmaya yardımcı olur. AdGroupId veya CampaignId belirtilmezse işlem, anahtar sözcüğün hesap bağlamında ne kadar iyi performans gösterebileceğini saptamaya yardımcı olmak için belirtilen CustomerAccountId üst bilgi öğesini kullanır.		 Uzun
CurrencyCode Maliyet tahminlerini ve önerilen teklif değerini hesaplamak için kullanılacak para biriminin ISO kodu.

Ayarlanmadıysa, hizmet CustomerAccountId üst bilgi öğesinde belirtilen hesaptan para birimini belirler. Currency veya CustomerAccountId ayarlı değilse, hizmet USD kullanır.		 CurrencyCode
EntityLevelBid Anahtar sözcük düzeyi teklifleri, reklam grubu düzeyi teklifleri veya her ikisi için tahminlerin döndürülip döndürülmeyeceğini belirler.

- Belirtilen anahtar sözcüklere karşılık gelen bir KeywordEstimatedBid dizisini almak için EntityLevelBid değerini Anahtar Sözcük olarak ayarlayın.

- Belirtilen reklam grubu için bir EstimatedBidAndTraffic almak için EntityLevelBid değerini AdGroup olarak ayarlayın.

- Anahtar sözcükler için bir KeywordEstimatedBid dizisi ve bir reklam grubu için bir EstimatedBidAndTraffic dizisi almak için EntityLevelBid değerini AllEntities olarak ayarlayın.

EntityLevelBid'i ayarlamazsanız, varsayılan değer yalnızca bir KeywordEstimatedBid dizisi veya EntityLevelBid ayarının Anahtar Sözcük olarak ayarlanmasının eşdeğeridir.

EntityLevelBid değeriniKeyword, AdGroup veya AllEntities dışında bir değere ayarlarsanız, hizmet ErrorCode CampaignServiceBidLevelInvalid ile Kod 3501 döndürür.		 Dize
Anahtar Sözcükler Önerilen teklif değerlerini almak istediğiniz KeywordAndMatchType veri nesnelerinin listesi. En fazla 1.000 anahtar sözcük belirtebilirsiniz ve her anahtar sözcük en fazla 100 karakter içerebilir. KeywordAndMatchType dizisi
Dil Teklifleri tahmin etmek için konum tanımlayıcılarıyla paralel olarak kullanılan dil.

Dil, LocationId'lerde belirttiğiniz konumların her birinde desteklenmelidir.

Olası dil değerleri için bkz. Reklam Dilleri.

Dili belirtmezseniz, hizmet işlemi belirtilen AdGroupId veya CampaignId dilini kullanır. Bu özelliklerden hiçbiri ayarlı değilse, varsayılan olarak EN (İngilizce) kullanılır.		 Dize
LocationId'ler Teklifleri tahmin etmek için kullanılacak coğrafi konumların tanımlayıcısı veya tanımlayıcıları.

Tüm konumların Language öğesinde belirtilen dili desteklemesi gerekir. Konum başına en doğru teklif tahminleri için en iyi yöntem olarak birden çok konum tanımlayıcısı belirtebilirsiniz ancak hizmet araması başına yalnızca bir konum belirtmeniz gerekir.

Olası konum tanımlayıcıları için bkz . Coğrafi Konum Kodları.

Herhangi bir konum belirtmezseniz, hizmet işlemi belirtilen AdGroupId veya CampaignId'nin konum ölçütlerini kullanır. Bu özelliklerden hiçbiri ayarlanmadıysa varsayılan olarak 190 (Birleşik Devletler) kullanılır.		 uzun dizi
TargetPositionForAds Reklamlarınızın arama sonuçlarında görünmesini istediğiniz konum.

Varsayılan değer MainLine1'dir.		 TargetAdPosition

İ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

GetEstimatedBidByKeywordsResponse 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ü
AdGroupEstimatedBid Önerilen teklifi kullanırsanız, tıklama tahminlerini, tıklama başına ortalama maliyeti (TBM), gösterimleri, tıklama oranını (CTR) ve belirtilen reklam grubunun toplam maliyetini içerir.

EstimatedBidAndTraffic içindeki MatchType değeri her zaman Toplama olur. Bu bağlamda, bir reklam grubu için varsayılan arama teklifini temsil eder.		 EstimatedBidAndTraffic
KeywordEstimatedBids KeywordEstimatedBid 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 KeywordEstimatedBid bir anahtar sözcük ve EstimatedPositions öğesi içerir. Anahtar sözcük için veriler kullanılabiliyorsa EstimatedPositionAndTraffic , arama sonuçlarının hedeflenen konumunda bir reklamın görünmesine neden olabilecek önerilen teklif değerini sağlar. Aksi takdirde , EstimatedPositions öğesi null olarak ayarlanır.		 KeywordEstimatedBid 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">GetEstimatedBidByKeywords</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>
    <GetEstimatedBidByKeywordsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <Keywords i:nil="false">
        <KeywordAndMatchType>
          <KeywordText i:nil="false">ValueHere</KeywordText>
          <MatchTypes i:nil="false">
            <MatchType>ValueHere</MatchType>
          </MatchTypes>
        </KeywordAndMatchType>
      </Keywords>
      <TargetPositionForAds>ValueHere</TargetPositionForAds>
      <Language i:nil="false">ValueHere</Language>
      <LocationIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </LocationIds>
      <CurrencyCode i:nil="false">ValueHere</CurrencyCode>
      <CampaignId i:nil="false">ValueHere</CampaignId>
      <AdGroupId i:nil="false">ValueHere</AdGroupId>
      <EntityLevelBid i:nil="false">ValueHere</EntityLevelBid>
    </GetEstimatedBidByKeywordsRequest>
  </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>
    <GetEstimatedBidByKeywordsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordEstimatedBids d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordEstimatedBid>
          <Keyword d4p1:nil="false">ValueHere</Keyword>
          <EstimatedBids d4p1:nil="false">
            <EstimatedBidAndTraffic>
              <MinClicksPerWeek d4p1:nil="false">ValueHere</MinClicksPerWeek>
              <MaxClicksPerWeek d4p1:nil="false">ValueHere</MaxClicksPerWeek>
              <AverageCPC d4p1:nil="false">ValueHere</AverageCPC>
              <MinImpressionsPerWeek d4p1:nil="false">ValueHere</MinImpressionsPerWeek>
              <MaxImpressionsPerWeek d4p1:nil="false">ValueHere</MaxImpressionsPerWeek>
              <CTR d4p1:nil="false">ValueHere</CTR>
              <MinTotalCostPerWeek d4p1:nil="false">ValueHere</MinTotalCostPerWeek>
              <MaxTotalCostPerWeek d4p1:nil="false">ValueHere</MaxTotalCostPerWeek>
              <CurrencyCode>ValueHere</CurrencyCode>
              <MatchType>ValueHere</MatchType>
              <EstimatedMinBid>ValueHere</EstimatedMinBid>
            </EstimatedBidAndTraffic>
          </EstimatedBids>
        </KeywordEstimatedBid>
      </KeywordEstimatedBids>
      <AdGroupEstimatedBid d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <MinClicksPerWeek d4p1:nil="false">ValueHere</MinClicksPerWeek>
        <MaxClicksPerWeek d4p1:nil="false">ValueHere</MaxClicksPerWeek>
        <AverageCPC d4p1:nil="false">ValueHere</AverageCPC>
        <MinImpressionsPerWeek d4p1:nil="false">ValueHere</MinImpressionsPerWeek>
        <MaxImpressionsPerWeek d4p1:nil="false">ValueHere</MaxImpressionsPerWeek>
        <CTR d4p1:nil="false">ValueHere</CTR>
        <MinTotalCostPerWeek d4p1:nil="false">ValueHere</MinTotalCostPerWeek>
        <MaxTotalCostPerWeek d4p1:nil="false">ValueHere</MaxTotalCostPerWeek>
        <CurrencyCode>ValueHere</CurrencyCode>
        <MatchType>ValueHere</MatchType>
        <EstimatedMinBid>ValueHere</EstimatedMinBid>
      </AdGroupEstimatedBid>
    </GetEstimatedBidByKeywordsResponse>
  </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<GetEstimatedBidByKeywordsResponse> GetEstimatedBidByKeywordsAsync(
	IList<KeywordAndMatchType> keywords,
	TargetAdPosition targetPositionForAds,
	string language,
	IList<long> locationIds,
	CurrencyCode? currencyCode,
	long? campaignId,
	long? adGroupId,
	string entityLevelBid)
{
	var request = new GetEstimatedBidByKeywordsRequest
	{
		Keywords = keywords,
		TargetPositionForAds = targetPositionForAds,
		Language = language,
		LocationIds = locationIds,
		CurrencyCode = currencyCode,
		CampaignId = campaignId,
		AdGroupId = adGroupId,
		EntityLevelBid = entityLevelBid
	};

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

static GetEstimatedBidByKeywordsResponse getEstimatedBidByKeywords(
	ArrayOfKeywordAndMatchType keywords,
	TargetAdPosition targetPositionForAds,
	java.lang.String language,
	ArrayOflong locationIds,
	CurrencyCode currencyCode,
	java.lang.Long campaignId,
	java.lang.Long adGroupId,
	java.lang.String entityLevelBid) throws RemoteException, Exception
{
	GetEstimatedBidByKeywordsRequest request = new GetEstimatedBidByKeywordsRequest();

	request.setKeywords(keywords);
	request.setTargetPositionForAds(targetPositionForAds);
	request.setLanguage(language);
	request.setLocationIds(locationIds);
	request.setCurrencyCode(currencyCode);
	request.setCampaignId(campaignId);
	request.setAdGroupId(adGroupId);
	request.setEntityLevelBid(entityLevelBid);

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

static function GetEstimatedBidByKeywords(
	$keywords,
	$targetPositionForAds,
	$language,
	$locationIds,
	$currencyCode,
	$campaignId,
	$adGroupId,
	$entityLevelBid)
{

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

	$request = new GetEstimatedBidByKeywordsRequest();

	$request->Keywords = $keywords;
	$request->TargetPositionForAds = $targetPositionForAds;
	$request->Language = $language;
	$request->LocationIds = $locationIds;
	$request->CurrencyCode = $currencyCode;
	$request->CampaignId = $campaignId;
	$request->AdGroupId = $adGroupId;
	$request->EntityLevelBid = $entityLevelBid;

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

response=adinsight_service.GetEstimatedBidByKeywords(
	Keywords=Keywords,
	TargetPositionForAds=TargetPositionForAds,
	Language=Language,
	LocationIds=LocationIds,
	CurrencyCode=CurrencyCode,
	CampaignId=CampaignId,
	AdGroupId=AdGroupId,
	EntityLevelBid=EntityLevelBid)

Gereksinimler

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