Search in sources :

Example 1 with AudienceSegmentServiceInterface

use of com.google.api.ads.admanager.axis.v202205.AudienceSegmentServiceInterface 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 AudienceSegmentServiceInterface

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

the class PopulateFirstPartyAudienceSegments 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 populate.
 * @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");
    // Default for total result set size.
    int totalResultSetSize = 0;
    do {
        // Get audience segments by statement.
        AudienceSegmentPage page = audienceSegmentService.getAudienceSegmentsByStatement(statementBuilder.toStatement());
        if (page.getResults() != null) {
            totalResultSetSize = page.getTotalResultSetSize();
            int i = page.getStartIndex();
            for (AudienceSegment audienceSegment : page.getResults()) {
                System.out.printf("%d) Audience segment with ID %d and name '%s' will be populated.%n", i++, audienceSegment.getId(), audienceSegment.getName());
            }
        }
        statementBuilder.increaseOffsetBy(StatementBuilder.SUGGESTED_PAGE_LIMIT);
    } while (statementBuilder.getOffset() < totalResultSetSize);
    System.out.printf("Number of audience segments to be populated: %d%n", totalResultSetSize);
    if (totalResultSetSize > 0) {
        // Remove limit and offset from statement.
        statementBuilder.removeLimitAndOffset();
        // Create action.
        PopulateAudienceSegments action = new PopulateAudienceSegments();
        // Perform action.
        UpdateResult result = audienceSegmentService.performAudienceSegmentAction(action, statementBuilder.toStatement());
        if (result != null && result.getNumChanges() > 0) {
            System.out.printf("Number of audience segments populated: %d%n", result.getNumChanges());
        } else {
            System.out.println("No audience segments were populated.");
        }
    }
}
Also used : AudienceSegmentPage(com.google.api.ads.admanager.axis.v202108.AudienceSegmentPage) StatementBuilder(com.google.api.ads.admanager.axis.utils.v202108.StatementBuilder) PopulateAudienceSegments(com.google.api.ads.admanager.axis.v202108.PopulateAudienceSegments) AudienceSegment(com.google.api.ads.admanager.axis.v202108.AudienceSegment) AudienceSegmentServiceInterface(com.google.api.ads.admanager.axis.v202108.AudienceSegmentServiceInterface) UpdateResult(com.google.api.ads.admanager.axis.v202108.UpdateResult)

Example 3 with AudienceSegmentServiceInterface

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

the class GetFirstPartyAudienceSegments method runExample.

/**
 * Runs the example.
 *
 * @param adManagerServices the services factory.
 * @param session the session.
 * @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) throws RemoteException {
    AudienceSegmentServiceInterface audienceSegmentService = adManagerServices.get(session, AudienceSegmentServiceInterface.class);
    // Create a statement to select audience segments.
    StatementBuilder statementBuilder = new StatementBuilder().where("type = :type").orderBy("id ASC").limit(StatementBuilder.SUGGESTED_PAGE_LIMIT).withBindVariableValue("type", AudienceSegmentType.FIRST_PARTY.toString());
    // Retrieve a small amount of audience segments at a time, paging through
    // until all audience segments have been retrieved.
    int totalResultSetSize = 0;
    do {
        AudienceSegmentPage page = audienceSegmentService.getAudienceSegmentsByStatement(statementBuilder.toStatement());
        if (page.getResults() != null) {
            // Print out some information for each audience segment.
            totalResultSetSize = page.getTotalResultSetSize();
            int i = page.getStartIndex();
            for (AudienceSegment audienceSegment : page.getResults()) {
                System.out.printf("%d) Audience segment with ID %d, name '%s', and size %d was found.%n", i++, audienceSegment.getId(), audienceSegment.getName(), audienceSegment.getSize());
            }
        }
        statementBuilder.increaseOffsetBy(StatementBuilder.SUGGESTED_PAGE_LIMIT);
    } while (statementBuilder.getOffset() < totalResultSetSize);
    System.out.printf("Number of results found: %d%n", totalResultSetSize);
}
Also used : AudienceSegmentPage(com.google.api.ads.admanager.axis.v202108.AudienceSegmentPage) StatementBuilder(com.google.api.ads.admanager.axis.utils.v202108.StatementBuilder) AudienceSegment(com.google.api.ads.admanager.axis.v202108.AudienceSegment) AudienceSegmentServiceInterface(com.google.api.ads.admanager.axis.v202108.AudienceSegmentServiceInterface)

Example 4 with AudienceSegmentServiceInterface

use of com.google.api.ads.admanager.axis.v202205.AudienceSegmentServiceInterface 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 5 with AudienceSegmentServiceInterface

use of com.google.api.ads.admanager.axis.v202205.AudienceSegmentServiceInterface 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)

Aggregations

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