캠페인 예산 할당

캠페인에 예산을 할당하거나, 캠페인에서 예산을 분리하거나, 특정 예산에 할당된 캠페인을 가져올 수 있습니다.

캠페인에 예산 할당

를 만들거나 기존 캠페인을 식101}별한 후 호출에서 필드 값을 사용합니다.CampaignBudgetCampaignBudgetServiceresource_nameCampaignService 별도의 요청에서 예산 생성 작업이 성공했지만 후속 캠페인 할당이 실패하면 연결되지 않은 예산 (캠페인과 연결되지 않은 예산)이 발생합니다. 단일 GoogleAdsService.Mutate 요청에서 CampaignBudget (임시 리소스 ID 사용)와 Campaign을 모두 원자적으로 만들거나 사용하지 않는 예산을 재사용 또는 삭제하여 연결되지 않은 예산을 방지할 수 있습니다.

새 캠페인

새 캠페인의 경우 CampaignOperation.create, 다음 코드 예와 같이 Campaign 객체의 campaign_budget 필드를 예산 리소스 이름으로 설정합니다.

자바

// Creates the campaign.
Campaign campaign =
    Campaign.newBuilder()
        .setName("Interplanetary Cruise #" + getPrintableDateTime())
        .setAdvertisingChannelType(AdvertisingChannelType.SEARCH)
        // Recommendation: Set the campaign to PAUSED when creating it to prevent
        // the ads from immediately serving. Set to ENABLED once you've added
        // targeting and the ads are ready to serve
        .setStatus(CampaignStatus.PAUSED)
        // Sets the bidding strategy and budget.
        .setManualCpc(ManualCpc.newBuilder().build())
        .setCampaignBudget(budgetResourceName)
        // Adds the networkSettings configured above.
        .setNetworkSettings(networkSettings)
        // Declares whether this campaign serves political ads targeting the EU.
        .setContainsEuPoliticalAdvertising(DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING)
        // Optional: Sets the start & end dates.
        .setStartDateTime(new DateTime().plusDays(1).toString("yyyy-MM-dd 00:00:00"))
        .setEndDateTime(new DateTime().plusDays(30).toString("yyyy-MM-dd 23:59:59"))
        .build();
AddCampaigns.java
      

C#

// Create the campaign.
Campaign campaign = new Campaign()
{
    Name = "Interplanetary Cruise #" + ExampleUtilities.GetRandomString(),
    AdvertisingChannelType = AdvertisingChannelType.Search,

    // Recommendation: Set the campaign to PAUSED when creating it to prevent
    // the ads from immediately serving. Set to ENABLED once you've added
    // targeting and the ads are ready to serve
    Status = CampaignStatus.Paused,

    // Set the bidding strategy and budget.
    ManualCpc = new ManualCpc(),
    CampaignBudget = budget,

    // Set the campaign network options.
    NetworkSettings = new NetworkSettings
    {
        TargetGoogleSearch = true,
        TargetSearchNetwork = true,
        // Enable Display Expansion on Search campaigns. See
        // https://support.google.com/google-ads/answer/7193800 to learn more.
        TargetContentNetwork = true,
        TargetPartnerSearchNetwork = false
    },

    // Declare whether or not this campaign contains political ads targeting the EU.
    ContainsEuPoliticalAdvertising = EuPoliticalAdvertisingStatus.DoesNotContainEuPoliticalAdvertising,

    // Optional: Set the start date.
    StartDateTime = DateTime.Now.AddDays(1).ToString("yyyyMMdd 00:00:00"),

    // Optional: Set the end date.
    EndDateTime = DateTime.Now.AddYears(1).ToString("yyyyMMdd 23:59:59"),
};
AddCampaigns.cs
      

PHP

$campaign = new Campaign([
    'name' => 'Interplanetary Cruise #' . Helper::getPrintableDatetime(),
    'advertising_channel_type' => AdvertisingChannelType::SEARCH,
    // Recommendation: Set the campaign to PAUSED when creating it to prevent
    // the ads from immediately serving. Set to ENABLED once you've added
    // targeting and the ads are ready to serve.
    'status' => CampaignStatus::PAUSED,
    // Sets the bidding strategy and budget.
    'manual_cpc' => new ManualCpc(),
    'campaign_budget' => $budgetResourceName,
    // Adds the network settings configured above.
    'network_settings' => $networkSettings,
    // Declare whether or not this campaign serves political ads targeting the EU.
    'contains_eu_political_advertising' =>
        EuPoliticalAdvertisingStatus::DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,
    // Optional: Sets the start and end dates.
    'start_date_time' => date('Y-m-d 00:00:00', strtotime('+1 day')),
    'end_date_time' => date('Y-m-d 23:59:59', strtotime('+1 month'))
]);
AddCampaigns.php
      

Python

# Create campaign.
campaign_operation: CampaignOperation = client.get_type("CampaignOperation")
campaign: Campaign = campaign_operation.create
campaign.name = f"Interplanetary Cruise {uuid.uuid4()}"
campaign.advertising_channel_type = (
    client.enums.AdvertisingChannelTypeEnum.SEARCH
)

# Recommendation: Set the campaign to PAUSED when creating it to prevent
# the ads from immediately serving. Set to ENABLED once you've added
# targeting and the ads are ready to serve.
campaign.status = client.enums.CampaignStatusEnum.PAUSED

# Set the bidding strategy and budget.
campaign.manual_cpc = client.get_type("ManualCpc")
campaign.campaign_budget = campaign_budget_response.results[0].resource_name

# Set the campaign network options.
campaign.network_settings.target_google_search = True
campaign.network_settings.target_search_network = True
campaign.network_settings.target_partner_search_network = False
# Enable Display Expansion on Search campaigns. For more details see:
# https://support.google.com/google-ads/answer/7193800
campaign.network_settings.target_content_network = True

# Declare whether or not this campaign serves political ads targeting the
# EU. Valid values are:
#   CONTAINS_EU_POLITICAL_ADVERTISING
#   DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
campaign.contains_eu_political_advertising = (
    client.enums.EuPoliticalAdvertisingStatusEnum.DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING
)

# Optional: Set the start date.
start_time: datetime.date = datetime.date.today() + datetime.timedelta(
    days=1
)
campaign.start_date_time = datetime.date.strftime(
    start_time, _START_DATE_FORMAT
)

# Optional: Set the end date.
end_time: datetime.date = start_time + datetime.timedelta(weeks=4)
campaign.end_date_time = datetime.date.strftime(end_time, _END_DATE_FORMAT)
add_campaigns.py
      

Ruby

# Create campaign.
campaign = client.resource.campaign do |c|
  c.name = "Interplanetary Cruise #{(Time.new.to_f * 1000).to_i}"
  c.advertising_channel_type = :SEARCH

  # Recommendation: Set the campaign to PAUSED when creating it to prevent
  # the ads from immediately serving. Set to ENABLED once you've added
  # targeting and the ads are ready to serve.
  c.status = :PAUSED

  # Set the bidding strategy and budget.
  c.manual_cpc = client.resource.manual_cpc
  c.campaign_budget = return_budget.results.first.resource_name

  # Set the campaign network options.
  c.network_settings = client.resource.network_settings do |ns|
    ns.target_google_search = true
    ns.target_search_network = true
    # Enable Display Expansion on Search campaigns. See
    # https://support.google.com/google-ads/answer/7193800 to learn more.
    ns.target_content_network = true
    ns.target_partner_search_network = false
  end

  # Declare whether or not this campaign serves political ads targeting the EU.
  # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
  # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
  c.contains_eu_political_advertising = :DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING

  # Optional: Set the start date.
  c.start_date_time = DateTime.parse((Date.today + 1).to_s).strftime('%Y%m%d %H:%M:%S')

  # Optional: Set the end date.
  c.end_date_time = DateTime.parse((Date.today.next_year).to_s).strftime('%Y%m%d %H:%M:%S')
end
add_campaigns.rb
      

Perl

# Create a campaign.
my $campaign = Google::Ads::GoogleAds::V26::Resources::Campaign->new({
    name                   => "Interplanetary Cruise #" . uniqid(),
    advertisingChannelType => SEARCH,
    # Recommendation: Set the campaign to PAUSED when creating it to stop
    # the ads from immediately serving. Set to ENABLED once you've added
    # targeting and the ads are ready to serve.
    status => PAUSED,
    # Set the bidding strategy and budget.
    manualCpc      => Google::Ads::GoogleAds::V26::Common::ManualCpc->new(),
    campaignBudget => $campaign_budgets_response->{results}[0]{resourceName},
    # Set the campaign network options.
    networkSettings =>
      Google::Ads::GoogleAds::V26::Resources::NetworkSettings->new({
        targetGoogleSearch  => "true",
        targetSearchNetwork => "true",
        # Enable Display Expansion on Search campaigns. See
        # https://support.google.com/google-ads/answer/7193800 to learn more.
        targetContentNetwork       => "true",
        targetPartnerSearchNetwork => "false"
      }
      ),
    # Declare whether or not this campaign serves political ads targeting the EU.
    # Valid values are CONTAINS_EU_POLITICAL_ADVERTISING and
    # DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING.
    containsEuPoliticalAdvertising =>
      DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING,
    # Optional: Set the start datetime. The campaign starts tomorrow.
    startDateTime =>
      strftime("%Y%m%d 00:00:00", localtime(time + 60 * 60 * 24)),
    # Optional: Set the end datetime. The campaign runs for 30 days.
    endDateTime =>
      strftime("%Y%m%d 23:59:59", localtime(time + 60 * 60 * 24 * 30)),
  });
add_campaigns.pl
      

curl

참고: 이 단계의 직접 REST 코드 샘플은 여기에 제공되지 않지만 수동 REST 요청을 사용하여 이 작업을 수행할 수 있습니다.

Google Ads API REST 인터페이스 문서 및 메서드별 참조 페이지를 참고하세요. 프로토 정의를 기반으로 JSON 페이로드를 구성해야 합니다.

주요 리소스:

• REST 사용
• REST 인터페이스 구조
• JSON 필드 매핑
• 특정 서비스 및 메서드에 관한 REST API 참조를 확인하세요.

기존 캠페인

기존 캠페인의 예산을 바꾸려면 CampaignOperation.update에서 campaign_budget 필드를 Campaign 객체로 기존 예산의 리소스 이름으로 설정합니다 (설정하려는 다른 캠페인 필드와 함께). 캠페인은 한 번에 하나의 예산과만 연결될 수 있으므로 이렇게 하면 캠페인에 할당된 기존 예산이 campaign_budget 필드에 지정된 예산으로 바뀝니다.

경고: 새로 만든 예산으로 바꾸는 대신 기존 예산을 업데이트하는 것이 좋습니다. 기존 캠페인에 새 캠페인 예산을 할당하면 기존 캠페인 예산에 누적된 모든 지출이 무시됩니다. 또한 30일 이내에 일일예산을 수정하면 초과 게재가 발생할 수 있습니다. 예를 들어 예산을 10달러로 설정하고 10달러를 지출한 후 당일 새 예산을 11달러로 할당하면 캠페인에서 약 21달러를 지출할 수 있습니다. 대신 기존 예산 금액을 11달러로 업데이트하면 일일 지출 목표는 11달러로 유지됩니다.

캠페인에서 예산 분리

캠페인은 항상 예산과 연결되어야 합니다. 캠페인과 연결된 예산을 변경하여 캠페인에서 예산 을 삭제하고 다른 예산으로 바꿀 수 있습니다. 특정 예산을 사용하는 캠페인을 식별하려면 다음 섹션을 참고하세요.

예산에 할당된 캠페인 가져오기

동일한 예산을 사용하는 캠페인 목록을 가져오면 예산 사용의 균형을 맞추는 데 도움이 될 수 있습니다. 다음 GAQL 쿼리는 지정된 예산 ID의 모든 캠페인을 반환합니다.

SELECT campaign.id
FROM campaign
WHERE campaign_budget.id = campaign_budget_id