Aracılığıyla paylaş


GetEstimatedBidByKeywordIds Hizmeti İşlemi - Ad Insight

Son 7 gün içinde arama sonuçlarında bir reklamın hedeflenen konumda görünmesine neden olabilecek bir veya daha fazla anahtar sözcüğün (anahtar sözcük tanımlayıcısı tarafından belirtilen) tahmini teklif değerini alır. Ayrıca, işlem tıklama tahminleri, tıklama başına ortalama maliyet (CPC) ve anahtar sözcüklerin tahmini teklifle oluşturulmuş olabileceği izlenimleri sağlar.

Tahminler son 7 günlük performans verilerini temel alır ve gelecekteki performansın tahminini veya garantisini temel alır.

Not

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

İstek Öğeleri

GetEstimatedBidByKeywordIdsRequest 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ü
KeywordIds Reklamınızın arama sonuçlarında hedeflenen konumda görünmesine neden olabilecek önerilen teklif değerlerini almak istediğiniz anahtar sözcüklerin tanımlayıcı dizisi. En fazla 1.000 anahtar sözcük belirtebilirsiniz. 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

GetEstimatedBidByKeywordIdsResponse 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ü
KeywordEstimatedBids KeywordIdEstimatedBid veri nesneleri dizisi. Dizi, istekte belirtilen her anahtar sözcük için karşılık gelen bir öğe içerir. Anahtar sözcük kimliği geçerli değilse, dizideki karşılık gelen öğe null olur.

Her KeywordIdEstimatedBid bir anahtar sözcük tanımlayıcısı ve bir KeywordEstimatedBid içerir. Anahtar sözcük için kullanılabilir veriler varsa KeywordEstimatedBid , arama sonuçlarının hedeflenen konumunda bir reklamın görünmesine neden olabilecek önerilen bir teklif değeri sağlar. Aksi takdirde , KeywordEstimatedBid öğesi null olarak ayarlanır.
KeywordIdEstimatedBid 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">GetEstimatedBidByKeywordIds</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>
    <GetEstimatedBidByKeywordIdsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordIds i:nil="false" xmlns:a1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <a1:long>ValueHere</a1:long>
      </KeywordIds>
      <TargetPositionForAds>ValueHere</TargetPositionForAds>
    </GetEstimatedBidByKeywordIdsRequest>
  </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>
    <GetEstimatedBidByKeywordIdsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
      <KeywordEstimatedBids d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
        <KeywordIdEstimatedBid>
          <KeywordId>ValueHere</KeywordId>
          <KeywordEstimatedBid d4p1:nil="false">
            <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>
        </KeywordIdEstimatedBid>
      </KeywordEstimatedBids>
    </GetEstimatedBidByKeywordIdsResponse>
  </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<GetEstimatedBidByKeywordIdsResponse> GetEstimatedBidByKeywordIdsAsync(
	IList<long> keywordIds,
	TargetAdPosition targetPositionForAds)
{
	var request = new GetEstimatedBidByKeywordIdsRequest
	{
		KeywordIds = keywordIds,
		TargetPositionForAds = targetPositionForAds
	};

	return (await AdInsightService.CallAsync((s, r) => s.GetEstimatedBidByKeywordIdsAsync(r), request));
}
static GetEstimatedBidByKeywordIdsResponse getEstimatedBidByKeywordIds(
	ArrayOflong keywordIds,
	TargetAdPosition targetPositionForAds) throws RemoteException, Exception
{
	GetEstimatedBidByKeywordIdsRequest request = new GetEstimatedBidByKeywordIdsRequest();

	request.setKeywordIds(keywordIds);
	request.setTargetPositionForAds(targetPositionForAds);

	return AdInsightService.getService().getEstimatedBidByKeywordIds(request);
}
static function GetEstimatedBidByKeywordIds(
	$keywordIds,
	$targetPositionForAds)
{

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

	$request = new GetEstimatedBidByKeywordIdsRequest();

	$request->KeywordIds = $keywordIds;
	$request->TargetPositionForAds = $targetPositionForAds;

	return $GLOBALS['AdInsightProxy']->GetService()->GetEstimatedBidByKeywordIds($request);
}
response=adinsight_service.GetEstimatedBidByKeywordIds(
	KeywordIds=KeywordIds,
	TargetPositionForAds=TargetPositionForAds)

Gereksinimler

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