GetBidLandscapeByKeywordIds 服務作業 - Ad Insight
假設有一份現有關鍵詞的清單,此作業會針對每個建議的報價清單以及 1 到 7 天的預估效能統計資料傳回。 這項作業不是以目標位置為基礎,而是會傳回多個會產生不同估計點擊次數、曝光數和成本的中標選項。 您可以使用多個標價點的橫向檢視搭配相同關鍵字的估計流量,協助您決定如何調整關鍵字的報價,以優化點擊次數、曝光數和成本。 例如,您可以使用產生的資料,將按一下成本曲線或對曝光曲線的嘗試視覺化。
估計值是以過去 7 天的效能資料為基礎,而不是預測或保證未來的效能。
注意事項
這項作業適用于使用增強型的檢定標定策略的搜尋活動。
要求專案
GetBidLandscapeByKeywordIdsRequest物件會定義服務作業要求的主體和標頭元素。 元素的順序必須與 要求 SOAP中所示的順序相同。
注意事項
除非下面另有說明,否則所有要求專案都是必要的。
要求本文專案
元素 | 說明 | 資料類型 |
---|---|---|
IncludeCurrentBid | 當設定為 false時,建議的中標值可能不包含關鍵字的目前報價。 預設值為 false。 當設定為 true時,其中一個建議的中標值會等於關鍵字的目前報價。 |
布林 |
KeywordIds | 關鍵字的識別碼陣列,您想要取得具有預估效能統計資料的建議報價值清單。 您可以指定最多 1,000 個關鍵字。 |
long 陣列 |
要求標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
AuthenticationToken | OAuth 存取權杖,代表具有 Microsoft Advertising 帳戶許可權之使用者的認證。 如需詳細資訊,請 參閱使用 OAuth 進行驗證。 |
string |
CustomerAccountId | 擁有或與要求中實體相關聯之廣告帳戶的識別碼。 當兩者都需要時,此標頭元素必須具有與 AccountId body 元素相同的值。 此元素是大部分服務作業的必要專案,最佳做法是一律加以設定。 如需詳細資訊, 請參閱取得您的帳戶和客戶識別碼。 |
string |
CustomerId | (使用者存取或操作之使用者) 客戶的管理員帳戶識別碼。 使用者可以存取多個管理員帳戶。 此元素是大部分服務作業的必要專案,最佳做法是一律加以設定。 如需詳細資訊, 請參閱取得您的帳戶和客戶識別碼。 |
string |
DeveloperToken | 用來存取 Bing 廣告 API 的開發人員權杖。 如需詳細資訊 ,請參閱取得開發人員權杖。 |
string |
密碼 | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
UserName | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
Response 元素
GetBidLandscapeByKeywordIdsResponse物件會定義服務作業回應的主體和標頭元素。 這些元素的傳回順序與 回應 SOAP中所示的順序相同。
回應本文專案
元素 | 說明 | 資料類型 |
---|---|---|
BidLandscape | KeywordBidLandscape 物件的陣列。 陣列包含 KeywordBidLandscape ,對應至要求中指定的每個關鍵字。 相同呼叫中允許重複的關鍵字識別碼,而且會傳回相同的結果。 如果指定的關鍵字識別碼無效或沒有相關聯的資料結果, 則 KeywordBidLandscape 內的所有元素都會是 nil,但反映要求中指定之關鍵字識別碼的 KeywordId 除外。 如果關鍵字有可用的資料, KeywordBidLandscape 物件會提供建議的報價清單和預估的效能統計資料。 |
KeywordBidLandscape 陣列 |
回應標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
TrackingId | 包含 API 呼叫詳細資料的記錄專案識別碼。 | string |
要求 SOAP
此範本是由工具所產生,用來顯示 SOAP 要求的主體和標頭元素順序。 如需可搭配此服務作業使用的支援類型,請參閱上述 的要求本文專案 參考。
<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>
回應 SOAP
此範本是由工具所產生,用來顯示 SOAP 回應的 主體 和 標頭 元素順序。
<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>
程式碼語法
範例語法可以與 Bing 廣告 SDK搭配使用。 如需更多範例,請參閱 Bing 廣告 API 程式碼范 例。
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)
需求
服務: AdInsightService.svc v13
命名 空間: https://bingads.microsoft.com/AdInsight/v13