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