Cách tạo đối tượng tùy chỉnh trong Google Ads để tăng hiệu quả nhắm mục tiêu

// Bản quyền 2020 Google LLC
//
// Được cấp phép theo Apache License, Phiên bản 2.0 (Giấy phép)
// Bạn có thể không sử dụng tệp này trừ khi tuân thủ các điều khoản của Giấy phép.
// Bạn có thể nhận bản sao của Giấy phép tại:
// http://www.apache.org/licenses/LICENSE-2.0
//
// Trừ khi có yêu cầu pháp lý, phần mềm này được cung cấp "nguyên trạng"
// không có bất kỳ bảo đảm nào.package com.google.ads.googleads.examples.remarketing;

import static com.google.ads.googleads.examples.utils.CodeSampleHelper.getPrintableDateTime;
import com.beust.jcommander.Parameter;
import com.google.ads.googleads.examples.utils.ArgumentNames;
import com.google.ads.googleads.examples.utils.CodeSampleParams;
import com.google.ads.googleads.lib.GoogleAdsClient;
import com.google.ads.googleads.v17.enums.CustomAudienceMemberTypeEnum.CustomAudienceMemberType;
import com.google.ads.googleads.v17.enums.CustomAudienceStatusEnum.CustomAudienceStatus;
import com.google.ads.googleads.v17.enums.CustomAudienceTypeEnum.CustomAudienceType;
import com.google.ads.googleads.v17.errors.GoogleAdsError;
import com.google.ads.googleads.v17.errors.GoogleAdsException;
import com.google.ads.googleads.v17.resources.CustomAudience;
import com.google.ads.googleads.v17.resources.CustomAudienceMember;
import com.google.ads.googleads.v17.services.CustomAudienceOperation;
import com.google.ads.googleads.v17.services.CustomAudienceServiceClient;
import com.google.ads.googleads.v17.services.MutateCustomAudiencesResponse;
import com.google.common.collect.ImmutableList;
import java.io.FileNotFoundException;
import java.io.IOException;

public class AddCustomAudience {

private static class AddCustomAudienceParams extends CodeSampleParams {
@Parameter(names = ArgumentNames.CUSTOMER_ID, required = true)
private Long customerId;
}

public static void main(String[] args) {
AddCustomAudienceParams params = new AddCustomAudienceParams();
if (!params.parseArguments(args)) {
params.customerId = Long.parseLong(“INSERT_CUSTOMER_ID_HERE”);
}

GoogleAdsClient googleAdsClient = null;
try {
googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
} catch (FileNotFoundException fnfe) {
System.err.printf(“Không thể tải GoogleAdsClient. Lỗi: %s%n”, fnfe);
System.exit(1);
} catch (IOException ioe) {
System.err.printf(“Không thể tạo GoogleAdsClient. Lỗi: %s%n”, ioe);
System.exit(1);
}

try {
new AddCustomAudience().runExample(googleAdsClient, params.customerId);
} catch (GoogleAdsException gae) {
System.err.printf(“Request ID %s gặp lỗi GoogleAdsException. Lỗi chi tiết:%n”, gae.getRequestId());
int i = 0;
for (GoogleAdsError googleAdsError : gae.getGoogleAdsFailure().getErrorsList()) {
System.err.printf(” Lỗi %d: %s%n”, i++, googleAdsError);
}
System.exit(1);
}
}

private void runExample(GoogleAdsClient googleAdsClient, long customerId) {
CustomAudience customAudience =
CustomAudience.newBuilder()
.setName(“Example CustomAudience #” + getPrintableDateTime())
.setDescription(“Tạo đối tượng tuỳ chỉnh với các điều kiện tìm kiếm cụ thể trên Google”)
.setType(CustomAudienceType.SEARCH)
.setStatus(CustomAudienceStatus.ENABLED)

.addMembers(createCustomAudienceMember(CustomAudienceMemberType.KEYWORD, “mars cruise”))
.addMembers(createCustomAudienceMember(CustomAudienceMemberType.KEYWORD, “jupiter cruise”))
.addMembers(createCustomAudienceMember(CustomAudienceMemberType.URL, “http://www.example.com/locations/mars”))
.addMembers(createCustomAudienceMember(CustomAudienceMemberType.URL, “http://www.example.com/locations/jupiter”))
.addMembers(createCustomAudienceMember(CustomAudienceMemberType.APP, “com.google.android.apps.adwords”))
.build();

CustomAudienceOperation operation = CustomAudienceOperation.newBuilder().setCreate(customAudience).build();

try (CustomAudienceServiceClient serviceClient = googleAdsClient.getLatestVersion().createCustomAudienceServiceClient()) {
MutateCustomAudiencesResponse response = serviceClient.mutateCustomAudiences(
String.valueOf(customerId), ImmutableList.of(operation));

System.out.printf(“Đối tượng tuỳ chỉnh mới đã được thêm với tên tài nguyên: ‘%s’.\n”, response.getResults(0).getResourceName());
}
}

private static CustomAudienceMember createCustomAudienceMember(
CustomAudienceMemberType memberType, String value) {
CustomAudienceMember.Builder builder = CustomAudienceMember.newBuilder().setMemberType(memberType);
if (memberType == CustomAudienceMemberType.KEYWORD) {
builder.setKeyword(value);
} else if (memberType == CustomAudienceMemberType.URL) {
builder.setUrl(value);
} else if (memberType == CustomAudienceMemberType.APP) {
builder.setApp(value);
}
return builder.build();
}
}