Membuat kampanye Aplikasi

Buat kampanye Aplikasi dengan Google Ads API untuk mempromosikan aplikasi seluler Anda di Penelusuran, Google Play, YouTube, AdMob, Discover, dan Jaringan Display Google. Optimalkan kampanye untuk penginstalan, tindakan dalam aplikasi, nilai konversi, atau prapendaftaran Android. Kampanye yang diaktifkan akan dikenai biaya penayangan iklan Google Ads standar hingga anggaran Anda.

Persiapan

Sasaran kampanye Anda—biaya per instal (CPI), biaya per tindakan (CPA), laba atas belanja iklan (ROAS), atau prapendaftaran—menentukan setelan API Anda. Temukan sasaran Anda di tabel berikut sebelum menyelesaikan langkah-langkah pembuatan. Untuk mencari kontrol UI Google Ads, lihat Memetakan setelan UI Google Ads ke kolom API, atau lihat Tentang kampanye Aplikasi.

Pemilihan sasaran dan UI Google Ads Enum subjenis dan sasaran Strategi bidding Setelan konversi (conversion_actions)
Lebih banyak penginstalan (target CPI).
Volume penginstalan > Semua pengguna, Tetapkan target biaya-per-instal (opsional) dipilih.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = target CPI). Opsional. Maksimal satu tindakan DOWNLOAD di conversion_actions.
Lebih banyak penginstalan tanpa target CPI.
Volume penginstalan > Semua pengguna, Tetapkan target biaya per penginstalan (opsional) tidak dicentang.
APP_CAMPAIGN.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
maximize_conversions (tanpa target_cpa_micros). Opsional. Maksimal satu tindakan DOWNLOAD.
Penginstalan dengan tindakan dalam aplikasi (target CPI).
Volume instal > Pengguna yang cenderung melakukan tindakan dalam aplikasi, Target biaya per instal.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
target_cpa (target_cpa_micros = target CPI). Wajib. Satu tindakan dalam aplikasi, plus tindakan DOWNLOAD opsional.
Tindakan dalam aplikasi (target CPA).
Tindakan dalam aplikasi, Tetapkan target biaya per tindakan dalam aplikasi (opsional) dipilih (atau Target biaya per tindakan untuk engagement).
APP_CAMPAIGN atau APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
target_cpa (target_cpa_micros = target CPA). Wajib. Tindakan pasca-penginstalan. Opsional DOWNLOAD di APP_CAMPAIGN (tidak ada di engagement).
Tindakan dalam aplikasi tanpa target CPA.
Tindakan dalam aplikasi, Tetapkan target biaya per tindakan dalam aplikasi (opsional) tidak dicentang.
APP_CAMPAIGN.
OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
maximize_conversions (tidak ada target_cpa_micros). Wajib. Tindakan pasca-penginstalan, ditambah tindakan DOWNLOAD opsional.
Nilai tindakan dalam aplikasi (target ROAS).
Nilai tindakan dalam aplikasi, Tetapkan target laba atas belanja iklan (opsional) dipilih (atau Target laba atas belanja iklan untuk engagement).
APP_CAMPAIGN atau APP_CAMPAIGN_FOR_ENGAGEMENT.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
target_roas (target_roas = target ROAS). Wajib. Tindakan nilai (seperti Firebase atau GOOGLE_PLAY_IN_APP_PURCHASE). DOWNLOAD opsional hanya di APP_CAMPAIGN.
Nilai tindakan dalam aplikasi tanpa target ROAS.
Nilai tindakan dalam aplikasi, Tetapkan target laba atas belanja iklan (opsional) tidak dicentang.
APP_CAMPAIGN.
OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
maximize_conversion_value (tanpa target_roas). Wajib. Tindakan nilai (seperti Firebase atau GOOGLE_PLAY_IN_APP_PURCHASE), plus tindakan DOWNLOAD opsional.
Prapendaftaran aplikasi (khusus Android).
Prapendaftaran (Target biaya per prapendaftaran).
APP_CAMPAIGN_FOR_PRE_REGISTRATION (khusus GOOGLE_APP_STORE).
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
target_cpa (target_cpa_micros = target biaya per prapendaftaran). Membiarkan selective_optimization tidak disetel. Tambahkan APP_PRE_REGISTRATION ke optimization_goal_types.

Langkah

Buat semua resource secara atomik dalam satu permintaan GoogleAdsService.Mutate menggunakan ID sementara negatif, atau panggil CampaignService.MutateCampaigns.

Mengonfigurasi dan membuat kampanye

Konfigurasikan resource Campaign:

  1. Buat CampaignBudget harian untuk campaign_budget dengan amount_micros dan explicitly_shared ditetapkan ke false (defaultnya adalah true; anggaran bersama dan CUSTOM_PERIOD gagal). Lihat Membuat anggaran kampanye.

  2. Tetapkan name, dan tetapkan status ke PAUSED secara opsional saat melampirkan iklan (defaultnya adalah ENABLED).

  3. Tetapkan advertising_channel_type yang tidak dapat diubah ke MULTI_CHANNEL dan advertising_channel_sub_type yang tidak dapat diubah ke APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT, atau APP_CAMPAIGN_FOR_PRE_REGISTRATION.

  4. Tetapkan contains_eu_political_advertising ke DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING atau CONTAINS_EU_POLITICAL_ADVERTISING. Panggilan MutateCampaigns mandiri memerlukan pernyataan Uni Eropa (EU) ini (opsional di v26 dan yang lebih baru saat menargetkan hanya lokasi non-EU secara atomik; lihat Iklan politik Uni Eropa).

  5. Tetapkan app_campaign_setting ke objek AppCampaignSetting (app_store dan app_id tidak dapat diubah):

    • app_store: AppCampaignAppStore (GOOGLE_APP_STORE atau APPLE_APP_STORE; prapendaftaran memerlukan GOOGLE_APP_STORE).
    • app_id: Nama paket Google Play (com.example.app) atau ID numerik Apple App Store. Engagement memerlukan penginstalan minimum; prapendaftaran memerlukan aplikasi prapendaftaran Konsol Play yang belum dirilis (tidak memenuhi syarat untuk APP_CAMPAIGN hingga peluncuran).
    • bidding_strategy_goal_type: AppCampaignBiddingStrategyGoalType untuk sasaran Anda (dapat diubah).
  6. Tetapkan strategi bidding standar di Campaign (resource BiddingStrategy portofolio tidak didukung). Mengaktifkan target UI opsional akan mengalihkan bidding_strategy_goal_type dan kolom oneof bidding:

    • Target CPI, CPA, atau prapendaftaran: Tetapkan target_cpa dengan target_cpa_micros positif dalam mikro mata uang akun (1500000 = 1,50 unit, seperti $1,50 USD).
    • Target ROAS: Tetapkan target_roas dengan target_roas dari 0.01 ke 1000.0 (3.0 = ROAS 300%).
    • Maksimalkan tanpa target (khusus APP_CAMPAIGN): Tetapkan kosong maximize_conversions atau maximize_conversion_value. Jangan tetapkan maximize_conversions.target_cpa_micros (ditolak di MULTI_CHANNEL) atau maximize_conversion_value.target_roas.
  7. Konfigurasikan sasaran konversi atau prapendaftaran:

  8. Opsional: Mulai v24, tetapkan view_through_conversion_optimization_enabled ke true di kampanye APP_CAMPAIGN Android untuk bidding konversi lihat-tayang (VTC) (default UI true, default API false).

  9. Opsional: Tetapkan start_date_time (00:00:00, hari ini atau nanti) dan end_date_time (23:59:59) di zona waktu akun (yyyy-MM-dd HH:mm:ss). Panggil MutateCampaigns atau GoogleAdsService.Mutate.

Opsional: Tambahkan penargetan dan pengecualian kampanye

Saring penargetan setelah pembuatan atau dalam permintaan GoogleAdsService.Mutate yang sama:

Memetakan setelan UI Google Ads ke kolom API

Gunakan tabel ini untuk memetakan kontrol UI Google Ads ke kolom Google Ads API (Bidding dan anggaran untuk penginstalan Aplikasi, atau Anggaran dan bidding untuk engagement dan prapendaftaran).

Bagian dan label UI Google Ads Resource dan kolom API Detail
Aplikasi > Pilih subjenis kampanye (Penginstalan aplikasi, Engagement aplikasi, Prapendaftaran aplikasi (khusus Android)). Campaign.advertising_channel_type, Campaign.advertising_channel_sub_type. Immutable: MULTI_CHANNEL dengan APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT, atau APP_CAMPAIGN_FOR_PRE_REGISTRATION.
Setelan kampanye > Nama kampanye. Campaign.name. Nama tampilan yang wajib diisi di akun pelanggan.
Setelan kampanye > Aplikasi seluler. Campaign.app_campaign_setting.app_store, Campaign.app_campaign_setting.app_id. Tidak dapat diubah: GOOGLE_APP_STORE (nama paket; diperlukan untuk prapendaftaran) atau APPLE_APP_STORE (ID numerik).
Setelan kampanye > Lokasi dan Bahasa. CampaignCriterion (location, language). Ditambahkan dengan MutateCampaignCriteria atau GoogleAdsService.Mutate atomik.
Setelan kampanye > Pengoptimalan konversi lihat-tayang > Aktifkan konversi lihat-tayang. Campaign.view_through_conversion_optimization_enabled. Khusus Android APP_CAMPAIGN (v24 dan yang lebih baru). Nilai defaultnya adalah true di UI dan false di API.
Setelan kampanye > Iklan politik Uni Eropa (Apakah kampanye Anda memiliki iklan politik Uni Eropa?). Campaign.contains_eu_political_advertising. Memetakan Ya, kampanye ini memiliki iklan politik Uni Eropa dan Tidak, kampanye ini tidak memiliki iklan politik Uni Eropa.
Setelan kampanye > Tanggal mulai dan akhir. Campaign.start_date_time, Campaign.end_date_time. Stempel waktu zona waktu akun opsional (00:00:00 hari ini atau nanti, dan 23:59:59).
Bidding dan anggaran > Anggaran. CampaignBudget.amount_micros, Campaign.campaign_budget. Mikro harian dalam mata uang akun dengan CampaignBudget.explicitly_shared ditetapkan ke false.
Bidding dan anggaran > Bidding > Apa yang ingin Anda fokuskan? dan Apa jenis pengguna yang ingin Anda target?
Tetapkan target biaya per instal (opsional), Tetapkan target biaya per tindakan dalam aplikasi (opsional), dan Tetapkan target laba atas belanja iklan (opsional).
Target biaya per instal, Target biaya per tindakan, dan Target laba atas belanja iklan.
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. Menetapkan enum sasaran dan kolom oneof bidding (lihat Persiapan). Strategi non-target hanya berlaku untuk APP_CAMPAIGN. Di iOS, Optimalkan untuk nilai konversi SKAdNetwork hanya tersedia di UI (baca skema dengan CustomerSkAdNetworkConversionValueSchema).
Bidding dan anggaran > Bidding > Bagaimana Anda ingin melacak volume penginstalan?
Tindakan apa yang paling penting bagi Anda? dan Tindakan mana yang paling penting bagi Anda?
Campaign.selective_optimization.conversion_actions. Pemilih penginstalan menambahkan hingga satu tindakan DOWNLOAD (khusus APP_CAMPAIGN). Pemilih tindakan menambahkan satu (tunggal) atau beberapa (jamak) tindakan yang cocok dengan app_id.
Anggaran dan bidding > Bidding > Prapendaftaran dan Target biaya per prapendaftaran. Campaign.target_cpa.target_cpa_micros, Campaign.optimization_goal_setting.optimization_goal_types. Menggunakan OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME dan APP_PRE_REGISTRATION (biarkan selective_optimization tidak disetel).

Contoh kode dan langkah berikutnya

Lampirkan grup iklan dan aset materi iklan agar kampanye Anda dapat menayangkan iklan: