public static void main(java.lang.String[] args) {
try {
authorizationData = new AuthorizationData();
authorizationData.setDeveloperToken(DeveloperToken);
authorizationData.setAuthentication(new PasswordAuthentication(UserName, Password));
authorizationData.setCustomerId(CustomerId);
authorizationData.setAccountId(AccountId);
CampaignService =
new ServiceClient<ICampaignManagementService>(
authorizationData, ICampaignManagementService.class);
// Get the user's list of Bing Merchant Center (BMC) stores.
final ArrayOfBMCStore stores = getBMCStoresByCustomerId();
if (stores == null) {
outputStatusMessage(
String.format(
"Customer %d does not have any regeistered BMC stores.\n\n",
authorizationData.getCustomerId()));
return;
}
// Create a Bing Shopping campaign using the ID of the first store in the list.
Campaign campaign = new Campaign();
campaign.setName("Bing Shopping Campaign " + System.currentTimeMillis());
campaign.setDescription("Bing Shopping Campaign Example.");
campaign.setBudgetType(BudgetLimitType.MONTHLY_BUDGET_SPEND_UNTIL_DEPLETED);
campaign.setMonthlyBudget(1000.00);
campaign.setTimeZone("PacificTimeUSCanadaTijuana");
ArrayList<CampaignType> campaignTypes = new ArrayList<CampaignType>();
campaignTypes.add(CampaignType.SHOPPING);
ArrayOfSetting settings = new ArrayOfSetting();
ShoppingSetting shoppingSetting = new ShoppingSetting();
shoppingSetting.setPriority(0);
shoppingSetting.setSalesCountryCode("US");
shoppingSetting.setStoreId(stores.getBMCStores().get(0).getId());
settings.getSettings().add(shoppingSetting);
campaign.setSettings(settings);
campaign.setCampaignType(campaignTypes);
campaign.setDaylightSaving(true);
ArrayOfCampaign campaigns = new ArrayOfCampaign();
campaigns.getCampaigns().add(campaign);
AddCampaignsResponse addCampaignsResponse = addCampaigns(AccountId, campaigns);
ArrayOfNullableOflong campaignIds = addCampaignsResponse.getCampaignIds();
ArrayOfBatchError campaignErrors = addCampaignsResponse.getPartialErrors();
outputCampaignsWithPartialErrors(campaigns, campaignIds, campaignErrors);
ArrayOfAdGroup adGroups = new ArrayOfAdGroup();
AdGroup adGroup = new AdGroup();
adGroup.setName("Product Categories");
ArrayList<AdDistribution> adDistribution = new ArrayList<AdDistribution>();
adDistribution.add(AdDistribution.SEARCH);
adGroup.setAdDistribution(adDistribution);
adGroup.setBiddingModel(BiddingModel.KEYWORD);
adGroup.setPricingModel(PricingModel.CPC);
adGroup.setStartDate(null);
adGroup.setEndDate(new com.microsoft.bingads.v10.campaignmanagement.Date());
adGroup.getEndDate().setDay(31);
adGroup.getEndDate().setMonth(12);
adGroup.getEndDate().setYear(2016);
Bid searchBid = new Bid();
searchBid.setAmount(0.09);
adGroup.setSearchBid(searchBid);
adGroup.setLanguage("English");
adGroups.getAdGroups().add(adGroup);
AddAdGroupsResponse addAdGroupsResponse =
addAdGroups(campaignIds.getLongs().get(0), adGroups);
ArrayOfNullableOflong adGroupIds = addAdGroupsResponse.getAdGroupIds();
ArrayOfBatchError adGroupErrors = addAdGroupsResponse.getPartialErrors();
outputAdGroupsWithPartialErrors(adGroups, adGroupIds, adGroupErrors);
ArrayOfAd ads = new ArrayOfAd();
ProductAd productAd =
new ProductAd() {
{
promotionalText = "Free shipping on $99 purchases.";
}
};
ads.getAds().add(productAd);
AddAdsResponse addAdsResponse = addAds(adGroupIds.getLongs().get(0), ads);
ArrayOfNullableOflong adIds = addAdsResponse.getAdIds();
ArrayOfBatchError adErrors = addAdsResponse.getPartialErrors();
outputAdsWithPartialErrors(ads, adIds, adErrors);
// Add criterion to the campaign. The criterion is used to limit the campaign to a subset of
// your product catalog.
AddCampaignCriterionsResponse addCriterionResponse =
addCampaignCriterion(campaignIds.getLongs().get(0));
printCampaignCriterionIdentifiers(
addCriterionResponse.getCampaignCriterionIds(),
addCriterionResponse.getNestedPartialErrors());
addAndUpdateAdGroupCriterion(adGroupIds.getLongs().get(0));
ApplyProductPartitionActionsResponse applyPartitionActionsResponse =
addBranchAndLeafCriterion(adGroupIds.getLongs().get(0));
long rootId = applyPartitionActionsResponse.getAdGroupCriterionIds().getLongs().get(1);
long electronicsCriterionId =
applyPartitionActionsResponse.getAdGroupCriterionIds().getLongs().get(8);
updateBranchAndLeafCriterion(adGroupIds.getLongs().get(0), rootId, electronicsCriterionId);
// Delete the campaign from the account.
ArrayOflong deleteCampaignIds = new ArrayOflong();
deleteCampaignIds.getLongs().add(campaignIds.getLongs().get(0));
deleteCampaigns(AccountId, deleteCampaignIds);
outputStatusMessage(String.format("Deleted CampaignId %d\n", campaignIds.getLongs().get(0)));
// Campaign Management service operations can throw AdApiFaultDetail.
} catch (AdApiFaultDetail_Exception ex) {
outputStatusMessage("The operation failed with the following faults:\n");
for (AdApiError error : ex.getFaultInfo().getErrors().getAdApiErrors()) {
outputStatusMessage("AdApiError\n");
outputStatusMessage(
String.format(
"Code: %d\nError Code: %s\nMessage: %s\n\n",
error.getCode(), error.getErrorCode(), error.getMessage()));
}
// Campaign Management service operations can throw ApiFaultDetail.
} catch (ApiFaultDetail_Exception ex) {
outputStatusMessage("The operation failed with the following faults:\n");
for (BatchError error : ex.getFaultInfo().getBatchErrors().getBatchErrors()) {
outputStatusMessage(String.format("BatchError at Index: %d\n", error.getIndex()));
outputStatusMessage(
String.format("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage()));
}
for (OperationError error : ex.getFaultInfo().getOperationErrors().getOperationErrors()) {
outputStatusMessage("OperationError\n");
outputStatusMessage(
String.format("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage()));
}
// Some Campaign Management service operations such as SetAdExtensionsAssociations can throw
// EditorialApiFaultDetail.
} catch (EditorialApiFaultDetail_Exception ex) {
outputStatusMessage("The operation failed with the following faults:\n");
for (BatchError error : ex.getFaultInfo().getBatchErrors().getBatchErrors()) {
outputStatusMessage(String.format("BatchError at Index: %d\n", error.getIndex()));
outputStatusMessage(
String.format("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage()));
}
for (EditorialError error : ex.getFaultInfo().getEditorialErrors().getEditorialErrors()) {
outputStatusMessage(String.format("EditorialError at Index: %d\n\n", error.getIndex()));
outputStatusMessage(
String.format("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage()));
outputStatusMessage(
String.format(
"Appealable: %s\nDisapproved Text: %s\nCountry: %s\n\n",
error.getAppealable(), error.getDisapprovedText(), error.getPublisherCountry()));
}
for (OperationError error : ex.getFaultInfo().getOperationErrors().getOperationErrors()) {
outputStatusMessage("OperationError\n");
outputStatusMessage(
String.format("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage()));
}
} catch (RemoteException ex) {
outputStatusMessage("Service communication error encountered: ");
outputStatusMessage(ex.getMessage());
ex.printStackTrace();
} catch (Exception ex) {
outputStatusMessage("Error encountered: ");
outputStatusMessage(ex.getMessage());
ex.printStackTrace();
}
}
public static void main(java.lang.String[] args) {
NumberFormat currencyFmt = NumberFormat.getCurrencyInstance();
try
{
authorizationData = new AuthorizationData();
authorizationData.setDeveloperToken(DeveloperToken);
authorizationData.setAuthentication(new PasswordAuthentication(UserName, Password));
authorizationData.setCustomerId(CustomerId);
authorizationData.setAccountId(AccountId);
AdIntelligenceService = new ServiceClient<IAdIntelligenceService>(
authorizationData,
IAdIntelligenceService.class);
// Set the Currency, Keywords, Language, PublisherCountries, and TargetPositionForAds
// for the estimated bid by keywords request.
Currency currency = Currency.US_DOLLAR;
ArrayOfKeywordAndMatchType keywordAndMatchTypes = new ArrayOfKeywordAndMatchType();
ArrayOfMatchType matchTypes = new ArrayOfMatchType();
matchTypes.getMatchTypes().add(MatchType.EXACT);
matchTypes.getMatchTypes().add(MatchType.PHRASE);
matchTypes.getMatchTypes().add(MatchType.BROAD);
KeywordAndMatchType keywordAndMatchType1 = new KeywordAndMatchType();
keywordAndMatchType1.setKeywordText("flower");
keywordAndMatchType1.setMatchTypes(matchTypes);
keywordAndMatchTypes.getKeywordAndMatchTypes().add(keywordAndMatchType1);
KeywordAndMatchType keywordAndMatchType2 = new KeywordAndMatchType();
keywordAndMatchType2.setKeywordText("delivery");
keywordAndMatchType2.setMatchTypes(matchTypes);
keywordAndMatchTypes.getKeywordAndMatchTypes().add(keywordAndMatchType2);
java.lang.String language = "English";
ArrayOfstring publisherCountries = new ArrayOfstring();
publisherCountries.getStrings().add("US");
TargetAdPosition targetPositionForAds = TargetAdPosition.SIDE_BAR;
// GetKeywordEstimatedBidByKeywords helper method calls the corresponding Bing Ads AdIntelligenceService.getService() operation
// to request the KeywordEstimatedBids.
ArrayOfKeywordEstimatedBid keywordEstimatedBids = getKeywordEstimatedBidByKeywords(
currency,
keywordAndMatchTypes,
language,
publisherCountries,
targetPositionForAds
);
// GetAdGroupEstimatedBidByKeywords helper method calls the corresponding Bing Ads AdIntelligenceService.getService() operation
// to request the AdGroupEstimatedBid.
AdGroupEstimatedBid adGroupEstimatedBid = getAdGroupEstimatedBidByKeywords(
currency,
keywordAndMatchTypes,
language,
publisherCountries,
targetPositionForAds
);
// Print the KeywordEstimatedBids
if (keywordEstimatedBids != null)
{
System.out.println("KeywordEstimatedBids\n");
for (KeywordEstimatedBid bid : keywordEstimatedBids.getKeywordEstimatedBids())
{
if (bid == null)
{
System.out.println("The keyword is not valid.\n");
}
else
{
System.out.println(bid.getKeyword());
if (bid.getEstimatedBids() == null)
{
System.out.println(" There is no bid information available for the keyword.\n");
}
else
{
for (EstimatedBidAndTraffic estimatedBidAndTraffic : bid.getEstimatedBids().getEstimatedBidAndTraffics())
{
System.out.println(" Estimated Minimum Bid: " +
currencyFmt.format(estimatedBidAndTraffic.getEstimatedMinBid()));
System.out.println(" Match Type: " + estimatedBidAndTraffic.getMatchType());
System.out.println(" Average CPC: " +
(estimatedBidAndTraffic.getAverageCPC() != null ? currencyFmt.format(estimatedBidAndTraffic.getAverageCPC()) : "null"));
System.out.printf(" Estimated clicks per week: %s to %s\n",
estimatedBidAndTraffic.getMinClicksPerWeek(), estimatedBidAndTraffic.getMaxClicksPerWeek());
System.out.printf(" Estimated impressions per week: %s to %s\n",
estimatedBidAndTraffic.getMinImpressionsPerWeek(), estimatedBidAndTraffic.getMaxImpressionsPerWeek());
System.out.printf(" Estimated cost per week: %s to %s\n",
(estimatedBidAndTraffic.getMinTotalCostPerWeek() != null ? currencyFmt.format(estimatedBidAndTraffic.getMinTotalCostPerWeek()) : "null"),
(estimatedBidAndTraffic.getMaxTotalCostPerWeek() != null ? currencyFmt.format(estimatedBidAndTraffic.getMaxTotalCostPerWeek()) : "null"));
System.out.println();
}
}
}
}
}
// Print the AdGroupEstimatedBid
if (adGroupEstimatedBid != null) {
System.out.println("AdGroupEstimatedBid\n");
System.out.println(" Estimated Ad Group Bid: " +
currencyFmt.format(adGroupEstimatedBid.getEstimatedAdGroupBid()));
System.out.println(" Average CPC: " +
(adGroupEstimatedBid.getAverageCPC() != null ? currencyFmt.format(adGroupEstimatedBid.getAverageCPC()) : "null"));
System.out.printf(" Estimated clicks per week: %s to %s\n",
adGroupEstimatedBid.getMinClicksPerWeek(), adGroupEstimatedBid.getMaxClicksPerWeek());
System.out.printf(" Estimated impressions per week: %s to %s\n",
adGroupEstimatedBid.getMinImpressionsPerWeek(), adGroupEstimatedBid.getMaxImpressionsPerWeek());
System.out.printf(" Estimated cost per week: %s to %s\n",
(adGroupEstimatedBid.getMinTotalCostPerWeek() != null ? currencyFmt.format(adGroupEstimatedBid.getMinTotalCostPerWeek()) : "null"),
(adGroupEstimatedBid.getMaxTotalCostPerWeek() != null ? currencyFmt.format(adGroupEstimatedBid.getMaxTotalCostPerWeek()) : "null"));
System.out.println();
}
// Ad Intelligence service operations can throw AdApiFaultDetail.
} catch (AdApiFaultDetail_Exception ex) {
System.out.println("The operation failed with the following faults:\n");
for (AdApiError error : ex.getFaultInfo().getErrors().getAdApiErrors())
{
System.out.printf("AdApiError\n");
System.out.printf("Code: %d\nError Code: %s\nMessage: %s\n\n", error.getCode(), error.getErrorCode(), error.getMessage());
}
// Ad Intelligence service operations can throw ApiFaultDetail.
} catch (ApiFaultDetail_Exception ex) {
System.out.println("The operation failed with the following faults:\n");
for (BatchError error : ex.getFaultInfo().getBatchErrors().getBatchErrors())
{
System.out.printf("BatchError at Index: %d\n", error.getIndex());
System.out.printf("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage());
}
for (OperationError error : ex.getFaultInfo().getOperationErrors().getOperationErrors())
{
System.out.printf("OperationError\n");
System.out.printf("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage());
}
} catch (RemoteException ex) {
System.out.println("Service communication error encountered: ");
System.out.println(ex.getMessage());
ex.printStackTrace();
} catch (Exception ex) {
System.out.println("Error encountered: ");
System.out.println(ex.getMessage());
ex.printStackTrace();
}
}
public static void main(String[] args) {
BulkEntityIterable entities = null;
try {
authorizationData = new AuthorizationData();
authorizationData.setDeveloperToken(DeveloperToken);
authorizationData.setAuthentication(new PasswordAuthentication(UserName, Password));
authorizationData.setCustomerId(CustomerId);
authorizationData.setAccountId(AccountId);
// You will need to use the Campaign Management service to get the Bing Merchant Center Store
// Id. This will be used
// when creating a new Bing Shopping Campaign.
// For other operations such as adding product conditions, you can manage Bing Shopping
// Campaigns solely with the Bulk Service.
CampaignService =
new ServiceClient<ICampaignManagementService>(
authorizationData, ICampaignManagementService.class);
// Get the user's list of Bing Merchant Center (BMC) stores.
final ArrayOfBMCStore stores = getBMCStoresByCustomerId();
if (stores == null) {
System.out.printf(
"Customer %d does not have any regeistered BMC stores.\n\n",
authorizationData.getCustomerId());
return;
}
BulkService = new BulkServiceManager(authorizationData);
BulkService.setStatusPollIntervalInMilliseconds(5000);
List<BulkEntity> uploadEntities = new ArrayList<BulkEntity>();
/* Add a new Bing Shopping campaign that will be associated with a ProductScope criterion.
* - Set the CampaignType element of the Campaign to Shopping.
* - Create a ShoppingSetting instance and set its Priority (0, 1, or 2), SalesCountryCode, and StoreId elements.
* Add this shopping setting to the Settings list of the Campaign.
*/
BulkCampaign bulkCampaign = new BulkCampaign();
// ClientId may be used to associate records in the bulk upload file with records in the
// results file. The value of this field
// is not used or stored by the server; it is simply copied from the uploaded record to the
// corresponding result record.
// Note: This bulk file Client Id is not related to an application Client Id for OAuth.
bulkCampaign.setClientId("YourClientIdGoesHere");
Campaign campaign =
new Campaign() {
{
// When using the Campaign Management service, the Id cannot be set. In the context of
// a BulkCampaign, the Id is optional
// and may be used as a negative reference key during bulk upload. For example the
// same negative value set for the campaign Id
// will be used when associating this new campaign with a new campaign product scope
// in the BulkCampaignProductScope object below.
id = campaignIdKey;
name = "Bing Shopping Campaign " + System.currentTimeMillis();
description = "Bing Shopping Campaign Example.";
budgetType = BudgetLimitType.MONTHLY_BUDGET_SPEND_UNTIL_DEPLETED;
monthlyBudget = 1000.00;
timeZone = "PacificTimeUSCanadaTijuana";
campaignType =
new ArrayList<CampaignType>() {
{
add(CampaignType.SHOPPING);
}
};
status = CampaignStatus.PAUSED;
settings =
new ArrayOfSetting() {
{
settings =
new ArrayList<Setting>() {
{
add(
new ShoppingSetting() {
{
priority = 0;
salesCountryCode = "US";
storeId = stores.getBMCStores().get(0).getId();
}
});
}
};
}
};
}
};
bulkCampaign.setCampaign(campaign);
/* Optionally, you can create a ProductScope criterion that will be associated with your Bing Shopping campaign.
* Use the product scope criterion to include a subset of your product catalog, for example a specific brand,
* category, or product type. A campaign can only be associated with one ProductScope, which contains a list
* of up to 7 ProductCondition. You'll also be able to specify more specific product conditions for each ad group.
*/
BulkCampaignProductScope bulkCampaignProductScope = new BulkCampaignProductScope();
CampaignCriterion campaignCriterion =
new CampaignCriterion() {
{
campaignId = campaignIdKey;
criterion =
new ProductScope() {
{
conditions =
new ArrayOfProductCondition() {
{
productConditions =
new ArrayList<ProductCondition>() {
{
add(
new ProductCondition() {
{
operand = "Condition";
attribute = "New";
}
});
add(
new ProductCondition() {
{
operand = "Brand";
attribute = "Contoso";
}
});
}
};
}
};
}
};
}
};
bulkCampaignProductScope.setCampaignCriterion(campaignCriterion);
// Specify one or more ad groups.
BulkAdGroup bulkAdGroup = new BulkAdGroup();
bulkAdGroup.setCampaignId(campaignIdKey);
AdGroup adGroup = new AdGroup();
adGroup.setName("Product Categories");
ArrayList<AdDistribution> adDistribution = new ArrayList<AdDistribution>();
adDistribution.add(AdDistribution.SEARCH);
adGroup.setAdDistribution(adDistribution);
adGroup.setBiddingModel(BiddingModel.KEYWORD);
adGroup.setPricingModel(PricingModel.CPC);
adGroup.setStartDate(null);
Calendar calendar = Calendar.getInstance();
adGroup.setEndDate(new com.microsoft.bingads.campaignmanagement.Date());
adGroup.getEndDate().setDay(31);
adGroup.getEndDate().setMonth(12);
adGroup.getEndDate().setYear(calendar.get(Calendar.YEAR));
adGroup.setLanguage("English");
bulkAdGroup.setAdGroup(adGroup);
/*
* Create a product ad. You must add at least one ProductAd to the corresponding ad group.
* A ProductAd is not used directly for delivered ad copy. Instead, the delivery engine generates
* product ads from the product details that it finds in your Bing Merchant Center store's product catalog.
* The primary purpose of the ProductAd object is to provide promotional text that the delivery engine
* adds to the product ads that it generates. For example, if the promotional text is set to
* “Free shipping on $99 purchases”, the delivery engine will set the product ad’s description to
* “Free shipping on $99 purchases.”
*/
BulkProductAd bulkProductAd = new BulkProductAd();
bulkProductAd.setAdGroupId(adGroupIdKey);
ProductAd productAd =
new ProductAd() {
{
promotionalText = "Free shipping on $99 purchases.";
}
};
bulkProductAd.setAd(productAd);
uploadEntities.add(bulkCampaign);
uploadEntities.add(bulkCampaignProductScope);
uploadEntities.add(bulkAdGroup);
uploadEntities.add(bulkProductAd);
Reader = uploadEntities(uploadEntities);
// Upload and write the output
entities = Reader.getEntities();
List<BulkCampaign> campaignResults = new ArrayList<BulkCampaign>();
List<BulkAdGroup> adGroupResults = new ArrayList<BulkAdGroup>();
List<BulkProductAd> productAdResults = new ArrayList<BulkProductAd>();
List<BulkCampaignProductScope> campaignProductScopeResults =
new ArrayList<BulkCampaignProductScope>();
for (BulkEntity entity : entities) {
if (entity instanceof BulkCampaign) {
campaignResults.add((BulkCampaign) entity);
outputBulkCampaigns(Arrays.asList((BulkCampaign) entity));
} else if (entity instanceof BulkAdGroup) {
adGroupResults.add((BulkAdGroup) entity);
outputBulkAdGroups(Arrays.asList((BulkAdGroup) entity));
} else if (entity instanceof BulkProductAd) {
productAdResults.add((BulkProductAd) entity);
outputBulkProductAds(Arrays.asList((BulkProductAd) entity));
} else if (entity instanceof BulkCampaignProductScope) {
campaignProductScopeResults.add((BulkCampaignProductScope) entity);
outputBulkCampaignProductScopes(Arrays.asList((BulkCampaignProductScope) entity));
}
}
entities.close();
Reader.close();
java.lang.Long adGroupId = adGroupResults.get(0).getAdGroup().getId();
// Add a biddable criterion as the root.
BulkAdGroupProductPartition root =
addPartition(
adGroupId,
null,
new ProductCondition() {
{
setOperand("All");
setAttribute(null);
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"root");
outputStatusMessage("Applying only the root as a Unit with a bid . . . \n");
ArrayList<BulkAdGroupProductPartition> bulkApplyProductPartitionActionsResults =
applyBulkProductPartitionActions(_partitionActions);
ArrayList<BulkAdGroupProductPartition> productPartitions =
getBulkAdGroupProductPartitionTree(adGroupId);
outputStatusMessage("The ad group's product partition only has a tree root node: \n");
outputProductPartitions(productPartitions);
/*
* Let's update the bid of the root Unit we just added.
*/
_partitionActions.clear();
BulkAdGroupProductPartition updatedRoot =
getNodeByClientId(bulkApplyProductPartitionActionsResults, "root");
updatedRoot.getAdGroupCriterion().setAdGroupId(adGroupId);
((BiddableAdGroupCriterion) updatedRoot.getAdGroupCriterion())
.setCriterionBid(getFixedBid(0.40));
_partitionActions.add(updatedRoot);
outputStatusMessage("Updating the bid for the tree root node . . . \n");
applyBulkProductPartitionActions(_partitionActions);
productPartitions = getBulkAdGroupProductPartitionTree(adGroupId);
outputStatusMessage("Updated the bid for the tree root node: \n");
outputProductPartitions(productPartitions);
/*
* Now we will overwrite any existing tree root, and build a product partition group tree structure in multiple steps.
* You could build the entire tree in a single call since there are less than 20,000 nodes; however,
* we will build it in steps to demonstrate how to use the results from bulk upload to update the tree.
*
* For a list of validation rules, see the Bing Shopping Campaigns technical guide:
* https://msdn.microsoft.com/en-US/library/bing-ads-campaign-management-bing-shopping-campaigns.aspx
*/
_partitionActions.clear();
/*
* Check whether a root node exists already.
*/
BulkAdGroupProductPartition existingRoot =
getNodeByClientId(bulkApplyProductPartitionActionsResults, "root");
if (existingRoot != null) {
existingRoot.setClientId("deletedroot");
existingRoot.getAdGroupCriterion().setStatus(AdGroupCriterionStatus.DELETED);
_partitionActions.add(existingRoot);
}
root =
addPartition(
adGroupId,
null,
new ProductCondition() {
{
setOperand("All");
setAttribute(null);
}
},
ProductPartitionType.SUBDIVISION,
null,
false,
"root");
/*
* The direct children of any node must have the same Operand.
* For this example we will use CategoryL1 nodes as children of the root.
* For a list of valid CategoryL1 through CategoryL5 values, see the Bing Category Taxonomy:
* http://advertise.bingads.microsoft.com/en-us/WWDocs/user/search/en-us/Bing_Category_Taxonomy.txt
*/
BulkAdGroupProductPartition animalsSubdivision =
addPartition(
adGroupId,
root,
new ProductCondition() {
{
setOperand("CategoryL1");
setAttribute("Animals & Pet Supplies");
}
},
ProductPartitionType.SUBDIVISION,
null,
false,
"animalsSubdivision");
/*
* If you use a CategoryL2 node, it must be a descendant (child or later) of a CategoryL1 node.
* In other words you cannot have a CategoryL2 node as parent of a CategoryL1 node.
* For this example we will a CategoryL2 node as child of the CategoryL1 Animals & Pet Supplies node.
*/
BulkAdGroupProductPartition petSuppliesSubdivision =
addPartition(
adGroupId,
animalsSubdivision,
new ProductCondition() {
{
setOperand("CategoryL2");
setAttribute("Pet Supplies");
}
},
ProductPartitionType.SUBDIVISION,
null,
false,
"petSuppliesSubdivision");
BulkAdGroupProductPartition brandA =
addPartition(
adGroupId,
petSuppliesSubdivision,
new ProductCondition() {
{
setOperand("Brand");
setAttribute("Brand A");
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"brandA");
/*
* If you won't bid on Brand B, set the helper method's bid to 'null' and isNegative to true.
* The helper method will create a NegativeAdGroupCriterion and apply the condition.
*/
BulkAdGroupProductPartition brandB =
addPartition(
adGroupId,
petSuppliesSubdivision,
new ProductCondition() {
{
setOperand("Brand");
setAttribute("Brand B");
}
},
ProductPartitionType.UNIT,
null,
true,
"brandB");
BulkAdGroupProductPartition otherBrands =
addPartition(
adGroupId,
petSuppliesSubdivision,
new ProductCondition() {
{
setOperand("Brand");
setAttribute(null);
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"otherBrands");
BulkAdGroupProductPartition otherPetSupplies =
addPartition(
adGroupId,
animalsSubdivision,
new ProductCondition() {
{
setOperand("CategoryL2");
setAttribute(null);
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"otherPetSupplies");
BulkAdGroupProductPartition electronics =
addPartition(
adGroupId,
root,
new ProductCondition() {
{
setOperand("CategoryL1");
setAttribute("Electronics");
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"electronics");
BulkAdGroupProductPartition otherCategoryL1 =
addPartition(
adGroupId,
root,
new ProductCondition() {
{
setOperand("CategoryL1");
setAttribute(null);
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"otherCategoryL1");
outputStatusMessage("Applying product partitions to the ad group . . . \n");
bulkApplyProductPartitionActionsResults = applyBulkProductPartitionActions(_partitionActions);
productPartitions = getBulkAdGroupProductPartitionTree(adGroupId);
/*
* The product partition group tree now has 9 nodes.
All other (Root Node)
|
+-- Animals & Pet Supplies (CategoryL1)
| |
| +-- Pet Supplies (CategoryL2)
| | |
| | +-- Brand A
| | |
| | +-- Brand B
| | |
| | +-- All other (Brand)
| |
| +-- All other (CategoryL2)
|
+-- Electronics (CategoryL1)
|
+-- All other (CategoryL1)
*/
outputStatusMessage("The product partition group tree now has 9 nodes: \n");
outputProductPartitions(productPartitions);
/*
* Let's replace the Electronics (CategoryL1) node created above with an Electronics (CategoryL1) node that
* has children i.e. Brand C (Brand), Brand D (Brand), and All other (Brand) as follows:
Electronics (CategoryL1)
|
+-- Brand C (Brand)
|
+-- Brand D (Brand)
|
+-- All other (Brand)
*/
_partitionActions.clear();
/*
* To replace a node we must know its Id and its ParentCriterionId. In this case the parent of the node
* we are replacing is All other (Root Node). The node that we are replacing is Electronics (CategoryL1).
*/
long rootId =
getNodeByClientId(bulkApplyProductPartitionActionsResults, "root")
.getAdGroupCriterion()
.getId();
electronics
.getAdGroupCriterion()
.setId(
getNodeByClientId(bulkApplyProductPartitionActionsResults, "electronics")
.getAdGroupCriterion()
.getId());
electronics.getAdGroupCriterion().setStatus(AdGroupCriterionStatus.DELETED);
_partitionActions.add(electronics);
BulkAdGroupProductPartition parent = new BulkAdGroupProductPartition();
AdGroupCriterion adGroupCriterion = new BiddableAdGroupCriterion();
adGroupCriterion.setId(rootId);
parent.setAdGroupCriterion(adGroupCriterion);
parent.getAdGroupCriterion().setAdGroupId(adGroupId);
BulkAdGroupProductPartition electronicsSubdivision =
addPartition(
adGroupId,
parent,
new ProductCondition() {
{
setOperand("CategoryL1");
setAttribute("Electronics");
}
},
ProductPartitionType.SUBDIVISION,
null,
false,
"electronicsSubdivision");
BulkAdGroupProductPartition brandC =
addPartition(
adGroupId,
electronicsSubdivision,
new ProductCondition() {
{
setOperand("Brand");
setAttribute("Brand C");
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"brandC");
BulkAdGroupProductPartition brandD =
addPartition(
adGroupId,
electronicsSubdivision,
new ProductCondition() {
{
setOperand("Brand");
setAttribute("Brand D");
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"brandD");
BulkAdGroupProductPartition otherElectronicBrands =
addPartition(
adGroupId,
electronicsSubdivision,
new ProductCondition() {
{
setOperand("Brand");
setAttribute(null);
}
},
ProductPartitionType.UNIT,
getFixedBid(0.35),
false,
"otherElectronicBrands");
outputStatusMessage(
"Updating the product partition group to refine Electronics (CategoryL1) with 3 child nodes . . . \n");
bulkApplyProductPartitionActionsResults = applyBulkProductPartitionActions(_partitionActions);
productPartitions = getBulkAdGroupProductPartitionTree(adGroupId);
/*
* The product partition group tree now has 12 nodes, including the children of Electronics (CategoryL1):
All other (Root Node)
|
+-- Animals & Pet Supplies (CategoryL1)
| |
| +-- Pet Supplies (CategoryL2)
| | |
| | +-- Brand A
| | |
| | +-- Brand B
| | |
| | +-- All other (Brand)
| |
| +-- All other (CategoryL2)
|
+-- Electronics (CategoryL1)
| |
| +-- Brand C (Brand)
| |
| +-- Brand D (Brand)
| |
| +-- All other (Brand)
|
+-- All other (CategoryL1)
*/
outputStatusMessage(
"The product partition group tree now has 12 nodes, including the children of Electronics (CategoryL1): \n");
outputProductPartitions(productPartitions);
/* Delete the campaign, ad group, criterion, and ad that were previously added.
* You should remove this region if you want to view the added entities in the
* Bing Ads web application or another tool.
*/
java.lang.Long campaignId = campaignResults.get(0).getCampaign().getId();
bulkCampaign = new BulkCampaign();
bulkCampaign.setCampaign(new Campaign());
bulkCampaign.getCampaign().setId(campaignId);
bulkCampaign.getCampaign().setStatus(CampaignStatus.DELETED);
uploadEntities = new ArrayList<BulkEntity>();
uploadEntities.add(bulkCampaign);
Reader = uploadEntities(uploadEntities);
// Upload and write the output
entities = Reader.getEntities();
for (BulkEntity entity : entities) {
if (entity instanceof BulkCampaign) {
campaignResults.add((BulkCampaign) entity);
outputBulkCampaigns(Arrays.asList((BulkCampaign) entity));
}
}
entities.close();
Reader.close();
outputStatusMessage("Deleted CampaignId " + campaignId + "\n");
// Bulk service operations can throw AdApiFaultDetail.
} catch (com.microsoft.bingads.bulk.AdApiFaultDetail_Exception ex) {
System.out.println("The operation failed with the following faults:\n");
for (com.microsoft.bingads.bulk.AdApiError error :
ex.getFaultInfo().getErrors().getAdApiErrors()) {
System.out.printf("AdApiError\n");
System.out.printf(
"Code: %d\nError Code: %s\nMessage: %s\n\n",
error.getCode(), error.getErrorCode(), error.getMessage());
}
// Bulk service operations can throw ApiFaultDetail.
} catch (com.microsoft.bingads.bulk.ApiFaultDetail_Exception ex) {
System.out.println("The operation failed with the following faults:\n");
for (com.microsoft.bingads.bulk.BatchError error :
ex.getFaultInfo().getBatchErrors().getBatchErrors()) {
System.out.printf("BatchError at Index: %d\n", error.getIndex());
System.out.printf("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage());
}
for (com.microsoft.bingads.bulk.OperationError error :
ex.getFaultInfo().getOperationErrors().getOperationErrors()) {
System.out.printf("OperationError\n");
System.out.printf("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage());
}
// Campaign Management service operations can throw AdApiFaultDetail.
} catch (com.microsoft.bingads.campaignmanagement.AdApiFaultDetail_Exception ex) {
System.out.println("The operation failed with the following faults:\n");
for (com.microsoft.bingads.campaignmanagement.AdApiError error :
ex.getFaultInfo().getErrors().getAdApiErrors()) {
System.out.printf("AdApiError\n");
System.out.printf(
"Code: %d\nError Code: %s\nMessage: %s\n\n",
error.getCode(), error.getErrorCode(), error.getMessage());
}
// Campaign Management service operations can throw ApiFaultDetail.
} catch (com.microsoft.bingads.campaignmanagement.ApiFaultDetail_Exception ex) {
System.out.println("The operation failed with the following faults:\n");
for (com.microsoft.bingads.campaignmanagement.BatchError error :
ex.getFaultInfo().getBatchErrors().getBatchErrors()) {
System.out.printf("BatchError at Index: %d\n", error.getIndex());
System.out.printf("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage());
}
for (com.microsoft.bingads.campaignmanagement.OperationError error :
ex.getFaultInfo().getOperationErrors().getOperationErrors()) {
System.out.printf("OperationError\n");
System.out.printf("Code: %d\nMessage: %s\n\n", error.getCode(), error.getMessage());
}
} catch (RemoteException ex) {
System.out.println("Service communication error encountered: ");
System.out.println(ex.getMessage());
ex.printStackTrace();
} catch (Exception ex) {
System.out.println("Error encountered: ");
System.out.println(ex.getMessage());
ex.printStackTrace();
} finally {
if (entities != null) {
try {
entities.close();
} catch (IOException ex) {
ex.printStackTrace();
}
}
}
System.exit(0);
}