Google Ads komut dosyaları, Arama Ağı ve Görüntülü Reklam Ağı kampanyalarındaki değişiklikleri hazırlamak ve test etmek için kullanılan kampanya taslaklarını ve denemelerini destekler.
Taslak, kendi reklamlarını yayınlamayacak mevcut bir kampanyanın kopyasıdır ancak orijinal kampanyada değişiklik yapılmadan değişiklikleri hazırlamak için kullanılabilir. Aşamalı değişiklikler daha sonra ana kampanyaya uygulanabilir.
Deneme, orijinal kampanyaya paralel olarak özelleştirilebilir bir kampanya yayınlar ve trafiğin belirli bir yüzdesine reklam gösterir. Denemenin sonuçlarına göre, değişiklikleri orijinal kampanyaya uygulayabilir, denemeyi bağımsız bir kampanyaya bölebilir veya deneme kampanyasını bırakabilirsiniz.
Bu kılavuzda, bir komut dosyasında taslaklar ve denemelerle çalışmaya ilişkin temel iş akışı açıklanmaktadır.
Taslaklar
Taslak oluşturma
DraftBuilder kullanılarak ve benzersiz bir ad sağlanarak mevcut bir ana kampanyadan taslak oluşturulur. Ana kampanya bir Arama Ağı, Görüntülü Reklam Ağı Genişletmeli Arama Ağı kampanyası veya Görüntülü Reklam Ağı kampanyası (Görüntülü Reklam Ağı için Mobil Uygulama kampanyası hariç) olmalı ve paylaşılan bir bütçeye sahip olmamalıdır.
const campaign = AdsApp.campaigns()
.withCondition(`campaign.name = "${campaignName}"`)
.get()
.next();
const draftBuilder = campaign.newDraftBuilder()
.withName("INSERT_DRAFT_NAME_HERE")
.build();
const draft = draftBuilder.getResult();
DraftBuilder.build(), Komut Dosyaları'nda tipik bir işlem olan DraftOperation döndürür. Daha fazla ayrıntı için geliştiricilere yönelik kılavuzumuza bakın.
draft, ana kampanya kimliği ile taslak kimliğinin kombinasyonuyla benzersiz bir şekilde tanımlanır. Daha fazla bilgi için DraftSelector.withIds() sayfasını inceleyin.
Taslak kampanyanın temel hazırlığını yapın
draft nesnesi bir ana kampanya ve bir taslak kampanyayla ilişkili. Ana kampanyada yapmak istediğiniz güncellemeleri
hazırlamak için değişiklikleri taslak kampanya yoluyla uygularsınız.
Diğer tüm kampanyalarda olduğu gibi, taslak kampanyanın da ölçüt, reklam grubu, teklif ve reklamlar gibi çeşitli özelliklerini almak ve ayarlamak için kullanabileceği yöntemler vardır.
const draftCampaign = draft.getDraftCampaign();
draftCampaign.setAdRotationType("CONVERSION_OPTIMIZE");
draftCampaign.createNegativeKeyword("shoes");
Reklam politikası kontrollerinin, ana kampanyada olduğu gibi taslak kampanya için de yapıldığını unutmayın. Politikaları ihlal eden reklamlar içeren taslak kampanyadan deneme çalıştıramazsınız.
Taslağı yürüt
Taslak kampanyanın temel hazırlığını yaptıktan sonra, aşağıdakilerden birini yapabilirsiniz:
Değişiklikleri kullanmak istemiyorsanız taslağı kaldırmanız yeterlidir. Taslağı kaldırma işlemi geri alınamaz. Ancak taslak, Google Ads kullanıcı arayüzünün taslaklar sekmesindeki Tüm taslaklar altında yine de görüntülenebilir.
draft.remove();Taslakta yaptığınız değişiklikleri korumaya karar verirseniz bunları uygulayabilirsiniz:
draft.startApplying();Bu yöntem, güncellemeleri ana kampanyaya uygulama sürecini başlatır. Böylece taslak, Google Ads kullanıcı arayüzünde Uygulanıyor... durumunda olur. Ancak, işlem tamamlandığında yöntem size bilgi vermez.
Değişikliklerinizi önce test etmek isterseniz taslağı kullanarak bir deneme oluşturabilirsiniz.
Denemeler
Deneme oluşturma
experiment, taslağa benzer ve ayrıca temel bir kampanyadan oluşturulur. ExperimentBuilder ile bir experiment oluşturuyorsunuz.
Bu, otomatik olarak denemenin farklı bölümlerini temsil eden iki "kol" ile bir deneme oluşturur. Bir kol (kontrol kolu) ana kampanyayı, diğer kol (değerlendirme kolu olarak adlandırılır) ise yeni bir taslak kampanya içerir. Bu kol, denemeyi planlamadan önce yukarıdaki taslaktaki adımlara göre özelleştirirsiniz.
Bir deneme oluştururken, oluşturucuda aşağıdakilerin tümünü ayarladığınızdan emin olun:
withCampaign- Denemenin temel almasını istediğiniz kampanya.
withTrafficSplitPercent- Trafiğin ne kadarının deneme koluna gideceği. %50 için
50değerini belirtin. withStartDatevewithEndDate- Kampanyanın başlangıç ve bitiş tarihini belirtir.
YYYYMMddbiçiminde belirtin. withType- Kullandığınız ağa bağlı olarak
SEARCH_CUSTOMveyaDISPLAY_CUSTOM. withSuffix- Değerlendirme kampanyasının, oluşturulduğunda adının sonuna eklenecek bir son eki belirtir.
withGoals- Bu denemenin hedeflerini belirtir. Bu, uygulamayı oluştururken hedeflerinizin ne olduğunu
size hatırlatır.
[{metric: 'CLICKS', direction: 'INCREASE'}]iyi bir varsayılan değerdir.
Trafik yükü yüzdesi, trafiğin ne kadarlık bir kısmında ana kampanya yerine deneme kampanyasındaki reklamların gösterileceğini belirler. Bu nedenle, her ana kampanyada aynı anda yalnızca bir deneme çalışabilir.
const experiment = AdsApp.newExperimentBuilder()
.withCampaign(campaign)
.withTrafficSplitPercent(50)
.withStartDate("20230501")
.withEndDate("20230601")
.withType("SEARCH_CUSTOM")
.withSuffix("experiment")
.withGoals([{metric: 'CLICKS', direction: 'INCREASE'}])
.build();
// The experimentCampaign represents the customizeable draft.
const experimentCampaign = experiment.getExperimentCampaign();
Taslakların aksine, denemeler benzersiz bir şekilde tek bir kimlikle tanımlanır. Daha fazla bilgi için ExperimentSelector.withIds() sayfasını inceleyin.
Deneme kampanyasının temel hazırlığını yapın
draft ile benzer şekilde, experiment kendisi de bir kampanya değildir. Bunun yerine ana kampanya, taslak ve deneme kampanyası ile bağlantılıdır. Deneme kampanyasının alanları aşağıdaki istisnalar haricinde değiştirilebilir:
- ad
- status
- başlangıç tarihi
- bitiş tarihi
- bütçe
const experimentCampaign = experiment.getExperimentCampaign();
// Will succeed.
experimentCampaign.setAdRotationType("ROTATE_FOREVER");
experimentCampaign.createNegativeKeyword("sneakers");
// Will fail.
experimentCampaign.setName("INSERT_EXPERIMENT_NAME_HERE");
Denemede ad, başlangıç tarihi ve bitiş tarihinde yapılan değişiklikler deneme kampanyasına uygulanır.
// Will succeed.
experiment.setName("INSERT_EXPERIMENT_NAME_HERE");
// Will succeed if date is acceptable.
const date = "20220601";
experiment.setStartDate(date);
Denemeyi başlatmak için experiment.startScheduling() numaralı telefonu arayın. Bu, ana kampanyadaki tüm ayarları kopyalaması gerektiği için eşzamansız bir süreçtir.
Deneme sona erdikten sonra
Denemeniz tamamlandığında, birkaç seçeneğiniz vardır. Denemenin reklam yayınlamayı durdurması için denemenin tamamen bitmesini beklemenizi öneririz ancak denemeyle etkileşim kurmaya devam edebilirsiniz. Tamamlanan bir deneme yine de kaldırılabilir, uygulanabilir veya sonlandırılabilir ve kampanyanın performans istatistiklerine erişmeye devam edebilirsiniz.
experiment.finish();
const stats = experimentCampaign.getStatsFor("INSERT_TIME_PERIOD_HERE");
İstatistiklere göre denemeden memnun kalmazsanız denemeyi kaldırabilirsiniz. Bu durumda deneme kampanyası da kaldırılır. Denemeyi kaldırma işlemi geri alınamaz ancak deneme, Google Ads kullanıcı arayüzünün denemeler sekmesindeki Tüm denemeler altında görüntülenebilir.
experiment.remove();Denemenin sonuçlarından memnunsanız iki seçeneğiniz vardır:
Değişiklikleri uygulamaya başlayabilirsiniz ve taslaklarda olduğu gibi, işlem tamamlandığında bildirim almazsınız.
experiment.startApplying();Deneme kampanyasını ana kampanyayı etkilemeden bağımsız, tam olarak çalışan bir kampanya olarak oluşturabilirsiniz. mezuniyet olarak bilinen bu süreç hemen tamamlanır ve yeni bir bütçe belirlenmesini gerektirir.
const budget = AdsApp.budgets() .withCondition(`campaign_budget.id = ${budgetId}`) .get() .next(); experiment.graduate(budget);Yeni kampanya artık ana kampanyayla bütçe paylaşamaz. Bu durum yeni bir bütçe gerektirir. Geçişli kampanyalar, tüm alanlarının değiştirilebilir olması ve daha fazla taslak ve deneme için ana kampanya işlevi görebilmeleri açısından normal kampanyalara benzer.
Dikkat edilmesi gereken diğer noktalar
Temel varlıklar
Taslakların ve denemelerin Google Ads komut dosyalarında kullanıma sunulmasıyla birlikte temel varlıklar da kullanıma sunuldu. Taslak kampanyalar ve deneme kampanyaları ile bunların içindeki reklam grupları, orijinal temel kampanyalarından farklıdır. Bu nedenle,
Campaign
ve AdGroup
artık kendi temel kampanyasına ve reklam grubuna erişmek için yöntemlere sahiptir:
getBaseCampaign() ve getBaseAdGroup().
Bu yöntemler, ana kampanya veya reklam grubu tarafından çağrılırsa çağrı yapan varlığı döndürür. Kampanyalar ve reklam gruplarındaki anahtar kelimeler ve reklamlar gibi öğelere de bu tür yöntemler uygulanmıştır.
Temel varlıkların izlenmesine yardımcı olmak için kampanyalara isBaseCampaign(), isDraftCampaign() ve isExperimentCampaign() yöntemleri verilmiştir.
Yeni Campaign.draftCampaigns() ve Campaign.experimentCampaigns() yöntemleri, ana kampanya olarak arama kampanyasını içeren tüm taslak ve deneme kampanyalarına erişmenize olanak tanır. Ancak CampaignSelector.withCondition() ile taslak kampanyaları seçemezsiniz; bunun yerine AdsApp.drafts() kullanın.
Hata işleme
Taslakları ve denemeleri içeren aşağıdaki yöntemler, komut dosyası çalıştırıldığında devam eder, ancak eşzamansız olarak başarısız olabilir:
Draft.startApplying()Experiment.startApplying()Experiment.startScheduling()
Bu işlemlerin başarılı olup olmadığını kontrol etmek için beklemeniz gerekir. Google Ads kullanıcı arayüzünde, startApplying() ve startScheduling() başarıyla tamamlandıktan sonra Uygulandı veya Etkin durumları gösterilmektedir. Başarısız olması durumunda Uygulanamıyor veya Oluşturulamıyor şeklinde bir ifade görürsünüz. Bu sayede hataları tıklayarak görebilirsiniz.
Bazı yöntemlerin önizleme aşamasında başarısız olmasına rağmen çalıştırıldıktan sonra başarılı olması da mümkündür. Örneğin, bir taslak oluşturduktan sonra:
const draftCampaign = draft.getDraftCampaign();
draftCampaign.createNegativeKeyword("shoes"); // Will fail in preview.
Taslak kampanyaya hemen erişemeyeceğinden, bu işlem önizleme modunda başarısız olur.
Benzer şekilde, bir deneme oluşturmak ve taslak kampanyasını hemen getirmeye çalışmak, taslak aslında oluşturulmadığı için önizleme modunda başarısız olur.
Bu nedenle, komut dosyası listenizi çalıştırdıktan sonra komut listesi altındaki günlükleri kontrol edin ve yalnızca nedenin önizleme modundaki sınırlamalardan kaynaklandığını düşünüyorsanız önizlemede başarısız olan bir komut dosyasıyla devam edin.