Cách tạo và quản lý nhóm quảng cáo trong Google Ads hiệu quả

// Copyright 2018 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.package com.google.ads.googleads.examples.basicoperations;

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.AdGroupStatusEnum.AdGroupStatus;
import com.google.ads.googleads.v17.enums.AdGroupTypeEnum.AdGroupType;
import com.google.ads.googleads.v17.errors.GoogleAdsError;
import com.google.ads.googleads.v17.errors.GoogleAdsException;
import com.google.ads.googleads.v17.resources.AdGroup;
import com.google.ads.googleads.v17.services.AdGroupOperation;
import com.google.ads.googleads.v17.services.AdGroupServiceClient;
import com.google.ads.googleads.v17.services.MutateAdGroupResult;
import com.google.ads.googleads.v17.services.MutateAdGroupsResponse;
import com.google.ads.googleads.v17.utils.ResourceNames;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

/** thêm nhóm quảng cáo vào chiến dịch. */
public class AddAdGroups {

private static class AddAdGroupParams extends CodeSampleParams {

@Parameter(names = ArgumentNames.CUSTOMER_ID, required = true)
private Long customerId;

@Parameter(names = ArgumentNames.CAMPAIGN_ID, required = true)
private Long campaignId;
}

public static void main(String[] args) throws IOException {
AddAdGroupParams params = new AddAdGroupParams();
if (!params.parseArguments(args)) {
// yêu cầu nhập các tham số bắt buộc từ dòng lệnh hoặc gán trực tiếp vào code tại đây
params.customerId = Long.parseLong(“INSERT_CUSTOMER_ID_HERE”);
params.campaignId = Long.parseLong(“INSERT_CAMPAIGN_ID_HERE”);
}

GoogleAdsClient googleAdsClient = null;
try {
googleAdsClient = GoogleAdsClient.newBuilder().fromPropertiesFile().build();
} catch (FileNotFoundException fnfe) {
System.err.printf(
“không thể tải tệp cấu hình 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 AddAdGroups().runExample(googleAdsClient, params.customerId, params.campaignId);
} catch (GoogleAdsException gae) {
System.err.printf(
“yêu cầu có mã id %s thất bại vì GoogleAdsException. chi tiết lỗi:%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);
}
}

/**
* chạy ví dụ.
*
* @param googleAdsClient client của Google Ads API.
* @param customerId id của khách hàng.
* @param campaignId id của chiến dịch.
* @throws GoogleAdsException nếu yêu cầu api gặp lỗi dịch vụ.
*/
private void runExample(GoogleAdsClient googleAdsClient, long customerId, long campaignId) {
String campaignResourceName = ResourceNames.campaign(customerId, campaignId);

// tạo một nhóm quảng cáo mới với giá thầu cpc tùy chọn.
AdGroup adGroup1 =
AdGroup.newBuilder()
.setName(“Earth to Mars Cruises #” + getPrintableDateTime())
.setStatus(AdGroupStatus.ENABLED)
.setCampaign(campaignResourceName)
.setType(AdGroupType.SEARCH_STANDARD)
.setCpcBidMicros(10_000_000L)
.build();

// bạn có thể thêm nhiều nhóm quảng cáo tùy ý.
AdGroup adGroup2 =
AdGroup.newBuilder()
.setName(“Earth to Venus Cruises #” + getPrintableDateTime())
.setStatus(AdGroupStatus.ENABLED)
.setCampaign(campaignResourceName)
.setType(AdGroupType.SEARCH_STANDARD)
.setCpcBidMicros(10_000_000L)
.build();

List<AdGroupOperation> operations = new ArrayList<>();
operations.add(AdGroupOperation.newBuilder().setCreate(adGroup1).build());
operations.add(AdGroupOperation.newBuilder().setCreate(adGroup2).build());

try (AdGroupServiceClient adGroupServiceClient =
googleAdsClient.getLatestVersion().createAdGroupServiceClient()) {
MutateAdGroupsResponse response =
adGroupServiceClient.mutateAdGroups(Long.toString(customerId), operations);
System.out.printf(“đã thêm %d nhóm quảng cáo:%n”, response.getResultsCount());
for (MutateAdGroupResult result : response.getResultsList()) {
System.out.println(result.getResourceName());
}
}
}
}