/// <summary>
/// Adds the campaign targeting criteria to a campaign.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="campaignId">The campaign id.</param>
/// <returns>The campaign criteria id.</returns>
public long AddCampaignTargetingCriteria(AdWordsUser user, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService) user.GetService(
AdWordsService.v201601.CampaignCriterionService);
// Create language criteria.
// See http://code.google.com/apis/adwords/docs/appendix/languagecodes.html
// for a detailed list of language codes.
Language language1 = new Language();
language1.id = 1002; // French
CampaignCriterion languageCriterion1 = new CampaignCriterion();
languageCriterion1.campaignId = campaignId;
languageCriterion1.criterion = language1;
CampaignCriterion[] criteria = new CampaignCriterion[] { languageCriterion1 };
List<CampaignCriterionOperation> operations = new List<CampaignCriterionOperation>();
foreach (CampaignCriterion criterion in criteria) {
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.ADD;
operation.operand = criterion;
operations.Add(operation);
}
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
return retVal.value[0].criterion.id;
}
/// <summary>
/// Adds the campaign targeting criteria to a campaign.
/// </summary>
/// <param name="user">The user.</param>
/// <param name="campaignId">The campaign id.</param>
/// <returns>The campaign criteria id.</returns>
public long AddCampaignTargetingCriteria(AdWordsUser user, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201406.CampaignCriterionService);
// Create language criteria.
// See http://code.google.com/apis/adwords/docs/appendix/languagecodes.html
// for a detailed list of language codes.
Language language1 = new Language();
language1.id = 1002; // French
CampaignCriterion languageCriterion1 = new CampaignCriterion();
languageCriterion1.campaignId = campaignId;
languageCriterion1.criterion = language1;
CampaignCriterion[] criteria = new CampaignCriterion[] { languageCriterion1 };
List <CampaignCriterionOperation> operations = new List <CampaignCriterionOperation>();
foreach (CampaignCriterion criterion in criteria)
{
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.ADD;
operation.operand = criterion;
operations.Add(operation);
}
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
return(retVal.value[0].criterion.id);
}
/// <summary>
/// Adds a language criterion to the draft campaign.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// /// <param name="draftCampaignResourceName">Resource name of the draft campaign.</param>
private static void AddLanguageCriteria(GoogleAdsClient client, long customerId,
string draftCampaignResourceName)
{
// Get the CampaignCriterionService.
CampaignCriterionServiceClient campaignCriterionService =
client.GetService(Services.V4.CampaignCriterionService);
// Add a language criterion.
CampaignCriterionOperation criterionOperation = new CampaignCriterionOperation()
{
Create = new CampaignCriterion()
{
Language = new LanguageInfo()
{
// Spanish
LanguageConstant = ResourceNames.LanguageConstant(1003)
},
Campaign = draftCampaignResourceName
}
};
MutateCampaignCriteriaResponse campaignCriteriaResponse =
campaignCriterionService.MutateCampaignCriteria(
customerId.ToString(),
new CampaignCriterionOperation[] { criterionOperation });
string newCampaignCriterionResource = campaignCriteriaResponse.Results[0].ResourceName;
Console.WriteLine($"Campaign Criterion with resource ID = " +
$"'{newCampaignCriterionResource}' was added to campaign with resource ID = " +
$"'{draftCampaignResourceName}'.");
}
/// <summary>
/// Builds new campaign criterion operations for creating negative campaign criteria
/// (as keywords).
/// </summary>
/// <param name="campaignOperations">The campaign operations to be used to create
/// campaign criteria.</param>
/// <returns>The campaign criterion operations.</returns>
private static List <CampaignCriterionOperation> BuildCampaignCriterionOperations(
List <CampaignOperation> campaignOperations)
{
List <CampaignCriterionOperation> operations =
new List <CampaignCriterionOperation>();
foreach (CampaignOperation campaignOperation in campaignOperations)
{
// Creates a campaign criterion.
CampaignCriterion campaignCriterion = new CampaignCriterion()
{
Keyword = new KeywordInfo()
{
Text = "venus",
MatchType = KeywordMatchType.Broad
},
// Sets the campaign criterion as a negative criterion.
Negative = true,
Campaign = campaignOperation.Create.ResourceName
};
// Creates a campaign criterion operation and adds it to the operations list.
CampaignCriterionOperation op = new CampaignCriterionOperation()
{
Create = campaignCriterion
};
operations.Add(op);
}
return(operations);
}
// [END setup_remarketing_4]
/// <summary>
/// Updates the bid modifier on a campaign criterion.
/// </summary>
/// <param name="client">The Google Ads API client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="campaignCriterionResourceName">The resource name of the campaign criterion to update.</param>
/// <param name="bidModifierValue">The bid modifier value.</param>
private void ModifyCampaignBids(
GoogleAdsClient client,
long customerId,
string campaignCriterionResourceName,
double bidModifierValue)
{
// Get the CampaignCriterionService client.
CampaignCriterionServiceClient campaignCriterionServiceClient =
client.GetService(Services.V10.CampaignCriterionService);
// Create the campaign criterion to update.
CampaignCriterion campaignCriterion = new CampaignCriterion
{
ResourceName = campaignCriterionResourceName,
BidModifier = (float)bidModifierValue
};
// Create the update operation.
CampaignCriterionOperation campaignCriterionOperation = new CampaignCriterionOperation
{
Update = campaignCriterion,
UpdateMask = FieldMasks.AllSetFieldsOf(campaignCriterion)
};
// Update the campaign criterion and print the results.
MutateCampaignCriteriaResponse mutateCampaignCriteriaResponse =
campaignCriterionServiceClient.MutateCampaignCriteria(customerId.ToString(),
new[] { campaignCriterionOperation });
Console.WriteLine("Successfully updated the bid for campaign criterion with resource " +
$"name '{mutateCampaignCriteriaResponse.Results.First().CampaignCriterion}'.");
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="baseCampaignId">Id of the campaign to use as base of the
/// draft.</param>
public void Run(AdWordsUser user, long baseCampaignId)
{
// Get the DraftService.
DraftService draftService = (DraftService)user.GetService(
AdWordsService.v201603.DraftService);
Draft draft = new Draft()
{
baseCampaignId = baseCampaignId,
draftName = "Test Draft #" + ExampleUtilities.GetRandomString()
};
DraftOperation draftOperation = new DraftOperation()
{
@operator = Operator.ADD,
operand = draft
};
try {
draft = draftService.mutate(new DraftOperation[] { draftOperation }).value[0];
Console.WriteLine("Draft with ID {0}, base campaign ID {1} and draft campaign ID " +
"{2} created.", draft.draftId, draft.baseCampaignId, draft.draftCampaignId);
// Once the draft is created, you can modify the draft campaign as if it
// were a real campaign. For example, you may add criteria, adjust bids,
// or even include additional ads. Adding a criterion is shown here.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201603.CampaignCriterionService);
Language language = new Language()
{
id = 1003L // Spanish
};
// Make sure to use the draftCampaignId when modifying the virtual draft
// campaign.
CampaignCriterion campaignCriterion = new CampaignCriterion()
{
campaignId = draft.draftCampaignId,
criterion = language
};
CampaignCriterionOperation criterionOperation = new CampaignCriterionOperation()
{
@operator = Operator.ADD,
operand = campaignCriterion
};
campaignCriterion = campaignCriterionService.mutate(
new CampaignCriterionOperation[] { criterionOperation }).value[0];
Console.WriteLine("Draft updated to include criteria in draft campaign ID {0}.",
draft.draftCampaignId);
} catch (Exception e) {
throw new System.ApplicationException("Failed to create draft campaign and add " +
"criteria.", e);
}
}
/// <summary>
/// Sets the campaign's targeting criteria.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaign">The campaign for which targeting criteria is
/// created.</param>
private void SetCampaignTargetingCriteria(AdWordsUser user, Campaign campaign) {
using (CampaignCriterionService campaignCriterionService =
(CampaignCriterionService) user.GetService(
AdWordsService.v201802.CampaignCriterionService)) {
// Create locations. The IDs can be found in the documentation or
// retrieved with the LocationCriterionService.
Location california = new Location() {
id = 21137L
};
Location mexico = new Location() {
id = 2484L
};
// Create languages. The IDs can be found in the documentation or
// retrieved with the ConstantDataService.
Language english = new Language() {
id = 1000L
};
Language spanish = new Language() {
id = 1003L
};
List<Criterion> criteria = new List<Criterion>() {
california, mexico, english, spanish };
// Create operations to add each of the criteria above.
List<CampaignCriterionOperation> operations = new List<CampaignCriterionOperation>();
foreach (Criterion criterion in criteria) {
CampaignCriterionOperation operation = new CampaignCriterionOperation() {
operand = new CampaignCriterion() {
campaignId = campaign.id,
criterion = criterion
},
@operator = Operator.ADD
};
operations.Add(operation);
}
// Set the campaign targets.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(
operations.ToArray());
if (retVal != null && retVal.value != null) {
// Display the added campaign targets.
foreach (CampaignCriterion criterion in retVal.value) {
Console.WriteLine("Campaign criteria of type '{0}' and id '{1}' was added.",
criterion.criterion.CriterionType, criterion.criterion.id);
}
}
}
}
/// <summary>Snippet for MutateCampaignCriteria</summary>
/// <remarks>
/// This snippet has been automatically generated for illustrative purposes only.
/// It may require modifications to work in your environment.
/// </remarks>
public void MutateCampaignCriteria()
{
// Create client
CampaignCriterionServiceClient campaignCriterionServiceClient = CampaignCriterionServiceClient.Create();
// Initialize request argument(s)
string customerId = "";
IEnumerable <CampaignCriterionOperation> operations = new CampaignCriterionOperation[]
{
new CampaignCriterionOperation(),
};
// Make the request
MutateCampaignCriteriaResponse response = campaignCriterionServiceClient.MutateCampaignCriteria(customerId, operations);
}
public UpdateGeoTargetsResponse UpdateCampaignGeoTargets(string campaignId, UpdateGeoTargetsRequest updateGeoTargetsRequest)
{
UpdateGeoTargetsResponse updateResponse = new UpdateGeoTargetsResponse()
{
Success = true
};
Operator action = Operator.ADD;
if (updateGeoTargetsRequest.UpdateMode == UpdateMode.Remove)
{
action = Operator.REMOVE;
}
List <KeyValuePair <string, string> > pairs = ExtractCityStatePairsFromRequets(updateGeoTargetsRequest);
CampaignCriterionService campaignCriterionService = (CampaignCriterionService)_adwordsUser.GetService(AdWordsService.v201708.CampaignCriterionService);
List <GeoTarget> targets = _locationNameHelper.GetTargetIdsByLocationNames(pairs);
List <CampaignCriterionOperation> operations = new List <CampaignCriterionOperation>();
foreach (GeoTarget target in targets)
{
Location location = new Location()
{
id = Convert.ToInt64(target.Id)
};
CampaignCriterionOperation operation = new CampaignCriterionOperation();
CampaignCriterion campaignCriterion = new CampaignCriterion();
campaignCriterion.campaignId = Convert.ToInt64(campaignId);
campaignCriterion.criterion = location;
campaignCriterion.CampaignCriterionType = "Location";
operation.operand = campaignCriterion;
operation.@operator = action;
operations.Add(operation);
}
try
{
CampaignCriterionReturnValue result = campaignCriterionService.mutate(operations.ToArray());
}
catch (Exception ex)
{
var exception = ex.Message;
updateResponse.Success = false;
}
return(updateResponse);
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="adGroupId">Id of the campaign whose bid should be modified.
/// </param>
/// <param name="bidModifier">The bid modifier.</param>
public void Run(AdWordsUser user, long campaignId, double bidModifier)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201409.CampaignCriterionService);
// Create mobile platform. The ID can be found in the documentation.
// https://developers.google.com/adwords/api/docs/appendix/platforms
Platform mobile = new Platform();
mobile.id = 30001;
// Create criterion with modified bid.
CampaignCriterion criterion = new CampaignCriterion();
criterion.campaignId = campaignId;
criterion.criterion = mobile;
criterion.bidModifier = bidModifier;
// Create SET operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.SET;
operation.operand = criterion;
try {
// Update campaign criteria.
CampaignCriterionReturnValue result = campaignCriterionService.mutate(
new CampaignCriterionOperation[] { operation });
// Display campaign criteria.
if (result.value != null)
{
foreach (CampaignCriterion newCriterion in result.value)
{
Console.WriteLine("Campaign criterion with campaign id '{0}', criterion id '{1}', " +
"and type '{2}' was modified with bid {3:F2}.", newCriterion.campaignId,
newCriterion.criterion.id, newCriterion.criterion.type, newCriterion.bidModifier);
}
}
else
{
Console.WriteLine("No campaign criteria were modified.");
}
} catch (Exception ex) {
throw new System.ApplicationException("Failed to set bid modifier for campaign.", ex);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="campaignId">ID of the campaign that contains the criterion.</param>
/// <param name="criterionId">ID of the criterion for which bid modifier is updated.</param>
/// <param name="bidModifierValue">The new value of the bid modifier to update.</param>
public void Run(GoogleAdsClient client, long customerId, long campaignId, long criterionId,
float?bidModifierValue)
{
// Get the CampaignCriterionServiceClient .
CampaignCriterionServiceClient campaignCriterionService =
client.GetService(Services.V10.CampaignCriterionService);
string criterionResourceName = ResourceNames.CampaignCriteria(customerId,
campaignId, criterionId);
// Construct a campaign bid modifier.
CampaignCriterion campaignCriterion = new CampaignCriterion()
{
ResourceName = criterionResourceName,
BidModifier = (bidModifierValue != null) ? bidModifierValue.Value : 1.5f,
};
// Construct an operation to create the campaign criterion.
CampaignCriterionOperation op = new CampaignCriterionOperation()
{
Update = campaignCriterion,
UpdateMask = FieldMasks.AllSetFieldsOf(campaignCriterion)
};
// Send the operation in a mutate request.
try
{
MutateCampaignCriteriaResponse response =
campaignCriterionService.MutateCampaignCriteria(customerId.ToString(),
new CampaignCriterionOperation[] { op });
foreach (MutateCampaignCriterionResult result in response.Results)
{
Console.WriteLine($"Campaign criterion with resource name" +
$" '{result.ResourceName}' was modified.");
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
/// <summary>Snippet for MutateCampaignCriteriaAsync</summary>
public async Task MutateCampaignCriteriaAsync()
{
// Snippet: MutateCampaignCriteriaAsync(string, IEnumerable<CampaignCriterionOperation>, CallSettings)
// Additional: MutateCampaignCriteriaAsync(string, IEnumerable<CampaignCriterionOperation>, CancellationToken)
// Create client
CampaignCriterionServiceClient campaignCriterionServiceClient = await CampaignCriterionServiceClient.CreateAsync();
// Initialize request argument(s)
string customerId = "";
IEnumerable <CampaignCriterionOperation> operations = new CampaignCriterionOperation[]
{
new CampaignCriterionOperation(),
};
// Make the request
MutateCampaignCriteriaResponse response = await campaignCriterionServiceClient.MutateCampaignCriteriaAsync(customerId, operations);
// End snippet
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign for which shopping channel
/// is set.</param>
public void Run(AdWordsUser user, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201406.CampaignCriterionService);
// ProductSalesChannel is a fixed id criterion, with the possible values
// defined here.
// ONLINE: 200
// LOCAL: 201
ProductSalesChannel productSalesChannel = new ProductSalesChannel();
productSalesChannel.id = 200;
CampaignCriterion campaignCriterion = new CampaignCriterion();
campaignCriterion.campaignId = campaignId;
campaignCriterion.criterion = productSalesChannel;
// Create operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.operand = campaignCriterion;
operation.@operator = Operator.ADD;
try {
// Make the mutate request.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(
new CampaignCriterionOperation[] { operation });
if (retVal != null && retVal.value != null)
{
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value)
{
Console.WriteLine("Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType, criterion.campaignId);
}
}
} catch (Exception ex) {
throw new System.ApplicationException("Failed to set shopping product channel.", ex);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="adGroupId">Id of the campaign whose bid should be modified.
/// </param>
/// <param name="bidModifier">The bid modifier.</param>
public void Run(AdWordsUser user, long campaignId, double bidModifier) {
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService) user.GetService(
AdWordsService.v201509.CampaignCriterionService);
// Create mobile platform. The ID can be found in the documentation.
// https://developers.google.com/adwords/api/docs/appendix/platforms
Platform mobile = new Platform();
mobile.id = 30001;
// Create criterion with modified bid.
CampaignCriterion criterion = new CampaignCriterion();
criterion.campaignId = campaignId;
criterion.criterion = mobile;
criterion.bidModifier = bidModifier;
// Create SET operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.SET;
operation.operand = criterion;
try {
// Update campaign criteria.
CampaignCriterionReturnValue result = campaignCriterionService.mutate(
new CampaignCriterionOperation[] {operation});
// Display campaign criteria.
if (result.value != null) {
foreach (CampaignCriterion newCriterion in result.value) {
Console.WriteLine("Campaign criterion with campaign id '{0}', criterion id '{1}', " +
"and type '{2}' was modified with bid {3:F2}.", newCriterion.campaignId,
newCriterion.criterion.id, newCriterion.criterion.type, newCriterion.bidModifier);
}
} else {
Console.WriteLine("No campaign criteria were modified.");
}
} catch (Exception e) {
throw new System.ApplicationException("Failed to set bid modifier for campaign.", e);
}
}
// [END setup_remarketing_2]
/// <summary>
/// Creates a campaign criterion that targets a user list with a campaign.
/// </summary>
/// <param name="client">The Google Ads API client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="campaignId">The campaign on which the user list will be targeted.</param>
/// <param name="userListResourceName">The resource name of the user list to be
/// targeted.</param>
/// <returns>The resource name of the newly created campaign criterion.</returns>
// [START setup_remarketing_4]
private string TargetAdsInCampaignToUserList(
GoogleAdsClient client, long customerId, long campaignId, string userListResourceName)
{
// Get the CampaignCriterionService client.
CampaignCriterionServiceClient campaignCriterionServiceClient =
client.GetService(Services.V10.CampaignCriterionService);
// Create the campaign criterion.
CampaignCriterion campaignCriterion = new CampaignCriterion
{
Campaign = ResourceNames.Campaign(customerId, campaignId),
UserList = new UserListInfo
{
UserList = userListResourceName
}
};
// Create the operation.
CampaignCriterionOperation campaignCriterionOperation = new CampaignCriterionOperation
{
Create = campaignCriterion
};
// Add the campaign criterion and print the resulting criterion's resource name.
MutateCampaignCriteriaResponse mutateCampaignCriteriaResponse =
campaignCriterionServiceClient.MutateCampaignCriteria(customerId.ToString(),
new[] { campaignCriterionOperation });
string campaignCriterionResourceName =
mutateCampaignCriteriaResponse.Results.First().ResourceName;
Console.WriteLine("Successfully created campaign criterion with resource name " +
$"'{campaignCriterionResourceName}' targeting user list with resource name " +
$"'{userListResourceName}' with campaign with ID {campaignId}.");
return(campaignCriterionResourceName);
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">The campaign id to add product scope.</param>
public void Run(AdWordsUser user, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201609.CampaignCriterionService);
ProductScope productScope = new ProductScope();
// This set of dimensions is for demonstration purposes only. It would be
// extremely unlikely that you want to include so many dimensions in your
// product scope.
ProductBrand nexusBrand = new ProductBrand();
nexusBrand.value = "Nexus";
ProductCanonicalCondition newProducts = new ProductCanonicalCondition();
newProducts.condition = ProductCanonicalConditionCondition.NEW;
ProductCustomAttribute customAttribute = new ProductCustomAttribute();
customAttribute.type = ProductDimensionType.CUSTOM_ATTRIBUTE_0;
customAttribute.value = "my attribute value";
ProductOfferId bookOffer = new ProductOfferId();
bookOffer.value = "book1";
ProductType mediaProducts = new ProductType();
mediaProducts.type = ProductDimensionType.PRODUCT_TYPE_L1;
mediaProducts.value = "Media";
ProductType bookProducts = new ProductType();
bookProducts.type = ProductDimensionType.PRODUCT_TYPE_L2;
bookProducts.value = "Books";
// The value for the bidding category is a fixed ID for the
// 'Luggage & Bags' category. You can retrieve IDs for categories from
// the ConstantDataService. See the 'GetProductCategoryTaxonomy' example
// for more details.
ProductBiddingCategory luggageBiddingCategory = new ProductBiddingCategory();
luggageBiddingCategory.type = ProductDimensionType.BIDDING_CATEGORY_L1;
luggageBiddingCategory.value = -5914235892932915235;
productScope.dimensions = new ProductDimension[] { nexusBrand, newProducts, bookOffer,
mediaProducts, luggageBiddingCategory };
CampaignCriterion campaignCriterion = new CampaignCriterion();
campaignCriterion.campaignId = campaignId;
campaignCriterion.criterion = productScope;
// Create operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.operand = campaignCriterion;
operation.@operator = Operator.ADD;
try {
// Make the mutate request.
CampaignCriterionReturnValue result = campaignCriterionService.mutate(
new CampaignCriterionOperation[] { operation });
Console.WriteLine("Created a ProductScope criterion with ID '{0}'",
result.value[0].criterion.id);
} catch (Exception e) {
throw new System.ApplicationException("Failed to set shopping product scope.", e);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign to which targeting criteria
/// are added.</param>
/// <param name="feedId">ID of a feed that has been configured for location
/// targeting, meaning it has an ENABLED FeedMapping with criterionType of
/// 77. Feeds linked to a GMB account automatically have this FeedMapping.
/// If you don't have such a feed, set this value to null.</param>
public void Run(AdWordsUser user, long campaignId, long?feedId)
{
using (CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(AdWordsService.v201802
.CampaignCriterionService))
{
// Create locations. The IDs can be found in the documentation or
// retrieved with the LocationCriterionService.
Location california = new Location()
{
id = 21137L
};
Location mexico = new Location()
{
id = 2484L
};
// Create languages. The IDs can be found in the documentation or
// retrieved with the ConstantDataService.
Language english = new Language()
{
id = 1000L
};
Language spanish = new Language()
{
id = 1003L
};
List <Criterion> criteria = new List <Criterion>()
{
california,
mexico,
english,
spanish
};
// Distance targeting. Area of 10 miles around the locations in the location feed.
if (feedId != null)
{
LocationGroups radiusLocationGroup = new LocationGroups()
{
feedId = feedId.Value,
matchingFunction = new Function()
{
@operator = FunctionOperator.IDENTITY,
lhsOperand = new FunctionArgumentOperand[]
{
new LocationExtensionOperand()
{
radius = new ConstantOperand()
{
type = ConstantOperandConstantType.DOUBLE,
unit = ConstantOperandUnit.MILES,
doubleValue = 10
}
}
}
}
};
criteria.Add(radiusLocationGroup);
}
// Create operations to add each of the criteria above.
List <CampaignCriterionOperation>
operations = new List <CampaignCriterionOperation>();
foreach (Criterion criterion in criteria)
{
CampaignCriterionOperation operation = new CampaignCriterionOperation()
{
operand = new CampaignCriterion()
{
campaignId = campaignId,
criterion = criterion
},
@operator = Operator.ADD
};
operations.Add(operation);
}
// Add a negative campaign criterion.
CampaignCriterion negativeCriterion = new NegativeCampaignCriterion()
{
campaignId = campaignId,
criterion = new Keyword()
{
text = "jupiter cruise",
matchType = KeywordMatchType.BROAD
}
};
CampaignCriterionOperation negativeCriterionOperation =
new CampaignCriterionOperation()
{
operand = negativeCriterion,
@operator = Operator.ADD
};
operations.Add(negativeCriterionOperation);
try
{
// Set the campaign targets.
CampaignCriterionReturnValue retVal =
campaignCriterionService.mutate(operations.ToArray());
if (retVal != null && retVal.value != null)
{
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value)
{
Console.WriteLine(
"Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType,
criterion.campaignId);
}
}
}
catch (Exception e)
{
throw new System.ApplicationException("Failed to set Campaign criteria.", e);
}
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign to which targeting criteria
/// are added.</param>
public void Run(AdWordsUser user, long campaignId) {
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService) user.GetService(
AdWordsService.v201509.CampaignCriterionService);
// Create language criteria.
// See http://code.google.com/apis/adwords/docs/appendix/languagecodes.html
// for a detailed list of language codes.
Language language1 = new Language();
language1.id = 1002; // French
CampaignCriterion languageCriterion1 = new CampaignCriterion();
languageCriterion1.campaignId = campaignId;
languageCriterion1.criterion = language1;
Language language2 = new Language();
language2.id = 1005; // Japanese
CampaignCriterion languageCriterion2 = new CampaignCriterion();
languageCriterion2.campaignId = campaignId;
languageCriterion2.criterion = language2;
// Create location criteria.
// See http://code.google.com/apis/adwords/docs/appendix/countrycodes.html
// for a detailed list of country codes.
Location location1 = new Location();
location1.id = 2840; // USA
CampaignCriterion locationCriterion1 = new CampaignCriterion();
locationCriterion1.campaignId = campaignId;
locationCriterion1.criterion = location1;
Location location2 = new Location();
location2.id = 2392; // Japan
CampaignCriterion locationCriterion2 = new CampaignCriterion();
locationCriterion2.campaignId = campaignId;
locationCriterion2.criterion = location2;
// Add a negative campaign placement.
NegativeCampaignCriterion negativeCriterion = new NegativeCampaignCriterion();
negativeCriterion.campaignId = campaignId;
Placement placement = new Placement();
placement.url = "http://mars.google.com";
negativeCriterion.criterion = placement;
CampaignCriterion[] criteria = new CampaignCriterion[] {languageCriterion1,
languageCriterion2, locationCriterion1, locationCriterion2, negativeCriterion};
List<CampaignCriterionOperation> operations = new List<CampaignCriterionOperation>();
foreach (CampaignCriterion criterion in criteria) {
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.ADD;
operation.operand = criterion;
operations.Add(operation);
}
try {
// Set the campaign targets.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
if (retVal != null && retVal.value != null) {
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value) {
Console.WriteLine("Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType, criterion.campaignId);
}
}
} catch (Exception e) {
throw new System.ApplicationException("Failed to set Campaign criteria.", e);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="campaignId">ID of the campaign to which targeting criteria are added.
/// </param>
/// <param name="keywordText">the keyword text for which to add a criterion.</param>
/// <param name="locationId">the locationId for which to add a criterion.</param>
public void Run(GoogleAdsClient client, long customerId, long campaignId,
string keywordText, long locationId)
{
// Get the CampaignCriterionService.
CampaignCriterionServiceClient campaignCriterionService =
client.GetService(Services.V1.CampaignCriterionService);
// Set the Campaign Resource Name
string campaignResourceName = ResourceNames.Campaign(customerId, campaignId);
// Add a campaign level negative keyword from keywordText.
CampaignCriterion keywordCriterion = buildNegativeKeywordCriterion(keywordText,
campaignResourceName);
// Creates a location constant (provided by GeoTargetConstantService) as a campaign
// targeting criterion. Please refer to GetGeoTargetConstantsByName.cs for retrieval
// of location constants.
CampaignCriterion locationCriterion = buildLocationCriterion(locationId,
campaignResourceName);
// Add a proximity criterion
CampaignCriterion proximityCriterion = buildProximityCriterion(campaignResourceName);
// Create the operations.
CampaignCriterionOperation negativeCriterionOperation =
new CampaignCriterionOperation()
{
Create = keywordCriterion
};
CampaignCriterionOperation locationCriterionOperation =
new CampaignCriterionOperation()
{
Create = locationCriterion
};
CampaignCriterionOperation proximityCriterionOperation =
new CampaignCriterionOperation()
{
Create = proximityCriterion
};
CampaignCriterionOperation[] operations = new CampaignCriterionOperation[] {
negativeCriterionOperation,
locationCriterionOperation,
proximityCriterionOperation
};
try
{
// Create the campaign criterion.
MutateCampaignCriteriaResponse response =
campaignCriterionService.MutateCampaignCriteria(customerId.ToString(),
operations);
// Display the results.
foreach (MutateCampaignCriterionResult criterionResult in response.Results)
{
Console.WriteLine($"New campaign criterion with resource name = " +
$"'{criterionResult.ResourceName}' was added to campaign " +
"ID {campaignId}.");
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign to which targeting criteria
/// are added.</param>
/// <param name="feedId">ID of a feed that has been configured for location
/// targeting, meaning it has an ENABLED FeedMapping with criterionType of
/// 77. Feeds linked to a GMB account automatically have this FeedMapping.
/// If you don't have such a feed, set this value to null.</param>
public void Run(AdWordsUser user, long campaignId, long? feedId) {
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService) user.GetService(
AdWordsService.v201509.CampaignCriterionService);
// Create language criteria.
// See http://code.google.com/apis/adwords/docs/appendix/languagecodes.html
// for a detailed list of language codes.
Language language1 = new Language();
language1.id = 1002; // French
CampaignCriterion languageCriterion1 = new CampaignCriterion();
languageCriterion1.campaignId = campaignId;
languageCriterion1.criterion = language1;
Language language2 = new Language();
language2.id = 1005; // Japanese
CampaignCriterion languageCriterion2 = new CampaignCriterion();
languageCriterion2.campaignId = campaignId;
languageCriterion2.criterion = language2;
// Target Tier 3 income group near Miami, Florida.
LocationGroups incomeLocationGroups = new LocationGroups();
IncomeOperand incomeOperand = new IncomeOperand();
// Tiers are numbered 1-10, and represent 10% segments of earners.
// For example, TIER_1 is the top 10%, TIER_2 is the 80-90%, etc.
// Tiers 6 through 10 are grouped into TIER_6_TO_10.
incomeOperand.tier = IncomeTier.TIER_3;
GeoTargetOperand geoTargetOperand1 = new GeoTargetOperand();
geoTargetOperand1.locations = new long[] { 1015116 }; // Miami, FL.
incomeLocationGroups.matchingFunction = new Function();
incomeLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { incomeOperand };
incomeLocationGroups.matchingFunction.@operator = FunctionOperator.AND;
incomeLocationGroups.matchingFunction.rhsOperand =
new FunctionArgumentOperand[] { geoTargetOperand1 };
CampaignCriterion locationGroupCriterion1 = new CampaignCriterion();
locationGroupCriterion1.campaignId = campaignId;
locationGroupCriterion1.criterion = incomeLocationGroups;
// Target places of interest near Downtown Miami, Florida.
LocationGroups interestLocationGroups = new LocationGroups();
PlacesOfInterestOperand placesOfInterestOperand = new PlacesOfInterestOperand();
placesOfInterestOperand.category = PlacesOfInterestOperandCategory.DOWNTOWN;
GeoTargetOperand geoTargetOperand2 = new GeoTargetOperand();
geoTargetOperand2.locations = new long[] { 1015116 }; // Miami, FL.
interestLocationGroups.matchingFunction = new Function();
interestLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { placesOfInterestOperand };
interestLocationGroups.matchingFunction.@operator = FunctionOperator.AND;
interestLocationGroups.matchingFunction.rhsOperand =
new FunctionArgumentOperand[] { geoTargetOperand2 };
CampaignCriterion locationGroupCriterion2 = new CampaignCriterion();
locationGroupCriterion2.campaignId = campaignId;
locationGroupCriterion2.criterion = interestLocationGroups;
CampaignCriterion locationGroupCriterion3 = new CampaignCriterion();
if (feedId.HasValue) {
// Distance targeting. Area of 10 miles around targets above.
ConstantOperand radius = new ConstantOperand();
radius.type = ConstantOperandConstantType.DOUBLE;
radius.unit = ConstantOperandUnit.MILES;
radius.doubleValue = 10.0;
LocationExtensionOperand distance = new LocationExtensionOperand();
distance.radius = radius;
LocationGroups radiusLocationGroups = new LocationGroups();
radiusLocationGroups.matchingFunction = new Function();
radiusLocationGroups.matchingFunction.@operator = FunctionOperator.IDENTITY;
radiusLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { distance };
// FeedID should be the ID of a feed that has been configured for location
// targeting, meaning it has an ENABLED FeedMapping with criterionType of
// 77. Feeds linked to a GMB account automatically have this FeedMapping.
radiusLocationGroups.feedId = feedId.Value;
locationGroupCriterion3.campaignId = campaignId;
locationGroupCriterion3.criterion = radiusLocationGroups;
}
// Create location criteria.
// See http://code.google.com/apis/adwords/docs/appendix/countrycodes.html
// for a detailed list of country codes.
Location location1 = new Location();
location1.id = 2840; // USA
CampaignCriterion locationCriterion1 = new CampaignCriterion();
locationCriterion1.campaignId = campaignId;
locationCriterion1.criterion = location1;
Location location2 = new Location();
location2.id = 2392; // Japan
CampaignCriterion locationCriterion2 = new CampaignCriterion();
locationCriterion2.campaignId = campaignId;
locationCriterion2.criterion = location2;
// Add a negative campaign keyword.
NegativeCampaignCriterion negativeCriterion = new NegativeCampaignCriterion();
negativeCriterion.campaignId = campaignId;
Keyword keyword = new Keyword();
keyword.matchType = KeywordMatchType.BROAD;
keyword.text = "jupiter cruise";
negativeCriterion.criterion = keyword;
List<CampaignCriterion> criteria = new List<CampaignCriterion>(
new CampaignCriterion[] {languageCriterion1,
languageCriterion2, locationCriterion1, locationCriterion2, negativeCriterion,
locationGroupCriterion1, locationGroupCriterion2});
if (feedId.HasValue) {
criteria.Add(locationGroupCriterion3);
}
List<CampaignCriterionOperation> operations = new List<CampaignCriterionOperation>();
foreach (CampaignCriterion criterion in criteria) {
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.ADD;
operation.operand = criterion;
operations.Add(operation);
}
try {
// Set the campaign targets.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
if (retVal != null && retVal.value != null) {
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value) {
Console.WriteLine("Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType, criterion.campaignId);
}
}
} catch (Exception e) {
throw new System.ApplicationException("Failed to set Campaign criteria.", e);
}
}
/// <summary>
/// Sets campaign targeting criteria for a given campaign. Both location and language
/// targeting are illustrated.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="campaignResourceName">The resource name of the campaign to apply
/// targeting to.</param>
private void SetCampaignTargetingCriteria(GoogleAdsClient client, long customerId,
string campaignResourceName)
{
// Get the CampaignCriterionService.
CampaignCriterionServiceClient campaignCriterionService = client.GetService(
Services.V4.CampaignCriterionService);
List <CampaignCriterionOperation> operations = new List <CampaignCriterionOperation>();
// Creates the location campaign criteria.
// Besides using location_id, you can also search by location names from
// GeoTargetConstantService.suggestGeoTargetConstants() and directly
// apply GeoTargetConstant.resource_name here. An example can be found
// in GetGeoTargetConstantByNames.cs.
int[] locationIds = new int[]
{
21137, // California
2484 // Mexico
};
foreach (int locationId in locationIds)
{
// Creates a campaign criterion.
CampaignCriterion campaignCriterion = new CampaignCriterion()
{
Campaign = campaignResourceName,
Type = CriterionType.Location,
Location = new LocationInfo()
{
GeoTargetConstant = ResourceNames.GeoTargetConstant(locationId)
}
};
// Creates a campaign criterion operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation()
{
Create = campaignCriterion
};
operations.Add(operation);
}
// Creates the language campaign criteria.
int[] languageIds = new int[]
{
1000, // English
1003 // Spanish
};
foreach (int languageId in languageIds)
{
// Creates a campaign criterion.
CampaignCriterion campaignCriterion = new CampaignCriterion()
{
Campaign = campaignResourceName,
Type = CriterionType.Language,
Language = new LanguageInfo()
{
LanguageConstant = ResourceNames.LanguageConstant(languageId)
}
};
// Creates a campaign criterion operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation()
{
Create = campaignCriterion
};
operations.Add(operation);
}
// Submits the criteria operations and prints their information.
MutateCampaignCriteriaResponse response =
campaignCriterionService.MutateCampaignCriteria(customerId.ToString(), operations);
Console.WriteLine($"Created {response.Results.Count} campaign criteria with " +
$"resource names:");
foreach (MutateCampaignCriterionResult result in response.Results)
{
Console.WriteLine(result.ResourceName);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign to which targeting criteria
/// are added.</param>
/// <param name="feedId">ID of a feed that has been configured for location
/// targeting, meaning it has an ENABLED FeedMapping with criterionType of
/// 77. Feeds linked to a GMB account automatically have this FeedMapping.
/// If you don't have such a feed, set this value to null.</param>
public void Run(AdWordsUser user, long campaignId, long?feedId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201605.CampaignCriterionService);
// Create locations. The IDs can be found in the documentation or
// retrieved with the LocationCriterionService.
Location california = new Location()
{
id = 21137L
};
Location mexico = new Location()
{
id = 2484L
};
// Create languages. The IDs can be found in the documentation or
// retrieved with the ConstantDataService.
Language english = new Language()
{
id = 1000L
};
Language spanish = new Language()
{
id = 1003L
};
// Location groups criteria. These represent targeting by household income
// or places of interest. The IDs can be found in the documentation or
// retrieved with the LocationCriterionService.
LocationGroups locationGroupTier3 = new LocationGroups();
Function tier3MatchingFunction = new Function();
tier3MatchingFunction.lhsOperand = new FunctionArgumentOperand[] {
// Tiers are numbered 1-10, and represent 10% segments of earners.
// For example, TIER_1 is the top 10%, TIER_2 is the 80-90%, etc.
// Tiers 6 through 10 are grouped into TIER_6_TO_10.
new IncomeOperand()
{
tier = IncomeTier.TIER_3
}
};
tier3MatchingFunction.@operator = FunctionOperator.AND;
tier3MatchingFunction.rhsOperand = new FunctionArgumentOperand[] {
new GeoTargetOperand()
{
locations = new long[] { 1015116L } // Miami, FL
}
};
locationGroupTier3.matchingFunction = tier3MatchingFunction;
LocationGroups locationGroupDowntown = new LocationGroups()
{
matchingFunction = new Function()
{
lhsOperand = new FunctionArgumentOperand[] {
new PlacesOfInterestOperand()
{
category = PlacesOfInterestOperandCategory.DOWNTOWN
}
},
@operator = FunctionOperator.AND,
rhsOperand = new FunctionArgumentOperand[] {
new GeoTargetOperand()
{
locations = new long[] { 1015116L } // Miami, FL
}
}
}
};
List <Criterion> criteria = new List <Criterion>()
{
california, mexico, english, spanish, locationGroupTier3
};
// Distance targeting. Area of 10 miles around the locations in the location feed.
if (feedId != null)
{
LocationGroups radiusLocationGroup = new LocationGroups()
{
feedId = feedId.Value,
matchingFunction = new Function()
{
@operator = FunctionOperator.IDENTITY,
lhsOperand = new FunctionArgumentOperand[] {
new LocationExtensionOperand()
{
radius = new ConstantOperand()
{
type = ConstantOperandConstantType.DOUBLE,
unit = ConstantOperandUnit.MILES,
doubleValue = 10
}
}
}
}
};
criteria.Add(radiusLocationGroup);
}
// Create operations to add each of the criteria above.
List <CampaignCriterionOperation> operations = new List <CampaignCriterionOperation>();
foreach (Criterion criterion in criteria)
{
CampaignCriterionOperation operation = new CampaignCriterionOperation()
{
operand = new CampaignCriterion()
{
campaignId = campaignId,
criterion = criterion
},
@operator = Operator.ADD
};
operations.Add(operation);
}
// Add a negative campaign criterion.
CampaignCriterion negativeCriterion = new NegativeCampaignCriterion()
{
campaignId = campaignId,
criterion = new Keyword()
{
text = "jupiter cruise",
matchType = KeywordMatchType.BROAD
}
};
CampaignCriterionOperation negativeCriterionOperation = new CampaignCriterionOperation()
{
operand = negativeCriterion,
@operator = Operator.ADD
};
operations.Add(negativeCriterionOperation);
try {
// Set the campaign targets.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
if (retVal != null && retVal.value != null)
{
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value)
{
Console.WriteLine("Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType, criterion.campaignId);
}
}
} catch (Exception e) {
throw new System.ApplicationException("Failed to set Campaign criteria.", e);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign to which targeting criteria
/// are added.</param>
public void Run(AdWordsUser user, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201502.CampaignCriterionService);
// Create language criteria.
// See http://code.google.com/apis/adwords/docs/appendix/languagecodes.html
// for a detailed list of language codes.
Language language1 = new Language();
language1.id = 1002; // French
CampaignCriterion languageCriterion1 = new CampaignCriterion();
languageCriterion1.campaignId = campaignId;
languageCriterion1.criterion = language1;
Language language2 = new Language();
language2.id = 1005; // Japanese
CampaignCriterion languageCriterion2 = new CampaignCriterion();
languageCriterion2.campaignId = campaignId;
languageCriterion2.criterion = language2;
// Create location criteria.
// See http://code.google.com/apis/adwords/docs/appendix/countrycodes.html
// for a detailed list of country codes.
Location location1 = new Location();
location1.id = 2840; // USA
CampaignCriterion locationCriterion1 = new CampaignCriterion();
locationCriterion1.campaignId = campaignId;
locationCriterion1.criterion = location1;
Location location2 = new Location();
location2.id = 2392; // Japan
CampaignCriterion locationCriterion2 = new CampaignCriterion();
locationCriterion2.campaignId = campaignId;
locationCriterion2.criterion = location2;
// Add a negative campaign placement.
NegativeCampaignCriterion negativeCriterion = new NegativeCampaignCriterion();
negativeCriterion.campaignId = campaignId;
Placement placement = new Placement();
placement.url = "http://mars.google.com";
negativeCriterion.criterion = placement;
CampaignCriterion[] criteria = new CampaignCriterion[] { languageCriterion1,
languageCriterion2, locationCriterion1, locationCriterion2, negativeCriterion };
List <CampaignCriterionOperation> operations = new List <CampaignCriterionOperation>();
foreach (CampaignCriterion criterion in criteria)
{
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.ADD;
operation.operand = criterion;
operations.Add(operation);
}
try {
// Set the campaign targets.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
if (retVal != null && retVal.value != null)
{
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value)
{
Console.WriteLine("Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType, criterion.campaignId);
}
}
} catch (Exception e) {
throw new System.ApplicationException("Failed to set Campaign criteria.", e);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign to which targeting criteria
/// are added.</param>
/// <param name="feedId">ID of a feed that has been configured for location
/// targeting, meaning it has an ENABLED FeedMapping with criterionType of
/// 77. Feeds linked to a GMB account automatically have this FeedMapping.
/// If you don't have such a feed, set this value to null.</param>
public void Run(AdWordsUser user, long campaignId, long?feedId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201506.CampaignCriterionService);
// Create language criteria.
// See http://code.google.com/apis/adwords/docs/appendix/languagecodes.html
// for a detailed list of language codes.
Language language1 = new Language();
language1.id = 1002; // French
CampaignCriterion languageCriterion1 = new CampaignCriterion();
languageCriterion1.campaignId = campaignId;
languageCriterion1.criterion = language1;
Language language2 = new Language();
language2.id = 1005; // Japanese
CampaignCriterion languageCriterion2 = new CampaignCriterion();
languageCriterion2.campaignId = campaignId;
languageCriterion2.criterion = language2;
// Target Tier 3 income group near Miami, Florida.
LocationGroups incomeLocationGroups = new LocationGroups();
IncomeOperand incomeOperand = new IncomeOperand();
// Tiers are numbered 1-10, and represent 10% segments of earners.
// For example, TIER_1 is the top 10%, TIER_2 is the 80-90%, etc.
// Tiers 6 through 10 are grouped into TIER_6_TO_10.
incomeOperand.tier = IncomeTier.TIER_3;
GeoTargetOperand geoTargetOperand1 = new GeoTargetOperand();
geoTargetOperand1.locations = new long[] { 1015116 }; // Miami, FL.
incomeLocationGroups.matchingFunction = new Function();
incomeLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { incomeOperand };
incomeLocationGroups.matchingFunction.@operator = FunctionOperator.AND;
incomeLocationGroups.matchingFunction.rhsOperand =
new FunctionArgumentOperand[] { geoTargetOperand1 };
CampaignCriterion locationGroupCriterion1 = new CampaignCriterion();
locationGroupCriterion1.campaignId = campaignId;
locationGroupCriterion1.criterion = incomeLocationGroups;
// Target places of interest near Downtown Miami, Florida.
LocationGroups interestLocationGroups = new LocationGroups();
PlacesOfInterestOperand placesOfInterestOperand = new PlacesOfInterestOperand();
placesOfInterestOperand.category = PlacesOfInterestOperandCategory.DOWNTOWN;
GeoTargetOperand geoTargetOperand2 = new GeoTargetOperand();
geoTargetOperand2.locations = new long[] { 1015116 }; // Miami, FL.
interestLocationGroups.matchingFunction = new Function();
interestLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { placesOfInterestOperand };
interestLocationGroups.matchingFunction.@operator = FunctionOperator.AND;
interestLocationGroups.matchingFunction.rhsOperand =
new FunctionArgumentOperand[] { geoTargetOperand2 };
CampaignCriterion locationGroupCriterion2 = new CampaignCriterion();
locationGroupCriterion2.campaignId = campaignId;
locationGroupCriterion2.criterion = interestLocationGroups;
CampaignCriterion locationGroupCriterion3 = new CampaignCriterion();
if (feedId.HasValue)
{
// Distance targeting. Area of 10 miles around targets above.
ConstantOperand radius = new ConstantOperand();
radius.type = ConstantOperandConstantType.DOUBLE;
radius.unit = ConstantOperandUnit.MILES;
radius.doubleValue = 10.0;
LocationExtensionOperand distance = new LocationExtensionOperand();
distance.radius = radius;
LocationGroups radiusLocationGroups = new LocationGroups();
radiusLocationGroups.matchingFunction = new Function();
radiusLocationGroups.matchingFunction.@operator = FunctionOperator.IDENTITY;
radiusLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { distance };
// FeedID should be the ID of a feed that has been configured for location
// targeting, meaning it has an ENABLED FeedMapping with criterionType of
// 77. Feeds linked to a GMB account automatically have this FeedMapping.
radiusLocationGroups.feedId = feedId.Value;
locationGroupCriterion3.campaignId = campaignId;
locationGroupCriterion3.criterion = radiusLocationGroups;
}
// Create location criteria.
// See http://code.google.com/apis/adwords/docs/appendix/countrycodes.html
// for a detailed list of country codes.
Location location1 = new Location();
location1.id = 2840; // USA
CampaignCriterion locationCriterion1 = new CampaignCriterion();
locationCriterion1.campaignId = campaignId;
locationCriterion1.criterion = location1;
Location location2 = new Location();
location2.id = 2392; // Japan
CampaignCriterion locationCriterion2 = new CampaignCriterion();
locationCriterion2.campaignId = campaignId;
locationCriterion2.criterion = location2;
// Add a negative campaign keyword.
NegativeCampaignCriterion negativeCriterion = new NegativeCampaignCriterion();
negativeCriterion.campaignId = campaignId;
Keyword keyword = new Keyword();
keyword.matchType = KeywordMatchType.BROAD;
keyword.text = "jupiter cruise";
negativeCriterion.criterion = keyword;
List <CampaignCriterion> criteria = new List <CampaignCriterion>(
new CampaignCriterion[] { languageCriterion1,
languageCriterion2, locationCriterion1, locationCriterion2, negativeCriterion,
locationGroupCriterion1, locationGroupCriterion2 });
if (feedId.HasValue)
{
criteria.Add(locationGroupCriterion3);
}
List <CampaignCriterionOperation> operations = new List <CampaignCriterionOperation>();
foreach (CampaignCriterion criterion in criteria)
{
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.ADD;
operation.operand = criterion;
operations.Add(operation);
}
try {
// Set the campaign targets.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
if (retVal != null && retVal.value != null)
{
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value)
{
Console.WriteLine("Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType, criterion.campaignId);
}
}
} catch (Exception ex) {
throw new System.ApplicationException("Failed to set Campaign criteria.", ex);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads customer ID for which the call is made.</param>
/// <param name="campaignId">The campaign to which listing scope is added.</param>
public void Run(GoogleAdsClient client, long customerId, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionServiceClient campaignCriterionService =
client.GetService(Services.V3.CampaignCriterionService);
// A listing scope allows you to filter the products that will be included in a given
// campaign. You can specify multiple dimensions with conditions that must be met for
// a product to be included in a campaign.
// A typical ListingScope might only have a few dimensions. This example demonstrates
// a range of different dimensions you could use.
ListingScopeInfo listingScope = new ListingScopeInfo()
{
Dimensions =
{
// Creates a ProductBrand dimension set to "google".
new ListingDimensionInfo()
{
ProductBrand = new ProductBrandInfo()
{
Value = "google"
}
},
// Creates a ProductCustomAttribute dimension for INDEX0 set to
// "top_selling_products".
new ListingDimensionInfo()
{
ProductCustomAttribute = new ProductCustomAttributeInfo()
{
Index = ProductCustomAttributeIndex.Index0,
Value = "top_selling_products"
}
},
// Creates a ProductType dimension for LEVEL1 set to "electronics".
new ListingDimensionInfo()
{
ProductType = new ProductTypeInfo()
{
Level = ProductTypeLevel.Level1,
Value = "electronics"
}
},
// Creates a ProductType dimension for LEVEL2 set to "smartphones".
new ListingDimensionInfo()
{
ProductType = new ProductTypeInfo()
{
Level = ProductTypeLevel.Level2,
Value = "smartphones"
}
},
}
};
string campaignResourceName = ResourceNames.Campaign(customerId, campaignId);
// Creates a campaign criterion to store the listing scope.
CampaignCriterion campaignCriterion = new CampaignCriterion()
{
Campaign = campaignResourceName,
ListingScope = listingScope
};
CampaignCriterionOperation operation = new CampaignCriterionOperation()
{
Create = campaignCriterion
};
try
{
// Calls the mutate method to add the campaign criterion.
MutateCampaignCriteriaResponse response =
campaignCriterionService.MutateCampaignCriteria(
customerId.ToString(), new[] { operation });
Console.WriteLine($"Added {response.Results.Count} campaign criteria:");
foreach (MutateCampaignCriterionResult result in response.Results)
{
Console.WriteLine(result.ResourceName);
}
}
catch (GoogleAdsException e)
{
Console.WriteLine("Failure:");
Console.WriteLine($"Message: {e.Message}");
Console.WriteLine($"Failure: {e.Failure}");
Console.WriteLine($"Request ID: {e.RequestId}");
throw;
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">The campaign id to add product scope.</param>
public void Run(AdWordsUser user, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService) user.GetService(
AdWordsService.v201601.CampaignCriterionService);
ProductScope productScope = new ProductScope();
// This set of dimensions is for demonstration purposes only. It would be
// extremely unlikely that you want to include so many dimensions in your
// product scope.
ProductBrand nexusBrand = new ProductBrand();
nexusBrand.value = "Nexus";
ProductCanonicalCondition newProducts = new ProductCanonicalCondition();
newProducts.condition = ProductCanonicalConditionCondition.NEW;
ProductCustomAttribute customAttribute = new ProductCustomAttribute();
customAttribute.type = ProductDimensionType.CUSTOM_ATTRIBUTE_0;
customAttribute.value = "my attribute value";
ProductOfferId bookOffer = new ProductOfferId();
bookOffer.value = "book1";
ProductType mediaProducts = new ProductType();
mediaProducts.type = ProductDimensionType.PRODUCT_TYPE_L1;
mediaProducts.value = "Media";
ProductType bookProducts = new ProductType();
bookProducts.type = ProductDimensionType.PRODUCT_TYPE_L2;
bookProducts.value = "Books";
// The value for the bidding category is a fixed ID for the
// 'Luggage & Bags' category. You can retrieve IDs for categories from
// the ConstantDataService. See the 'GetProductCategoryTaxonomy' example
// for more details.
ProductBiddingCategory luggageBiddingCategory = new ProductBiddingCategory();
luggageBiddingCategory.type = ProductDimensionType.BIDDING_CATEGORY_L1;
luggageBiddingCategory.value = -5914235892932915235;
productScope.dimensions = new ProductDimension[] {nexusBrand, newProducts, bookOffer,
mediaProducts, luggageBiddingCategory};
CampaignCriterion campaignCriterion = new CampaignCriterion();
campaignCriterion.campaignId = campaignId;
campaignCriterion.criterion = productScope;
// Create operation.
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.operand = campaignCriterion;
operation.@operator = Operator.ADD;
try {
// Make the mutate request.
CampaignCriterionReturnValue result = campaignCriterionService.mutate(
new CampaignCriterionOperation[] { operation });
Console.WriteLine("Created a ProductScope criterion with ID '{0}'",
result.value[0].criterion.id);
} catch (Exception e) {
throw new System.ApplicationException("Failed to set shopping product scope.", e);
}
}
/// <summary>
/// Runs the code example.
/// </summary>
/// <param name="user">The AdWords user.</param>
/// <param name="campaignId">Id of the campaign to which targeting criteria
/// are added.</param>
public void Run(AdWordsUser user, long campaignId)
{
// Get the CampaignCriterionService.
CampaignCriterionService campaignCriterionService =
(CampaignCriterionService)user.GetService(
AdWordsService.v201402.CampaignCriterionService);
// Create language criteria.
// See http://code.google.com/apis/adwords/docs/appendix/languagecodes.html
// for a detailed list of language codes.
Language language1 = new Language();
language1.id = 1002; // French
CampaignCriterion languageCriterion1 = new CampaignCriterion();
languageCriterion1.campaignId = campaignId;
languageCriterion1.criterion = language1;
Language language2 = new Language();
language2.id = 1005; // Japanese
CampaignCriterion languageCriterion2 = new CampaignCriterion();
languageCriterion2.campaignId = campaignId;
languageCriterion2.criterion = language2;
// Target Tier 3 income group near Miami, Florida.
LocationGroups incomeLocationGroups = new LocationGroups();
IncomeOperand incomeOperand = new IncomeOperand();
// Tiers are numbered 1-10, and represent 10% segments of earners.
// For example, TIER_1 is the top 10%, TIER_2 is the 80-90%, etc.
// Tiers 6 through 10 are grouped into TIER_6_TO_10.
incomeOperand.tier = IncomeTier.TIER_3;
GeoTargetOperand geoTargetOperand1 = new GeoTargetOperand();
geoTargetOperand1.locations = new long[] { 1015116 }; // Miami, FL.
incomeLocationGroups.matchingFunction = new Function();
incomeLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { incomeOperand };
incomeLocationGroups.matchingFunction.@operator = FunctionOperator.AND;
incomeLocationGroups.matchingFunction.rhsOperand =
new FunctionArgumentOperand[] { geoTargetOperand1 };
CampaignCriterion locationGroupCriterion1 = new CampaignCriterion();
locationGroupCriterion1.campaignId = campaignId;
locationGroupCriterion1.criterion = incomeLocationGroups;
// Target places of interest near Downtown Miami, Florida.
LocationGroups interestLocationGroups = new LocationGroups();
PlacesOfInterestOperand placesOfInterestOperand = new PlacesOfInterestOperand();
placesOfInterestOperand.category = PlacesOfInterestOperandCategory.DOWNTOWN;
GeoTargetOperand geoTargetOperand2 = new GeoTargetOperand();
geoTargetOperand2.locations = new long[] { 1015116 }; // Miami, FL.
interestLocationGroups.matchingFunction = new Function();
interestLocationGroups.matchingFunction.lhsOperand =
new FunctionArgumentOperand[] { placesOfInterestOperand };
interestLocationGroups.matchingFunction.@operator = FunctionOperator.AND;
interestLocationGroups.matchingFunction.rhsOperand =
new FunctionArgumentOperand[] { geoTargetOperand2 };
CampaignCriterion locationGroupCriterion2 = new CampaignCriterion();
locationGroupCriterion2.campaignId = campaignId;
locationGroupCriterion2.criterion = interestLocationGroups;
// Create location criteria.
// See http://code.google.com/apis/adwords/docs/appendix/countrycodes.html
// for a detailed list of country codes.
Location location1 = new Location();
location1.id = 2840; // USA
CampaignCriterion locationCriterion1 = new CampaignCriterion();
locationCriterion1.campaignId = campaignId;
locationCriterion1.criterion = location1;
Location location2 = new Location();
location2.id = 2392; // Japan
CampaignCriterion locationCriterion2 = new CampaignCriterion();
locationCriterion2.campaignId = campaignId;
locationCriterion2.criterion = location2;
// Add a negative campaign keyword.
NegativeCampaignCriterion negativeCriterion = new NegativeCampaignCriterion();
negativeCriterion.campaignId = campaignId;
Keyword keyword = new Keyword();
keyword.matchType = KeywordMatchType.BROAD;
keyword.text = "jupiter cruise";
negativeCriterion.criterion = keyword;
CampaignCriterion[] criteria = new CampaignCriterion[] { languageCriterion1,
languageCriterion2, locationCriterion1, locationCriterion2, negativeCriterion,
locationGroupCriterion1, locationGroupCriterion2 };
List <CampaignCriterionOperation> operations = new List <CampaignCriterionOperation>();
foreach (CampaignCriterion criterion in criteria)
{
CampaignCriterionOperation operation = new CampaignCriterionOperation();
operation.@operator = Operator.ADD;
operation.operand = criterion;
operations.Add(operation);
}
try {
// Set the campaign targets.
CampaignCriterionReturnValue retVal = campaignCriterionService.mutate(operations.ToArray());
if (retVal != null && retVal.value != null)
{
// Display campaign targets.
foreach (CampaignCriterion criterion in retVal.value)
{
Console.WriteLine("Campaign criteria of type '{0}' was set to campaign with" +
" id = '{1}'.", criterion.criterion.CriterionType, criterion.campaignId);
}
}
} catch (Exception ex) {
throw new System.ApplicationException("Failed to set Campaign criteria.", ex);
}
}
