Kitle oluşturma ve yönetme

Audience, odaklanmış segmentler, demografik hedefleme ve hariç tutmalardan oluşan, yeniden kullanılabilir bir koleksiyondur. Kitle hedefleme, Maksimum Performans, Talep Yaratma ve uygulama kampanyalarında desteklenir. Görüntülü Reklam Ağı, Arama Ağı, video, otel veya Standart Alışveriş kampanyasında doğrudan kitle segmentlerini hedeflemek istiyorsanız Kitle segmentleri'ne gidin.

Kitle oluştur

AudienceService'i kullanarak kitle oluşturma ve güncelleme Her Audience benzersiz bir ada sahip olmalıdır. Bu yeniden kullanılabilir kitle, birden fazla kitle boyutunun birleştirilmesine olanak tanır:

audience_id için MutateAudienceResult inceleniyor

AudienceService.MutateAudiences ile kitle oluştururken her işlem bir MutateAudienceResult döndürür. MutateAudienceResult, audience_id elde etmek için incelenebilir. Bu işlem, döndürülen resource_name ayrıştırılarak veya response_content_type, MUTABLE_RESOURCE olarak ayarlandığında değiştirilebilir audience nesnesi incelenerek yapılabilir:

# Inspect MutateAudienceResult to get audience_id
for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = resource_name.split("/")[-1]
    print(f"Created audience with resource_name '{resource_name}' and audience_id '{audience_id}'.")

    # If response_content_type is MUTABLE_RESOURCE, you can access result.audience.id directly:
    if result.audience and result.audience.id:
        print(f"Audience ID from mutable resource: {result.audience.id}")

AudienceInfo ölçütlerini kullanarak kitleleri reklam grubu düzeyinde hedefleyebilirsiniz. Bunun için AdGroupCriterion üzerinde audience alanını kitle kaynağı adına ayarlayın.

Kitleleri alma

Diğer kaynaklarda olduğu gibi, kitlelerin özelliklerini almak için GoogleAdsService.SearchStream kullanabilirsiniz.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Hedef kitleler

Kitleler, kampanya türüne bağlı olarak birden fazla şekilde hedeflenebilir.

Öğe grubu sinyalleri

Maksimum Performans kampanyalarında kitleleri hedeflemek için AssetGroupSignal kullanılır. Öğe grubu sinyallerini kullanarak kitleleri hedefleme hakkında bilgi edinmek için Öğe Grupları kılavuzuna bakın.

Reklam grubu ölçütü

Talep Yaratma ve uygulama kampanyaları, kitleleri hedeflemek veya kitle sinyalleri sağlamak için AdGroupCriterion kullanılarak kitle reklam grubu ölçütü eklenmesini destekler.

Kitle hedeflemeyi ayarlamak için aşağıdaki adımları uygulayın:

AdGroup bölümünde kitle hedeflemeyi etkinleştirin.

Reklam grubu oluşturulurken AdGroup ayarını use_audience_grouped olarak belirleyerek true kitle hedeflemeyi etkinleştirmeniz gerekir.

Bu sayede, kitlelerle birlikte AdGroupCriterion ekleyebilirsiniz. Bu değer true olarak ayarlanmazsa kitleyi hedefleme isteğiniz başarısız olur.

AdGroupCriterion oluşturma

AdGroupCriterion oluşturun ve audience alanını, bu kılavuzda daha önce oluşturulan kitlenin kaynak adına ayarlayın.

İsteğe bağlı: Kampanyada kitle hedeflemeyi etkinleştirin.

İsteğe bağlı olarak, kampanya oluşturulduğunda use_audience_grouped değerini true olarak ayarlayabilirsiniz. Bu ayarla, kampanya düzeyinde segmentleri ve demografik grupları hariç tutacak ölçütler eklemeye çalışırsanız hata alırsınız.

En iyi uygulamalar

  • Karakter oluşturmak için kitleleri kullanma Kitleler, belirli bir kişiyi hedeflemek için birden fazla segment ve demografik ölçüt katmanlandırmak istediğiniz Maksimum Performans, Talep Yaratma ve uygulama kampanyalarında en iyi şekilde kullanılır.
  • Doğrudan hedefleme için kitle segmentlerini kullanma. Görüntülü Reklam Ağı, Arama Ağı, video, otel ve Standart Alışveriş kampanyalarında veya yalnızca tek bir segmenti (ör. yeniden pazarlama listesi) hedeflemeniz gerektiğinde kitleler yerine kitle segmentlerini kullanın.

Sık karşılaşılan hatalar

Google Ads API, Audience oluşturulurken veya güncellenirken isteği doğrular ve doğrulama başarısız olursa AudienceError enum'ından hatalar döndürür.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Özet İstekteki bir kitle segmenti bulunamadı.
Genel nedenler Mevcut olmayan veya erişilemeyen bir segment kimliğine referans veriliyor.
İtirazı yanıtlama Kitle oluşturmadan veya güncellemeden önce tüm segment kimliklerinin mevcut ve erişilebilir olduğundan emin olun.
Korunmayla ilgili ipuçları Segment kimliklerini bir kitleye eklemeden önce doğrulayın.
DIMENSION_INVALID
Özet Bir kitle boyutu geçersiz.
Genel nedenler exclusion_dimension içinde detailed_demographic dahil.
İtirazı yanıtlama exclusion_dimension içindeki hariç tutmalar için yalnızca user_list kullanın.
Korunmayla ilgili ipuçları Kitle oluştururken veya güncellerken exclusion_dimension içinde yalnızca user_list kullanıldığından emin olun.
DUPLICATE_AUDIENCE_SEGMENT
Özet Kitle, yinelenen segmentler içeriyor.
Genel nedenler Aynı segmenti aynı kitleye birden çok kez ekleme.
İtirazı yanıtlama Kitle tanımından yinelenen segmentleri kaldırın.
Korunmayla ilgili ipuçları Bir kitledeki tüm segmentlerin benzersiz olduğundan emin olun.
NAME_ALREADY_IN_USE
Özet Kitle adı zaten kullanılıyor.
Genel nedenler Aynı ada sahip birden fazla kitle oluşturmaya çalışmak
İtirazı yanıtlama Kitle oluştururken benzersiz bir ad kullanın.
Korunmayla ilgili ipuçları Yeni bir kitle oluşturmadan önce mevcut kitle adlarını kontrol edin.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Özet Kitle, aynı türden çok fazla boyut içeriyor.
Genel nedenler Aynı türden birden fazla boyutu (ör. birden fazla yaş boyutu) tek bir kitleye dahil etme.
İtirazı yanıtlama Kitle tanımının her türden yalnızca bir boyut içerdiğinden emin olun.
Korunmayla ilgili ipuçları Kitle tanımını inceleyerek yinelenen boyut türleri içermediğinden emin olun.
TOO_MANY_SEGMENTS
Özet Kitle çok fazla segment içeriyor.
Genel nedenler Bir kitlede izin verilen maksimum segment sayısını aşma
İtirazı yanıtlama Kitle tanımındaki segment sayısını azaltın.
Korunmayla ilgili ipuçları Kitle başına segment sayısıyla ilgili sınırlamalar için dokümanları inceleyin.