Search in sources :

Example 1 with RuleBasedFirstPartyAudienceSegment

use of com.google.api.ads.admanager.axis.v202205.RuleBasedFirstPartyAudienceSegment in project googleads-java-lib by googleads.

the class CreateAudienceSegments method runExample.

/**
 * Runs the example.
 *
 * @param adManagerServices the services factory.
 * @param session the session.
 * @param customTargetingKeyId the ID of the custom criteria to be used in the segment rule.
 * @param customTargetingValueId the custom targeting value ID.
 * @throws ApiException if the API request failed with one or more service errors.
 * @throws RemoteException if the API request failed due to other errors.
 */
public static void runExample(AdManagerServices adManagerServices, AdManagerSession session, long customTargetingKeyId, long customTargetingValueId) throws RemoteException {
    // Get the AudienceSegmentService.
    AudienceSegmentServiceInterface audienceSegmentService = adManagerServices.get(session, AudienceSegmentServiceInterface.class);
    // Get the NetworkService.
    NetworkServiceInterface networkService = adManagerServices.get(session, NetworkServiceInterface.class);
    // Get the root ad unit ID used to target the whole site.
    String rootAdUnitId = networkService.getCurrentNetwork().getEffectiveRootAdUnitId();
    // Create inventory targeting.
    InventoryTargeting inventoryTargeting = new InventoryTargeting();
    // Create ad unit targeting for the root ad unit (i.e. the whole network).
    AdUnitTargeting adUnitTargeting = new AdUnitTargeting();
    adUnitTargeting.setAdUnitId(rootAdUnitId);
    adUnitTargeting.setIncludeDescendants(true);
    inventoryTargeting.setTargetedAdUnits(new AdUnitTargeting[] { adUnitTargeting });
    // Create the custom criteria to be used in the segment rule.
    // TARGETING_KEY_ID == TARGETING_VALUE_ID
    CustomCriteria customCriteria = new CustomCriteria();
    customCriteria.setKeyId(customTargetingKeyId);
    customCriteria.setOperator(CustomCriteriaComparisonOperator.IS);
    customCriteria.setValueIds(new long[] { customTargetingValueId });
    // Create the custom criteria expression.
    CustomCriteriaSet topCustomCriteriaSet = new CustomCriteriaSet();
    topCustomCriteriaSet.setLogicalOperator(CustomCriteriaSetLogicalOperator.AND);
    topCustomCriteriaSet.setChildren(new CustomCriteriaNode[] { customCriteria });
    // Create the audience segment rule.
    FirstPartyAudienceSegmentRule rule = new FirstPartyAudienceSegmentRule();
    rule.setInventoryRule(inventoryTargeting);
    rule.setCustomCriteriaRule(topCustomCriteriaSet);
    // Create an audience segment.
    RuleBasedFirstPartyAudienceSegment audienceSegment = new RuleBasedFirstPartyAudienceSegment();
    audienceSegment.setName("Sports enthusiasts audience segment #" + new Random().nextInt(Integer.MAX_VALUE));
    audienceSegment.setDescription("Sports enthusiasts between the ages of 20 and 30.");
    audienceSegment.setPageViews(6);
    audienceSegment.setRecencyDays(6);
    audienceSegment.setMembershipExpirationDays(88);
    audienceSegment.setRule(rule);
    // Create the audience segment on the server.
    AudienceSegment[] audienceSegments = audienceSegmentService.createAudienceSegments(new FirstPartyAudienceSegment[] { audienceSegment });
    for (AudienceSegment createdAudienceSegment : audienceSegments) {
        System.out.printf("An audience segment with ID %d, name '%s', and type '%s' was created.%n", createdAudienceSegment.getId(), createdAudienceSegment.getName(), createdAudienceSegment.getType());
    }
}
Also used : NetworkServiceInterface(com.google.api.ads.admanager.axis.v202108.NetworkServiceInterface) AdUnitTargeting(com.google.api.ads.admanager.axis.v202108.AdUnitTargeting) Random(java.util.Random) FirstPartyAudienceSegmentRule(com.google.api.ads.admanager.axis.v202108.FirstPartyAudienceSegmentRule) CustomCriteria(com.google.api.ads.admanager.axis.v202108.CustomCriteria) InventoryTargeting(com.google.api.ads.admanager.axis.v202108.InventoryTargeting) CustomCriteriaSet(com.google.api.ads.admanager.axis.v202108.CustomCriteriaSet) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202108.RuleBasedFirstPartyAudienceSegment) FirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202108.FirstPartyAudienceSegment) AudienceSegment(com.google.api.ads.admanager.axis.v202108.AudienceSegment) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202108.RuleBasedFirstPartyAudienceSegment) AudienceSegmentServiceInterface(com.google.api.ads.admanager.axis.v202108.AudienceSegmentServiceInterface)

Example 2 with RuleBasedFirstPartyAudienceSegment

use of com.google.api.ads.admanager.axis.v202205.RuleBasedFirstPartyAudienceSegment in project googleads-java-lib by googleads.

the class UpdateAudienceSegments method runExample.

/**
 * Runs the example.
 *
 * @param adManagerServices the services factory.
 * @param session the session.
 * @param audienceSegmentId the ID of the first party audience segment to update.
 * @throws ApiException if the API request failed with one or more service errors.
 * @throws RemoteException if the API request failed due to other errors.
 */
public static void runExample(AdManagerServices adManagerServices, AdManagerSession session, long audienceSegmentId) throws RemoteException {
    // Get the AudienceSegmentService.
    AudienceSegmentServiceInterface audienceSegmentService = adManagerServices.get(session, AudienceSegmentServiceInterface.class);
    // Create a statement to only select a specified first party audience
    // segment.
    StatementBuilder statementBuilder = new StatementBuilder().where("WHERE id = :audienceSegmentId and type = :type").orderBy("id ASC").limit(1).withBindVariableValue("audienceSegmentId", audienceSegmentId).withBindVariableValue("type", "FIRST_PARTY");
    // Get the audience segment.
    RuleBasedFirstPartyAudienceSegment audienceSegment = (RuleBasedFirstPartyAudienceSegment) audienceSegmentService.getAudienceSegmentsByStatement(statementBuilder.toStatement()).getResults()[0];
    // Update the member expiration days.
    audienceSegment.setMembershipExpirationDays(180);
    // Update the audience segment on the server.
    AudienceSegment[] audienceSegments = audienceSegmentService.updateAudienceSegments(new FirstPartyAudienceSegment[] { audienceSegment });
    for (AudienceSegment updatedAudienceSegment : audienceSegments) {
        System.out.printf("Audience segment with ID %d and name '%s' was updated.%n", updatedAudienceSegment.getId(), updatedAudienceSegment.getName());
    }
}
Also used : StatementBuilder(com.google.api.ads.admanager.axis.utils.v202108.StatementBuilder) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202108.RuleBasedFirstPartyAudienceSegment) FirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202108.FirstPartyAudienceSegment) AudienceSegment(com.google.api.ads.admanager.axis.v202108.AudienceSegment) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202108.RuleBasedFirstPartyAudienceSegment) AudienceSegmentServiceInterface(com.google.api.ads.admanager.axis.v202108.AudienceSegmentServiceInterface)

Example 3 with RuleBasedFirstPartyAudienceSegment

use of com.google.api.ads.admanager.axis.v202205.RuleBasedFirstPartyAudienceSegment in project googleads-java-lib by googleads.

the class CreateAudienceSegments method runExample.

/**
 * Runs the example.
 *
 * @param adManagerServices the services factory.
 * @param session the session.
 * @param customTargetingKeyId the ID of the custom criteria to be used in the segment rule.
 * @param customTargetingValueId the custom targeting value ID.
 * @throws ApiException if the API request failed with one or more service errors.
 * @throws RemoteException if the API request failed due to other errors.
 */
public static void runExample(AdManagerServices adManagerServices, AdManagerSession session, long customTargetingKeyId, long customTargetingValueId) throws RemoteException {
    // Get the AudienceSegmentService.
    AudienceSegmentServiceInterface audienceSegmentService = adManagerServices.get(session, AudienceSegmentServiceInterface.class);
    // Get the NetworkService.
    NetworkServiceInterface networkService = adManagerServices.get(session, NetworkServiceInterface.class);
    // Get the root ad unit ID used to target the whole site.
    String rootAdUnitId = networkService.getCurrentNetwork().getEffectiveRootAdUnitId();
    // Create inventory targeting.
    InventoryTargeting inventoryTargeting = new InventoryTargeting();
    // Create ad unit targeting for the root ad unit (i.e. the whole network).
    AdUnitTargeting adUnitTargeting = new AdUnitTargeting();
    adUnitTargeting.setAdUnitId(rootAdUnitId);
    adUnitTargeting.setIncludeDescendants(true);
    inventoryTargeting.setTargetedAdUnits(new AdUnitTargeting[] { adUnitTargeting });
    // Create the custom criteria to be used in the segment rule.
    // TARGETING_KEY_ID == TARGETING_VALUE_ID
    CustomCriteria customCriteria = new CustomCriteria();
    customCriteria.setKeyId(customTargetingKeyId);
    customCriteria.setOperator(CustomCriteriaComparisonOperator.IS);
    customCriteria.setValueIds(new long[] { customTargetingValueId });
    // Create the custom criteria expression.
    CustomCriteriaSet topCustomCriteriaSet = new CustomCriteriaSet();
    topCustomCriteriaSet.setLogicalOperator(CustomCriteriaSetLogicalOperator.AND);
    topCustomCriteriaSet.setChildren(new CustomCriteriaNode[] { customCriteria });
    // Create the audience segment rule.
    FirstPartyAudienceSegmentRule rule = new FirstPartyAudienceSegmentRule();
    rule.setInventoryRule(inventoryTargeting);
    rule.setCustomCriteriaRule(topCustomCriteriaSet);
    // Create an audience segment.
    RuleBasedFirstPartyAudienceSegment audienceSegment = new RuleBasedFirstPartyAudienceSegment();
    audienceSegment.setName("Sports enthusiasts audience segment #" + new Random().nextInt(Integer.MAX_VALUE));
    audienceSegment.setDescription("Sports enthusiasts between the ages of 20 and 30.");
    audienceSegment.setPageViews(6);
    audienceSegment.setRecencyDays(6);
    audienceSegment.setMembershipExpirationDays(88);
    audienceSegment.setRule(rule);
    // Create the audience segment on the server.
    AudienceSegment[] audienceSegments = audienceSegmentService.createAudienceSegments(new FirstPartyAudienceSegment[] { audienceSegment });
    for (AudienceSegment createdAudienceSegment : audienceSegments) {
        System.out.printf("An audience segment with ID %d, name '%s', and type '%s' was created.%n", createdAudienceSegment.getId(), createdAudienceSegment.getName(), createdAudienceSegment.getType());
    }
}
Also used : NetworkServiceInterface(com.google.api.ads.admanager.axis.v202205.NetworkServiceInterface) AdUnitTargeting(com.google.api.ads.admanager.axis.v202205.AdUnitTargeting) Random(java.util.Random) FirstPartyAudienceSegmentRule(com.google.api.ads.admanager.axis.v202205.FirstPartyAudienceSegmentRule) CustomCriteria(com.google.api.ads.admanager.axis.v202205.CustomCriteria) InventoryTargeting(com.google.api.ads.admanager.axis.v202205.InventoryTargeting) CustomCriteriaSet(com.google.api.ads.admanager.axis.v202205.CustomCriteriaSet) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202205.RuleBasedFirstPartyAudienceSegment) AudienceSegment(com.google.api.ads.admanager.axis.v202205.AudienceSegment) FirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202205.FirstPartyAudienceSegment) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202205.RuleBasedFirstPartyAudienceSegment) AudienceSegmentServiceInterface(com.google.api.ads.admanager.axis.v202205.AudienceSegmentServiceInterface)

Example 4 with RuleBasedFirstPartyAudienceSegment

use of com.google.api.ads.admanager.axis.v202205.RuleBasedFirstPartyAudienceSegment in project googleads-java-lib by googleads.

the class CreateAudienceSegments method runExample.

/**
 * Runs the example.
 *
 * @param adManagerServices the services factory.
 * @param session the session.
 * @param customTargetingKeyId the ID of the custom criteria to be used in the segment rule.
 * @param customTargetingValueId the custom targeting value ID.
 * @throws ApiException if the API request failed with one or more service errors.
 * @throws RemoteException if the API request failed due to other errors.
 */
public static void runExample(AdManagerServices adManagerServices, AdManagerSession session, long customTargetingKeyId, long customTargetingValueId) throws RemoteException {
    // Get the AudienceSegmentService.
    AudienceSegmentServiceInterface audienceSegmentService = adManagerServices.get(session, AudienceSegmentServiceInterface.class);
    // Get the NetworkService.
    NetworkServiceInterface networkService = adManagerServices.get(session, NetworkServiceInterface.class);
    // Get the root ad unit ID used to target the whole site.
    String rootAdUnitId = networkService.getCurrentNetwork().getEffectiveRootAdUnitId();
    // Create inventory targeting.
    InventoryTargeting inventoryTargeting = new InventoryTargeting();
    // Create ad unit targeting for the root ad unit (i.e. the whole network).
    AdUnitTargeting adUnitTargeting = new AdUnitTargeting();
    adUnitTargeting.setAdUnitId(rootAdUnitId);
    adUnitTargeting.setIncludeDescendants(true);
    inventoryTargeting.setTargetedAdUnits(new AdUnitTargeting[] { adUnitTargeting });
    // Create the custom criteria to be used in the segment rule.
    // TARGETING_KEY_ID == TARGETING_VALUE_ID
    CustomCriteria customCriteria = new CustomCriteria();
    customCriteria.setKeyId(customTargetingKeyId);
    customCriteria.setOperator(CustomCriteriaComparisonOperator.IS);
    customCriteria.setValueIds(new long[] { customTargetingValueId });
    // Create the custom criteria expression.
    CustomCriteriaSet topCustomCriteriaSet = new CustomCriteriaSet();
    topCustomCriteriaSet.setLogicalOperator(CustomCriteriaSetLogicalOperator.AND);
    topCustomCriteriaSet.setChildren(new CustomCriteriaNode[] { customCriteria });
    // Create the audience segment rule.
    FirstPartyAudienceSegmentRule rule = new FirstPartyAudienceSegmentRule();
    rule.setInventoryRule(inventoryTargeting);
    rule.setCustomCriteriaRule(topCustomCriteriaSet);
    // Create an audience segment.
    RuleBasedFirstPartyAudienceSegment audienceSegment = new RuleBasedFirstPartyAudienceSegment();
    audienceSegment.setName("Sports enthusiasts audience segment #" + new Random().nextInt(Integer.MAX_VALUE));
    audienceSegment.setDescription("Sports enthusiasts between the ages of 20 and 30.");
    audienceSegment.setPageViews(6);
    audienceSegment.setRecencyDays(6);
    audienceSegment.setMembershipExpirationDays(88);
    audienceSegment.setRule(rule);
    // Create the audience segment on the server.
    AudienceSegment[] audienceSegments = audienceSegmentService.createAudienceSegments(new FirstPartyAudienceSegment[] { audienceSegment });
    for (AudienceSegment createdAudienceSegment : audienceSegments) {
        System.out.printf("An audience segment with ID %d, name '%s', and type '%s' was created.%n", createdAudienceSegment.getId(), createdAudienceSegment.getName(), createdAudienceSegment.getType());
    }
}
Also used : NetworkServiceInterface(com.google.api.ads.admanager.axis.v202202.NetworkServiceInterface) AdUnitTargeting(com.google.api.ads.admanager.axis.v202202.AdUnitTargeting) Random(java.util.Random) FirstPartyAudienceSegmentRule(com.google.api.ads.admanager.axis.v202202.FirstPartyAudienceSegmentRule) CustomCriteria(com.google.api.ads.admanager.axis.v202202.CustomCriteria) InventoryTargeting(com.google.api.ads.admanager.axis.v202202.InventoryTargeting) CustomCriteriaSet(com.google.api.ads.admanager.axis.v202202.CustomCriteriaSet) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202202.RuleBasedFirstPartyAudienceSegment) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202202.RuleBasedFirstPartyAudienceSegment) FirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202202.FirstPartyAudienceSegment) AudienceSegment(com.google.api.ads.admanager.axis.v202202.AudienceSegment) AudienceSegmentServiceInterface(com.google.api.ads.admanager.axis.v202202.AudienceSegmentServiceInterface)

Example 5 with RuleBasedFirstPartyAudienceSegment

use of com.google.api.ads.admanager.axis.v202205.RuleBasedFirstPartyAudienceSegment in project googleads-java-lib by googleads.

the class UpdateAudienceSegments method runExample.

/**
 * Runs the example.
 *
 * @param adManagerServices the services factory.
 * @param session the session.
 * @param audienceSegmentId the ID of the first party audience segment to update.
 * @throws ApiException if the API request failed with one or more service errors.
 * @throws RemoteException if the API request failed due to other errors.
 */
public static void runExample(AdManagerServices adManagerServices, AdManagerSession session, long audienceSegmentId) throws RemoteException {
    // Get the AudienceSegmentService.
    AudienceSegmentServiceInterface audienceSegmentService = adManagerServices.get(session, AudienceSegmentServiceInterface.class);
    // Create a statement to only select a specified first party audience
    // segment.
    StatementBuilder statementBuilder = new StatementBuilder().where("WHERE id = :audienceSegmentId and type = :type").orderBy("id ASC").limit(1).withBindVariableValue("audienceSegmentId", audienceSegmentId).withBindVariableValue("type", "FIRST_PARTY");
    // Get the audience segment.
    RuleBasedFirstPartyAudienceSegment audienceSegment = (RuleBasedFirstPartyAudienceSegment) audienceSegmentService.getAudienceSegmentsByStatement(statementBuilder.toStatement()).getResults()[0];
    // Update the member expiration days.
    audienceSegment.setMembershipExpirationDays(180);
    // Update the audience segment on the server.
    AudienceSegment[] audienceSegments = audienceSegmentService.updateAudienceSegments(new FirstPartyAudienceSegment[] { audienceSegment });
    for (AudienceSegment updatedAudienceSegment : audienceSegments) {
        System.out.printf("Audience segment with ID %d and name '%s' was updated.%n", updatedAudienceSegment.getId(), updatedAudienceSegment.getName());
    }
}
Also used : StatementBuilder(com.google.api.ads.admanager.axis.utils.v202202.StatementBuilder) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202202.RuleBasedFirstPartyAudienceSegment) RuleBasedFirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202202.RuleBasedFirstPartyAudienceSegment) FirstPartyAudienceSegment(com.google.api.ads.admanager.axis.v202202.FirstPartyAudienceSegment) AudienceSegment(com.google.api.ads.admanager.axis.v202202.AudienceSegment) AudienceSegmentServiceInterface(com.google.api.ads.admanager.axis.v202202.AudienceSegmentServiceInterface)

Aggregations

Random (java.util.Random)4 AudienceSegment (com.google.api.ads.admanager.axis.v202108.AudienceSegment)2 AudienceSegmentServiceInterface (com.google.api.ads.admanager.axis.v202108.AudienceSegmentServiceInterface)2 FirstPartyAudienceSegment (com.google.api.ads.admanager.axis.v202108.FirstPartyAudienceSegment)2 RuleBasedFirstPartyAudienceSegment (com.google.api.ads.admanager.axis.v202108.RuleBasedFirstPartyAudienceSegment)2 AudienceSegment (com.google.api.ads.admanager.axis.v202111.AudienceSegment)2 AudienceSegmentServiceInterface (com.google.api.ads.admanager.axis.v202111.AudienceSegmentServiceInterface)2 FirstPartyAudienceSegment (com.google.api.ads.admanager.axis.v202111.FirstPartyAudienceSegment)2 RuleBasedFirstPartyAudienceSegment (com.google.api.ads.admanager.axis.v202111.RuleBasedFirstPartyAudienceSegment)2 AudienceSegment (com.google.api.ads.admanager.axis.v202202.AudienceSegment)2 AudienceSegmentServiceInterface (com.google.api.ads.admanager.axis.v202202.AudienceSegmentServiceInterface)2 FirstPartyAudienceSegment (com.google.api.ads.admanager.axis.v202202.FirstPartyAudienceSegment)2 RuleBasedFirstPartyAudienceSegment (com.google.api.ads.admanager.axis.v202202.RuleBasedFirstPartyAudienceSegment)2 AudienceSegment (com.google.api.ads.admanager.axis.v202205.AudienceSegment)2 AudienceSegmentServiceInterface (com.google.api.ads.admanager.axis.v202205.AudienceSegmentServiceInterface)2 FirstPartyAudienceSegment (com.google.api.ads.admanager.axis.v202205.FirstPartyAudienceSegment)2 StatementBuilder (com.google.api.ads.admanager.axis.utils.v202108.StatementBuilder)1 StatementBuilder (com.google.api.ads.admanager.axis.utils.v202111.StatementBuilder)1 StatementBuilder (com.google.api.ads.admanager.axis.utils.v202202.StatementBuilder)1 StatementBuilder (com.google.api.ads.admanager.axis.utils.v202205.StatementBuilder)1