Kitle oluşturma ve yönetme

Audience, odaklanmış segmentler, demografik hedefleme ve hariç tutmaların yeniden kullanılabilir bir koleksiyonudur. 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 kitle segmentlerini doğrudan hedeflemek istiyorsanız Kitle segmentleri başlıklı makaleyi inceleyin.

Kitle oluştur

AudienceService 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'u inceleyin.

AudienceService.MutateAudiences ile kitle oluştururken her işlem bir MutateAudienceResult döndürür. Döndürülen resource_name ayrıştırılarak audience_id elde etmek için MutateAudienceResult öğesini inceleyebilirsiniz. Ayrıca, response_content_type MUTABLE_RESOURCE olarak ayarlandığında döndürülen audience nesnesindeki değiştirilebilir alanları (ör. name) inceleyebilirsiniz:

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

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 nasıl hedefleyeceğinizi öğrenmek için Öğe grubu sinyalleri 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. AudienceInfo ölçütlerini kullanarak reklam grubu düzeyinde kitleleri hedefleyebilirsiniz. Bunun için AdGroupCriterion.audience üzerinde AudienceInfo.audience alanını (ad_group_criterion.audience.audience) kitle kaynağı adına ayarlayın.

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 true olarak ayarlayarak kitle hedeflemeyi etkinleştirmeniz gerekir. Bu ayar, reklam grubu oluşturulduktan sonra değiştirilemez.

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

AdGroupCriterion oluşturma

AdGroupCriterion oluşturun ve AudienceInfo.audience alanını AdGroupCriterion.audience üzerinde Kitle oluşturma'da oluşturulan kitlenin kaynak adına ayarlayın.

İsteğe bağlı: Campaign bölümünde 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 kullanın. 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 kitleye dahil etmeden önce doğrulayın.
DIMENSION_INVALID
Özet Bir kitle boyutu geçersiz.
Genel nedenler detailed_demographic dahil exclusion_dimension.
İ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 user_list yalnızca exclusion_dimension içinde 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 boyutun (ör. birden fazla yaş boyutu) tek bir kitleye dahil edilmesi.
İtirazı yanıtlama Kitle tanımının her türden yalnızca bir boyut içerdiğinden emin olun.
Korunmayla ilgili ipuçları Yinelenen boyut türleri olmadığından emin olmak için kitle tanımını inceleyin.
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.