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:
Buat
CampaignBudgetharian untukcampaign_budgetdenganamount_microsdanexplicitly_sharedditetapkan kefalse(defaultnya adalahtrue; anggaran bersama danCUSTOM_PERIODgagal). Lihat Membuat anggaran kampanye.Tetapkan
name, dan tetapkanstatuskePAUSEDsecara opsional saat melampirkan iklan (defaultnya adalahENABLED).Tetapkan
advertising_channel_typeyang tidak dapat diubah keMULTI_CHANNELdanadvertising_channel_sub_typeyang tidak dapat diubah keAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENT, atauAPP_CAMPAIGN_FOR_PRE_REGISTRATION.Tetapkan
contains_eu_political_advertisingkeDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGatauCONTAINS_EU_POLITICAL_ADVERTISING. PanggilanMutateCampaignsmandiri 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).Tetapkan
app_campaign_settingke objekAppCampaignSetting(app_storedanapp_idtidak dapat diubah):app_store:AppCampaignAppStore(GOOGLE_APP_STOREatauAPPLE_APP_STORE; prapendaftaran memerlukanGOOGLE_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 untukAPP_CAMPAIGNhingga peluncuran).bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypeuntuk sasaran Anda (dapat diubah).
Tetapkan strategi bidding standar di
Campaign(resourceBiddingStrategyportofolio tidak didukung). Mengaktifkan target UI opsional akan mengalihkanbidding_strategy_goal_typedan kolomoneofbidding:- Target CPI, CPA, atau prapendaftaran: Tetapkan
target_cpadengantarget_cpa_microspositif dalam mikro mata uang akun (1500000= 1,50 unit, seperti $1,50 USD). - Target ROAS: Tetapkan
target_roasdengantarget_roasdari0.01ke1000.0(3.0= ROAS 300%). - Maksimalkan tanpa target (khusus
APP_CAMPAIGN): Tetapkan kosongmaximize_conversionsataumaximize_conversion_value. Jangan tetapkanmaximize_conversions.target_cpa_micros(ditolak diMULTI_CHANNEL) ataumaximize_conversion_value.target_roas.
- Target CPI, CPA, atau prapendaftaran: Tetapkan
Konfigurasikan sasaran konversi atau prapendaftaran:
APP_CAMPAIGNdanAPP_CAMPAIGN_FOR_ENGAGEMENT: Tambahkan nama resourceConversionActionyang cocok denganapp_idkeselective_optimization.conversion_actions(bukanCampaignConversionGoalatauoptimization_goal_setting; lihat Sasaran konversi kampanye). DiAPP_CAMPAIGN, sertakan hingga satu tindakanDOWNLOAD, sepertiGOOGLE_PLAY_DOWNLOADataufirst_openFirebase (diperlukan UI, opsional API, dilarang dalam engagement).APP_CAMPAIGN_FOR_PRE_REGISTRATION: Biarkanselective_optimizationtidak ditetapkan, dan tambahkanAPP_PRE_REGISTRATIONkeoptimization_goal_setting.optimization_goal_types.
Opsional: Mulai v24, tetapkan
view_through_conversion_optimization_enabledketruedi kampanyeAPP_CAMPAIGNAndroid untuk bidding konversi lihat-tayang (VTC) (default UItrue, default APIfalse).Opsional: Tetapkan
start_date_time(00:00:00, hari ini atau nanti) danend_date_time(23:59:59) di zona waktu akun (yyyy-MM-dd HH:mm:ss). PanggilMutateCampaignsatauGoogleAdsService.Mutate.
Opsional: Tambahkan penargetan dan pengecualian kampanye
Saring penargetan setelah pembuatan atau dalam permintaan GoogleAdsService.Mutate yang sama:
- Lokasi dan bahasa: Tambahkan
resource
CampaignCriteriondenganCampaignCriterionService.MutateCampaignCriteria, seperti kriterialanguagedanlocation(lihat Kriteria). - Daftar kata kunci negatif: Menautkan
CampaignSharedSetkeNEGATIVE_KEYWORDSSharedSet(lihat Kumpulan bersama). - Audiens: Lampirkan kriteria
UserListInfoyang diperlukan (APP_CAMPAIGN_FOR_ENGAGEMENT) atau sinyalAudienceInfoopsional (APP_CAMPAIGN) di grup iklan aplikasi (lihat Membuat grup iklan dan iklan Aplikasi).
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:
- Membuat grup iklan aplikasi dan iklan Aplikasi: Tambahkan resource
AdGroup(dengan kriteriaUserListInfoyang diperlukan diAPP_CAMPAIGN_FOR_ENGAGEMENT) dan iklan Aplikasi. - Contoh kode kampanye Aplikasi: Periksa contoh
AddAppCampaignmultibahasa yang membuat anggaran, kampanye, kriteria, grup iklan, dan iklan. - Pelaporan kampanye Aplikasi: Buat kueri metrik kampanye, aset, penginstalan, dan SKAdNetwork dengan Bahasa Kueri Google Ads.