GetKeywordOpportunities 服務作業 - Ad Insight
取得與指定廣告群組相關的關鍵字建議清單。 關鍵字建議也包含建議的報價值。
要求專案
GetKeywordOpportunitiesRequest物件會定義服務作業要求的主體和標頭元素。 元素的順序必須與 要求 SOAP中所示的順序相同。
注意事項
除非下面另有說明,否則所有要求專案都是必要的。
要求本文專案
元素 | 說明 | 資料類型 |
---|---|---|
AdGroupId | 要取得關鍵字建議之廣告群組的識別碼。 下列限制適用于指定的廣告群組: - 其語言必須設定為英文。 - 其散發媒體必須包含搜尋。 - 它應該包含關鍵字和廣告。 只有當廣告群組包含一或多個廣告和關鍵字時,作業才會建議關鍵字;廣告群組包含的關鍵字和廣告越多,建議的關鍵字集就越豐富。 如果 AdGroupId 為 nil 或空白,作業會傳回指定行銷活動的所有關鍵詞機會。 |
長 |
CampaignId | 擁有指定廣告群組之行銷活動的識別碼。 如果 CampaignId 元素是 nil 或空白, 則 AdGroupId 也必須是 nil 或空白,而且作業會傳回帳戶的所有關鍵詞機會。 |
長 |
OpportunityType | 決定您想要的關鍵字商機類型。 您可以將多個值包含為旗標。 指定多個旗標的方式取決於您使用的程式設計語言。 例如,C# 會將這些值視為旗標值,而 JAVA 會將它們視為字串陣列。 SOAP 應該包含字串,其中包含以空格分隔的值清單, <OpportunityType>BroadMatch CampaignContext</OpportunityType> 例如 。 |
KeywordOpportunityType |
要求標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
AuthenticationToken | OAuth 存取權杖,代表具有 Microsoft Advertising 帳戶許可權之使用者的認證。 如需詳細資訊,請 參閱使用 OAuth 進行驗證。 |
string |
CustomerAccountId | 擁有或與要求中實體相關聯之廣告帳戶的識別碼。 當兩者都需要時,此標頭元素必須具有與 AccountId body 元素相同的值。 此元素是大部分服務作業的必要專案,最佳做法是一律加以設定。 如需詳細資訊, 請參閱取得您的帳戶和客戶識別碼。 |
string |
CustomerId | (使用者存取或操作之使用者) 客戶的管理員帳戶識別碼。 使用者可以存取多個管理員帳戶。 此元素是大部分服務作業的必要專案,最佳做法是一律加以設定。 如需詳細資訊, 請參閱取得您的帳戶和客戶識別碼。 |
string |
DeveloperToken | 用來存取 Bing 廣告 API 的開發人員權杖。 如需詳細資訊 ,請參閱取得開發人員權杖。 |
string |
密碼 | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
UserName | 此元素會保留供內部使用,並會從未來的 API 版本中移除。 您必須使用 AuthenticationToken 元素來設定使用者認證。 | string |
Response 元素
GetKeywordOpportunitiesResponse物件會定義服務作業回應的主體和標頭元素。 這些元素的傳回順序與 回應 SOAP中所示的順序相同。
回應本文專案
元素 | 說明 | 資料類型 |
---|---|---|
機會 | 可識別建議關鍵字和 bid 值的 KeywordOpportunity 資料物件清單。 如果沒有建議,清單將會是空的,如果廣告群組不包含現有的廣告和關鍵字,可能會發生此情況。 目前最多可以傳回 1,000 個清單專案,但限制可能會變更。 |
KeywordOpportunity 陣列 |
回應標頭元素
元素 | 說明 | 資料類型 |
---|---|---|
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">GetKeywordOpportunities</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>
<GetKeywordOpportunitiesRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
<AdGroupId i:nil="false">ValueHere</AdGroupId>
<CampaignId i:nil="false">ValueHere</CampaignId>
<OpportunityType>ValueHere</OpportunityType>
</GetKeywordOpportunitiesRequest>
</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>
<GetKeywordOpportunitiesResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
<Opportunities d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<KeywordOpportunity d4p1:type="-- derived type specified here with the appropriate prefix --">
<AdGroupId>ValueHere</AdGroupId>
<AdGroupName d4p1:nil="false">ValueHere</AdGroupName>
<CampaignId>ValueHere</CampaignId>
<CampaignName d4p1:nil="false">ValueHere</CampaignName>
<Competition>ValueHere</Competition>
<EstimatedIncreaseInClicks>ValueHere</EstimatedIncreaseInClicks>
<EstimatedIncreaseInCost>ValueHere</EstimatedIncreaseInCost>
<EstimatedIncreaseInImpressions>ValueHere</EstimatedIncreaseInImpressions>
<MatchType>ValueHere</MatchType>
<MonthlySearches>ValueHere</MonthlySearches>
<SuggestedBid>ValueHere</SuggestedBid>
<SuggestedKeyword d4p1:nil="false">ValueHere</SuggestedKeyword>
<!--These fields are applicable if the derived type attribute is set to BroadMatchKeywordOpportunity-->
<AverageCPC>ValueHere</AverageCPC>
<AverageCTR>ValueHere</AverageCTR>
<ClickShare>ValueHere</ClickShare>
<ImpressionShare>ValueHere</ImpressionShare>
<ReferenceKeywordBid>ValueHere</ReferenceKeywordBid>
<ReferenceKeywordId>ValueHere</ReferenceKeywordId>
<ReferenceKeywordMatchType>ValueHere</ReferenceKeywordMatchType>
<SearchQueryKPIs d4p1:nil="false">
<BroadMatchSearchQueryKPI>
<AverageCTR>ValueHere</AverageCTR>
<Clicks>ValueHere</Clicks>
<Impressions>ValueHere</Impressions>
<SRPV>ValueHere</SRPV>
<SearchQuery d4p1:nil="false">ValueHere</SearchQuery>
</BroadMatchSearchQueryKPI>
</SearchQueryKPIs>
</KeywordOpportunity>
</Opportunities>
</GetKeywordOpportunitiesResponse>
</s:Body>
</s:Envelope>
程式碼語法
範例語法可以與 Bing 廣告 SDK搭配使用。 如需更多範例,請參閱 Bing 廣告 API 程式碼范 例。
public async Task<GetKeywordOpportunitiesResponse> GetKeywordOpportunitiesAsync(
long? adGroupId,
long? campaignId,
KeywordOpportunityType opportunityType)
{
var request = new GetKeywordOpportunitiesRequest
{
AdGroupId = adGroupId,
CampaignId = campaignId,
OpportunityType = opportunityType
};
return (await AdInsightService.CallAsync((s, r) => s.GetKeywordOpportunitiesAsync(r), request));
}
static GetKeywordOpportunitiesResponse getKeywordOpportunities(
java.lang.Long adGroupId,
java.lang.Long campaignId,
ArrayList<KeywordOpportunityType> opportunityType) throws RemoteException, Exception
{
GetKeywordOpportunitiesRequest request = new GetKeywordOpportunitiesRequest();
request.setAdGroupId(adGroupId);
request.setCampaignId(campaignId);
request.setOpportunityType(opportunityType);
return AdInsightService.getService().getKeywordOpportunities(request);
}
static function GetKeywordOpportunities(
$adGroupId,
$campaignId,
$opportunityType)
{
$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];
$request = new GetKeywordOpportunitiesRequest();
$request->AdGroupId = $adGroupId;
$request->CampaignId = $campaignId;
$request->OpportunityType = $opportunityType;
return $GLOBALS['AdInsightProxy']->GetService()->GetKeywordOpportunities($request);
}
response=adinsight_service.GetKeywordOpportunities(
AdGroupId=AdGroupId,
CampaignId=CampaignId,
OpportunityType=OpportunityType)
需求
服務: AdInsightService.svc v13
命名 空間: https://bingads.microsoft.com/AdInsight/v13