title | ms.service | ms.subservice | ms.topic | author | ms.author | description | dev_langs | ||||
---|---|---|---|---|---|---|---|---|---|---|---|
TagRecommendations Service Operation - Ad Insight |
bing-ads |
ad-insight-api |
article |
jonmeyers |
jonmeyers |
Notifies Microsoft Advertising that the specific recommendation to create responsive search ads should be tagged as *applied* or *dismissed*. |
|
Notifies Microsoft Advertising that the specific recommendation to create responsive search ads should be tagged as applied or dismissed. The dismissed recommendations won't be surfaced to users when calling GetRecommendations in the next 30 days.
The TagRecommendationsRequest object defines the body and header elements of the service operation request. The elements must be in the same order as shown in the Request SOAP.
Note
Unless otherwise noted below, all request elements are required.
Element | Description | Data Type |
---|---|---|
Lable | The value must be set to either applied or dismissed | string |
RecommendationsInfo | The information for an individual recommendation. Duplicate RecommendationInfo (RecommendationId) will be returned as DuplicateRecommendationInfo error. You may specify a maximum of 100 input elements. |
RecommendationInfo array |
RecommendationType | The identifier of the recommendation type that you have applied. Currently only ResponsiveSearchAdsOpportunity is supported. This element cannot be nil or empty. One specific recommendation type per request, e.g., ResponsiveSearchAdsOpportunity. |
string |
[!INCLUDErequest-header]
The TagRecommendationsResponse object defines the body and header elements of the service operation response. The elements are returned in the same order as shown in the Response SOAP.
Element | Description | Data Type |
---|---|---|
PartialErrors | An array BatchError that contains details for any request items that were not successful. The list of errors does not correspond directly to the list of items in the request. The list can be empty if there were no errors, or it can include one or more error objects corresponding to each unsuccessful list item in the request. |
BatchError array |
[!INCLUDEresponse-header]
This template was generated by a tool to show the order of the body and header elements for the SOAP request. For supported types that you can use with this service operation, see the Request Body Elements reference above.
<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">TagRecommendations</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>
<TagRecommendationsRequest xmlns="https://bingads.microsoft.com/AdInsight/v13">
<RecommendationType i:nil="false">ValueHere</RecommendationType>
<RecommendationsInfo i:nil="false">
<RecommendationInfo i:type="-- derived type specified here with the appropriate prefix --">
<RecommendationHash i:nil="false">ValueHere</RecommendationHash>
<RecommendationId i:nil="false">ValueHere</RecommendationId>
<!--This field is applicable if the derived type attribute is set to RSARecommendationInfo-->
<AdId i:nil="false">ValueHere</AdId>
</RecommendationInfo>
</RecommendationsInfo>
<Lable i:nil="false">ValueHere</Lable>
</TagRecommendationsRequest>
</s:Body>
</s:Envelope>
This template was generated by a tool to show the order of the body and header elements for the SOAP response.
<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>
<TagRecommendationsResponse xmlns="https://bingads.microsoft.com/AdInsight/v13">
<PartialErrors d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">
<BatchError>
<Code>ValueHere</Code>
<Details d4p1:nil="false">ValueHere</Details>
<ErrorCode d4p1:nil="false">ValueHere</ErrorCode>
<Index>ValueHere</Index>
<Message d4p1:nil="false">ValueHere</Message>
</BatchError>
</PartialErrors>
</TagRecommendationsResponse>
</s:Body>
</s:Envelope>
The example syntax can be used with Bing Ads SDKs. See Bing Ads API Code Examples for more examples.
public async Task<TagRecommendationsResponse> TagRecommendationsAsync(
string recommendationType,
IList<RecommendationInfo> recommendationsInfo,
string lable)
{
var request = new TagRecommendationsRequest
{
RecommendationType = recommendationType,
RecommendationsInfo = recommendationsInfo,
Lable = lable
};
return (await AdInsightService.CallAsync((s, r) => s.TagRecommendationsAsync(r), request));
}
static TagRecommendationsResponse tagRecommendations(
java.lang.String recommendationType,
ArrayOfRecommendationInfo recommendationsInfo,
java.lang.String lable) throws RemoteException, Exception
{
TagRecommendationsRequest request = new TagRecommendationsRequest();
request.setRecommendationType(recommendationType);
request.setRecommendationsInfo(recommendationsInfo);
request.setLable(lable);
return AdInsightService.getService().tagRecommendations(request);
}
static function TagRecommendations(
$recommendationType,
$recommendationsInfo,
$lable)
{
$GLOBALS['Proxy'] = $GLOBALS['AdInsightProxy'];
$request = new TagRecommendationsRequest();
$request->RecommendationType = $recommendationType;
$request->RecommendationsInfo = $recommendationsInfo;
$request->Lable = $lable;
return $GLOBALS['AdInsightProxy']->GetService()->TagRecommendations($request);
}
response=adinsight_service.TagRecommendations(
RecommendationType=RecommendationType,
RecommendationsInfo=RecommendationsInfo,
Lable=Lable)
Service: AdInsightService.svc v13
Namespace: https://bingads.microsoft.com/AdInsight/v13