Yeniden Pazarlama Kitleleri Geliştirici Kılavuzu

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

Giriş

Management API ile bir Google Analytics mülkü için create, get, delete, list, update ve patch yeniden pazarlama kitlelerini kullanabilirsiniz. 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ğı al, sil, listele, yama ve güncelleme işlemlerini destekler, ancak temel kullanım alanları şunlardır:

Yeniden pazarlama kitlelerini listeleme

Bir mülke ait tüm yeniden pazarlama kitlelerini listelemek için:

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

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

Yeni bir yeniden pazarlama kitlesi oluşturma

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

  1. accountId ve webPropertyId öğelerini almak için Management API'yi veya Hesap Gezgini'ni kullanın.
  2. linkedViews [] mülkünün görünüm (profil) kimliğini almak için Management API'yi veya Hesap Gezgini'ni kullanın.
  3. linkedAdAccounts.linkedAccountId için bir Google Ads hesap 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 öğesinin segment özelliğini ayarlama seçenekleri için Segmentler koleksiyonunu kullanın. Duruma dayalı kitle oluşturuluyorsa aynı işlemi excludeConditions için de yapın. Ayrıca, bir segmenti tanımlamak için segment referansına da bakın.
    • includeConditions, isteğe bağlı olarak membershipDurationDays ve daysToLookBack değerleri içerebilir
    • excludeConditions.exclusionDuration, isteğe bağlı olarak PERMANENT olarak ayarlanabilir.
  5. Yeniden Pazarlama Kitlesi kaynağının insert yöntemini yürütün.

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

Mevcut bir yeniden pazarlama kitlesini güncelleme

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

  1. Yeniden Pazarlama Kitle Kimliği'ne sahipseniz get numarasını arayabilirsiniz. Aksi takdirde list numarasını arayıp güncellemek istediğiniz kitleyi seçebilirsiniz.
  2. Yazılabilir alanlardan herhangi birini güncelleyin ve güncellenen kitle nesnesinde geçen update değerini çağırın.