교차 계정 입찰 전략은 관리자 계정에서 만든 효과적인 스마트 자동 입찰 포트폴리오 입찰 전략입니다. 전략을 소유한 관리자 아래에 있는 모든 고객 계정의 캠페인에서 사용할 수 있습니다.
만들기 및 관리
새 교차 계정 입찰 전략을 만드는 방법은 API 호출의 customer_id를 관리자 계정의 입찰 전략으로 설정한다는 점을 제외하면 새 포트폴리오 입찰 전략을 만드는 것과 거의 동일합니다. 고객 계정에서 새 포트폴리오 전략을 만드는 것과 동일한 방식으로 관리자 계정의 ID를 사용하여 새 BiddingStrategy 리소스를 만듭니다.
Java
private String createBiddingStrategy(GoogleAdsClient googleAdsClient, long managerCustomerId) {
try (BiddingStrategyServiceClient biddingStrategyServiceClient =
googleAdsClient.getLatestVersion().createBiddingStrategyServiceClient()) {
// Creates a portfolio bidding strategy.
BiddingStrategy portfolioBiddingStrategy =
BiddingStrategy.newBuilder()
.setName("Maximize Clicks #" + getPrintableDateTime())
.setTargetSpend(TargetSpend.getDefaultInstance())
// Sets the currency of the new bidding strategy. If not provided, the bidding
// strategy uses the manager account's default currency.
.setCurrencyCode("USD")
.build();
// Constructs an operation that will create a portfolio bidding strategy.
BiddingStrategyOperation operation =
BiddingStrategyOperation.newBuilder().setCreate(portfolioBiddingStrategy).build();
// Sends the operation in a mutate request.
MutateBiddingStrategiesResponse response =
biddingStrategyServiceClient.mutateBiddingStrategies(
Long.toString(managerCustomerId), ImmutableList.of(operation));
// Prints the resource name of the created cross-account bidding strategy.
MutateBiddingStrategyResult mutateBiddingStrategyResult = response.getResults(0);
String resourceName = mutateBiddingStrategyResult.getResourceName();
System.out.printf("Created cross-account bidding strategy: '%s'.%n", resourceName);
return resourceName;
}
}
C#
/// <summary>
/// Creates a new TargetSpend (Maximize Clicks) cross-account bidding strategy in the
/// specified manager account.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="managerCustomerId">The manager customer ID.</param>
/// <returns>The resource name of the newly created bidding strategy.</returns>
private string CreateBiddingStrategy(GoogleAdsClient client, long managerCustomerId)
{
BiddingStrategyServiceClient biddingStrategyServiceClient =
client.GetService(Services.V16.BiddingStrategyService);
// Create a portfolio bidding strategy.
BiddingStrategy portfolioBiddingStrategy = new BiddingStrategy
{
Name = $"Maximize clicks #{ExampleUtilities.GetRandomString()}",
TargetSpend = new TargetSpend(),
// Set the currency of the new bidding strategy. If not provided, the bidding
// strategy uses the manager account's default currency.
CurrencyCode = "USD"
};
// Send a create operation that will create the portfolio bidding strategy.
MutateBiddingStrategiesResponse mutateBiddingStrategiesResponse =
biddingStrategyServiceClient.MutateBiddingStrategies(managerCustomerId.ToString(),
new[]
{
new BiddingStrategyOperation
{
Create = portfolioBiddingStrategy
}
});
// Print and return the resource name of the newly created cross-account bidding
// strategy.
string biddingStrategyResourceName =
mutateBiddingStrategiesResponse.Results.First().ResourceName;
Console.WriteLine("Created cross-account bidding strategy " +
$"'{biddingStrategyResourceName}'.");
return biddingStrategyResourceName;
}
2,399필리핀
private static function createBiddingStrategy(
GoogleAdsClient $googleAdsClient,
int $managerCustomerId
): string {
// Creates a portfolio bidding strategy.
$portfolioBiddingStrategy = new BiddingStrategy([
'name' => 'Maximize Clicks #' . Helper::getPrintableDatetime(),
'target_spend' => new TargetSpend(),
// Optional: Sets the currency of the new bidding strategy to match the currency of the
// client account with which this bidding strategy is shared.
// If not provided, the bidding strategy uses the manager account's default currency.
'currency_code' => 'USD'
]);
// Constructs an operation that will create a portfolio bidding strategy.
$biddingStrategyOperation = new BiddingStrategyOperation();
$biddingStrategyOperation->setCreate($portfolioBiddingStrategy);
// Issues a mutate request to create the bidding strategy.
$biddingStrategyServiceClient = $googleAdsClient->getBiddingStrategyServiceClient();
$response = $biddingStrategyServiceClient->mutateBiddingStrategies(
MutateBiddingStrategiesRequest::build($managerCustomerId, [$biddingStrategyOperation])
);
/** @var BiddingStrategy $addedBiddingStrategy */
$addedBiddingStrategy = $response->getResults()[0];
// Prints out the resource name of the created bidding strategy.
printf(
"Created cross-account bidding strategy with resource name: '%s'.%s",
$addedBiddingStrategy->getResourceName(),
PHP_EOL
);
return $addedBiddingStrategy->getResourceName();
}
Python
def create_bidding_strategy(client, manager_customer_id):
"""Creates a new cross-account bidding strategy in the manager account.
The cross-account bidding strategy is of type TargetSpend (Maximize Clicks).
Args:
client: An initialized GoogleAdsClient instance.
manager_customer_id: A manager customer ID.
Returns:
The ID of the newly created bidding strategy.
"""
bidding_strategy_service = client.get_service("BiddingStrategyService")
# Creates a portfolio bidding strategy.
# Constructs an operation that will create a portfolio bidding strategy.
bidding_strategy_operation = client.get_type("BiddingStrategyOperation")
bidding_strategy = bidding_strategy_operation.create
bidding_strategy.name = f"Maximize Clicks #{uuid4()}"
# Sets target_spend to an empty TargetSpend object without setting any
# of its nested fields.
bidding_strategy.target_spend = client.get_type("TargetSpend")
# Sets the currency of the new bidding strategy. If not provided, the
# bidding strategy uses the manager account's default currency.
bidding_strategy.currency_code = "USD"
# Sends the operation in a mutate request.
response = bidding_strategy_service.mutate_bidding_strategies(
customer_id=manager_customer_id, operations=[bidding_strategy_operation]
)
# Prints the resource name of the created cross-account bidding strategy.
resource_name = response.results[0].resource_name
print(f"Created cross-account bidding strategy: '{resource_name}'")
return resource_name
Ruby
def create_bidding_strategy(client, manager_customer_id)
# Constructs an operation that will create a portfolio bidding strategy.
operation = client.operation.create_resource.bidding_strategy do |b|
b.name = "Maximize Clicks ##{(Time.new.to_f * 1000).to_i}"
b.target_spend = client.resource.target_spend
# Sets the currency of the new bidding strategy. If not provided, the
# bidding strategy uses the manager account's default currency.
b.currency_code = "USD"
end
# Sends the operation in a mutate request.
response = client.service.bidding_strategy.mutate_bidding_strategies(
customer_id: manager_customer_id,
operations: [operation],
)
resource_name = response.results.first.resource_name
puts "Created cross-account bidding strategy: `#{resource_name}`"
resource_name
end
Perl
# Creates a new TargetSpend (Maximize Clicks) cross-account bidding strategy in
# the specified manager account.
sub _create_bidding_strategy {
my ($api_client, $manager_customer_id) = @_;
# Create a portfolio bidding strategy.
my $portfolio_bidding_strategy =
Google::Ads::GoogleAds::V16::Resources::BiddingStrategy->new({
name => "Maximize clicks #" . uniqid(),
targetSpend => Google::Ads::GoogleAds::V16::Common::TargetSpend->new(),
# Sets the currency of the new bidding strategy. If not provided, the
# bidding strategy uses the manager account's default currency.
currencyCode => "USD"
});
# Send a create operation that will create the portfolio bidding strategy.
my $mutate_bidding_strategies_response =
$api_client->BiddingStrategyService()->mutate({
customerId => $manager_customer_id,
operations => [
Google::Ads::GoogleAds::V16::Services::BiddingStrategyService::BiddingStrategyOperation
->new({
create => $portfolio_bidding_strategy
})]});
my $resource_name =
$mutate_bidding_strategies_response->{results}[0]{resourceName};
printf "Created cross-account bidding strategy with resource name '%s'.\n",
$resource_name;
return $resource_name;
}
통화 코드 설정
관리자 계정의 교차 계정 전략은 선택사항인 currency_code 설정을 지원하므로 다양한 통화를 사용하는 고객 계정과 입찰 전략을 공유할 수 있습니다. 이 필드는 선택사항이며, 설정하지 않을 경우 관리자 계정의 통화로 기본 설정됩니다. currency_code 필드는 교차 계정 입찰 전략에서만 변경할 수 있습니다.
Java
BiddingStrategy portfolioBiddingStrategy =
BiddingStrategy.newBuilder()
.setName("Maximize Clicks #" + getPrintableDateTime())
.setTargetSpend(TargetSpend.getDefaultInstance())
// Sets the currency of the new bidding strategy. If not provided, the bidding
// strategy uses the manager account's default currency.
.setCurrencyCode("USD")
.build();
C#
BiddingStrategy portfolioBiddingStrategy = new BiddingStrategy
{
Name = $"Maximize clicks #{ExampleUtilities.GetRandomString()}",
TargetSpend = new TargetSpend(),
// Set the currency of the new bidding strategy. If not provided, the bidding
// strategy uses the manager account's default currency.
CurrencyCode = "USD"
};
2,399필리핀
$portfolioBiddingStrategy = new BiddingStrategy([
'name' => 'Maximize Clicks #' . Helper::getPrintableDatetime(),
'target_spend' => new TargetSpend(),
// Optional: Sets the currency of the new bidding strategy to match the currency of the
// client account with which this bidding strategy is shared.
// If not provided, the bidding strategy uses the manager account's default currency.
'currency_code' => 'USD'
]);
Python
# Constructs an operation that will create a portfolio bidding strategy.
bidding_strategy_operation = client.get_type("BiddingStrategyOperation")
bidding_strategy = bidding_strategy_operation.create
bidding_strategy.name = f"Maximize Clicks #{uuid4()}"
# Sets target_spend to an empty TargetSpend object without setting any
# of its nested fields.
bidding_strategy.target_spend = client.get_type("TargetSpend")
# Sets the currency of the new bidding strategy. If not provided, the
# bidding strategy uses the manager account's default currency.
bidding_strategy.currency_code = "USD"
Ruby
operation = client.operation.create_resource.bidding_strategy do |b|
b.name = "Maximize Clicks ##{(Time.new.to_f * 1000).to_i}"
b.target_spend = client.resource.target_spend
# Sets the currency of the new bidding strategy. If not provided, the
# bidding strategy uses the manager account's default currency.
b.currency_code = "USD"
Perl
my $portfolio_bidding_strategy =
Google::Ads::GoogleAds::V16::Resources::BiddingStrategy->new({
name => "Maximize clicks #" . uniqid(),
targetSpend => Google::Ads::GoogleAds::V16::Common::TargetSpend->new(),
# Sets the currency of the new bidding strategy. If not provided, the
# bidding strategy uses the manager account's default currency.
currencyCode => "USD"
});
업데이트 전략
입찰 전략의 일부 필드는 유형에 따라 업데이트할 수 있습니다. 입찰 전략을 소유한 관리자 계정 (또는 관리자 계정)은 다른 포트폴리오 전략과 유사하게 전체 계정 입찰 전략의 필드를 업데이트할 수 있습니다.
예를 들어 이전 예시에서 만든 TargetSpend 전략의 최대 입찰가 한도를 변경하려면 cpc_bid_ceiling_micros 필드를 새 값으로 설정합니다.
사용하지 않는 전략 삭제
교차 계정 입찰 전략을 삭제하려면 이 전략을 사용 중인 캠페인이 없어야 합니다. 아직 사용 중인 전략을 삭제하려고 하면 CANNOT_REMOVE_ASSOCIATED_STRATEGY 오류가 발생합니다. 먼저 연결된 캠페인에서 전략을 삭제해야 합니다.
속성 읽기
BiddingStrategy 리소스는 단일 계정 내에서 입찰 전략 속성을 만들고 업데이트하고 가져오는 데 사용됩니다. 이전 섹션에서 언급했듯이 해당 계정이 관리자 계정인 경우 BiddingStrategy 리소스에서 변형하고 읽어오는 방법으로 교차 계정 입찰 전략을 관리합니다.
따라서 관리자 계정으로 API를 호출할 때 BiddingStrategy 리소스를 쿼리하여 소유한 교차 계정 입찰 전략의 목록을 나열하고 읽을 수 있습니다.
Java
private void listManagerOwnedBiddingStrategies(
GoogleAdsClient googleAdsClient, long managerCustomerId) throws GoogleAdsException {
try (GoogleAdsServiceClient googleAdsServiceClient =
googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
String query =
"SELECT bidding_strategy.id, "
+ "bidding_strategy.name, "
+ "bidding_strategy.type, "
+ "bidding_strategy.currency_code "
+ "FROM bidding_strategy";
// Constructs the SearchGoogleAdsStreamRequest.
SearchGoogleAdsStreamRequest request =
SearchGoogleAdsStreamRequest.newBuilder()
.setCustomerId(Long.toString(managerCustomerId))
.setQuery(query)
.build();
// Creates and issues a search Google Ads stream request that will retrieve all bidding
// strategies.
ServerStream<SearchGoogleAdsStreamResponse> stream =
googleAdsServiceClient.searchStreamCallable().call(request);
// Iterates through and prints all of the results in the stream response.
System.out.printf(
"Cross-account bid strategies in manager account %d: %n", managerCustomerId);
for (SearchGoogleAdsStreamResponse response : stream) {
for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
BiddingStrategy bs = googleAdsRow.getBiddingStrategy();
System.out.printf(" ID: %d%n", bs.getId());
System.out.printf(" Name: %s%n", bs.getName());
System.out.printf(" Strategy type: %s%n", bs.getType());
System.out.printf(" Currency: %s%n", bs.getCurrencyCode());
System.out.println();
}
}
}
}
C#
/// <summary>
/// Lists all cross-account bidding strategies in a specified manager account.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="managerCustomerId">The manager customer ID.</param>
private void ListManagerOwnedBiddingStrategies(GoogleAdsClient client,
long managerCustomerId)
{
GoogleAdsServiceClient googleAdsServiceClient =
client.GetService(Services.V16.GoogleAdsService);
// Create a GAQL query that will retrieve all cross-account bidding strategies.
string query = @"
SELECT
bidding_strategy.id,
bidding_strategy.name,
bidding_strategy.type,
bidding_strategy.currency_code
FROM bidding_strategy";
// Issue a streaming search request, then iterate through and print the results.
googleAdsServiceClient.SearchStream(managerCustomerId.ToString(), query,
delegate(SearchGoogleAdsStreamResponse resp)
{
Console.WriteLine("Cross-account bid strategies in manager account " +
$"{managerCustomerId}:");
foreach (GoogleAdsRow googleAdsRow in resp.Results)
{
BiddingStrategy biddingStrategy = googleAdsRow.BiddingStrategy;
Console.WriteLine($"\tID: {biddingStrategy.Id}\n" +
$"\tName: {biddingStrategy.Name}\n" +
"\tStrategy type: " +
$"{Enum.GetName(typeof(BiddingStrategyType), biddingStrategy.Type)}\n" +
$"\tCurrency: {biddingStrategy.CurrencyCode}\n\n");
}
}
);
}
2,399필리핀
private static function listManagerOwnedBiddingStrategies(
GoogleAdsClient $googleAdsClient,
int $managerCustomerId
) {
$googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
// Creates a query that retrieves all bidding strategies.
$query = 'SELECT bidding_strategy.id, bidding_strategy.name, '
. 'bidding_strategy.type, bidding_strategy.currency_code '
. 'FROM bidding_strategy';
// Issues a search stream request.
/** @var GoogleAdsServerStreamDecorator $stream */
$stream = $googleAdsServiceClient->searchStream(
SearchGoogleAdsStreamRequest::build($managerCustomerId, $query)
);
// Iterates over all rows in all messages and prints the requested field values for
// the bidding strategy in each row.
printf(
"Cross-account bid strategies in manager account ID %d:%s",
$managerCustomerId,
PHP_EOL
);
foreach ($stream->iterateAllElements() as $googleAdsRow) {
/** @var GoogleAdsRow $googleAdsRow */
printf(
' ID: %1$d%2$s Name: "%3$s"%2$s Strategy type: "%4$s"%2$s'
. ' Currency: "%5$s"%2$s%2$s',
$googleAdsRow->getBiddingStrategy()->getId(),
PHP_EOL,
$googleAdsRow->getBiddingStrategy()->getName(),
BiddingStrategyType::name($googleAdsRow->getBiddingStrategy()->getType()),
$googleAdsRow->getBiddingStrategy()->getCurrencyCode()
);
}
}
Python
def list_manager_owned_bidding_strategies(client, manager_customer_id):
"""List all cross-account bidding strategies in the manager account.
Args:
client: An initialized GoogleAdsClient instance.
manager_customer_id: A manager customer ID.
"""
googleads_service = client.get_service("GoogleAdsService")
query = """
SELECT
bidding_strategy.id,
bidding_strategy.name,
bidding_strategy.type,
bidding_strategy.currency_code
FROM bidding_strategy"""
# Creates and issues a search Google Ads stream request that will retrieve
# all bidding strategies.
stream = googleads_service.search_stream(
customer_id=manager_customer_id, query=query
)
# Iterates through and prints all of the results in the stream response.
print(
"Cross-account bid strategies in manager account: "
f"{manager_customer_id}"
)
for response in stream:
for row in response.results:
bs = row.bidding_strategy
print(
f"\tID: {bs.id}\n"
f"\tName: {bs.name}\n"
f"\tStrategy type: {bs.type_}\n"
f"\tCurrency: {bs.currency_code}\n\n"
)
Ruby
def list_manager_owned_bidding_strategies(client, manager_customer_id)
query = <<~QUERY
SELECT bidding_strategy.id,
bidding_strategy.name,
bidding_strategy.type,
bidding_strategy.currency_code
FROM bidding_strategy
QUERY
responses = client.service.google_ads.search_stream(
customer_id: manager_customer_id,
query: query,
)
puts "Cross-account bid strategies in manager account #{manager_customer_id}:"
responses.each do |response|
response.results.each do |row|
b = row.bidding_strategy
puts "ID: #{b.id}"
puts "Name: #{b.name}"
puts "Strategy type: #{b.type}"
puts "Currency: #{b.currency_code}"
puts
end
end
end
Perl
# Lists all cross-account bidding strategies in a specified manager account.
sub _list_manager_owned_bidding_strategies {
my ($api_client, $manager_customer_id) = @_;
# Create a GAQL query that will retrieve all cross-account bidding
# strategies.
my $query = "SELECT
bidding_strategy.id,
bidding_strategy.name,
bidding_strategy.type,
bidding_strategy.currency_code
FROM bidding_strategy";
# Issue a streaming search request, then iterate through and print the
# results.
my $search_stream_handler =
Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
service => $api_client->GoogleAdsService(),
request =>
Google::Ads::GoogleAds::V16::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
->new({
customerId => $manager_customer_id,
query => $query
})});
printf
"Cross-account bid strategies in manager account $manager_customer_id:\n";
$search_stream_handler->process_contents(
sub {
my $google_ads_row = shift;
my $bidding_strategy = $google_ads_row->{biddingStrategy};
printf "\tID: $bidding_strategy->{id}\n" .
"\tName: $bidding_strategy->{name}\n" .
"\tStrategy type: $bidding_strategy->{type}\n" .
"\tCurrency: $bidding_strategy->{currencyCode}\n\n";
});
}
사용하기 쉬운 입찰 전략 보기
교차 계정 입찰 전략을 사용하는 고객 계정으로 작업할 때 AccessibleBiddingStrategy 리소스는 현재 고객이 액세스할 수 있는 모든 입찰 전략의 읽기 전용 뷰를 제공하는 데 사용됩니다. 여기에는 고객이 소유한 포트폴리오 전략과 고객과 공유된 교차 계정 입찰 전략이 모두 포함됩니다.
접근성이 우수한 모든 입찰 전략 사용하기
현재 고객이 액세스할 수 있는 모든 입찰 전략을 검색하려면
accessible_bidding_strategy 리소스를
직접 쿼리합니다. 결과에는 기본적으로 현재 계정의 포트폴리오 전략과 관리자가 공유한 교차 계정 입찰 전략이 모두 포함됩니다.
Java
private void listCustomerAccessibleBiddingStrategies(
GoogleAdsClient googleAdsClient, long clientCustomerId) throws GoogleAdsException {
try (GoogleAdsServiceClient googleAdsServiceClient =
googleAdsClient.getLatestVersion().createGoogleAdsServiceClient()) {
String query =
"SELECT accessible_bidding_strategy.id, "
+ "accessible_bidding_strategy.name, "
+ "accessible_bidding_strategy.type, "
+ "accessible_bidding_strategy.owner_customer_id, "
+ "accessible_bidding_strategy.owner_descriptive_name "
+ "FROM accessible_bidding_strategy "
// Uncomment the following WHERE clause to filter results to *only* cross-account bidding
// strategies shared with the current customer by a manager (and not also include the
// current customer's portfolio bidding strategies).
// + "WHERE accessible_bidding_strategy.owner_customer_id != " + clientCustomerId;
;
// Constructs the SearchGoogleAdsStreamRequest.
SearchGoogleAdsStreamRequest request =
SearchGoogleAdsStreamRequest.newBuilder()
.setCustomerId(Long.toString(clientCustomerId))
.setQuery(query)
.build();
// Creates and issues a search Google Ads stream request that will retrieve all accessible
// bidding strategies.
ServerStream<SearchGoogleAdsStreamResponse> stream =
googleAdsServiceClient.searchStreamCallable().call(request);
// Iterates through and prints all of the results in the stream response.
System.out.printf("All bid strategies accessible by account %d: %n", clientCustomerId);
for (SearchGoogleAdsStreamResponse response : stream) {
for (GoogleAdsRow googleAdsRow : response.getResultsList()) {
AccessibleBiddingStrategy bs = googleAdsRow.getAccessibleBiddingStrategy();
System.out.printf(" ID: %d%n", bs.getId());
System.out.printf(" Name: %s%n", bs.getName());
System.out.printf(" Strategy type: %s%n", bs.getType());
System.out.printf(" Owner customer ID: %d%n", bs.getOwnerCustomerId());
System.out.printf(" Owner description: %s%n", bs.getOwnerDescriptiveName());
System.out.println();
}
}
}
}
C#
/// <summary>
/// Lists all bidding strategies available to specified client customer account. This
/// includes both portfolio bidding strategies owned by the client customer account and
/// cross-account bidding strategies shared by any of its managers.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads client customer ID for which the call is
/// made.</param>
private void ListCustomerAccessibleBiddingStrategies(GoogleAdsClient client,
long customerId)
{
GoogleAdsServiceClient googleAdsServiceClient =
client.GetService(Services.V16.GoogleAdsService);
// Create a GAQL query that will retrieve all accessible bidding strategies.
string query = @"
SELECT
accessible_bidding_strategy.resource_name,
accessible_bidding_strategy.id,
accessible_bidding_strategy.name,
accessible_bidding_strategy.type,
accessible_bidding_strategy.owner_customer_id,
accessible_bidding_strategy.owner_descriptive_name
FROM accessible_bidding_strategy";
// Uncomment the following WHERE clause addition to the query to filter results to
// *only* cross-account bidding strategies shared with the current customer by a manager
// (and not also include the current customer's portfolio bidding strategies).
// query += $" WHERE accessible_bidding_strategy.owner_customer_id != {customerId}";
// Issue a streaming search request, then iterate through and print the results.
googleAdsServiceClient.SearchStream(customerId.ToString(), query,
delegate(SearchGoogleAdsStreamResponse resp)
{
Console.WriteLine($"All bid strategies accessible by account {customerId}:");
foreach (GoogleAdsRow googleAdsRow in resp.Results)
{
AccessibleBiddingStrategy biddingStrategy =
googleAdsRow.AccessibleBiddingStrategy;
Console.WriteLine($"\tID: {biddingStrategy.Id}\n" +
$"\tName: {biddingStrategy.Name}\n" +
$"\tStrategy type: {biddingStrategy.Type.ToString()}\n" +
$"\tOwner customer ID: {biddingStrategy.OwnerCustomerId}\n" +
$"\tOwner description: {biddingStrategy.OwnerDescriptiveName}\n\n");
}
}
);
}
2,399필리핀
private static function listCustomerAccessibleBiddingStrategies(
GoogleAdsClient $googleAdsClient,
int $clientCustomerId
) {
$googleAdsServiceClient = $googleAdsClient->getGoogleAdsServiceClient();
// Creates a query that retrieves all bidding strategies.
$query = 'SELECT accessible_bidding_strategy.id, '
. 'accessible_bidding_strategy.name, '
. 'accessible_bidding_strategy.type, '
. 'accessible_bidding_strategy.owner_customer_id, '
. 'accessible_bidding_strategy.owner_descriptive_name '
. 'FROM accessible_bidding_strategy '
// Uncomment the following WHERE clause to filter results to *only* cross-account
// bidding strategies shared with the current customer by a manager (and not also
// include the current customer's portfolio bidding strategies).
// . 'WHERE accessible_bidding_strategy.owner_customer_id != ' . $clientCustomerId
;
// Issues a search stream request.
/** @var GoogleAdsServerStreamDecorator $stream */
$stream = $googleAdsServiceClient->searchStream(
SearchGoogleAdsStreamRequest::build($clientCustomerId, $query)
);
// Iterates over all rows in all messages and prints the requested field values for
// each accessible bidding strategy.
printf(
"All bid strategies accessible by the customer ID %d:%s",
$clientCustomerId,
PHP_EOL
);
foreach ($stream->iterateAllElements() as $googleAdsRow) {
/** @var GoogleAdsRow $googleAdsRow */
printf(
' ID: %1$d%2$s Name: "%3$s"%2$s Strategy type: "%4$s"%2$s'
. ' Owner customer ID: %5$d%2$s Owner customer description: "%6$s"%2$s%2$s',
$googleAdsRow->getAccessibleBiddingStrategy()->getId(),
PHP_EOL,
$googleAdsRow->getAccessibleBiddingStrategy()->getName(),
BiddingStrategyType::name($googleAdsRow->getAccessibleBiddingStrategy()->getType()),
$googleAdsRow->getAccessibleBiddingStrategy()->getOwnerCustomerId(),
$googleAdsRow->getAccessibleBiddingStrategy()->getOwnerDescriptiveName()
);
}
}
Python
def list_customer_accessible_bidding_strategies(client, customer_id):
"""Lists all bidding strategies available to the client account.
This includes both portfolio bidding strategies owned by account and
cross-account bidding strategies shared by any of its managers.
Args:
client: An initialized GoogleAdsClient instance.
customer_id: A client customer ID.
"""
googleads_service = client.get_service("GoogleAdsService")
query = """
SELECT
accessible_bidding_strategy.id,
accessible_bidding_strategy.name,
accessible_bidding_strategy.type,
accessible_bidding_strategy.owner_customer_id,
accessible_bidding_strategy.owner_descriptive_name
FROM accessible_bidding_strategy"""
# Uncomment the following WHERE clause to filter results to *only*
# cross-account bidding strategies shared with the current customer by a
# manager (and not also include the current customer's portfolio
# bidding strategies).
#
# query += f"WHERE accessible_bidding_strategy.owner_customer_id != {customer_id}"
# Creates and issues a search Google Ads stream request that will retrieve
# all bidding strategies.
stream = googleads_service.search_stream(
customer_id=customer_id, query=query
)
# Iterates through and prints all of the results in the stream response.
print(f"All bid strategies accessible by account '{customer_id}'\n")
for response in stream:
for row in response.results:
bs = row.accessible_bidding_strategy
print(
f"\tID: {bs.id}\n"
f"\tName: {bs.name}\n"
f"\tStrategy type: {bs.type_}\n"
f"\tOwner customer ID: {bs.owner_customer_id}\n"
f"\tOwner description: {bs.owner_descriptive_name}\n\n"
)
Ruby
def list_customer_accessible_bidding_strategies(client, customer_id)
query = <<~QUERY
SELECT accessible_bidding_strategy.id,
accessible_bidding_strategy.name,
accessible_bidding_strategy.type,
accessible_bidding_strategy.owner_customer_id,
accessible_bidding_strategy.owner_descriptive_name
FROM accessible_bidding_strategy
QUERY
# Add the following WHERE clause to filter results to *only*
# cross-account bidding strategies shared with the current customer by a
# manager (and not also include the current customer's portfolio bidding
# strategies).
# query += <<~QUERY
# WHERE accessible_bidding_strategy.owner_customer_id != #{customer_id}
# QUERY
responses = client.service.google_ads.search_stream(
customer_id: customer_id,
query: query,
)
puts "All bid strategies accessible by account #{customer_id}:"
responses.each do |response|
response.results.each do |row|
b = row.accessible_bidding_strategy
puts "ID: #{b.id}"
puts "Name: #{b.name}"
puts "Strategy type: #{b.type}"
puts "Owner customer ID: #{b.owner_customer_id}"
puts "Owner description: #{b.owner_descriptive_name}"
puts
end
end
end
Perl
# Lists all bidding strategies available to specified client customer account.
# This includes both portfolio bidding strategies owned by the client customer
# account and cross-account bidding strategies shared by any of its managers.
sub _list_customer_accessible_bidding_strategies {
my ($api_client, $customer_id) = @_;
# Create a GAQL query that will retrieve all accessible bidding strategies.
my $query = "SELECT
accessible_bidding_strategy.resource_name,
accessible_bidding_strategy.id,
accessible_bidding_strategy.name,
accessible_bidding_strategy.type,
accessible_bidding_strategy.owner_customer_id,
accessible_bidding_strategy.owner_descriptive_name
FROM accessible_bidding_strategy";
# Uncomment the following WHERE clause addition to the query to filter results
# to *only* cross-account bidding strategies shared with the current customer
# by a manager (and not also include the current customer's portfolio bidding
# strategies).
# $query .=
# " WHERE accessible_bidding_strategy.owner_customer_id != $customer_id";
# Issue a streaming search request, then iterate through and print the
# results.
my $search_stream_handler =
Google::Ads::GoogleAds::Utils::SearchStreamHandler->new({
service => $api_client->GoogleAdsService(),
request =>
Google::Ads::GoogleAds::V16::Services::GoogleAdsService::SearchGoogleAdsStreamRequest
->new({
customerId => $customer_id,
query => $query
})});
printf "All bid strategies accessible by account $customer_id:\n";
$search_stream_handler->process_contents(
sub {
my $google_ads_row = shift;
my $bidding_strategy = $google_ads_row->{accessibleBiddingStrategy};
printf "\tID: $bidding_strategy->{id}\n" .
"\tName: $bidding_strategy->{name}\n" .
"\tStrategy type: $bidding_strategy->{type}\n" .
"\tOwner customer ID: $bidding_strategy->{ownerCustomerId}\n" .
"\tOwner description: $bidding_strategy->{ownerDescriptiveName}\n\n";
});
}
특정 캠페인에 대한 정보 얻기
캠페인을 쿼리할 때 bidding_strategy 및
accessible_bidding_strategy의 필드를 가져올 수도 있습니다. 쿼리의 FROM 절에서 campaign를 사용하면 일치하는 캠페인이 연결된 bidding_strategy 및 accessible_bidding_strategy 리소스를 암시적으로 조인합니다.
예를 들어 다음 쿼리는 연결된 bidding_strategy 및 accessible_bidding_strategy 리소스의 모든 활성 캠페인과 필드를 가져옵니다.
Google 애널리틱스 QL
SELECT campaign.id, campaign.name, campaign.bidding_strategy, campaign.bidding_strategy_type, accessible_bidding_strategy.id, accessible_bidding_strategy.name, accessible_bidding_strategy.type, accessible_bidding_strategy.owner_customer_id, accessible_bidding_strategy.owner_descriptive_name, bidding_strategy.name, bidding_strategy.type FROM campaign WHERE campaign.status != REMOVED
캠페인에 연결
표준 포트폴리오 입찰 전략과 마찬가지로 bidding_strategy를 교차 계정 입찰 전략의 리소스 이름으로 설정하여 교차 계정 입찰 전략을 캠페인에 연결합니다. 교차 계정 입찰 전략을 소유한 관리자 (또는 이러한 관리자의 관리자)만 이러한 전략을 캠페인에 연결할 수 있습니다.
따라서 교차 계정 입찰 전략을 캠페인에 연결하는 API 호출에서는
입찰 전략에 대한 적절한 액세스 권한이 있는
관리자의 login-customer-id를 사용해야 합니다.
Java
private void attachCrossAccountBiddingStrategyToCampaign(
GoogleAdsClient googleAdsClient,
long clientCustomerId,
long campaignId,
String biddingStrategyResourceName)
throws GoogleAdsException {
try (CampaignServiceClient campaignServiceClient =
googleAdsClient.getLatestVersion().createCampaignServiceClient()) {
Campaign campaign =
Campaign.newBuilder()
.setResourceName(ResourceNames.campaign(clientCustomerId, campaignId))
.setBiddingStrategy(biddingStrategyResourceName)
.build();
CampaignOperation operation =
CampaignOperation.newBuilder()
.setUpdate(campaign)
.setUpdateMask(FieldMasks.allSetFieldsOf(campaign))
.build();
// Sends the operation in a mutate request.
MutateCampaignsResponse response =
campaignServiceClient.mutateCampaigns(
Long.toString(clientCustomerId), ImmutableList.of(operation));
MutateCampaignResult mutateCampaignResult = response.getResults(0);
// Prints the resource name of the updated campaign.
System.out.printf(
"Updated campaign with resource name: '%s'.%n", mutateCampaignResult.getResourceName());
}
}
C#
/// <summary>
/// Attaches a specified cross-account bidding strategy to a campaign owned by a specified
/// client customer account.
/// </summary>
/// <param name="client">The Google Ads client.</param>
/// <param name="customerId">The Google Ads client customer ID for which the call is
/// made.</param>
/// <param name="campaignId">The ID of the campaign owned by the customer ID to which the
/// cross-account bidding strategy will be attached.</param>
/// <param name="biddingStrategyResourceName">A cross-account bidding strategy resource
/// name.</param>
private void AttachCrossAccountBiddingStrategyToCampaign(GoogleAdsClient client,
long customerId, long campaignId, string biddingStrategyResourceName)
{
CampaignServiceClient campaignServiceClient =
client.GetService(Services.V16.CampaignService);
Campaign campaign = new Campaign
{
ResourceName = ResourceNames.Campaign(customerId, campaignId),
BiddingStrategy = biddingStrategyResourceName
};
// Mutate the campaign and print the resource name of the updated campaign.
MutateCampaignsResponse mutateCampaignsResponse =
campaignServiceClient.MutateCampaigns(customerId.ToString(), new[]
{
new CampaignOperation
{
Update = campaign,
UpdateMask = FieldMasks.AllSetFieldsOf(campaign)
}
});
Console.WriteLine("Updated campaign with resource name " +
$"'{mutateCampaignsResponse.Results.First().ResourceName}'.");
}
2,399필리핀
private static function attachCrossAccountBiddingStrategyToCampaign(
GoogleAdsClient $googleAdsClient,
int $clientCustomerId,
int $campaignId,
string $biddingStrategyResourceName
) {
// Creates a campaign using the specified campaign ID and the bidding strategy ID.
// Note that a cross-account bidding strategy's resource name should use the
// client's customer ID when attaching it to a campaign, not that of the manager that owns
// the strategy.
$campaign = new Campaign([
'resource_name' => ResourceNames::forCampaign($clientCustomerId, $campaignId),
'bidding_strategy' => $biddingStrategyResourceName
]);
// Constructs an operation that will update the campaign with the specified resource name,
// using the FieldMasks utility to derive the update mask. This mask tells the Google Ads
// API which attributes of the campaign you want to change.
$campaignOperation = new CampaignOperation();
$campaignOperation->setUpdate($campaign);
$campaignOperation->setUpdateMask(FieldMasks::allSetFieldsOf($campaign));
// Issues a mutate request to update the campaign.
$campaignServiceClient = $googleAdsClient->getCampaignServiceClient();
$response = $campaignServiceClient->mutateCampaigns(
MutateCampaignsRequest::build($clientCustomerId, [$campaignOperation])
);
// Prints information about the updated campaign.
printf(
"Updated campaign with resource name: '%s'.%s",
$response->getResults()[0]->getResourceName(),
PHP_EOL
);
}
Python
def attach_cross_account_bidding_strategy_to_campaign(
client, customer_id, campaign_id, bidding_strategy_resource_name
):
"""Attaches the cross-account bidding strategy to the given campaign.
Args:
client: An initialized GoogleAdsClient instance.
customer_id: A client customer ID.
campaign_id: The ID of an existing campaign in the client customer's
account.
bidding_strategy_resource_name: The ID of a bidding strategy
"""
campaign_service = client.get_service("CampaignService")
bidding_strategy_service = client.get_service("BiddingStrategyService")
campaign_operation = client.get_type("CampaignOperation")
campaign = campaign_operation.update
campaign.resource_name = campaign_service.campaign_path(
customer_id, campaign_id
)
campaign.bidding_strategy = bidding_strategy_resource_name
campaign_operation.update_mask = protobuf_helpers.field_mask(
None, campaign._pb
)
# Sends the operation in a mutate request.
response = campaign_service.mutate_campaigns(
customer_id=customer_id, operations=[campaign_operation]
)
# Prints the resource name of the updated campaign.
print(
"Updated campaign with resource name: "
f"'{response.results[0].resource_name}'"
)
Ruby
def attach_cross_account_bidding_strategy_to_campaign(
client,
customer_id,
campaign_id,
bidding_strategy_resource_name)
operation = client.operation.update_resource.campaign(
client.path.campaign(customer_id, campaign_id)) do |c|
c.bidding_strategy = bidding_strategy_resource_name
end
# Sends the operation in a mutate request.
response = client.service.campaign.mutate_campaigns(
customer_id: customer_id,
operations: [operation],
)
puts "Updated campaign with resource name: " \
"`#{response.results.first.resource_name}`"
end
Perl
# Attaches a specified cross-account bidding strategy to a campaign owned by a
# specified client customer account.
sub _attach_cross_account_bidding_strategy_to_campaign {
my ($api_client, $customer_id, $campaign_id, $bidding_strategy_resource_name)
= @_;
my $campaign = Google::Ads::GoogleAds::V16::Resources::Campaign->new({
resourceName =>
Google::Ads::GoogleAds::V16::Utils::ResourceNames::campaign(
$customer_id, $campaign_id
),
biddingStrategy => $bidding_strategy_resource_name
});
my $campaign_operation =
Google::Ads::GoogleAds::V16::Services::CampaignService::CampaignOperation->
new({
update => $campaign,
updateMask => all_set_fields_of($campaign)});
my $campaigns_response = $api_client->CampaignService()->mutate({
customerId => $customer_id,
operations => [$campaign_operation]});
printf "Updated campaign with resource name '%s'.\n",
$campaigns_response->{results}[0]{resourceName};
}
입찰 전략 삭제
캠페인에서 교차 계정 입찰 전략의 연결을 해제하려면 다른 입찰 전략을 사용하도록 캠페인을 업데이트하세요. 다른 포트폴리오 전략을 사용하도록 bidding_strategy 필드를 설정하거나 대신 표준 입찰 전략을 사용하세요.
고객 계정 연결 해제
고객 계정과 관리자의 연결을 해제하면 해당 관리자가 공유한 교차 계정 입찰 전략에 더 이상 액세스할 수 없습니다. 이러한 입찰 전략을 사용하도록 설정된 클라이언트의 캠페인은 게재가 중단되며 다른 입찰 전략을 사용하도록 업데이트해야 합니다.