Hướng dẫn chi tiết cách tạo chiến dịch trong Google Ads và sử dụng API hiệu quả

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.common.manualcpc;
import com.google.ads.googleads.v17.enums.advertisingchanneltypeenum.advertisingchanneltype;
import com.google.ads.googleads.v17.enums.budgetdeliverymethodenum.budgetdeliverymethod;
import com.google.ads.googleads.v17.enums.campaignstatusenum.campaignstatus;
import com.google.ads.googleads.v17.errors.googleadserror;
import com.google.ads.googleads.v17.errors.googleadsexception;
import com.google.ads.googleads.v17.resources.campaign;
import com.google.ads.googleads.v17.resources.campaign.networksettings;
import com.google.ads.googleads.v17.resources.campaignbudget;
import com.google.ads.googleads.v17.services.campaignbudgetoperation;
import com.google.ads.googleads.v17.services.campaignbudgetserviceclient;
import com.google.ads.googleads.v17.services.campaignoperation;
import com.google.ads.googleads.v17.services.campaignserviceclient;
import com.google.ads.googleads.v17.services.mutatecampaignbudgetsresponse;
import com.google.ads.googleads.v17.services.mutatecampaignresult;
import com.google.ads.googleads.v17.services.mutatecampaignsresponse;
import com.google.common.collect.immutablelist;
import java.io.filenotfoundexception;
import java.io.ioexception;
import java.util.arraylist;
import java.util.list;
import org.joda.time.datetime;

/** thêm chiến dịch mới vào tài khoản khách hàng. */
public class addcampaigns {

/** số lượng chiến dịch sẽ được thêm trong ví dụ này. */
private static final int number_of_campaigns_to_add = 2;

private static class addcampaignsparams extends codesampleparams {

@parameter(names = argumentnames.customer_id, required = true)
private long customerid;
}

public static void main(string[] args) {
addcampaignsparams params = new addcampaignsparams();
if (!params.parsearguments(args)) {

// hoặc truyền tham số cần thiết cho ví dụ này qua dòng lệnh, hoặc chèn chúng
// vào mã ở đây. xem định nghĩa lớp tham số ở trên để biết mô tả.
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 tải được cấu hình googleadsclient từ tệp. ngoại lệ: %s%n”, fnfe);
system.exit(1);
} catch (ioexception ioe) {
system.err.printf(“không thể tạo googleadsclient. ngoại lệ: %s%n”, ioe);
system.exit(1);
}

try {
new addcampaigns().runexample(googleadsclient, params.customerid);
} catch (googleadsexception gae) {
// googleadsexception là lớp cơ bản cho hầu hết các ngoại lệ được ném ra bởi yêu cầu api.
// các trường hợp ngoại lệ này có một thông báo và một googleadsfailure chứa
// một tập hợp các googleadserrors chỉ ra nguyên nhân cơ bản của
// googleadsexception.
system.err.printf(
“yêu cầu id %s thất bại do googleadsexception. lỗi cơ bản:%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);
}
}

/**
* tạo một ngân sách chiến dịch mới trong tài khoản khách hàng được chỉ định.
*
* @param googleadsclient là google ads api client.
* @param customerid là id khách hàng.
* @return tên tài nguyên của ngân sách vừa tạo.
* @throws googleadsexception nếu một yêu cầu api không thành công với một hoặc nhiều lỗi dịch vụ.
*/
private static string addcampaignbudget(googleadsclient googleadsclient, long customerid) {
campaignbudget budget =
campaignbudget.newbuilder()
.setname(“ngân sách hành trình liên hành tinh #” + getprintabledatetime())
.setdeliverymethod(budgetdeliverymethod.standard)
.setamountmicros(500_000)
.build();

campaignbudgetoperation op = campaignbudgetoperation.newbuilder().setcreate(budget).build();

try (campaignbudgetserviceclient campaignbudgetserviceclient =
googleadsclient.getlatestversion().createcampaignbudgetserviceclient()) {
mutatecampaignbudgetsresponse response =
campaignbudgetserviceclient.mutatecampaignbudgets(
long.tostring(customerid), immutablelist.of(op));
string budgetresourcename = response.getresults(0).getresourcename();
system.out.printf(“thêm ngân sách: %s%n”, budgetresourcename);
return budgetresourcename;
}
}

/**
* chạy ví dụ.
*
* @param googleadsclient là google ads api client.
* @param customerid là id khách hàng.
* @throws googleadsexception nếu một yêu cầu api không thành công với một hoặc nhiều lỗi dịch vụ.
*/
private void runexample(googleadsclient googleadsclient, long customerid) {

// tạo một ngân sách chia sẻ chung để sử dụng cho các chiến dịch được thêm dưới đây.
string budgetresourcename = addcampaignbudget(googleadsclient, customerid);

list<campaignoperation> operations = new arraylist<>(number_of_campaigns_to_add);

for (int i = 0; i < number_of_campaigns_to_add; i++) {
// cấu hình các tùy chọn mạng cho chiến dịch
networksettings networksettings =
networksettings.newbuilder()
.settargetgooglesearch(true)
.settargetsearchnetwork(true)
// kích hoạt hiển thị mở rộng trên các chiến dịch tìm kiếm. xem
// https://support.google.com/google-ads/answer/7193800 để biết thêm.
.settargetcontentnetwork(true)
.settargetpartnersearchnetwork(false)
.build();

// tạo chiến dịch.
campaign campaign =
campaign.newbuilder()
.setname(“hành trình liên hành tinh #” + getprintabledatetime())
.setadvertisingchanneltype(advertisingchanneltype.search)
// khuyến nghị: đặt chiến dịch ở trạng thái tạm dừng khi tạo để ngăn
// quảng cáo ngay lập tức phục vụ. chuyển sang kích hoạt sau khi đã thêm
// nhắm mục tiêu và quảng cáo đã sẵn sàng phục vụ
.setstatus(campaignstatus.paused)
// đặt chiến lược đấu giá và ngân sách.
.setmanualcpc(manualcpc.newbuilder().build())
.setcampaignbudget(budgetresourcename)
// thêm các networksettings đã được cấu hình ở trên.
.setnetworksettings(networksettings)
// tùy chọn: đặt ngày bắt đầu và kết thúc.
.setstartdate(new datetime().plusdays(1).tostring(“yyyymmdd”))
.setenddate(new datetime().plusdays(30).tostring(“yyyymmdd”))
.build();

campaignoperation op = campaignoperation.newbuilder().setcreate(campaign).build();
operations.add(op);
}

try (campaignserviceclient campaignserviceclient =
googleadsclient.getlatestversion().createcampaignserviceclient()) {
mutatecampaignsresponse response =
campaignserviceclient.mutatecampaigns(long.tostring(customerid), operations);
system.out.printf(“đã thêm %d chiến dịch:%n”, response.getresultscount());
for (mutatecampaignresult result : response.getresultslist()) {
system.out.println(result.getresourcename());
}
}
}
}