GetBidLandscapeByKeywordIds Hizmeti İşlemi - Ad Insight
Mevcut anahtar sözcüklerin listesi verüldüğünde, bu işlem her biri için önerilen tekliflerin listesini ve 1 ila 7 gün arasında tahmini performans istatistiklerini döndürür. Bu işlem hedef konumu temel almaz, bunun yerine farklı tahmini tıklamalar, gösterimler ve maliyet sağlayan birden çok teklif seçeneği döndürür. Tıklamalar, gösterimler ve maliyet için iyileştirme yapmak üzere anahtar sözcük teklifinizi nasıl ayarlayabileceğiniz konusunda karar vermenize yardımcı olması için aynı anahtar sözcüğün tahmini trafiğine sahip birden çok teklif noktasının yatay görünümünü kullanabilirsiniz. Örneğin, maliyet eğrisine tıklamaları veya gösterimler eğrisine yapılan teklifi görselleştirmek için elde edilen verileri kullanabilirsiniz.
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
GetBidLandscapeByKeywordIdsRequest 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
İ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
GetBidLandscapeByKeywordIdsResponse 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ü |
|---|---|---|
| BidLandscape |
KeywordBidLandscape nesneleri dizisi. Dizi, istekte belirtilen her anahtar kelimeye karşılık gelen bir KeywordBidLandscape içerir. Aynı çağrıda yinelenen anahtar sözcük tanımlayıcılarına izin verilir ve aynı sonuçları döndürür. Belirtilen anahtar sözcük tanımlayıcısı geçersizse veya ilişkili veri sonuçları yoksa, keywordBidLandscape içindeki tüm öğeler, istekte belirtilen anahtar sözcük tanımlayıcısını yansıtan KeywordId dışında sıfır olur. Anahtar sözcük için kullanılabilir veriler varsa , KeywordBidLandscape nesnesi önerilen tekliflerin ve tahmini performans istatistiklerinin listesini sağlar. |
KeywordBidLandscape 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">GetBidLandscapeByKeywordIds</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>
<GetBidLandscapeByKeywordIdsRequest 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>
<IncludeCurrentBid i:nil="false">ValueHere</IncludeCurrentBid>
</GetBidLandscapeByKeywordIdsRequest>
</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>
<GetBidLandscapeByKeywordIdsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
<BidLandscape d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<KeywordBidLandscape>
<KeywordId>ValueHere</KeywordId>
<StartDate d4p1:nil="false">
<Day>ValueHere</Day>
<Month>ValueHere</Month>
<Year>ValueHere</Year>
</StartDate>
<EndDate d4p1:nil="false">
<Day>ValueHere</Day>
<Month>ValueHere</Month>
<Year>ValueHere</Year>
</EndDate>
<BidLandscapePoints d4p1:nil="false">
<BidLandscapePoint>
<Bid>ValueHere</Bid>
<Clicks d4p1:nil="false">ValueHere</Clicks>
<Impressions>ValueHere</Impressions>
<TopImpressions d4p1:nil="false">ValueHere</TopImpressions>
<CurrencyCode>ValueHere</CurrencyCode>
<Cost d4p1:nil="false">ValueHere</Cost>
<MarginalCPC d4p1:nil="false">ValueHere</MarginalCPC>
</BidLandscapePoint>
</BidLandscapePoints>
</KeywordBidLandscape>
</BidLandscape>
</GetBidLandscapeByKeywordIdsResponse>
</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<GetBidLandscapeByKeywordIdsResponse> GetBidLandscapeByKeywordIdsAsync(
IList<long> keywordIds,
bool? includeCurrentBid)
{
var request = new GetBidLandscapeByKeywordIdsRequest
{
KeywordIds = keywordIds,
IncludeCurrentBid = includeCurrentBid
};
return (await AdInsightService.CallAsync((s, r) => s.GetBidLandscapeByKeywordIdsAsync(r), request));
}
static GetBidLandscapeByKeywordIdsResponse getBidLandscapeByKeywordIds(
ArrayOflong keywordIds,
boolean includeCurrentBid) throws RemoteException, Exception
{
GetBidLandscapeByKeywordIdsRequest request = new GetBidLandscapeByKeywordIdsRequest();
request.setKeywordIds(keywordIds);
request.setIncludeCurrentBid(includeCurrentBid);
return AdInsightService.getService().getBidLandscapeByKeywordIds(request);
}
static function GetBidLandscapeByKeywordIds(
$keywordIds,
$includeCurrentBid)
{
$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];
$request = new GetBidLandscapeByKeywordIdsRequest();
$request->KeywordIds = $keywordIds;
$request->IncludeCurrentBid = $includeCurrentBid;
return $GLOBALS['AdInsightProxy']->GetService()->GetBidLandscapeByKeywordIds($request);
}
response=adinsight_service.GetBidLandscapeByKeywordIds(
KeywordIds=KeywordIds,
IncludeCurrentBid=IncludeCurrentBid)
Gereksinimler
Hizmet: AdInsightService.svc v13
Ad alanı: https://bingads.microsoft.com/AdInsight/v13
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin