アプリ キャンペーンを作成する

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 リソースを構成します。

  1. campaign_budget の 1 日の CampaignBudget を作成します。amount_micros と explicitly_shared は false に設定します(デフォルトは 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。エンゲージメントには最小インストール数が必要です。事前登録には、未リリースの Google Play Console 事前登録アプリが必要です(リリースまで APP_CAMPAIGN の対象外)。
    • bidding_strategy_goal_type: 目標の AppCampaignBiddingStrategyGoalType(変更可能)。
  6. 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 を設定しないでください。
  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 広告の管理画面の設定を 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 は設定しないままにします)。

コード例と次のステップ

キャンペーンで広告を配信できるように、広告グループとクリエイティブ アセットを関連付けます。