Google Ads API を使用してアプリ キャンペーンを作成すると、Google 検索、Google Play、YouTube、AdMob、Discover、Google ディスプレイ ネットワークでモバイルアプリを宣伝できます。インストール、アプリ内コンバージョン、コンバージョン値、Android の事前登録を重視してキャンペーンを最適化します。有効なキャンペーンでは、予算を上限として、標準の Google 広告の広告配信料金が発生します。
準備
API の設定は、キャンペーンの目標(インストール単価(CPI)、アクション単価(CPA)、広告費用対効果(ROAS)、事前登録)によって決まります。作成手順を完了する前に、次の表で目標を確認してください。Google 広告の UI コントロールを検索するには、Google 広告の UI 設定を API フィールドにマッピングする、またはアプリ キャンペーンについてをご覧ください。
| 目標と Google 広告の管理画面の選択 | サブタイプと目標の列挙型 | 入札戦略 | コンバージョンの設定(conversion_actions) |
|---|---|---|---|
|
インストール数の増加(目標インストール単価)。 [インストール数] > [すべてのユーザー]、 [目標インストール単価を設定(任意)] を選択。 |
APP_CAMPAIGN。OPTIMIZE_INSTALLS_TARGET_INSTALL_COST。
|
target_cpa
(target_cpa_micros
= 目標 CPI)。
|
省略可。conversion_actions に最大 1 つの DOWNLOAD アクション。 |
|
目標 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 コンバージョン。
|
|
アプリ内コンバージョン(目標アクション単価) [アプリ内コンバージョン]、[目標アプリ内アクション単価を設定(任意)] を選択(またはエンゲージメントの [目標アクション単価] を選択)。 |
APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT。OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST。
|
target_cpa(target_cpa_micros = 目標アクション単価)。
|
必須。インストール後のアクション。省略可。DOWNLOAD(APP_CAMPAIGN の場合。エンゲージメントの場合はなし)。 |
|
目標アクション単価を設定しないアプリ内コンバージョン。 [アプリ内コンバージョン]、 [目標アプリ内アクション単価を設定(任意)] をオフにします。 |
APP_CAMPAIGN。OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA。
|
maximize_conversions(target_cpa_micros なし)。 |
必須。インストール後のアクションと、オプションの DOWNLOAD アクション。
|
|
アプリ内コンバージョンの価値(目標広告費用対効果) [アプリ内コンバージョンの価値]、[目標広告費用対効果を設定する(任意)] を選択(またはエンゲージメントの [目標広告費用対効果])。 |
APP_CAMPAIGN または APP_CAMPAIGN_FOR_ENGAGEMENT。OPTIMIZE_RETURN_ON_ADVERTISING_SPEND。
|
target_roas
(target_roas
= 目標広告費用対効果)。
|
必須。値アクション(Firebase や GOOGLE_PLAY_IN_APP_PURCHASE など)。APP_CAMPAIGN のオプションの DOWNLOAD のみ。
|
|
アプリ内コンバージョンの価値(目標広告費用対効果なし) アプリ内コンバージョンの価値、 目標広告費用対効果を設定する(省略可)をオフにします。 |
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 を使用して、1 つの GoogleAdsService.Mutate リクエストですべてのリソースをアトミックに作成するか、CampaignService.MutateCampaigns を呼び出します。
キャンペーンを設定して作成する
Campaign リソースを構成します。
campaign_budgetの 1 日のCampaignBudgetを作成します。amount_microsとexplicitly_sharedはfalseに設定します(デフォルトは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。エンゲージメントには最小インストール数が必要です。事前登録には、未リリースの Google Play Console 事前登録アプリが必要です(リリースまでAPP_CAMPAIGNの対象外)。bidding_strategy_goal_type: 目標のAppCampaignBiddingStrategyGoalType(変更可能)。
Campaignに標準入札戦略を設定します(ポートフォリオBiddingStrategyリソースはサポートされていません)。オプションの UI 目標を切り替えると、bidding_strategy_goal_typeと入札のoneofフィールドの両方が切り替わります。- 目標 CPI、目標 CPA、事前登録:
target_cpaを、アカウントの通貨のマイクロ単位で正のtarget_cpa_microsに設定します(1500000= 1.50 単位(1.50 米ドルなど))。 - 目標広告費用対効果:
0.01から1000.0までのtarget_roasを使用してtarget_roasを設定します(3.0= 広告費用対効果 300%)。 - 目標値を設定せずに最大化(
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 広告の管理画面の設定を API フィールドにマッピングする
この表を使用して、Google 広告 UI コントロールを Google Ads API フィールドにマッピングします(アプリ インストールの場合は入札単価と予算、エンゲージメントと事前登録の場合は予算と入札単価)。
| Google 広告 UI のセクションとラベル | API リソースとフィールド | 詳細 |
|---|---|---|
| [アプリ] > [キャンペーンのサブタイプの選択]([アプリ インストール]、[アプリ エンゲージメント]、[アプリの事前登録(Android のみ)])。 |
Campaign.advertising_channel_type、Campaign.advertising_channel_sub_type。 |
変更不可: MULTI_CHANNEL(APP_CAMPAIGN、APP_CAMPAIGN_FOR_ENGAGEMENT、APP_CAMPAIGN_FOR_PRE_REGISTRATION)。 |
| [キャンペーン設定] > [キャンペーン名] |
Campaign.name。
|
お客様のアカウントの必須の表示名。 |
| [キャンペーン設定] > [モバイルアプリ] |
Campaign.app_campaign_setting.app_store、Campaign.app_campaign_setting.app_id。 |
不変: 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。 |
アカウントの通貨での 1 日あたりのマイクロ単位。CampaignBudget.explicitly_shared は false に設定されています。 |
|
[入札単価と予算] > [入札単価] > [重視している要素]、[どのようなユーザーをターゲットに設定しますか?] [目標インストール単価を設定する(省略可)]、 [目標アプリ内アクション単価を設定(任意)]、 [目標広告費用対効果を設定(任意)]。 目標インストール単価、目標アクション単価、目標広告費用対効果。 |
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。
|
目標列挙型と入札 oneof フィールドの両方を設定します(準備を参照)。ターゲット以外の戦略は APP_CAMPAIGN にのみ適用されます。iOS では、SKAdNetwork のコンバージョン値を重視して最適化するは UI のみです(CustomerSkAdNetworkConversionValueSchema を使用してスキーマを読み取ります)。
|
|
[入札単価と予算] > [入札] > [インストール数をどのようにトラッキングしますか?] 最も重要なアクションはどれですか?、最も重要なアクションはどれですか? |
Campaign.selective_optimization.conversion_actions。
|
インストール選択ツールは、最大 1 つの DOWNLOAD アクションを追加します(APP_CAMPAIGN のみ)。アクション選択ツールは、app_id に一致する 1 つ(単数)または複数(複数)のアクションを追加します。 |
| [予算と入札単価] > [入札単価] > [事前登録]、[目標事前登録単価] |
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 広告クエリ言語を使用して、キャンペーン、アセット、インストール、SKAdNetwork の指標をクエリします。