앱 캠페인 만들기

Google Ads API로 앱 캠페인을 만들어 검색, Google Play, YouTube, AdMob, 디스커버, Google 디스플레이 네트워크에서 모바일 앱을 홍보하세요. 설치, 인앱 액션, 전환 가치 또는 Android 사전 등록에 맞게 캠페인을 최적화합니다. 사용 설정된 캠페인에는 예산 한도까지 표준 Google Ads 광고 게재 요금이 부과됩니다.

준비

캠페인 목표(설치당비용(CPI), 액션당비용(CPA), 광고 투자수익(ROAS) 또는 사전 등록)에 따라 API 설정이 결정됩니다. 만들기 단계를 완료하기 전에 다음 표에서 목표를 찾습니다. Google Ads UI 컨트롤을 조회하려면 Google Ads UI 설정을 API 필드에 매핑을 참고하거나 앱 캠페인에 대한 정보를 참고하세요.

목표 및 Google Ads UI 선택 하위유형 및 목표 enum 입찰 전략 전환 설정(conversion_actions)
설치 수 증가(타겟 CPI)
설치 수 > 모든 사용자, 타겟 설치당비용 설정(선택사항)이 선택됨
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = 타겟 CPI) 선택사항. conversion_actions의 DOWNLOAD 작업 최대 1개
타겟 CPI 없이 설치 수 늘리기
설치 수 > 모든 사용자, 타겟 설치당비용 설정(선택사항)이 선택 해제되었습니다.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
maximize_conversions (target_cpa_micros 없음). 선택사항. 최대 1개의 DOWNLOAD 작업
인앱 액션이 포함된 설치(타겟 CPI).
설치 수 > 인앱 액션을 취할 가능성이 높은 사용자, 타겟 설치당비용
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
target_cpa(target_cpa_micros = 타겟 CPI) 필수사항. 인앱 액션 1개 및 선택사항인 DOWNLOAD 액션
인앱 액션(타겟 CPA):
인앱 액션, 타겟 인앱 액션당 비용 설정(선택사항)이 선택됨(또는 참여의 경우 타겟 액션당비용)
APP_CAMPAIGN또는APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
target_cpa(target_cpa_micros = 타겟 CPA) 필수사항. 설치 후 작업 APP_CAMPAIGN의 DOWNLOAD(참여 없음)은 선택사항입니다.
타겟 CPA가 없는 인앱 액션
인앱 액션, 타겟 인앱 액션당비용 설정(선택사항)이 선택 해제되었습니다.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
maximize_conversions(target_cpa_micros 없음) 필수사항. 설치 후 작업 및 선택적 DOWNLOAD 작업
인앱 액션 가치(타겟 ROAS)
인앱 액션 가치, 타겟 광고 투자수익(ROAS) 설정(선택사항)이 선택됨(또는 참여의 경우 타겟 광고 투자수익(ROAS)).
APP_CAMPAIGN 또는 APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
target_roas (target_roas = 타겟 ROAS) 필수사항. 값 작업(예: Firebase 또는 GOOGLE_PLAY_IN_APP_PURCHASE). APP_CAMPAIGN의 선택적 DOWNLOAD만 해당됩니다.
타겟 ROAS가 없는 인앱 액션 가치
인앱 액션 가치, 타겟 광고 투자수익(ROAS) 설정(선택사항)이 선택 해제되었습니다.
APP_CAMPAIGN.
OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
maximize_conversion_value (target_roas 없음). 필수사항. 가치 액션(예: Firebase 또는 GOOGLE_PLAY_IN_APP_PURCHASE) 및 선택적 DOWNLOAD 액션
앱 사전 등록(Android 전용).
사전 등록 (타겟 사전 등록당 비용).
APP_CAMPAIGN_FOR_PRE_REGISTRATION(GOOGLE_APP_STORE만 해당)
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
target_cpa(target_cpa_micros = 타겟 사전 등록당 비용) selective_optimization는 설정하지 않은 상태로 둡니다. APP_PRE_REGISTRATION를 optimization_goal_types에 추가합니다.

단계

음수 임시 ID를 사용하여 하나의 GoogleAdsService.Mutate 요청에서 모든 리소스를 원자적으로 만들거나 CampaignService.MutateCampaigns를 호출합니다.

캠페인 구성 및 만들기

Campaign 리소스를 구성합니다.

  1. campaign_budget에 대해 amount_micros 및 explicitly_shared가 false로 설정된 일일 CampaignBudget을 만듭니다(기본값은 true, 공유 및 CUSTOM_PERIOD 예산은 실패). 캠페인 예산 만들기를 참고하세요.

  2. name를 설정하고, 원하는 경우 광고를 연결하는 동안 status를 PAUSED로 설정합니다(기본값은 ENABLED).

  3. 변경 불가능한 advertising_channel_type을 MULTI_CHANNEL로 설정하고 변경 불가능한 advertising_channel_sub_type을 APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT 또는 APP_CAMPAIGN_FOR_PRE_REGISTRATION로 설정합니다.

  4. contains_eu_political_advertising를 DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING 또는 CONTAINS_EU_POLITICAL_ADVERTISING로 설정합니다. 독립형 MutateCampaigns 호출에는 이 유럽연합(EU) 선언이 필요합니다(v26 이상에서 EU 이외의 위치만 원자적으로 타겟팅하는 경우 선택사항, EU 정치 광고 참고).

  5. app_campaign_setting를 AppCampaignSetting 객체로 설정합니다(app_store 및 app_id는 변경할 수 없음).

    • app_store: AppCampaignAppStore(GOOGLE_APP_STORE 또는 APPLE_APP_STORE, 사전 등록에는 GOOGLE_APP_STORE 필요)
    • app_id: Google Play 패키지 이름(com.example.app) 또는 Apple 앱 스토어 숫자 ID입니다. 참여에는 최소 설치가 필요합니다. 사전 등록에는 출시되지 않은 Play Console 사전 등록 앱이 필요합니다(출시 전까지는 APP_CAMPAIGN에 사용할 수 없음).
    • bidding_strategy_goal_type: 목표의 AppCampaignBiddingStrategyGoalType입니다(변경 가능).
  6. Campaign에 표준 입찰 전략을 설정합니다(포트폴리오 BiddingStrategy 리소스는 지원되지 않음). 선택사항인 UI 타겟을 전환하면 bidding_strategy_goal_type 및 입찰 oneof 필드가 모두 전환됩니다.

    • 타겟 CPI, CPA 또는 사전 등록: 계정 통화 마이크로 단위로 양수 target_cpa_micros를 사용하여 target_cpa를 설정합니다(1500000 = 1.50단위, 예: 미화 1.50달러).
    • 타겟 ROAS: 0.01에서 1000.0까지 target_roas를 사용하여 target_roas를 설정합니다(3.0 = 300% ROAS).
    • 타겟 없이 최대화(APP_CAMPAIGN만 해당): 빈 maximize_conversions 또는 maximize_conversion_value를 설정합니다. maximize_conversions.target_cpa_micros(MULTI_CHANNEL에 거부됨) 또는 maximize_conversion_value.target_roas를 설정하지 마세요.
  7. 전환 또는 사전 등록 목표를 구성합니다.

  8. 선택사항: v24부터 조회 후 전환(VTC) 입찰을 위해 Android APP_CAMPAIGN 캠페인에서 view_through_conversion_optimization_enabled를 true로 설정합니다(UI 기본값 true, API 기본값 false).

  9. 선택사항: 계정의 시간대(yyyy-MM-dd HH:mm:ss)에서 start_date_time(00:00:00, 오늘 또는 이후) 및 end_date_time(23:59:59)를 설정합니다. MutateCampaigns 또는 GoogleAdsService.Mutate를 호출합니다.

선택사항: 캠페인 타겟팅 및 제외 추가

생성 후 또는 동일한 GoogleAdsService.Mutate 요청에서 타겟팅을 미세 조정합니다.

Google Ads UI 설정을 API 필드에 매핑하기

이 표를 사용하여 Google Ads UI 컨트롤을 Google Ads API 필드(앱 설치의 경우 입찰 및 예산, 참여 및 사전 등록의 경우 예산 및 입찰)에 매핑합니다.

Google Ads UI 섹션 및 라벨 API 리소스 및 필드 세부정보
앱 > 캠페인 하위유형 선택(앱 설치, 앱 참여, 앱 사전 등록(Android 전용)) Campaign.advertising_channel_type, Campaign.advertising_channel_sub_type. 변경 불가: APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT 또는 APP_CAMPAIGN_FOR_PRE_REGISTRATION가 있는 MULTI_CHANNEL입니다.
캠페인 설정 > 캠페인 이름 Campaign.name. 고객 계정의 필수 표시 이름입니다.
캠페인 설정 > 모바일 앱 Campaign.app_campaign_setting.app_store, Campaign.app_campaign_setting.app_id. immutable: GOOGLE_APP_STORE(패키지 이름, 사전 등록에 필요) 또는 APPLE_APP_STORE(숫자 ID)
캠페인 설정 > 위치 및 언어 CampaignCriterion (location, language). MutateCampaignCriteria 또는 원자 GoogleAdsService.Mutate로 추가되었습니다.
캠페인 설정 > 조회 후 전환 최적화 > 조회 후 전환 사용 설정 Campaign.view_through_conversion_optimization_enabled. Android APP_CAMPAIGN만 해당(v24 이상) 기본값은 UI에서 true, API에서 false입니다.
캠페인 설정 > EU 정치 광고 (캠페인에 EU 정치 광고가 있나요?) Campaign.contains_eu_political_advertising. 예, 이 캠페인에 EU 정치 광고가 있습니다 및 아니요, 이 캠페인에 EU 정치 광고가 없습니다를 매핑합니다.
캠페인 설정 > 시작일 및 종료일 Campaign.start_date_time, Campaign.end_date_time. 선택사항인 계정 시간대 타임스탬프(00:00:00 오늘 또는 이후, 23:59:59)입니다.
입찰 및 예산 > 예산을 클릭합니다. CampaignBudget.amount_micros, Campaign.campaign_budget. CampaignBudget.explicitly_shared가 false로 설정된 계정 통화의 일일 마이크로입니다.
입찰 및 예산 > 입찰 > 중점을 두고자 하는 부분은 무엇인가요? 및 어떤 유형의 사용자를 타겟팅하시겠습니까?
타겟 설치당비용 설정(선택사항), 타겟 인앱 액션당비용 설정(선택사항), 타겟 광고 투자수익(ROAS) 설정(선택사항)
타겟 설치당비용, 타겟 액션당비용, 타겟 광고 투자수익(ROAS)
Campaign.app_campaign_setting.bidding_strategy_goal_type, Campaign.target_cpa.target_cpa_micros, Campaign.target_roas.target_roas, Campaign.maximize_conversions, Campaign.maximize_conversion_value. 목표 enum과 입찰 oneof 필드를 모두 설정합니다(준비 참고). 비타겟팅 전략은 APP_CAMPAIGN에만 적용됩니다. iOS에서 SKAdNetwork 전환 가치에 맞게 최적화는 UI 전용입니다(CustomerSkAdNetworkConversionValueSchema를 사용하여 스키마 읽기).
입찰 및 예산 > 입찰 > 설치 수를 어떻게 추적하시겠습니까?
어떤 액션이 비즈니스에 가장 중요한가요? 및 어떤 액션이 비즈니스에 가장 중요한가요?
Campaign.selective_optimization.conversion_actions. 설치 선택 도구는 최대 1개의 DOWNLOAD 작업을 추가합니다(APP_CAMPAIGN만 해당). 작업 선택 도구는 app_id과 일치하는 하나(단수) 또는 여러(복수) 작업을 추가합니다.
예산 및 입찰 > 입찰 > 사전 등록 및 타겟 사전 등록당 비용 Campaign.target_cpa.target_cpa_micros, Campaign.optimization_goal_setting.optimization_goal_types. OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME 및 APP_PRE_REGISTRATION를 사용합니다(selective_optimization는 설정하지 않은 상태로 둠).

코드 예시 및 다음 단계

캠페인에서 광고를 게재할 수 있도록 광고 그룹과 광고 애셋을 연결하세요.