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 리소스를 구성합니다.
campaign_budget에 대해amount_micros및explicitly_shared가false로 설정된 일일CampaignBudget을 만듭니다(기본값은true, 공유 및CUSTOM_PERIOD예산은 실패). 캠페인 예산 만들기를 참고하세요.name를 설정하고, 원하는 경우 광고를 연결하는 동안status를PAUSED로 설정합니다(기본값은ENABLED).변경 불가능한
advertising_channel_type을MULTI_CHANNEL로 설정하고 변경 불가능한advertising_channel_sub_type을APP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENT또는APP_CAMPAIGN_FOR_PRE_REGISTRATION로 설정합니다.contains_eu_political_advertising를DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING또는CONTAINS_EU_POLITICAL_ADVERTISING로 설정합니다. 독립형MutateCampaigns호출에는 이 유럽연합(EU) 선언이 필요합니다(v26 이상에서 EU 이외의 위치만 원자적으로 타겟팅하는 경우 선택사항, EU 정치 광고 참고).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입니다(변경 가능).
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를 설정하지 마세요.
- 타겟 CPI, CPA 또는 사전 등록: 계정 통화 마이크로 단위로 양수
전환 또는 사전 등록 목표를 구성합니다.
APP_CAMPAIGN및APP_CAMPAIGN_FOR_ENGAGEMENT:app_id와 일치하는ConversionAction리소스 이름을selective_optimization.conversion_actions에 추가합니다(CampaignConversionGoal또는optimization_goal_setting가 아님, 캠페인 전환 목표 참고).APP_CAMPAIGN에서GOOGLE_PLAY_DOWNLOAD또는 Firebasefirst_open와 같은DOWNLOAD작업을 최대 1개 포함합니다(UI 필수, API 선택사항, 참여 시 금지됨).APP_CAMPAIGN_FOR_PRE_REGISTRATION:selective_optimization를 설정하지 않은 상태로 두고APP_PRE_REGISTRATION를optimization_goal_setting.optimization_goal_types에 추가합니다.
선택사항: v24부터 조회 후 전환(VTC) 입찰을 위해 Android
APP_CAMPAIGN캠페인에서view_through_conversion_optimization_enabled를true로 설정합니다(UI 기본값true, API 기본값false).선택사항: 계정의 시간대(
yyyy-MM-dd HH:mm:ss)에서start_date_time(00:00:00, 오늘 또는 이후) 및end_date_time(23:59:59)를 설정합니다.MutateCampaigns또는GoogleAdsService.Mutate를 호출합니다.
선택사항: 캠페인 타겟팅 및 제외 추가
생성 후 또는 동일한 GoogleAdsService.Mutate 요청에서 타겟팅을 미세 조정합니다.
- 위치 및 언어:
CampaignCriterionService.MutateCampaignCriteria를 사용하여CampaignCriterion리소스를 추가합니다(예:language및location기준)(기준 참고). - 제외 키워드 목록:
CampaignSharedSet를NEGATIVE_KEYWORDSSharedSet에 연결합니다(공유 조합 참고). - 잠재고객: 광고 그룹에 필수
UserListInfo기준(APP_CAMPAIGN_FOR_ENGAGEMENT) 또는 선택적AudienceInfo신호(APP_CAMPAIGN)를 연결합니다(앱 광고 그룹 및 광고 만들기 참고).
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는 설정하지 않은 상태로 둠).
|
코드 예시 및 다음 단계
캠페인에서 광고를 게재할 수 있도록 광고 그룹과 광고 애셋을 연결하세요.
- 앱 광고그룹 및 광고 만들기:
AdGroup리소스(APP_CAMPAIGN_FOR_ENGAGEMENT에 필수UserListInfo기준 포함)와 앱 광고를 추가합니다. - 앱 캠페인 코드 예: 예산, 캠페인, 기준, 광고 그룹, 광고를 만드는 다국어
AddAppCampaign샘플을 검사합니다. - 앱 캠페인 보고: Google Ads Query Language를 사용하여 캠페인, 확장 소재, 설치, SKAdNetwork 측정항목을 쿼리합니다.