Mobil uygulamanızı Arama, Google Play, YouTube, AdMob, Keşfet ve Google Görüntülü Reklam Ağı'nda tanıtmak için Google Ads API ile uygulama kampanyaları oluşturun. Kampanyaları yüklemeler, uygulama içi işlemler, dönüşüm değeri veya Android ön kayıtları için optimize edin. Etkinleştirilen kampanyalar, bütçenize kadar standart Google Ads reklam sunma ücretlerine tabidir.
Hazırlık
API ayarlarınızı kampanya hedefiniz [yükleme başına maliyet (YBM), işlem başına maliyet (EBM), reklam harcamalarından elde edilen gelir (ROAS) veya ön kayıtlar] belirler. Oluşturma adımlarını tamamlamadan önce aşağıdaki tabloda hedefinizi bulun. Bir Google Ads kullanıcı arayüzü kontrolünü aramak için Google Ads kullanıcı arayüzü ayarlarını API alanlarıyla eşleme veya Uygulama kampanyaları hakkında başlıklı makaleyi inceleyin.
| Hedef ve Google Ads kullanıcı arayüzü seçimi | Alt tür ve hedef enum değeri | Teklif stratejisi | Dönüşüm ayarları (conversion_actions) |
|---|---|---|---|
|
Daha fazla yükleme (hedef YBM). Yükleme hacmi > Tüm kullanıcılar, Yükleme başına maliyet hedefi belirleyin (isteğe bağlı) seçili. |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_TARGET_INSTALL_COST.
|
target_cpa
(target_cpa_micros
= hedef YBM).
|
İsteğe bağlı. conversion_actions içinde en fazla bir DOWNLOAD işlemi.
|
|
Hedef YBM olmadan daha fazla yükleme. Yükleme hacmi > Tüm kullanıcılar, Yükleme başına maliyet hedefi belirleyin (isteğe bağlı) seçeneği işaretlenmemiş. |
APP_CAMPAIGN.OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST.
|
maximize_conversions
(target_cpa_micros yok).
|
İsteğe bağlı. En fazla bir DOWNLOAD işlemi.
|
|
Uygulama içi işlemle yüklemeler (hedef YBM). Yükleme hacmi > Uygulama içi işlem gerçekleştirme olasılığı yüksek kullanıcılar, Yükleme başına maliyet hedefi. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST.
|
target_cpa (target_cpa_micros = hedef YBM).
|
Zorunlu. Bir uygulama içi işlem ve isteğe bağlı DOWNLOAD işlemi.
|
|
Uygulama içi işlemler (hedef EBM). Uygulama içi işlemler, Uygulama içi işlem başına maliyet hedefi belirleyin (isteğe bağlı) seçili (veya etkileşim için İşlem başına maliyet hedefi). |
APP_CAMPAIGN veya
APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST.
|
target_cpa (target_cpa_micros = hedef EBM).
|
Zorunlu. Yükleme sonrası işlemler. İsteğe bağlı
DOWNLOAD, APP_CAMPAIGN (etkileşimde
yok).
|
|
Hedef EBM olmadan uygulama içi işlemler. Uygulama içi işlemler, Uygulama içi işlem başına maliyet hedefi belirleyin (isteğe bağlı) seçeneğinin işareti kaldırıldı. |
APP_CAMPAIGN.OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA.
|
maximize_conversions (target_cpa_micros yok).
|
Zorunlu. Yükleme sonrası işlemler ve isteğe bağlı DOWNLOAD işlemi.
|
|
Uygulama içi işlem değeri (hedef ROAS). Uygulama içi işlem değeri, Reklam harcamalarından elde edilen gelir hedefi belirleyin (isteğe bağlı) seçili (veya etkileşim için Reklam harcamalarından elde edilen gelir hedefi). |
APP_CAMPAIGN veya
APP_CAMPAIGN_FOR_ENGAGEMENT.OPTIMIZE_RETURN_ON_ADVERTISING_SPEND.
|
target_roas
(target_roas
= hedef ROAS).
|
Zorunlu. Değer işlemleri (Firebase veya GOOGLE_PLAY_IN_APP_PURCHASE gibi). Yalnızca APP_CAMPAIGN üzerinde isteğe bağlı DOWNLOAD.
|
|
Hedef ROAS olmadan uygulama içi işlem değeri Uygulama içi işlem değeri, Reklam harcamalarından elde edilen gelir hedefi belirleyin (isteğe bağlı) seçeneği işaretlenmedi. |
APP_CAMPAIGN.OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS.
|
maximize_conversion_value
(target_roas yok).
|
Zorunlu. Değer işlemleri (ör. Firebase veya GOOGLE_PLAY_IN_APP_PURCHASE) ve isteğe bağlı DOWNLOAD işlemi.
|
|
Uygulama ön kayıtları (yalnızca Android). Ön kayıt (Ön kayıt başına maliyet hedefi). |
APP_CAMPAIGN_FOR_PRE_REGISTRATION
(yalnızca GOOGLE_APP_STORE).OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME.
|
target_cpa (target_cpa_micros = ön kayıt başına maliyet hedefi).
|
selective_optimization ayarını boş bırakın. APP_PRE_REGISTRATION öğesini optimization_goal_types öğesine ekleyin.
|
Adımlar
Negatif geçici ID'ler kullanarak tüm kaynakları tek bir GoogleAdsService.Mutate isteğinde atomik olarak oluşturun veya CampaignService.MutateCampaigns yöntemini çağırın.
Kampanyayı yapılandırma ve oluşturma
Campaign kaynağını yapılandırın:
campaign_budgetiçinamount_microsvefalseolarak ayarlanmışexplicitly_sharedile günlükCampaignBudgetoluşturun (varsayılan olaraktrue; paylaşılan veCUSTOM_PERIODbütçeler başarısız olur). Kampanya bütçeleri oluşturma başlıklı makaleyi inceleyin.Reklam eklerken
namedeğerini ayarlayın ve isteğe bağlı olarakstatusdeğeriniPAUSEDolarak ayarlayın (varsayılan değerENABLED).Değiştirilemez
advertising_channel_typedeğeriniMULTI_CHANNEL, değiştirilemezadvertising_channel_sub_typedeğerini iseAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENTveyaAPP_CAMPAIGN_FOR_PRE_REGISTRATIONolarak ayarlayın.contains_eu_political_advertisingdeğeriniDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGveyaCONTAINS_EU_POLITICAL_ADVERTISINGolarak ayarlayın. BağımsızMutateCampaignsçağrıları için bu Avrupa Birliği (AB) beyanı gereklidir (yalnızca AB dışı konumları atomik olarak hedeflerken v26 ve sonraki sürümlerde isteğe bağlıdır; AB siyasi reklamları bölümüne bakın).app_campaign_settingdeğerini birAppCampaignSettingnesnesine ayarlayın (app_storeveapp_idsabittir):app_store:AppCampaignAppStore(GOOGLE_APP_STOREveyaAPPLE_APP_STORE; ön kayıt içinGOOGLE_APP_STOREgerekir).app_id: Google Play paket adı (com.example.app) veya Apple uygulama mağazası sayısal kimliği. Etkileşim için minimum yükleme sayısı gerekir. Ön kayıt için yayınlanmamış bir Google Play Console ön kayıt uygulaması gerekir (lansmana kadarAPP_CAMPAIGNiçin uygun değildir).bidding_strategy_goal_type: Hedefiniz içinAppCampaignBiddingStrategyGoalType(değiştirilebilir).
Campaigniçin standart bir teklif stratejisi belirleyin (portföyBiddingStrategykaynakları desteklenmez). İsteğe bağlı bir kullanıcı arayüzü hedefini açıp kapatmak hembidding_strategy_goal_typehem de teklifoneofalanını değiştirir:- Hedef YBM, EBM veya ön kayıt: Hesap para birimi mikrosu cinsinden pozitif
target_cpa_microsiletarget_cpadeğerini ayarlayın (1500000= 1,50 birim, örneğin 1,50 ABD doları). - Hedef ROAS:
0.01içintarget_roasiletarget_roasdeğerini1000.0(3.0= %300 ROAS) olarak ayarlayın. - Hedef olmadan artırma (yalnızca
APP_CAMPAIGN): Boş bırakınmaximize_conversionsveyamaximize_conversion_value.maximize_conversions.target_cpa_micros(MULTI_CHANNELtarihinde reddedildi) veyamaximize_conversion_value.target_roasdeğerini ayarlamayın.
- Hedef YBM, EBM veya ön kayıt: Hesap para birimi mikrosu cinsinden pozitif
Dönüşüm veya ön kayıt hedeflerini yapılandırma:
APP_CAMPAIGNveAPP_CAMPAIGN_FOR_ENGAGEMENT:app_idile eşleşenConversionActionkaynak adlarınıselective_optimization.conversion_actionsöğesine ekleyin (CampaignConversionGoalveyaoptimization_goal_settingöğesine değil; Kampanya dönüşüm hedefleri bölümüne bakın).APP_CAMPAIGNtarihinde,DOWNLOADişlemi gibi en fazla birGOOGLE_PLAY_DOWNLOADveya Firebasefirst_openişlemi ekleyin (Kullanıcı arayüzü için zorunlu, API için isteğe bağlı, etkileşimde yasak).APP_CAMPAIGN_FOR_PRE_REGISTRATION:selective_optimizationdeğerini ayarlamadan bırakın veAPP_PRE_REGISTRATIONdeğerinioptimization_goal_setting.optimization_goal_typesöğesine ekleyin.
İsteğe bağlı: v24'ten itibaren, görüntüleme dönüşümü (GD) teklifi için Android
APP_CAMPAIGNkampanyalarındaview_through_conversion_optimization_enableddeğerinitrueolarak ayarlayın (Kullanıcı arayüzü varsayılanıtrue, API varsayılanıfalse).İsteğe bağlı: Hesabın saat diliminde (
yyyy-MM-dd HH:mm:ss)start_date_time(00:00:00, bugün veya daha sonra) veend_date_time(23:59:59) ayarlayın.MutateCampaignsveyaGoogleAdsService.Mutateyöntemini çağırın.
İsteğe bağlı: Kampanya hedeflemesi ve hariç tutmalar ekleme
Oluşturduktan sonra veya aynı GoogleAdsService.Mutate isteğinde hedeflemeyi hassaslaştırın:
- Konumlar ve diller:
CampaignCriterionService.MutateCampaignCriteriaiçerenCampaignCriterionkaynakları ekleyin (ör.languagevelocationölçütleri; Ölçütler bölümüne bakın). - Negatif anahtar kelime listeleri: Bir
CampaignSharedSetöğesini birNEGATIVE_KEYWORDSSharedSetöğesine bağlayın (Paylaşılan kümeler bölümüne bakın). - Kitleler: Reklam gruplarına gerekli
UserListInfoölçütlerini (APP_CAMPAIGN_FOR_ENGAGEMENT) veya isteğe bağlıAudienceInfosinyallerini (APP_CAMPAIGN) ekleyin (Uygulama reklam grubu ve reklam oluşturma bölümüne bakın).
Google Ads kullanıcı arayüzü ayarlarını API alanlarıyla eşleme
Google Ads kullanıcı arayüzü kontrollerini Google Ads API alanlarıyla eşlemek için bu tabloyu kullanın (Uygulama yüklemeleri için Teklif ve bütçe veya etkileşim ve ön kayıt için Bütçe ve teklif).
| Google Ads kullanıcı arayüzü bölümü ve etiketi | API kaynağı ve alanı | Ayrıntılar |
|---|---|---|
| Uygulama > Kampanya alt türü seçin (Uygulama yüklemeleri, Uygulama etkileşimi, Uygulama ön kaydı (yalnızca Android)). |
Campaign.advertising_channel_type,
Campaign.advertising_channel_sub_type.
|
Değiştirilemez: MULTI_CHANNEL, APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT veya APP_CAMPAIGN_FOR_PRE_REGISTRATION ile.
|
| Kampanya ayarları > Kampanya adı. |
Campaign.name.
|
Müşteri hesabında zorunlu görünen ad. |
| Kampanya ayarları > Mobil uygulama. |
Campaign.app_campaign_setting.app_store,
Campaign.app_campaign_setting.app_id.
|
Değiştirilemez: GOOGLE_APP_STORE (paket adı; ön kayıt için gereklidir) veya APPLE_APP_STORE (sayısal kimlik).
|
| Kampanya ayarları > Konumlar ve Diller. |
CampaignCriterion
(location,
language).
|
MutateCampaignCriteria veya atomik GoogleAdsService.Mutate ile eklendi.
|
| Kampanya ayarları > Görüntüleme dönüşümü optimizasyonu > Görüntüleme dönüşümlerini etkinleştir. |
Campaign.view_through_conversion_optimization_enabled.
|
Yalnızca Android APP_CAMPAIGN (24 ve sonraki sürümler). Kullanıcı arayüzünde varsayılan olarak true, API'de ise false değerine ayarlanır.
|
| Kampanya ayarları > AB siyasi reklamları (Kampanyanızda Avrupa Birliği siyasi reklamları var mı?). |
Campaign.contains_eu_political_advertising.
|
Evet, bu kampanyada AB siyasi reklamları var ve Hayır, bu kampanyada AB siyasi reklamları yok ile eşleşir. |
| Kampanya ayarları > Başlangıç ve bitiş tarihleri. |
Campaign.start_date_time,
Campaign.end_date_time.
|
İsteğe bağlı hesap saat dilimi zaman damgaları (00:00:00 bugün veya daha sonra ve 23:59:59).
|
| Teklif verme ve bütçe > Bütçe. |
CampaignBudget.amount_micros,
Campaign.campaign_budget.
|
CampaignBudget.explicitly_shared, false olarak ayarlanmış şekilde hesap para biriminde günlük mikro değerler.
|
|
Teklif verme ve bütçe > Teklif verme >
Neye odaklanmak istiyorsunuz? ve
Ne tür kullanıcıları hedeflemek istiyorsunuz? Yükleme başına maliyet hedefi belirleyin (isteğe bağlı), Uygulama içi işlem başına maliyet hedefi belirleyin (isteğe bağlı) ve Reklam harcamalarından elde edilen gelir hedefi belirleyin (isteğe bağlı). Yükleme başına maliyet hedefi, İşlem başına maliyet hedefi ve Reklam harcamalarından elde edilen gelir hedefi. |
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.
|
Hem hedef enum'u hem de teklif verme oneof alanını ayarlar (Hazırlık bölümüne bakın). Hedef dışı stratejiler yalnızca APP_CAMPAIGN için geçerlidir. iOS'te, SKAdNetwork dönüşüm değerleri için optimize et yalnızca kullanıcı arayüzüyle ilgilidir (CustomerSkAdNetworkConversionValueSchema ile şemaları okuyun).
|
|
Teklif verme ve bütçe > Teklif verme >
Yükleme hacmini nasıl takip etmek istiyorsunuz? Hangi işlem sizin için en önemli? ve Hangi işlemler sizin için en önemli? |
Campaign.selective_optimization.conversion_actions.
|
Yükleme seçici, en fazla bir DOWNLOAD işlemi ekler
(yalnızca APP_CAMPAIGN). İşlem seçiciler, app_id ile eşleşen bir (tekil) veya birden fazla (çoğul) işlem ekler.
|
| Bütçe ve teklif verme > Teklif verme > Ön kayıt ve Ön kayıt başına maliyet hedefi. |
Campaign.target_cpa.target_cpa_micros,
Campaign.optimization_goal_setting.optimization_goal_types.
|
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME ve APP_PRE_REGISTRATION kullanır (selective_optimization ayarlanmadan bırakılır).
|
Kod örneği ve sonraki adımlar
Kampanyanızın reklam yayınlayabilmesi için bir reklam grubu ve reklam öğeleri ekleyin:
- Uygulama reklamı grubu ve reklam oluşturma:
AdGroupkaynağı (APP_CAMPAIGN_FOR_ENGAGEMENTüzerinde gerekliUserListInfoölçütleriyle) ve uygulama reklamı ekleyin. - Uygulama kampanyası kod örneği: Bütçe, kampanya, ölçüt, reklam grubu ve reklam oluşturan çok dilli
AddAppCampaignörneğini inceleyin. - Uygulama kampanyası raporlaması: Google Ads Sorgu Dili ile kampanya, öğe, yükleme ve SKAdNetwork metriklerini sorgulayın.