- Kaynak: FirstAndÜçüncü TarafKitle
- FirstAndThirdPartyAudienceType
- AudienceType
- AudienceSource
- ContactInfoList
- ContactInfo
- İzin
- ConsentStatus
- MobileDeviceIdList
- Yöntemler
Kaynak: FirstAndÜçüncü TarafKitle
Hedefleme için kullanılan birinci veya üçüncü taraf kitle listesini açıklar. Birinci taraf kitleler, müşteri verileri kullanılarak oluşturulur. Üçüncü taraf kitleler, üçüncü taraf veri sağlayıcıları tarafından sağlanır ve yalnızca müşterilere lisanslanabilir.
JSON gösterimi |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Birinci ve üçüncü taraf kitlenin kaynak adı. |
firstAndThirdPartyAudienceId |
Yalnızca çıkış. Birinci ve üçüncü taraf kitlenin benzersiz kimliği. Sistem tarafından atanır. |
displayName |
Birinci ve üçüncü taraf kitlenin görünen adı. |
description |
Kitle için kullanıcı tarafından sağlanan açıklama. Yalnızca birinci taraf kitleler için geçerlidir. |
firstAndThirdPartyAudienceType |
Kitlenin birinci taraf mı yoksa üçüncü taraf bir kitle mi olduğu. |
audienceType |
Kitlenin türü. |
audienceSource |
Yalnızca çıkış. Kitlenin kaynağı. |
membershipDurationDays |
Bir girişin, uygun etkinlikten sonra kitlede kaldığı gün cinsinden süre. Kitlenin son kullanma tarihi yoksa bu alanın değerini 10.000 olarak ayarlayın. Aksi takdirde, ayarlanan değer 0'dan büyük ve en fazla 540 olmalıdır. Yalnızca birinci taraf kitleler için geçerlidir. Aşağıdaki
|
displayAudienceSize |
Yalnızca çıkış. Görüntülü Reklam Ağı için tahmini kitle boyutu. Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki önemli basamağa yuvarlanır. Yalnızca GET isteğinde döndürülür. |
activeDisplayAudienceSize |
Yalnızca çıkış. Görüntülü Reklam Ağı'nın geçen ayki tahmini kitle boyutu. Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki önemli basamağa yuvarlanır. Yalnızca GET isteğinde döndürülür. |
youtubeAudienceSize |
Yalnızca çıkış. YouTube ağı için tahmini kitle boyutu. Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki önemli basamağa yuvarlanır. Yalnızca birinci taraf kitleler için geçerlidir. Yalnızca GET isteğinde döndürülür. |
gmailAudienceSize |
Yalnızca çıkış. Gmail ağı için tahmini kitle boyutu. Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki önemli basamağa yuvarlanır. Yalnızca birinci taraf kitleler için geçerlidir. Yalnızca GET isteğinde döndürülür. |
displayMobileAppAudienceSize |
Yalnızca çıkış. Görüntülü Reklam Ağı'ndaki tahmini mobil uygulama kitle boyutu. Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki önemli basamağa yuvarlanır. Yalnızca birinci taraf kitleler için geçerlidir. Yalnızca GET isteğinde döndürülür. |
displayMobileWebAudienceSize |
Yalnızca çıkış. Görüntülü Reklam Ağı'ndaki tahmini mobil web kitlesi boyutu. Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki önemli basamağa yuvarlanır. Yalnızca birinci taraf kitleler için geçerlidir. Yalnızca GET isteğinde döndürülür. |
displayDesktopAudienceSize |
Yalnızca çıkış. Görüntülü Reklam Ağı'ndaki tahmini masaüstü kitle boyutu. Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki önemli basamağa yuvarlanır. Yalnızca birinci taraf kitleler için geçerlidir. Yalnızca GET isteğinde döndürülür. |
appId |
appId, yüklenen mobileDeviceId'lerin türüyle eşleşiyor. Yalnızca |
Birleştirme alanı members . Müşteri Eşleştirme kitlesinin ilk üyeleri. members şunlardan yalnızca biri olabilir: |
|
contactInfoList |
Yalnızca giriş'e dokunun. İlk hedef kitle üyelerini tanımlamak için kullanılan iletişim bilgileri listesi. Yalnızca |
mobileDeviceIdList |
Yalnızca giriş'e dokunun. İlk kitle üyelerini tanımlamak için mobil cihaz kimliklerinin listesi. Yalnızca |
FirstAndThirdPartyAudienceType
Olası birinci ve üçüncü taraf kitle kaynağı türleri.
Sıralamalar | |
---|---|
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED |
Tür belirtilmediğinde veya bilinmiyorsa varsayılan değer. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY |
Müşteri verileri kullanılarak oluşturulan kitle. |
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY |
Üçüncü taraf veri sağlayıcıları tarafından sağlanan kitle. |
AudienceType
Olası kitle türleri.
Sıralamalar | |
---|---|
AUDIENCE_TYPE_UNSPECIFIED |
Tür belirtilmediğinde veya bilinmiyorsa varsayılan değer. |
CUSTOMER_MATCH_CONTACT_INFO |
Kitle, müşteriler bilinen iletişim bilgileriyle eşleştirilerek oluşturuldu. |
CUSTOMER_MATCH_DEVICE_ID |
Kitle, müşterileri bilinen mobil cihaz kimlikleriyle eşleştirilerek oluşturuldu. |
CUSTOMER_MATCH_USER_ID |
Kitle, müşterileri bilinen User ID'lerle eşleştirerek oluşturuldu. |
ACTIVITY_BASED |
Kitle, kampanya etkinliğine göre oluşturuldu. |
FREQUENCY_CAP |
Kitle, kendilerine yayınlanan gösterimlerin sayısı hariç tutularak oluşturuldu. |
TAG_BASED |
Kitle, piksele ekli özelleştirilebilen değişkenlere göre oluşturuldu. |
YOUTUBE_USERS |
Kitle; videolar, YouTube reklamları veya YouTube kanalıyla geçmişteki etkileşimlere göre oluşturuldu. |
LICENSED |
Üçüncü taraf kitle türünün alt türü. |
AudienceSource
Olası kitle kaynakları.
Sıralamalar | |
---|---|
AUDIENCE_SOURCE_UNSPECIFIED |
Kitle kaynağı belirtilmediğinde veya bilinmiyorsa varsayılan değer. |
DISPLAY_VIDEO_360 |
Display & Video 360'tan alınmıştır. |
CAMPAIGN_MANAGER |
Campaign Manager 360'tan alınmıştır. |
AD_MANAGER |
Google Ad Manager'dan gelir. |
SEARCH_ADS_360 |
Kaynak: Search Ads 360. |
YOUTUBE |
Kaynağı YouTube'dur. |
ADS_DATA_HUB |
Ads Data Hub'dan alınmıştır. |
ContactInfoList
Müşteri Eşleştirme kitlesi üyelerini tanımlayan iletişim bilgileri listesi için sarmalayıcı mesajı.
JSON gösterimi |
---|
{ "contactInfos": [ { object ( |
Alanlar | |
---|---|
contactInfos[] |
Müşteri Eşleştirme kitlesi üyelerini tanımlayan ContactInfo nesnelerinin listesi. contactInfo'lar bölündükten sonra üyelerin boyutu 500.000'den fazla olmamalıdır. |
consent |
Yalnızca giriş'e dokunun. Bu alanın ayarlanmadan bırakılması, rızanın belirtilmediği anlamına gelir.
|
ContactInfo
Müşteri Eşleştirme kitlesi üyesini tanımlayan iletişim bilgileri.
JSON gösterimi |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
Alanlar | |
---|---|
hashedEmails[] |
Üyenin SHA256 karma oluşturma işlemi uygulanmış e-posta listesi. Karma oluşturma işleminden önce tüm boşlukları kaldırın ve dizenin tamamının küçük harfli olduğundan emin olun. |
hashedPhoneNumbers[] |
Üyenin SHA256 karma oluşturma işlemi uygulanmış telefon numaralarının listesi. Karma oluşturma işleminden önce tüm telefon numaraları E.164 biçimi kullanılarak biçimlendirilmeli ve ülke telefon kodu içermelidir. |
zipCodes[] |
Üyenin posta kodlarının listesi. Ayrıca aşağıdaki alanlarla ayarlanmalıdır: |
hashedFirstName |
SHA256, üyenin adına karma oluşturma işlemi uygulanmış. Karma oluşturma işleminden önce tüm boşlukları kaldırın ve dizenin tamamının küçük harfli olduğundan emin olun. Ayrıca aşağıdaki alanlarla ayarlanmalıdır: |
hashedLastName |
Üyenin SHA256 karma oluşturma işlemi uygulanmış soyadı. Karma oluşturma işleminden önce tüm boşlukları kaldırın ve dizenin tamamının küçük harfli olduğundan emin olun. Ayrıca aşağıdaki alanlarla ayarlanmalıdır: |
countryCode |
Üyenin ülke kodu. Ayrıca aşağıdaki alanlarla ayarlanmalıdır: |
Rıza
Kullanıcı izni durumu.
JSON gösterimi |
---|
{ "adUserData": enum ( |
Alanlar | |
---|---|
adUserData |
Reklam kullanıcı verilerine yönelik izni temsil eder. |
adPersonalization |
Reklam kişiselleştirmeye yönelik izni temsil eder. |
ConsentStatus
İzin durumu.
Sıralamalar | |
---|---|
CONSENT_STATUS_UNSPECIFIED |
Tür değeri belirtilmemiş veya bu sürümde bilinmiyor. |
CONSENT_STATUS_GRANTED |
İzin verildi. |
CONSENT_STATUS_DENIED |
İzin reddedildi. |
MobileDeviceIdList
Müşteri Eşleştirme kitle üyelerini tanımlayan mobil cihaz kimlikleri listesi için sarmalayıcı mesajı.
JSON gösterimi |
---|
{
"mobileDeviceIds": [
string
],
"consent": {
object ( |
Alanlar | |
---|---|
mobileDeviceIds[] |
Müşteri Eşleştirme kitle üyelerini tanımlayan mobil cihaz kimliklerinin listesi. mobileDeviceId'lerin boyutu 500.000'den büyük olmamalıdır. |
consent |
Yalnızca giriş'e dokunun. Bu alanın ayarlanmadan bırakılması, rızanın belirtilmediği anlamına gelir.
|
Yöntemler |
|
---|---|
|
FirstAndÜçüncü TarafKitle oluşturur. |
|
Müşteri Eşleştirme kitlesinin üye listesini günceller. |
|
Birinci ve üçüncü taraf bir kitle edinir. |
|
Birinci ve üçüncü taraf kitleleri listeler. |
|
Mevcut bir FirstAndÜçüncüPartyAudience'ı günceller. |