Yeniden Pazarlama Kitleleri Geliştirici Kılavuzu

Bu dokümanda, Google Analytics yeniden pazarlama kitlelerini yönetmek için Management API'sinin nasıl kullanılacağı açıklanmaktadır.

Not: Bu API'yi kullanırken hassas kategorilerle ilgili kurallar da dahil olmak üzere Google Analytics Reklamcılık Özellikleri Politikası'na uymanız gerekir.

Giriş

Management API'si bir Google Analytics mülkü için create, get, delete, list, update ve patch yeniden pazarlama kitlesi kullanmanıza olanak tanır. Yeniden pazarlama kitlelerinin işleyiş şekli hakkında daha fazla bilgi edinmek için Analytics'teki Yeniden Pazarlama Kitleleri Hakkında başlıklı yardım merkezi makalesini inceleyin.

Kullanım alanları

Yeniden Pazarlama Kitlesi kaynağı; get, sil, liste, yama ve güncellemeyi destekler ancak temel kullanım alanları şunlardır:

• Yeniden pazarlama kitlelerini listeleyin.
• Yeni bir yeniden pazarlama kitlesi oluşturun.
• Mevcut bir yeniden pazarlama kitlesini güncelleyebilirsiniz.

Not: Uygun verileri toplamak için etiketinizi etkinleştirmezseniz yeniden pazarlama kitleleriniz boş kalır ve yeniden pazarlama kampanyalarınız yayınlanmayabilir. Başlamak için Google Analytics Mülk Ayarlarınızda Reklamcılık Özellikleri'ni etkinleştirin.

Yeniden pazarlama kitlelerini listeleyin

Bir mülkün tüm yeniden pazarlama kitlelerini listelemek için:

1. accountId ve webPropertyId değerlerini almak için Management API'sini veya Hesap Gezgini'ni kullanın.
2. Yeniden Pazarlama Kitleleri kaynağının list yöntemini yürütme.

Yeniden pazarlama kitlesi kaynağı için list yönteminin ayrıntılarıyla ilgili API referansına bakın.

Yeni yeniden pazarlama kitlesi oluşturma

Bir mülk için yeni yeniden pazarlama kitlesi oluşturmak isterseniz:

1. accountId ve webPropertyId araçlarını almak için Management API'sini veya Hesap Gezgini'ni kullanın.
2. linkedViews [] mülkünün görünüm (profil) kimliğini almak için Management API'sini veya Hesap Gezgini'ni kullanın.
3. linkedAdAccounts.linkedAccountId için Google Ads hesabı kimliği almak üzere Google Ads Bağlantıları koleksiyonunu kullanın.
   • linkedAdAccounts[] özelliği şu anda yalnızca bir linkedForeignAccount ile sınırlıdır.
   • linkedAdAccounts[].type ADWORDS_LINKS, DBM_LINKS, MCC_LINKS veya OPTIMIZE olarak ayarlanabilir.
4. includeConditions özelliğinin segment özelliğini ayarlama seçenekleri için Segmentler koleksiyonunu kullanın. Eyalete dayalı bir kitle oluşturuyorsanız excludeConditions için de aynı işlemi yapın. Ayrıca, bir segmenti tanımlamak için segment referansına bakın.
   • İsteğe bağlı olarak includeConditions, membershipDurationDays ve daysToLookBack değerleri içerebilir
   • İsteğe bağlı olarak excludeConditions.exclusionDuration, PERMANENT olarak ayarlanabilir.
5. Yeniden Pazarlama Kitlesi kaynağının insert yöntemini çalıştırın.

API iki tür kitle oluşturmanıza olanak tanır: SIMPLE ve STATE_BASED. SIMPLE kitleleri için audienceDefinition öğesini yalnızca NOT operatörü (! karakteri) olmadan pozitif bir segment ile oluşturmanız gerekir. Bir hariç tutma koşulu eklemek isterseniz bir statebasedDefinition tanımlamanız gerekir; daha fazla bilgi için Duruma Bağlı Kitleler bölümüne bakın. Ayrıntılar için referans örneği inceleyin.

Not: audienceDefinition veya stateBasedAudienceDefinition tanımlayabilir ve audienceType değerini ilgili değere ayarlayabilirsiniz. Ayrıca,izin verilen 2.000 yeniden pazarlama kitlesi sınırı vardır. Yeniden pazarlama kitlelerinin oluşturulmasını otomatikleştirirken dikkatli olun.

Mevcut bir yeniden pazarlama kitlesini güncelleme

Bir mülkün mevcut yeniden pazarlama kitlesini güncellemek için:

1. Yeniden Pazarlama Kitlesi Kimliğiniz zaten varsa get numaralı telefonu arayabilir, aksi takdirde list'ni arayıp güncellemek istediğiniz kitleyi seçebilirsiniz.
2. Yazılabilir alanlardan herhangi birini güncelleyin ve güncellenmiş kitle nesnesinden geçen update değerini çağırın.

Not: Oluşturulan kitlenin audienceType değerini değiştiremezsiniz. Diğer bir deyişle, bir kitlenin audienceDefinition değeri varsa stateBasedAudienceDefinition değeri ile güncellemeyi çağıramazsınız. Daha fazla bilgi edinmek için Duruma Bağlı Kitleler bölümüne bakın. Ayrıntılar için referans örneğini inceleyin.