Package google.ads.datamanager.v1

Dizin

IngestionService

Kitle verilerini desteklenen hedeflere gönderme hizmeti.

IngestAdEvents

rpc IngestAdEvents(IngestAdEventsRequest) returns (IngestAdEventsResponse)

Google Analytics'e AdEvent kaynak listesi yükler.

Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

Belirtilen Destination konumuna AudienceMember kaynak listesi yükler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
IngestEvents

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

Belirtilen Destination içindeki Event kaynakların listesini yükler.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
IngestUsers

rpc IngestUsers(IngestUsersRequest) returns (IngestUsersResponse)

Belirtilen hedeflere kullanıcı listesi yükler. IngestAudienceMembers (hedefleme için kullanıcıları belirli reklamveren kitle listelerine ekler) özelliğinden farklı olarak IngestUsers, belirli kitle segmentlerinden bağımsız olarak hesap düzeyinde kimlik bağlantısı verilerini (ör. mobil kimliklere bağlı kullanıcı tanımlayıcıları) alır.

Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
RemoveAllAudienceMembers

rpc RemoveAllAudienceMembers(RemoveAllAudienceMembersRequest) returns (RemoveAllAudienceMembersResponse)

Tüm kitle üyelerini sağlanan hedeflerden kaldırır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

Belirtilen Destination öğesinden AudienceMember kaynak listesini kaldırır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
RemoveUsers

rpc RemoveUsers(RemoveUsersRequest) returns (RemoveUsersResponse)

Belirtilen hedeflerden bir kullanıcı listesini kaldırır.

Bu özellik yalnızca izin verilenler listesindeki hesaplarda kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
RetrieveRequestStatus

rpc RetrieveRequestStatus(RetrieveRequestStatusRequest) returns (RetrieveRequestStatusResponse)

Belirli bir istek kimliğine sahip isteğin durumunu alır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager

MarketingDataInsightsService

Pazarlama verileriyle ilgili analizler döndüren hizmet.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

RetrieveInsights

rpc RetrieveInsights(RetrieveInsightsRequest) returns (RetrieveInsightsResponse)

Belirli bir kullanıcı listesi için pazarlama verileri analizlerini alır.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme Başlıkları:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üstbilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak istek hesabına ayarlanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager

PartnerLinkService

İş ortağı bağlantılarını yönetme hizmeti.

UserListDirectLicenseService

Kullanıcı listesi doğrudan lisanslarını yönetme hizmeti. Silme, UserListDirectLicenses için desteklenen bir işlem değildir. Arayanlar, lisansı devre dışı bırakmak için lisans durumunu DISABLED olarak güncellemelidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

CreateUserListDirectLicense

rpc CreateUserListDirectLicense(CreateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Doğrudan kullanıcı listesi lisansı oluşturur.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
GetUserListDirectLicense

rpc GetUserListDirectLicense(GetUserListDirectLicenseRequest) returns (UserListDirectLicense)

Doğrudan kullanıcı listesi lisansını alır.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
ListUserListDirectLicenses

rpc ListUserListDirectLicenses(ListUserListDirectLicensesRequest) returns (ListUserListDirectLicensesResponse)

Ebeveyn hesabına ait tüm kullanıcı listesi doğrudan lisanslarını listeler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListDirectLicense

rpc UpdateUserListDirectLicense(UpdateUserListDirectLicenseRequest) returns (UserListDirectLicense)

Kullanıcı listesi doğrudan lisansını günceller.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager

UserListGlobalLicenseService

Kullanıcı listesi genel lisanslarını yönetme hizmeti. Silme, UserListGlobalLicenses için desteklenen bir işlem değildir. Arayanlar, lisansı devre dışı bırakmak için lisans durumunu DISABLED olarak güncellemelidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

CreateUserListGlobalLicense

rpc CreateUserListGlobalLicense(CreateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Genel kullanıcı listesi lisansı oluşturur.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
GetUserListGlobalLicense

rpc GetUserListGlobalLicense(GetUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Genel kullanıcı listesi lisansını alır.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenseCustomerInfos

rpc ListUserListGlobalLicenseCustomerInfos(ListUserListGlobalLicenseCustomerInfosRequest) returns (ListUserListGlobalLicenseCustomerInfosResponse)

Bir kullanıcı listesi genel lisansı için tüm müşteri bilgilerini listeler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
ListUserListGlobalLicenses

rpc ListUserListGlobalLicenses(ListUserListGlobalLicensesRequest) returns (ListUserListGlobalLicensesResponse)

Ebeveyn hesabına ait tüm kullanıcı listesi genel lisanslarını listeler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
UpdateUserListGlobalLicense

rpc UpdateUserListGlobalLicense(UpdateUserListGlobalLicenseRequest) returns (UserListGlobalLicense)

Bir kullanıcı listesi genel lisansını günceller.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager

UserListService

UserList kaynaklarını yönetme hizmeti.

CreateUserList

rpc CreateUserList(CreateUserListRequest) returns (UserList)

UserList oluşturur.

Yetkilendirme Başlıkları:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üstbilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak istek hesabına ayarlanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
DeleteUserList

rpc DeleteUserList(DeleteUserListRequest) returns (Empty)

Bir UserList'i siler.

Yetkilendirme Başlıkları:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üstbilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak istek hesabına ayarlanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
GetUserList

rpc GetUserList(GetUserListRequest) returns (UserList)

UserList alır.

Yetkilendirme Başlıkları:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üstbilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak istek hesabına ayarlanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
ListUserLists

rpc ListUserLists(ListUserListsRequest) returns (ListUserListsResponse)

UserLists'i listeler.

Yetkilendirme Başlıkları:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üstbilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak istek hesabına ayarlanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager
UpdateUserList

rpc UpdateUserList(UpdateUserListRequest) returns (UserList)

Bir UserList'i günceller.

Yetkilendirme Başlıkları:

Bu yöntem, API'nin istek için erişimi nasıl yetkilendireceğini tanımlamak üzere aşağıdaki isteğe bağlı üstbilgileri destekler:

  • login-account: (İsteğe bağlı) Kimlik bilgilerinin Google Hesabı'nın kullanıcı olduğu hesabın kaynak adı. Ayarlanmamışsa varsayılan olarak istek hesabına ayarlanır. Biçim: accountTypes/{loginAccountType}/accounts/{loginAccountId}
  • linked-account: (İsteğe bağlı) login-account ile oluşturulmuş bir ürün bağlantısı olan hesabın kaynak adı. Biçim: accountTypes/{linkedAccountType}/accounts/{linkedAccountId}
Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/datamanager

AdEvent

Reklam etkinliği.

Alanlar
advertiser_id

string

Zorunlu. Reklam etkinliğinin reklamvereni için kimlik.

Bu kimlik, bağlantı akışında gönderilen kimlikle eşleşmelidir.

event_type

EventType

Zorunlu. Etkinliğin türü.

timestamp

Timestamp

Zorunlu. Etkinliğin gerçekleştiği zaman.

event_id

string

İsteğe bağlıdır. Arayan tarafından oluşturulan ve yönetilen, bu etkinliği benzersiz şekilde tanımlayan bir kimlik.

Birden fazla isteğe dahil edilen reklam etkinliklerinin yinelenenlerini kaldırmak istiyorsanız zorunludur. Aksi takdirde bu alan isteğe bağlıdır.

user_data

UserData

İsteğe bağlıdır. Etkinliğin ilişkilendirildiği kullanıcıyı temsil eden, kullanıcı tarafından sağlanan birden fazla veri parçası.

Aynı türde verilerin (ör. e-posta adresi) birden fazla örneğini sağlayabilirsiniz. Ne kadar çok veri sağlanırsa eşleşme bulunma olasılığı o kadar artar.

device_info

DeviceInfo

Zorunlu. Reklam etkinliği gerçekleştiğinde kullanılan cihaz hakkında toplanan bilgiler.

ip_address

string

İsteğe bağlıdır. Ölçüm için kullanılan IP adresi. Bu, DeviceInfo.ip_address ile aynı değer olmalıdır. Ölçüm için IP paylaşmak istemiyorsanız boş bırakın.

mobile_device_id

string

İsteğe bağlıdır. Reklamın yayınlandığı cihazın cihaz kimliği.

campaign_id

string

Zorunlu. İlişkilendirilmiş kampanyanın kimliği.

campaign_name

string

Zorunlu. İlişkili kampanyanın adı.

ad_group_id

string

İsteğe bağlıdır. İlişkili reklam grubunun kimliği.

ad_id

string

İsteğe bağlıdır. Gruptaki ilişkili reklamın kimliği.

ad_height

int32

İsteğe bağlıdır. Reklamın piksel cinsinden yüksekliği.

ad_width

int32

İsteğe bağlıdır. Reklamın piksel cinsinden genişliği.

region_code

string

İsteğe bağlıdır. ISO 3166-2 ülke ve alt bölümü.

source

string

Zorunlu. Google Analytics kaynağına benzer şekilde, reklamın platform kaynağı.

medium

string

Zorunlu. Google Analytics ortamına benzer şekilde, reklamın ortamı.

attribution_hint

AttributionHint

İsteğe bağlıdır. Bu reklam etkinliği için iş ortağı tarafından varsayılan ilişkilendirme durumu.

Bu yalnızca iş ortağının ilişkilendirmenin nasıl gerçekleştiğini varsaydığına dair bir sinyal olarak işlev görür ve nihai raporlarda bir sonuç zorlamaz.

viewability_info

ViewabilityInfo

Zorunlu. Yayınlanan reklamın görüntülenebilirliğiyle ilgili ayrıntılar.

event_subtype_oneof birleşik alanı. İsteğe bağlıdır. Reklam etkinliğinin türüyle ilgili ek sınıflandırma.

Saf numaralandırmalar dışındaki değerleri işlemek için ham dize kabul edilir. Mümkünse enum tercih edilir. event_subtype_oneof aşağıdakilerden yalnızca biri olabilir:

event_subtype

EventSubtype

Etkinlik alt türü için sıralama değeri.

event_subtype_string

string

Etkinlik alt türü için dize değeri.

ad_type_oneof birleşik alanı. İsteğe bağlıdır. Yayınlanan reklamın türü.

Saf numaralandırmalar dışındaki değerleri işlemek için ham dize kabul edilir. Mümkünse enum tercih edilir. ad_type_oneof aşağıdakilerden yalnızca biri olabilir:

ad_type

AdType

Reklam türü için enum değeri.

ad_type_string

string

Reklam türü için dize değeri.

ad_format_oneof birleşik alanı. İsteğe bağlıdır. Yayınlanan reklamın türü.

Saf numaralandırmalar dışındaki değerleri işlemek için ham dize kabul edilir. Mümkünse enum tercih edilir. ad_format_oneof aşağıdakilerden yalnızca biri olabilir:

ad_format

AdFormat

Reklam biçimi için enum değeri.

ad_format_string

string

Reklam biçimi için dize değeri.

ad_placement_oneof birleşik alanı. İsteğe bağlıdır. Sunulan reklamın yerleşimi.

Saf numaralandırmalar dışındaki değerleri işlemek için ham dize kabul edilir. Mümkünse enum tercih edilir. ad_placement_oneof aşağıdakilerden yalnızca biri olabilir:

ad_placement

AdPlacement

Reklam yerleşimi için enum değeri.

ad_placement_string

string

Reklam yerleşimi için dize değeri.

targeting_type_oneof birleşik alanı. İsteğe bağlıdır. Reklamı yayınlamak için kullanılan hedefleme türü.

Saf numaralandırmalar dışındaki değerleri işlemek için ham dize kabul edilir. Mümkünse enum tercih edilir. targeting_type_oneof aşağıdakilerden yalnızca biri olabilir:

targeting_type

TargetingType

Hedefleme türü için enum değeri.

targeting_type_string

string

Hedefleme türü için dize değeri.

platform_type_oneof birleşik alanı. İsteğe bağlıdır. Reklamın yayınlandığı platformun türü.

Saf numaralandırmalar dışındaki değerleri işlemek için ham dize kabul edilir. Mümkünse enum tercih edilir. platform_type_oneof aşağıdakilerden yalnızca biri olabilir:

platform_type

PlatformType

Platform türü için enum değeri.

platform_type_string

string

Platform türü için dize değeri.

platform_oneof birleşik alanı. İsteğe bağlıdır. Reklamın yayınlandığı platformla ilgili daha fazla ayrıntı.

Saf numaralandırmalar dışındaki değerleri işlemek için ham dize kabul edilir. Mümkünse enum tercih edilir. platform_oneof aşağıdakilerden yalnızca biri olabilir:

platform

Platform

Platform için enum değeri.

platform_string

string

Platform için dize değeri.

measurement_allowed

bool

İsteğe bağlıdır. Satırın, bölgesel yargı alanındaki geçerli gizlilik yasaları uyarınca ölçüm amacıyla kullanılmasına izin verilip verilmediğini gösterir.

EventSubtype

Reklam etkinliğinin türüyle ilgili ek sınıflandırma.

Sıralamalar
EVENT_SUBTYPE_UNSPECIFIED Belirtilmemiş etkinlik alt türü.
EVENT_SUBTYPE_IMPRESSION Gösterim etkinliği.
EVENT_SUBTYPE_ENGAGED_VIEW Etkileşimli görüntüleme etkinliği.
EVENT_SUBTYPE_ONSITE_CLICK Sitedeki tıklama etkinliği.
EVENT_SUBTYPE_OUTBOUND_CLICK Giden tıklama etkinliği.

EventType

Etkinliğin türü.

Sıralamalar
EVENT_TYPE_UNSPECIFIED Belirtilmemiş etkinlik türü.
EVENT_TYPE_VIEW Etkinliği görüntüleyin.
EVENT_TYPE_CLICK Tıklama etkinliği.

AdFormat

Yayınlanan reklamın biçimi.

Sıralamalar
AD_FORMAT_UNSPECIFIED Belirtilmemiş reklam biçimi.
AD_FORMAT_AR AR reklamı.
AD_FORMAT_AUDIO İşitsel reklam.
AD_FORMAT_BANNER Banner reklam.
AD_FORMAT_BUMPER Bumper reklam
AD_FORMAT_COLLECTION Koleksiyon reklamı.
AD_FORMAT_IMAGE Resim reklam.
AD_FORMAT_INTERACTIVE Etkileşimli reklam.
AD_FORMAT_INTERSTITIAL Geçiş reklamı.
AD_FORMAT_IN_FEED Feed içi reklam.
AD_FORMAT_IN_STREAM Yayın içi reklam.
AD_FORMAT_IN_STREAM_SKIPPABLE Atlanabilir yayın içi reklam.
AD_FORMAT_IN_STREAM_NON_SKIPPABLE Yayın içi atlanamayan reklam.
AD_FORMAT_NATIVE Doğal reklam.
AD_FORMAT_SHORTS Shorts reklamı.
AD_FORMAT_STORY Hikaye reklamı.
AD_FORMAT_SPONSORED Sponsorlu reklam.
AD_FORMAT_VIDEO Video reklam.

AdIdentifiers

Dönüşüm etkinliğini diğer online etkinliklerle (ör. reklam tıklamaları) eşleştirmek için kullanılan tanımlayıcılar ve diğer bilgiler.

Alanlar
session_attributes

string

İsteğe bağlıdır. Etkinlik ilişkilendirmesi ve modellemesi için oturum özellikleri.

gclid

string

İsteğe bağlıdır. Bu etkinlikle ilişkilendirilen Google tıklama kimliği (gclid).

gbraid

string

İsteğe bağlıdır. Uygulama etkinlikleriyle ilişkilendirilen ve iOS 14 veya sonraki sürümü yüklü iOS cihazlardan gelen tıklamalara yönelik tıklama tanımlayıcısı.

wbraid

string

İsteğe bağlıdır. Web etkinlikleriyle ilişkilendirilen ve iOS 14 veya sonraki sürümü yüklü iOS cihazlardan gelen tıklamalara yönelik tıklama tanımlayıcısı.

landing_page_device_info

DeviceInfo

İsteğe bağlıdır. Reklamla etkileşimden sonra reklamverenin sitesine yönlendirilirken kullanılan cihaz hakkında toplanan bilgiler (varsa).

mobile_device_id

string

İsteğe bağlıdır. Reklamverenler için mobil kimlik. Bu, iOS'te IDFA, Android'de AdID veya diğer platformların reklamverenler için tanımlayıcıları olabilir.

dclid

string

İsteğe bağlıdır. Bu etkinlikle ilişkili görüntülü reklam tıklama kimliği.

impression_id

string

İsteğe bağlıdır. Bu etkinlikle ilişkili gösterim kimliği.

match_id

string

İsteğe bağlıdır. Bu etkinliği önceki bir etkinlikle birleştirmek için kullanılan eşleşme kimliği alanı.

encrypted_user_ids[]

EncryptedUserId

İsteğe bağlıdır. Şifrelenmiş kullanıcı kimliklerinin sayısı.

ppid

string

İsteğe bağlıdır. Yayıncı tarafından tanımlanan, kimliği doğrulanmış (oturum açmış) bir kullanıcı için benzersiz tanımlayıcı.

visitor_ppid

string

İsteğe bağlıdır. Yayıncı tarafından tanımlanan, kimliği doğrulanmamış bir kullanıcı (oturum açmamış kullanıcı) için benzersiz tanımlayıcı.

AdPlacement

Sunulan reklamın yerleşimi.

Sıralamalar
AD_PLACEMENT_UNSPECIFIED Reklam yerleşimi belirtilmemiş.
AD_PLACEMENT_DISCOVER Keşfet yerleşimi.
AD_PLACEMENT_FEED Feed yerleşimi.
AD_PLACEMENT_HEADER Üstbilgi yerleşimi.
AD_PLACEMENT_HOME Ana sayfa yerleşimi.
AD_PLACEMENT_IN_CONTENT İçeriğe yerleştirme
AD_PLACEMENT_PROMOTED Tanıtılan yerleşim.
AD_PLACEMENT_STORY Hikaye yerleşimi.

AdType

Yayınlanan reklamın türü.

Sıralamalar
AD_TYPE_UNSPECIFIED Belirtilmemiş reklam türü.
AD_TYPE_DISPLAY Görüntülü reklam.
AD_TYPE_TEXT Metin reklam'ı seçin.
AD_TYPE_IMAGE Resim reklam.
AD_TYPE_RICH_MEDIA Rich media reklamı.
AD_TYPE_HTML HTML reklam
AD_TYPE_AUDIO İşitsel reklam.
AD_TYPE_VIDEO Video reklam.

AddressInfo

Kullanıcının adres bilgileri.

Alanlar
given_name

string

Zorunlu. Kullanıcının verilen (ad) adı, tümü küçük harflerle, noktalama işareti olmadan, başında veya sonunda boşluk olmadan ve SHA-256 olarak karma oluşturma işlemi uygulanmış şekilde.

family_name

string

Zorunlu. Kullanıcının soyadı (son adı), tümü küçük harf, noktalama işareti yok, başında veya sonunda boşluk yok ve SHA-256 olarak karma oluşturma işlemi uygulanmış.

region_code

string

Zorunlu. Kullanıcının adresinin ISO-3166-1 alfa-2 cinsinden 2 harfli bölge kodu.

postal_code

string

Zorunlu. Kullanıcının adresinin posta kodu.

address_line

string

İsteğe bağlıdır. Kullanıcının adresinin bulunduğu sokak ve numara. Yalnızca Google Analytics için kullanılır. Bu alan karma oluşturma işlemine tabi tutulur ve şifrelenmiş olabilir.

Anonimleştirmeden (hash) önce değeri normalleştirin:

  • Sembol karakterleri kaldırma
  • Küçük harfe dönüştürme
  • Baştaki ve sondaki boşlukları kaldırma
city

string

İsteğe bağlıdır. Kullanıcının adresinin bulunduğu şehir. Yalnızca Google Analytics için kullanılır.

Değer şu şekilde normalleştirilmelidir:

  • Sembol karakterleri kaldırma
  • Küçük harfe dönüştürme
  • Baştaki ve sondaki boşlukları kaldırma
administrative_area

string

İsteğe bağlıdır. Kullanıcının adresinin bağlı olduğu yer (eyalet/il). Yalnızca Google Analytics için kullanılır.

Değer şu şekilde normalleştirilmelidir:

  • Sembol karakterleri kaldırma
  • Küçük harfe dönüştürme
  • Baştaki ve sondaki boşlukları kaldırma

Yaş Aralığı

Demografik yaş aralıkları

Sıralamalar
AGE_RANGE_UNSPECIFIED Belirtilmedi.
AGE_RANGE_UNKNOWN Bilinmiyor.
AGE_RANGE_18_24 18-24 yaş aralığında
AGE_RANGE_25_34 25-34 yaş aralığında
AGE_RANGE_35_44 35-44 yaş aralığında
AGE_RANGE_45_54 45-54 yaş aralığında
AGE_RANGE_55_64 55-64 yaş aralığında
AGE_RANGE_65_UP 65 yaş ve üzeri

AttributionHint

Bu reklam etkinliği için iş ortağı tarafından varsayılan ilişkilendirme durumu.

Sıralamalar
ATTRIBUTION_HINT_UNSPECIFIED İlişkilendirme durumu bilinmiyor.
ATTRIBUTION_HINT_CONVERTED Dönüştürülmüş durumu.
ATTRIBUTION_HINT_NOT_CONVERTED Dönüştürülmedi durumu.

AudienceMember

Üzerinde işlem yapılacak kitle üyesi.

Alanlar
destination_references[]

string

İsteğe bağlıdır. Kitle üyesinin hangi Destination gönderileceğini tanımlar.

consent

Consent

İsteğe bağlıdır. Kullanıcının izin ayarı.

data birleşik alanı. Üzerinde işlem yapılacak tanımlayıcı verilerin türü. data aşağıdakilerden yalnızca biri olabilir:
user_data

UserData

Kullanıcıyı tanımlayan, kullanıcı tarafından sağlanan veriler.

pair_data

PairData

Yayıncı-Reklamveren Kimlik Eşleşmesi (PAIR) kimlikleri.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

mobile_data

MobileData

Kullanıcının mobil cihazlarını tanımlayan veriler.

user_id_data

UserIdData

Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcılarla ilgili veriler.

ppid_data

PpidData

Yayıncı tarafından sağlanan tanımlayıcılarla ilgili veriler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

composite_data

CompositeData

Birden fazla tanımlayıcı türünün grubu.

google_user_id_data

GoogleUserIdData

Şifrelenmiş Google kullanıcı kimlikleri.

partner_provided_id_data

PartnerProvidedIdData

İş ortağı tarafından sağlanan tanımlayıcılar.

AwsWrappedKeyInfo

AWS KMS anahtarıyla sarmalanmış bir veri şifreleme anahtarı.

Alanlar
key_type

KeyType

Zorunlu. Verileri şifrelemek için kullanılan algoritma türü.

role_arn

string

Zorunlu. KMS şifre çözme erişimi için üstlenilecek IAM rolünün Amazon Kaynak Adı. arn:{partition}:iam::{account_id}:role/{role_name} biçiminde olmalıdır.

kek_uri

string

Zorunlu. DEK'nin şifresini çözmek için kullanılan AWS KMS anahtarının URI'si. arn:{partition}:kms:{region}:{account_id}:key/{key_id} veya aws-kms://arn:{partition}:kms:{region}:{account_id}:key/{key_id} biçiminde olmalıdır.

encrypted_dek

string

Zorunlu. Base64 kodlu şifrelenmiş veri şifreleme anahtarı.

KeyType

Verileri şifrelemek için kullanılan algoritma türü.

Sıralamalar
KEY_TYPE_UNSPECIFIED Belirtilmemiş anahtar türü. Hiç kullanılmamalıdır.
XCHACHA20_POLY1305 Algoritma XChaCha20-Poly1305

Referans

Analizlerin karşılaştırıldığı temel ölçütler.

Alanlar
baseline birleşik alanı. Analizlerin karşılaştırıldığı temel konum. baseline aşağıdakilerden yalnızca biri olabilir:
baseline_location

Location

İsteğin temel konum bilgisi. Temel konum, istenen bölgelerin BİLEŞİK VEYA listesidir.

location_auto_detection_enabled

bool

Doğru olarak ayarlanırsa hizmet, analizler için temel konumu otomatik olarak algılamaya çalışır.

Konum

İsteğin temel konum bilgisi. Temel konum, istenen bölgelerin ISO 3166-1 alfa-2 bölge kodlarının OR listesindedir.

Alanlar
region_codes[]

string

ISO 3166-1 alfa-2 bölge kodlarının listesi.

CartData

Etkinlikle ilişkili alışveriş sepeti verileri.

Alanlar
merchant_id

string

İsteğe bağlıdır. Öğelerle ilişkili Merchant Center kimliği.

merchant_feed_label

string

İsteğe bağlıdır. Öğelerin feed'iyle ilişkili Merchant Center feed etiketi.

merchant_feed_language_code

string

İsteğe bağlıdır. Öğelerinizin yüklendiği Merchant Center feed'iyle ilişkili ISO 639-1 dil kodu.

transaction_discount

double

İsteğe bağlıdır. İşlemle ilişkili tüm indirimlerin toplamı.

items[]

Item

İsteğe bağlıdır. Etkinlikle ilişkili öğelerin listesi.

coupon_codes[]

string

İsteğe bağlıdır. Sepete uygulanan kupon kodlarının listesi. Sepet düzeyindeki ve öğe düzeyindeki kupon kodları birbirinden bağımsızdır.

Etkinlik bir Google Analytics hedefi içinse yalnızca tek bir kupon kodu sağlayın. Google Analytics, ek kupon kodlarını yok sayar.

CompositeData

Bir kullanıcı için tanımlayıcılar ve ilişkili veriler içeren bileşik veriler. En az bir user_data veya ip_data zorunludur.

Alanlar
user_data

UserData

İsteğe bağlıdır. Kullanıcıyı tanımlayan, kullanıcı tarafından sağlanan veriler.

ip_data[]

IpData

İsteğe bağlıdır. Kitle oluşturmak için kullanılan müşteri etkileşimini temsil eden IP adresi verileri.

Kullanıcı için Dijital Pazarlar Yasası (DMA) izin ayarları.

Alanlar
ad_user_data

ConsentStatus

İsteğe bağlıdır. Kullanıcının reklam kullanıcı verilerine izin verip vermediğini gösterir.

ad_personalization

ConsentStatus

İsteğe bağlıdır. Kullanıcının reklam kişiselleştirmeye izin verip vermediğini gösterir.

ConsentStatus

Kullanıcının izin verip vermediğini, izni reddedip etmediğini veya izni belirtip belirtmediğini gösterir.

Sıralamalar
CONSENT_STATUS_UNSPECIFIED Belirtilmedi.
CONSENT_GRANTED İzin verildi.
CONSENT_DENIED Reddedildi.

ContactIdInfo

CONTACT_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Alanlar
match_rate_percentage

int32

Yalnızca çıkış. Müşteri Eşleştirme kullanıcı listeleri için eşleşme oranı.

data_source_type

DataSourceType

İsteğe bağlıdır. Değiştirilemez. Yüklenen verilerin kaynağı

CoordinatorKeyInfo

Koordinatör anahtarı hakkında bilgiler.

Alanlar
key_id

string

Zorunlu. Seçilen koordinatör anahtarının kimliği.

CreatePartnerLinkRequest

PartnerLink kaynağı oluşturma isteği PartnerLink değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Bu iş ortağı bağlantıları koleksiyonunun sahibi olan üst öğe. Biçim: accountTypes/{account_type}/accounts/{account}

CreateUserListDirectLicenseRequest

UserListDirectLicense kaynağı oluşturma isteği

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisans verilen kullanıcı listesinin sahibi olan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

user_list_direct_license

UserListDirectLicense

Zorunlu. Kullanıcı listesi oluşturmak için doğrudan lisans.

CreateUserListGlobalLicenseRequest

UserListGlobalLicense kaynağı oluşturma isteği

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisans verilen kullanıcı listesinin sahibi olan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

user_list_global_license

UserListGlobalLicense

Zorunlu. Kullanıcı listesi oluşturmak için genel lisans.

CreateUserListRequest

CreateUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Bu kullanıcı listesinin oluşturulacağı üst hesap. Biçim: accountTypes/{account_type}/accounts/{account}

user_list

UserList

Zorunlu. Oluşturulacak kullanıcı listesi.

validate_only

bool

İsteğe bağlıdır. Doğruysa istek doğrulanır ancak yürütülmez.

ÖzelleştirilebilenDeğişken

Reklam dönüşümleri için özelleştirilebilen değişken.

Alanlar
variable

string

İsteğe bağlıdır. Ayarlanacak özelleştirilebilen değişkenin adı. Değişken, belirtilen hedef için bulunamazsa yoksayılır.

value

string

İsteğe bağlıdır. Özelleştirilebilen değişken için depolanacak değer.

destination_references[]

string

İsteğe bağlıdır. Özel değişkenin Event.destination_references öğelerinden hangisine gönderileceğini belirlemek için kullanılan referans dizesi. Boş bırakılırsa Event.destination_references kullanılır.

CustomerType

Etkinlikle ilişkili müşterinin türü.

Sıralamalar
CUSTOMER_TYPE_UNSPECIFIED Belirtilmemiş CustomerType. Hiç kullanılmamalıdır.
NEW Müşteri, reklamveren için yeni olmalıdır.
RETURNING Müşteri, reklamverene geri dönüyorsa
REENGAGED Müşteri, reklamverenle yeniden etkileşime geçmiştir.

CustomerValueBucket

Müşterinin reklamveren tarafından değerlendirilen değeri.

Sıralamalar
CUSTOMER_VALUE_BUCKET_UNSPECIFIED Belirtilmemiş CustomerValueBucket. Hiç kullanılmamalıdır.
LOW Müşterinin değeri düşük.
MEDIUM Müşteri, orta değere sahiptir.
HIGH Müşteri yüksek değere sahip.

DataSourceType

Yüklenen verilerin kaynağını gösterir.

Sıralamalar
DATA_SOURCE_TYPE_UNSPECIFIED Belirtilmedi.
DATA_SOURCE_TYPE_FIRST_PARTY Yüklenen veriler birinci taraf verileridir.
DATA_SOURCE_TYPE_THIRD_PARTY_CREDIT_BUREAU Yüklenen veriler, üçüncü taraf bir kredi bürosuna aittir.
DATA_SOURCE_TYPE_THIRD_PARTY_VOTER_FILE Yüklenen veriler, üçüncü taraf seçmen dosyasından alınmıştır.
DATA_SOURCE_TYPE_THIRD_PARTY_PARTNER_DATA Yüklenen veriler, üçüncü taraf iş ortağı verileridir.

DeletePartnerLinkRequest

PartnerLink kaynağını silme isteği. google.protobuf.Empty değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Silinecek iş ortağı bağlantısının kaynak adı. Biçim: accountTypes/{account_type}/accounts/{account}/partnerLinks/{partner_link}

DeleteUserListRequest

DeleteUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Silinecek kullanıcı listesinin adı. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

validate_only

bool

İsteğe bağlıdır. Doğruysa istek doğrulanır ancak yürütülmez.

Hedef

Veri gönderdiğiniz Google ürünü. Örneğin, Google Ads hesabı.

Alanlar
reference

string

İsteğe bağlıdır. Bu Destination kaynağının, istek içinde benzersiz olan kimliği. IngestEventsRequest ve IngestAudienceMembersRequest içinde bu Destination öğesine referans vermek için kullanılır.

login_account

ProductAccount

İsteğe bağlıdır. Bu API çağrısını yapmak için kullanılan hesap. operating_account verilerini eklemek veya kaldırmak için bu login_account, operating_account yazma erişimine sahip olmalıdır. Örneğin, operating_account yönetici hesabı veya operating_account ile bağlantısı olan bir hesap.

linked_account

ProductAccount

İsteğe bağlıdır. Arayan kullanıcının login_account, oluşturulmuş bir hesap bağlantısı aracılığıyla erişebildiği hesap. Örneğin, bir veri iş ortağının login_account, bir müşterinin linked_account erişebilir. İş ortağı, linked_account hizmetinden başka bir operating_account hizmetine veri göndermek için bu alanı kullanabilir.

operating_account

ProductAccount

Zorunlu. Verilerin gönderileceği veya kaldırılacağı hesap.

product_destination_id

string

İsteğe bağlıdır. Ürün hesabında verilerin aktarılacağı nesne. Örneğin, Google Ads kitle kimliği, Display & Video 360 kitle kimliği veya Google Ads dönüşüm işlemi kimliği.

Bu alan, Google Ad Manager etkinlik alımı ve kullanıcı alımı için isteğe bağlıdır. Diğer tüm kullanım alanları için zorunludur.

DeviceInfo

Etkinlik gerçekleştiğinde kullanılan cihazla ilgili bilgiler (varsa).

Alanlar
user_agent

string

İsteğe bağlıdır. Belirli bir bağlam için cihazın kullanıcı aracısı dizesi.

ip_address

string

İsteğe bağlıdır. Belirli bir bağlam için cihazın IP adresi. Coğrafi kontroller için AdEvent içinde kullanıldığında zorunludur.

category

string

İsteğe bağlıdır. Cihazın kategorisi. Örneğin, "masaüstü", "tablet", "mobil", "akıllı TV".

language_code

string

İsteğe bağlıdır. Cihazın kullandığı dil, ISO 639-1 biçiminde.

screen_height

int32

İsteğe bağlıdır. Ekranın piksel cinsinden yüksekliği.

screen_width

int32

İsteğe bağlıdır. Ekranın piksel cinsinden genişliği.

operating_system

string

İsteğe bağlıdır. Cihazın işletim sistemi veya platformu.

operating_system_version

string

İsteğe bağlıdır. İşletim sisteminin veya platformun sürümü.

model

string

İsteğe bağlıdır. Cihazın modeli.

brand

string

İsteğe bağlıdır. Cihazın markası.

browser

string

İsteğe bağlıdır. Tarayıcının markası veya türü.

browser_version

string

İsteğe bağlıdır. Tarayıcının sürümü.

Kodlama

Karma oluşturma işlemi uygulanmış kişisel verilerin kodlama türü.

Sıralamalar
ENCODING_UNSPECIFIED Belirtilmemiş kodlama türü. Hiç kullanılmamalıdır.
HEX Onaltılık kodlama.
BASE64 Base64 kodlaması.

EncryptedUserId

İlişkilendirme için kullanılmak üzere verilen kullanıcı tanımlayıcısı. Bu özellik kullanılıyorsa tüm alanların doldurulması zorunludur.

Alanlar
encrypted_id

string

Zorunlu. Alfanümerik şifrelenmiş kimlik.

entity_type

EncryptionEntityType

Zorunlu. Şifreleme varlık türü. Bu, reklam yayınlama veya veri aktarımı için şifreleme yapılandırmasıyla eşleşmelidir.

entity_id

int64

Zorunlu. Şifreleme varlığı kimliği. Bu, reklam yayınlama veya veri aktarımı için şifreleme yapılandırmasıyla eşleşmelidir.

source

EncryptionSource

Zorunlu. Şifrelenmiş çerezin reklam yayınından (%m makrosu) mı yoksa Veri Aktarımı'ndan mı alındığını açıklar.

EncryptionEntityType

Şifreleme varlık türü.

Sıralamalar
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED Belirtilmemiş şifreleme varlık türü.
CAMPAIGN_MANAGER_ACCOUNT Campaign Manager 360 hesabı.
CAMPAIGN_MANAGER_ADVERTISER Campaign Manager 360 reklamvereni.
DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni.
GOOGLE_ADS_CUSTOMER Google Ads müşterisi.
GOOGLE_AD_MANAGER_NETWORK_CODE Google Ad Manager ağ kodu.

EncryptionSource

Şifreleme kaynağı.

Sıralamalar
ENCRYPTION_SOURCE_UNSPECIFIED Belirtilmemiş şifreleme kaynağı.
AD_SERVING Reklam sunumu şifreleme kaynağı.
DATA_TRANSFER Veri aktarımı şifreleme kaynağı.

EncryptionInfo

Alınan verilerin şifreleme bilgileri.

Alanlar
wrapped_key birleşik alanı. Verileri şifrelemek için kullanılan sarmalanmış anahtar. wrapped_key aşağıdakilerden yalnızca biri olabilir:
gcp_wrapped_key_info

GcpWrappedKeyInfo

Google Cloud Platform sarmalanmış anahtar bilgileri.

aws_wrapped_key_info

AwsWrappedKeyInfo

Amazon Web Services sarmalanmış anahtar bilgileri.

coordinator_key_info

CoordinatorKeyInfo

Seçilen koordinatör anahtarıyla ilgili önemli bilgiler.

Bu özellik IngestEvents, IngestAudienceMembers ve RemoveAudienceMembers yöntemleri için desteklenmez.

ErrorCount

Belirli bir hata nedenine ait hata sayısı.

Alanlar
record_count

int64

Belirli bir nedenle yüklenemeyen kayıtların sayısı.

reason

ProcessingErrorReason

Başarısız olan kayıtların hata nedeni.

ErrorInfo

Her hata türü için hata sayısı.

Alanlar
error_counts[]

ErrorCount

Hata listesi ve hata nedenine göre sayı. Bazı durumlarda doldurulmayabilir.

ErrorReason

Data Manager API'nin hata nedenleri. NOT: Bu enum dondurulmamıştır ve gelecekte yeni değerler eklenebilir.

Sıralamalar
ERROR_REASON_UNSPECIFIED Bu varsayılan değeri kullanmayın.
INTERNAL_ERROR Dahili bir hata oluştu.
DEADLINE_EXCEEDED İsteğe yanıt verilmesi çok uzun sürdü.
RESOURCE_EXHAUSTED Çok fazla istek var.
NOT_FOUND Kaynak bulunamadı.
PERMISSION_DENIED Kullanıcının izni yok veya kaynak bulunamadı.
INVALID_ARGUMENT İstekle ilgili bir sorun vardı.
REQUIRED_FIELD_MISSING Zorunlu alan eksik.
INVALID_FORMAT Biçim geçersiz.
INVALID_HEX_ENCODING HEX olarak kodlanmış değer hatalı biçimlendirilmiş.
INVALID_BASE64_ENCODING Base64 kodlu değer hatalı biçimlendirilmiş.
INVALID_SHA256_FORMAT SHA-256 olarak kodlanmış değer hatalı biçimlendirilmiş.
INVALID_POSTAL_CODE Posta kodu geçerli değil.
INVALID_COUNTRY_CODE

Kullanımdan kaldırıldı: Enum, Data Manager API'de kullanılmıyor.

INVALID_ENUM_VALUE Enum değeri kullanılamaz.
INVALID_USER_LIST_TYPE Kullanıcı listesi türü bu istek için geçerli değil.
INVALID_AUDIENCE_MEMBER Bu kitle üyesi geçerli değil.
TOO_MANY_AUDIENCE_MEMBERS İstek başına izin verilen maksimum kitle üyesi sayısı 10.000'dir.
TOO_MANY_USER_IDENTIFIERS Kitle üyesi başına izin verilen maksimum kullanıcı tanımlayıcısı sayısı 10'dur.
TOO_MANY_DESTINATIONS İstek başına izin verilen maksimum hedef sayısı 10'dur.
INVALID_DESTINATION Bu hedef geçerli değil.
DATA_PARTNER_USER_LIST_MUTATE_NOT_ALLOWED Veri İş Ortağı, kullanıcı listesinin sahibi olan işletme hesabına erişemiyor.
INVALID_MOBILE_ID_FORMAT Mobil kimlik biçimi geçerli değil.
INVALID_USER_LIST_ID Kullanıcı listesi geçerli değil.
MULTIPLE_DATA_TYPES_NOT_ALLOWED Tek bir istekte birden fazla veri türünün alınmasına izin verilmez.
DIFFERENT_LOGIN_ACCOUNTS_NOT_ALLOWED_FOR_DATA_PARTNER Bir Veri İş Ortağı giriş hesabı içeren hedef yapılandırmaları, tüm hedef yapılandırmalarında aynı giriş hesabına sahip olmalıdır.
TERMS_AND_CONDITIONS_NOT_SIGNED Gerekli hükümler ve koşullar kabul edilmedi.
INVALID_NUMBER_FORMAT Geçersiz numara biçimi.
INVALID_CONVERSION_ACTION_ID Dönüşüm işlemi kimliği geçerli değil.
INVALID_CONVERSION_ACTION_TYPE Dönüşüm işlemi türü geçerli değil.
INVALID_CURRENCY_CODE Para birimi kodu desteklenmiyor.
INVALID_EVENT Bu etkinlik geçerli değil.
TOO_MANY_EVENTS İstek başına izin verilen maksimum etkinlik sayısı 10.000'dir.
DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS Hedef hesapta potansiyel müşteriler için gelişmiş dönüşümler etkinleştirilmemiş.
DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS Google müşteri verileri politikaları nedeniyle hedef hesapta gelişmiş dönüşümler kullanılamıyor. Google temsilcinizle iletişime geçin.
DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Hedef hesap, gelişmiş dönüşümlerin şartlarını kabul etmemiştir.
DUPLICATE_DESTINATION_REFERENCE İstekteki iki veya daha fazla hedef aynı referansa sahip.
UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER Veri iş ortağı yetkilendirmesi için desteklenmeyen işletim hesabı.
UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER Veri iş ortağı yetkilendirmesi için desteklenmeyen bağlı hesap.
NO_IDENTIFIERS_PROVIDED Etkinlik verileri, kullanıcı tanımlayıcıları veya reklam tanımlayıcıları içermez. Floodlight etkinliği alımında bu hata, isteklerin reklam tanımlayıcı içermediğini gösterir.
INVALID_PROPERTY_TYPE Mülk türü desteklenmiyor.
INVALID_STREAM_TYPE Akış türü desteklenmiyor.
LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT Bağlı hesap yalnızca giriş hesabı DATA_PARTNER olduğunda desteklenir.
OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH Giriş hesabı, söz konusu kullanım alanında kullanılan işletim hesabıyla aynı olmalıdır.
EVENT_TIME_INVALID Etkinlik, kabul edilebilir zaman aralığında gerçekleşmedi.
RESERVED_NAME_USED Parametre, ayrılmış bir ad kullanıyor.
INVALID_EVENT_NAME Etkinlik adı desteklenmiyor.
NOT_ALLOWLISTED Hesap, söz konusu özellik için izin verilenler listesinde değil.
INVALID_REQUEST_ID Bir isteğin durumunu almak için kullanılan istek kimliği geçerli değil. Durum yalnızca başarılı olan ve validate_only=true içermeyen istekler için alınabilir.
MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT Bir etkinliğin 2 veya daha fazla Google Analytics hedefi vardı.
FIELD_VALUE_TOO_LONG Alan değerinin uzunluğu çok fazla.
FIELD_VALUE_TOO_SHORT Alan değerinin uzunluğu çok kısa.
TOO_MANY_ELEMENTS İstek içinde bir listede çok fazla öğe var.
TOO_FEW_ELEMENTS İstek listesinde çok az öğe var.
ALREADY_EXISTS Kaynak zaten mevcut.
IMMUTABLE_FIELD_FOR_UPDATE Güncelleme isteği için değiştirilemez bir alan ayarlanmaya çalışıldı.
INVALID_RESOURCE_NAME Kaynak adı geçersiz.
INVALID_FILTER Sorgu filtresi geçersiz.
INVALID_UPDATE_MASK Güncelleme maskesi geçersiz.
INVALID_PAGE_TOKEN Sayfa jetonu geçersiz.
CANNOT_UPDATE_DISABLED_LICENSE Devre dışı bırakılmış bir lisans güncellenemez.
CANNOT_CREATE_LICENSE_FOR_SENSITIVE_USERLIST Hassas kullanıcı listeleri bu müşteriye lisanslanamaz.
INSUFFICIENT_COST Bu lisans için maliyet çok düşük.
CANNOT_DISABLE_LICENSE Bayi lisansı kullanıldığı için devre dışı bırakılamaz.
INVALID_CLIENT_ACCOUNT_ID Geçersiz müşteri hesabı kimliği.
PRICING_ONLY_ZERO_COST_ALLOWED Bu müşteri hesabı için sıfır olmayan maliyete izin verilmiyor.
PRICE_TOO_HIGH Bu lisans için maliyet çok yüksek.
CUSTOMER_NOT_ALLOWED_TO_CREATE_LICENSE Müşterinin lisans oluşturmasına izin verilmiyor.
INVALID_PRICING_END_DATE Bu lisans için fiyatlandırma bitiş tarihi geçersiz.
CANNOT_LICENSE_LOGICAL_LIST_WITH_LICENSED_OR_SHARED_SEGMENT Paylaşılan veya lisanslı segment içeren mantıksal kullanıcı listeleri lisanslanamaz.
MISMATCHED_ACCOUNT_TYPE İstekle gönderilen müşteri müşterisinin hesap türü, müşterinin gerçek hesap türüyle eşleşmiyor.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_LICENSE_TYPE Lisans türü, medya paylaşım maliyetini desteklemiyor.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_CLIENT_CUSTOMER Müşteri türü, medya paylaşım maliyetini desteklemiyor.
INVALID_MEDIA_SHARE_COST Geçersiz medya paylaşımı maliyeti.
INVALID_COST_TYPE Geçersiz maliyet türü.
MEDIA_SHARE_COST_NOT_ALLOWED_FOR_NON_COMMERCE_USER_LIST UserList türü, medya paylaşım maliyetini desteklemez.
MAX_COST_NOT_ALLOWED Maksimum maliyete yalnızca cost_type MEDIA_SHARE için izin verilir.
COMMERCE_AUDIENCE_CAN_ONLY_BE_DIRECTLY_LICENSED Ticari kitle yalnızca doğrudan lisanslanabilir.
INVALID_DESCRIPTION Açıklama geçerli değil.
INVALID_DISPLAY_NAME Görünen ad geçerli değil.
DISPLAY_NAME_ALREADY_USED Görünen ad, hesap için başka bir kullanıcı listesinde zaten kullanılıyor.
OWNERSHIP_REQUIRED_FOR_UPDATE Kullanıcı listesini değiştirmek için sahiplik gerekir.
USER_LIST_MUTATION_NOT_SUPPORTED Kullanıcı listesi türü salt okunurdur ve mutasyonu desteklemez.
SENSITIVE_USER_LIST_IMMUTABLE Gizlilik açısından hassas olan veya yasal olarak reddedilen bir kullanıcı listesi, harici kullanıcılar tarafından değiştirilemez.
BILLABLE_RECORD_COUNT_IMMUTABLE Yeniden pazarlama kullanıcı listesinin faturalandırılabilir kayıt alanı, ayarlandıktan sonra değiştirilemez.
USER_LIST_NAME_RESERVED Kullanıcı listesi adı, sistem listeleri için ayrılmıştır.
ADVERTISER_NOT_ALLOWLISTED_FOR_UPLOADED_DATA Reklamverenin, reklamveren tarafından yüklenen verilerden oluşturulan yeniden pazarlama listelerini kullanabilmesi için izin verilenler listesine eklenmesi gerekir.
UNSUPPORTED_PARTNER_AUDIENCE_SOURCE İş ortağı kitlesi kaynağı, kullanıcı listesi türü için desteklenmez.
COMMERCE_PARTNER_NOT_ALLOWED commerce_partner alanının ayarlanması yalnızca partner_audience_source alanı COMMERCE_AUDIENCE ise desteklenir.
UNSUPPORTED_PARTNER_AUDIENCE_INFO partner_audience_info alanı, kullanıcı listesi türü için desteklenmez.
PARTNER_MATCH_FOR_MANAGER_ACCOUNT_DISALLOWED İş Ortağı Eşleştirme kullanıcı listeleri, yönetici hesapları tarafından oluşturulamaz.
DATA_PARTNER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Veri iş ortağı, THIRD_PARTY_PARTNER_DATA için izin verilenler listesinde değil.
ADVERTISER_TOS_NOT_ACCEPTED Reklamveren, iş ortağının hizmet şartlarını kabul etmemiştir.
ADVERTISER_NOT_ALLOWLISTED_FOR_THIRD_PARTY_PARTNER_DATA Reklamveren, THIRD_PARTY_PARTNER_DATA için izin verilenler listesinde değil.
USER_LIST_TYPE_NOT_SUPPORTED_FOR_ACCOUNT Bu kullanıcı listesi türü bu hesapta desteklenmiyor.
INVALID_COMMERCE_PARTNER commerce_partner alanı geçersiz.
CUSTOMER_NOT_ALLOWLISTED_FOR_COMMERCE_AUDIENCE Veri sağlayıcı, ticari kitleler oluşturmak için izin verilenler listesinde değil.
UNSUPPORTED_USER_LIST_UPLOAD_KEY_TYPES Kullanıcı listesi yükleme anahtarı türleri desteklenmez.
UNSUPPORTED_INGESTED_USER_LIST_INFO_CONFIG Alınan kullanıcı listesi bilgisi yapılandırması desteklenmiyor.
UNSUPPORTED_ACCOUNT_TYPES_FOR_USER_LIST_TYPE Hesap türleri, kullanıcı listesi türü için desteklenmez.
MEMBERSHIP_DURATION_TOO_LONG Kullanıcı listesi üyelik süresi çok uzun.
INVALID_MERCHANT_ID merchant_id alanı geçerli değil.
EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED Müşteride, AB siyasi reklamcılığı beyanı olmayan ve muafiyetten yararlanmayan kampanyalar var.
ACCOUNT_INELIGIBLE_FOR_STORE_SALES Hesap, mağaza satışları için uygun değil.
INVALID_MERCHANT_FEED_LANGUAGE_CODE Satıcı feed'i dil kodu geçerli değil.
INVALID_REGION_CODE Bölge kodu geçerli değil.
INVALID_SUBDIVISION_CODE Alt bölüm kodu geçerli değil.
INVALID_SUBCONTINENT_CODE Alt kıta kodu geçerli değil.
INVALID_CONTINENT_CODE Kıta kodu geçerli değil.
INVALID_DEVICE_CATEGORY Cihaz kategorisi geçerli değil.
BOTH_CLIENT_ID_AND_APP_INSTANCE_ID_NOT_ALLOWED Hem app_instance_id hem de client_id ayarlanmış.
GOOGLE_ANALYTICS_SUBPROPERTY_OR_ROLLUP_PROPERTY_NOT_ALLOWED Google Analytics mülkü bir alt mülk veya toplayıcı mülk olmalıdır.
THIRD_PARTY_USER_DATA_NOT_ALLOWED Üçüncü taraf kullanıcı verileri yalnızca veri iş ortakları tarafından ayarlanabilir.
INVALID_COUPON_CODE Kupon kodu geçerli değil.
EVENT_SOURCE_AND_DESTINATION_MISMATCH Etkinlik kaynağı türü, hedef türüyle eşleşmiyor.
DESTINATION_ACCOUNT_TYPE_MISMATCH Hedef hesap türü, belirtilen hesap kimliğiyle eşleşmiyor.
CUSTOM_VARIABLE_VALUE_CONTAINS_PII Özelleştirilebilen değişken değeri, kimliği tanımlayabilecek bilgiler (PII) içeriyor.
CUSTOM_VARIABLE_NOT_ENABLED Özelleştirilebilen değişken etkin değil.
INVALID_CUSTOM_VARIABLE_VALUE Özelleştirilebilen değişkenin değeri geçersiz.
CUSTOM_VARIABLE_NOT_FOUND Hedefte, belirtilen variable ile eşleşen bir ada sahip özel değişken yok.
TOO_MANY_USERS İstek başına izin verilen maksimum kullanıcı sayısı 10.000'dir.
BASELINE_LOCATION_AUTO_DETECTION_FAILED İsteğin location_auto_detection_enabled alanı true olarak ayarlandı ancak temel konumun otomatik olarak algılanması başarısız oldu.
INSIGHTS_MISSING_FOR_DIMENSION Bu boyutla ilgili analizler eksik.
INVALID_REMOVE_AS_OF_TIME Kaldırma tarihi geçmişte veya şu anda olmalıdır. Kitle üyelerini kaldırmak için gelecekteki zaman damgalarına izin verilmez.
REQUEST_TOO_OLD İstek durumu, API bir istek aldıktan sonra yalnızca yaklaşık 50 gün boyunca kullanılabilir.
CONVERSION_ACTION_TOO_RECENTLY_CREATED Dönüşüm işlemi çok kısa süre önce oluşturuldu.
INVALID_AD_IDENTIFIER_FOR_ACCOUNT

Reklam tanımlayıcısı hesaba ait değil.

Örneğin, gclid, hedefin operating_account ve product_destination_id ile ilişkilendirilmemiş.

Etkinlik

Kullanıcının bir reklamverenin web sitesi veya uygulamasıyla etkileşimini temsil eden bir etkinlik.

Alanlar
destination_references[]

string

İsteğe bağlıdır. Hedefi belirlemek için kullanılan referans dizesi. Boşsa etkinlik, istekteki tüm destinations öğelerine gönderilir.

transaction_id

string

İsteğe bağlıdır. Bu etkinliğin benzersiz tanımlayıcısı. Etiket dönüşümleri için ek veri kaynağı olarak gönderilen etkinlikler için gereklidir.

event_timestamp

Timestamp

Zorunlu. Etkinliğin gerçekleştiği zaman.

last_updated_timestamp

Timestamp

İsteğe bağlıdır. Etkinliğin son güncellendiği zaman.

user_data

UserData

İsteğe bağlıdır. Etkinliğin ilişkilendirildiği kullanıcıyı temsil eden, kullanıcı tarafından sağlanan veri parçaları.

consent

Consent

İsteğe bağlıdır. İlişkili kullanıcının farklı izin türleri verip vermediği hakkında bilgiler.

ad_identifiers

AdIdentifiers

İsteğe bağlıdır. Dönüşüm etkinliğini diğer online etkinliklerle (ör. reklam tıklamaları) eşleştirmek için kullanılan tanımlayıcılar ve diğer bilgiler.

currency

string

İsteğe bağlıdır. Bu etkinlikteki tüm parasal değerlerle ilişkili para birimi kodu.

event_source

EventSource

İsteğe bağlıdır. Etkinliğin gerçekleştiği yerle (web, uygulama, mağaza vb.) ilgili sinyal.

event_device_info

DeviceInfo

İsteğe bağlıdır. Etkinlik gerçekleştiğinde kullanılan cihaz hakkında toplanan bilgiler (varsa).

cart_data

CartData

İsteğe bağlıdır. İşlem ve etkinlikle ilişkili öğeler hakkında bilgi.

custom_variables[]

CustomVariable

İsteğe bağlıdır. Dönüşüm kapsayıcılarına (dönüşüm işlemi veya FL etkinliği) gönderilecek ek anahtar/değer çifti bilgileri.

experimental_fields[]

ExperimentalField

İsteğe bağlıdır. Sonunda API'nin bir parçası olarak tanıtılabilecek deneysel alanlar için anahtar/değer çiftlerinin listesi.

user_properties

UserProperties

İsteğe bağlıdır. Etkinliğin gerçekleştiği sırada kullanıcı hakkında reklamveren tarafından değerlendirilen bilgiler.

event_name

string

İsteğe bağlıdır. Etkinliğin adı. GA4 etkinlikleri için gereklidir.

client_id

string

İsteğe bağlıdır. Bu GA4 web akışı için bir web istemcisinin kullanıcı örneğinin benzersiz tanımlayıcısı.

user_id

string

İsteğe bağlıdır. Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcı.

additional_event_parameters[]

EventParameter

İsteğe bağlıdır. Diğer yapılandırılmış alanlar kullanılarak belirtilmemiş, etkinliğe dahil edilecek tüm etkinlik parametrelerinin bulunduğu bir grup.

third_party_user_data

UserData

İsteğe bağlıdır. user_data parametresinde sağlanan verilerle aynı türde verilerdir ancak açıkça üçüncü tarafa ait olarak sağlandığı ve birinci taraf reklamveren verisi olmadığı belirtilir.

event_location

EventLocation

İsteğe bağlıdır. Bu etkinlik gerçekleştiğinde kullanıcının konumu hakkında toplanan bilgiler.

app_instance_id

string

İsteğe bağlıdır. Bu GA4 uygulama akışı için bir uygulama istemcisinin kullanıcı örneğinin benzersiz tanımlayıcısı.

conversion_value

double

İsteğe bağlıdır. Değere dayalı dönüşümler için etkinlikle ilişkili dönüşüm değeri.

conversion_count

double

İsteğe bağlıdır. Saymaya dayalı dönüşümler için etkinlikle ilişkili dönüşüm miktarı.

EventLocation

Etkinliğin gerçekleştiği konum.

Alanlar
store_id

string

İsteğe bağlıdır. Mağaza satışları için zorunludur. Etkinliğin gerçekleştiği fiziksel mağazayı temsil eden tanımlayıcı.

city

string

İsteğe bağlıdır. Etkinliğin gerçekleştiği şehrin adı.

subdivision_code

string

İsteğe bağlıdır. Etkinliğin gerçekleştiği ISO 3166-2 alt bölüm kodu.

region_code

string

İsteğe bağlıdır. Kullanıcının adresinin 2 harfli CLDR bölge kodu.

subcontinent_code

string

İsteğe bağlıdır. Etkinliğin gerçekleştiği alt kıtanın UN M49 biçimindeki kodu.

continent_code

string

İsteğe bağlıdır. Etkinliğin gerçekleştiği yerin UN M49 biçimindeki kıta kodu.

EventParameter

GA4 etkinlikleri için etkinlik parametresi.

Alanlar
parameter_name

string

Zorunlu. Kullanılacak parametrenin adı.

value

string

Zorunlu. Ayarlanacak parametrenin değerinin dize gösterimi.

EventSource

Etkinliğin kaynağı.

Sıralamalar
EVENT_SOURCE_UNSPECIFIED Belirtilmemiş EventSource. Hiç kullanılmamalıdır.
WEB Etkinlik, web tarayıcısından oluşturuldu.
APP Etkinlik, bir uygulamadan oluşturuldu.
IN_STORE Etkinlik, mağaza içi bir işlemden oluşturuldu.
PHONE Etkinlik, telefon görüşmesinden oluşturuldu.
MESSAGE Etkinlik, bir iletiden oluşturuldu.
OTHER Etkinlik, diğer kaynaklardan oluşturulmuştur.

ExperimentalField

Resmi olmayan alanları temsil eden deneysel alan.

Alanlar
field

string

İsteğe bağlıdır. Kullanılacak alanın adı.

value

string

İsteğe bağlıdır. Alan için ayarlanacak değer.

FeatureSet

Bir iş ortağı bağlantısı için desteklenen özellikler grubu.

Sıralamalar
FEATURE_SET_UNSPECIFIED Belirtilmemiş özellik seti. Belirtilmezse sistem davranışı varsayılan olarak FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT olur.
FEATURE_SET_AUDIENCE_AND_EVENT_MANAGEMENT Kitle ve etkinlik yönetimi için kullanılan bir bağlantıyı gösterir.
FEATURE_SET_AD_EVENT_MANAGEMENT Reklam etkinliği yönetimi için kullanılan bir bağlantıyı belirtir.

FieldWarning

Alan yollarıyla ilgili ayrıntılı satır düzeyinde uyarı.

Alanlar
reason

WarningReason

Uyarı nedeni.

description

string

Sorunu açıklayan ayrıntılı uyarı mesajı.

field

string

Uyarıyı tetikleyen alan yolu. google.rpc.BadRequest.FieldViolation.field ile aynı biçimi kullanır.

GcpWrappedKeyInfo

Google Cloud Platform sarmalanmış anahtarı hakkında bilgiler.

Alanlar
key_type

KeyType

Zorunlu. Verileri şifrelemek için kullanılan algoritma türü.

wip_provider

string

Zorunlu. KEK'in kullanılması için gereken Workload Identity havuzu sağlayıcısı.

kek_uri

string

Zorunlu. Google Cloud Platform Cloud Key Management Service kaynak kimliği. projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} veya gcp-kms://projects/{project}/locations/{location}/keyRings/{key_ring}/cryptoKeys/{key} biçiminde olmalıdır.

encrypted_dek

string

Zorunlu. Base64 kodlu şifrelenmiş veri şifreleme anahtarı.

KeyType

Verileri şifrelemek için kullanılan algoritma türü.

Sıralamalar
KEY_TYPE_UNSPECIFIED Belirtilmemiş anahtar türü. Hiç kullanılmamalıdır.
XCHACHA20_POLY1305 Algoritma XChaCha20-Poly1305

Cinsiyet

Demografik cinsiyet türü (ör. kadın).

Sıralamalar
GENDER_UNSPECIFIED Belirtilmedi.
GENDER_UNKNOWN Bilinmiyor.
GENDER_MALE Erkek.
GENDER_FEMALE Kadın

GetUserListDirectLicenseRequest

UserListDirectLicense kaynağını alma isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Kullanıcı listesi doğrudan lisansının kaynak adı.

GetUserListGlobalLicenseRequest

UserListGlobalLicense kaynağını alma isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Kullanıcı listesi genel lisansının kaynak adı.

GetUserListRequest

GetUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
name

string

Zorunlu. Alınacak UserList'in kaynak adı. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

GoogleUserIdData

Şifrelenmiş Google kullanıcı kimliklerini içeren Google kullanıcı kimliği verileri. En az bir Google kullanıcı kimliği gereklidir.

Alanlar
google_user_ids[]

string

Zorunlu. Şifrelenmiş Google kullanıcı kimliklerinin listesi.

IngestAdEventsRequest

Reklam etkinliklerini yükleme isteği

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
ad_events[]

AdEvent

Zorunlu. Zorunlu (en az 1). Reklam etkinliklerinin listesi.

encryption_info

EncryptionInfo

İsteğe bağlıdır. Verileri şifrelemek için kullanılan şifreleme anahtarları hakkında bilgiler. Reklam etkinlikleri UserData içerdiğinde bu alan sağlanmalıdır.

validate_only
(deprecated)

bool

İsteğe bağlıdır. Doğruysa istek doğrulanır ancak yürütülmez.

IngestAdEventsResponse

Bu türde alan yok.

Bir reklam etkinliği alımı işleminden gelen yanıt.

IngestAudienceMembersRequest

Kitle üyelerinin, belirtilen hedeflere yüklenmesini isteyin. IngestAudienceMembersResponse döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Kitle üyelerinin gönderileceği hedeflerin listesi.

audience_members[]

AudienceMember

Zorunlu. Belirtilen hedeflere gönderilecek kullanıcıların listesi. Tek bir istekte en fazla 10.000 AudienceMember kaynağı gönderilebilir.

consent

Consent

İsteğe bağlıdır. İstekteki tüm kullanıcılar için geçerli olacak istek düzeyinde izin. Kullanıcı düzeyinde izin, istek düzeyinde izni geçersiz kılar ve her AudienceMember içinde belirtilebilir.

validate_only

bool

İsteğe bağlıdır. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

encoding

Encoding

İsteğe bağlıdır. UserData yüklemeleri için sağlanmalıdır. Kullanıcı tanımlayıcılarının kodlama türü. Karma oluşturulmuş kullanıcı tanımlayıcıları için bu, karma oluşturulmuş dizenin kodlama türüdür. Şifrelenmiş karma oluşturma işlemi uygulanmış kullanıcı tanımlayıcıları için bu, dıştaki şifrelenmiş dizenin kodlama türüdür ancak içteki karma oluşturma işlemi uygulanmış dize için geçerli olmayabilir. Yani içteki karma oluşturma işlemi uygulanmış dize, dıştaki şifrelenmiş dizeden farklı şekilde kodlanmış olabilir. UserData dışındaki yüklemelerde bu alan yoksayılır.

encryption_info

EncryptionInfo

İsteğe bağlıdır. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmazsa yüklenen kişisel verilerin karma oluşturma işlemi uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemelerde bu alan yoksayılır.

terms_of_service

TermsOfService

İsteğe bağlıdır. Kullanıcının kabul ettiği/reddettiği hizmet şartları.

IngestAudienceMembersResponse

IngestAudienceMembersRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan kimliği.

field_warnings[]

FieldWarning

Alan yollarıyla ilgili ayrıntılı satır düzeyinde uyarılar.

IngestEventsRequest

Kitle üyelerinin, belirtilen hedeflere yüklenmesini isteyin. IngestEventsResponse döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Etkinliklerin gönderileceği hedeflerin listesi.

events[]

Event

Zorunlu. Belirtilen hedeflere gönderilecek etkinliklerin listesi. Tek bir istekte en fazla 2.000 Event kaynağı gönderilebilir.

consent

Consent

İsteğe bağlıdır. İstekteki tüm kullanıcılar için geçerli olacak istek düzeyinde izin. Kullanıcı düzeyinde izin, istek düzeyinde izni geçersiz kılar ve her Event içinde belirtilebilir.

validate_only

bool

İsteğe bağlıdır. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

encoding

Encoding

İsteğe bağlıdır. UserData yüklemeleri için sağlanmalıdır. Kullanıcı tanımlayıcılarının kodlama türü. Karma oluşturulmuş kullanıcı tanımlayıcıları için bu, karma oluşturulmuş dizenin kodlama türüdür. Şifrelenmiş karma oluşturma işlemi uygulanmış kullanıcı tanımlayıcıları için bu, dıştaki şifrelenmiş dizenin kodlama türüdür ancak içteki karma oluşturma işlemi uygulanmış dize için geçerli olmayabilir. Yani içteki karma oluşturma işlemi uygulanmış dize, dıştaki şifrelenmiş dizeden farklı şekilde kodlanmış olabilir. UserData dışındaki yüklemelerde bu alan yoksayılır.

encryption_info

EncryptionInfo

İsteğe bağlıdır. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmazsa yüklenen kişisel verilerin karma oluşturma işlemi uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemelerde bu alan yoksayılır.

IngestEventsResponse

IngestEventsRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan kimliği.

field_warnings[]

FieldWarning

Alan yollarıyla ilgili ayrıntılı satır düzeyinde uyarılar.

IngestUsersRequest

Kullanıcıların, belirtilen hedeflere yüklenmesini isteyin.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Olası alım hedeflerinin listesi.

users[]

User

Zorunlu. Eklenecek kullanıcıların listesi.

encryption_info

EncryptionInfo

İsteğe bağlıdır. Verileri şifrelemek için kullanılan şifreleme anahtarlarıyla ilgili şifreleme bilgileri.

validate_only

bool

İsteğe bağlıdır. true ise istek doğrulanır ancak yürütülmez.

encoding

Encoding

Zorunlu. Kullanıcı tanımlayıcılarının kodlama türü. Şifrelenmiş kullanıcı tanımlayıcıları için bu yalnızca dış kodlama için geçerlidir.

IngestUsersResponse

IngestUsersRequest'ten gelen yanıt.

Alanlar
request_id

string

Alım isteğinin oluşturulan istek kimliği.

IngestedUserListInfo

Kullanıcı tarafından sağlanan verilerle doldurulmuş bir kullanıcı listesini temsil eder.

Alanlar
upload_key_types[]

UploadKeyType

Zorunlu. Değiştirilemez. Bu kullanıcı listesinin yükleme anahtarı türleri.

contact_id_info

ContactIdInfo

İsteğe bağlıdır. CONTACT_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

mobile_id_info

MobileIdInfo

İsteğe bağlıdır. MOBILE_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

user_id_info

UserIdInfo

İsteğe bağlıdır. USER_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

pair_id_info

PairIdInfo

İsteğe bağlıdır. PAIR_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

pseudonymous_id_info

PseudonymousIdInfo

İsteğe bağlıdır. PSEUDONYMOUS_ID için ek bilgiler upload_key_types'dan biridir.

partner_audience_info

PartnerAudienceInfo

İsteğe bağlıdır. İş ortağı kitleleri için ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

UploadKeyType

Bir kullanıcı listesinin olası yükleme anahtarı türlerini içeren sıralama.

Sıralamalar
UPLOAD_KEY_TYPE_UNSPECIFIED Belirtilmedi.
CONTACT_ID E-posta adresi, telefon numarası veya fiziksel adres gibi müşteri bilgileri
MOBILE_ID Mobil reklam kimlikleri.
USER_ID Üçüncü taraf tarafından sağlanan kullanıcı kimlikleri.
PAIR_ID Yayıncı-reklamveren kimlik eşleşmesi kimlikleri.
PSEUDONYMOUS_ID

Veri Yönetimi Platformu Kimlikleri:

  • Google Kullanıcı Kimliği
  • İş ortağı tarafından sağlanan kimlik
  • Yayıncı Tarafından Sağlanan Kimlik
  • iOS IDFA
  • Android reklam kimliği
  • Roku kimliği
  • Amazon Fire TV kimliği
  • Xbox veya Microsoft kimliği
  • Genel Cihaz Kimliği

IpData

Kullanıcının IP adresi bilgileri. Müşteri Eşleştirme eşleşme oranlarını artırmak için observe_start_time ve observe_end_time parametrelerini eklemenizi öneririz.

Alanlar
ip_address

string

Zorunlu. Müşteri etkileşimi sırasında alınan IP adresi. Hem IPv4 hem de IPv6 için standart dize biçimlerini kabul eder.

observe_start_time

Timestamp

İsteğe bağlıdır. Bir oturumda bu IP adresinden gelen, kaydedilmiş ilk etkileşimin zamanı.

observe_end_time

Timestamp

İsteğe bağlıdır. Bir oturumda bu IP adresinden gelen, kaydedilmiş son etkileşim zamanı.

Öğe

Etkinlikle ilişkili alışveriş sepetindeki bir öğeyi temsil eder.

Alanlar
merchant_product_id

string

İsteğe bağlıdır. Merchant Center hesabındaki ürün kimliği.

quantity

int64

İsteğe bağlıdır. Etkinlikle ilişkilendirilmiş bu öğenin sayısı.

unit_price

double

İsteğe bağlıdır. Vergi ve kargo ücretinin yanı sıra, işlem düzeyindeki tüm indirimler hariç birim fiyat.

item_id

string

İsteğe bağlıdır. Öğeye referans vermek için kullanılan benzersiz tanımlayıcı.

additional_item_parameters[]

ItemParameter

İsteğe bağlıdır. Etkinliğe dahil edilecek ve diğer yapılandırılmış alanlar kullanılarak belirtilmemiş bir öğeyle ilgili tüm etkinlik parametrelerinin bulunduğu bir grup.

merchant_id

string

İsteğe bağlıdır. Öğeyle ilişkili Merchant Center kimliği. Mağaza satışı etkinliklerinde bu, alışveriş sepeti düzeyinde ayarlanan değeri geçersiz kılar. Bu alan diğer etkinlikler için yoksayılır.

merchant_feed_label

string

İsteğe bağlıdır. Merchant Center feed'inin feed etiketi. Ülkeler hâlâ kullanılıyorsa bunun yerine ISO-3166-1 alfa-2 cinsinden 2 harfli ülke kodu kullanılabilir. Mağaza satışı etkinliklerinde bu, alışveriş sepeti düzeyinde ayarlanan değeri geçersiz kılar. Bu alan diğer etkinlikler için yoksayılır.

merchant_feed_language_code

string

İsteğe bağlıdır. Öğelerinizin yüklendiği Merchant Center feed'iyle ilişkili ISO 639-1 dil kodu.

custom_variables[]

ItemCustomVariable

İsteğe bağlıdır. Öğe başına dönüşümler izlenirken dönüşüm kapsayıcılarına (dönüşüm işlemi veya Floodlight etkinliği) gönderilecek ek anahtar/değer çifti bilgileri.

conversion_value

double

İsteğe bağlıdır. Dönüşüm değerinin her öğe için farklı olduğu durumlarda, etkinlikteki bu öğeyle ilişkili dönüşüm değeri.

ItemCustomVariable

Reklam dönüşümleri için öğe düzeyinde özelleştirilebilen değişken.

Alanlar
variable

string

İsteğe bağlıdır. Ayarlanacak özelleştirilebilen değişkenin adı. Değişken, belirtilen hedef için bulunamazsa yoksayılır.

value

string

İsteğe bağlıdır. Özelleştirilebilen değişken için depolanacak değer.

destination_references[]

string

İsteğe bağlıdır. Özel değişkenin Event.destination_references öğelerinden hangisine gönderileceğini belirlemek için kullanılan referans dizesi. Boş bırakılırsa Event.destination_references kullanılır.

ItemParameter

Etkinliğe dahil edilecek ve diğer yapılandırılmış alanlar kullanılarak belirtilmemiş bir öğeyle ilgili tüm etkinlik parametrelerinin bulunduğu bir grup.

Alanlar
parameter_name

string

Zorunlu. Kullanılacak parametrenin adı.

value

string

Zorunlu. Ayarlanacak parametrenin değerinin dize gösterimi.

ListUserListDirectLicensesRequest

Belirli bir hesaba ait tüm UserListDirectLicense kaynaklarının listelenmesini isteyin.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisansları sorgulanan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

filter

string

İsteğe bağlıdır. Liste isteğine uygulanacak bir filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: user_list_id = 123). Alanlar, tümü camel case veya tümü snake case kullanılarak belirtilmelidir. Camel case ve snake case kombinasyonu kullanmayın.

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Desteklenen İşlevler: - IN(field, value1, value2, ...): Alan değerlerinden herhangi biriyle eşleşirse true değerini döndürür. Örnek: IN(user_list_id, 123, 456)

Desteklenmeyen Alanlar:

  • name (Bunun yerine get yöntemini kullanın)
  • historical_pricings ve tüm alt alanları
  • pricing.start_time
  • pricing.end_time
page_size

int32

İsteğe bağlıdır. Sayfa başına döndürülecek maksimum lisans sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemesi halinde en fazla 50 lisans döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlıdır. Önceki bir ListUserListDirectLicense çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserListDirectLicense öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListUserListDirectLicensesResponse

ListUserListDirectLicensesRequest tarafından verilen yanıt.

Alanlar
user_list_direct_licenses[]

UserListDirectLicense

İstekteki belirli kullanıcı listesinin lisansları.

next_page_token

string

Bir sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

ListUserListGlobalLicenseCustomerInfosRequest

Belirli bir kullanıcı için tüm UserListGlobalLicenseCustomerInfo kaynaklarını listeleme isteğinde bulunun.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Müşteri bilgilerinin sorgulandığı global lisans. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID} biçiminde olmalıdır. Tüm küresel lisans müşteri bilgilerini bir hesap altında listelemek için kullanıcı listesi küresel lisans kimliğini "-" ile değiştirin (örneğin, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-).

filter

string

İsteğe bağlıdır. Liste isteğine uygulanacak bir filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: user_list_id = 123). Alanlar, tümü camel case veya tümü snake case kullanılarak belirtilmelidir. Camel case ve snake case kombinasyonu kullanmayın.

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Desteklenen İşlevler: - IN(field, value1, value2, ...): Alan değerlerinden herhangi biriyle eşleşirse true değerini döndürür. Örnek: IN(user_list_id, 123, 456)

Desteklenmeyen Alanlar:

  • name (Bunun yerine get yöntemini kullanın)
  • historical_pricings ve tüm alt alanları
  • pricing.start_time
  • pricing.end_time
page_size

int32

İsteğe bağlıdır. Döndürülecek maksimum lisans sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemesi halinde en fazla 50 lisans döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlıdır. Önceki bir ListUserListDirectLicense çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserListDirectLicense öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListUserListGlobalLicenseCustomerInfosResponse

[ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest] yanıtı.

Alanlar
user_list_global_license_customer_infos[]

UserListGlobalLicenseCustomerInfo

İstekteki belirli lisansla ilgili müşteri bilgileri.

next_page_token

string

Bir sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

ListUserListGlobalLicensesRequest

Belirli bir hesaba ait tüm UserListGlobalLicense kaynaklarının listelenmesini isteyin.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Lisansları sorgulanan hesap. accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID} biçiminde olmalıdır.

filter

string

İsteğe bağlıdır. Liste isteğine uygulanacak bir filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: user_list_id = 123). Alanlar, tümü camel case veya tümü snake case kullanılarak belirtilmelidir. Camel case ve snake case kombinasyonu kullanmayın.

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

Desteklenen İşlevler: - IN(field, value1, value2, ...): Alan değerlerinden herhangi biriyle eşleşirse true değerini döndürür. Örnek: IN(user_list_id, 123, 456)

Desteklenmeyen Alanlar:

  • name (Bunun yerine get yöntemini kullanın)
  • historical_pricings ve tüm alt alanları
  • pricing.start_time
  • pricing.end_time
page_size

int32

İsteğe bağlıdır. Döndürülecek maksimum lisans sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemesi halinde en fazla 50 lisans döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlıdır. Önceki bir ListUserListGlobalLicense çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserListDirectLicense öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

ListUserListGlobalLicensesResponse

ListUserListGlobalLicensesRequest tarafından verilen yanıt.

Alanlar
user_list_global_licenses[]

UserListGlobalLicense

İstekteki belirli kullanıcı listesinin lisansları.

next_page_token

string

Bir sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

ListUserListsRequest

ListUserLists için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Bu kullanıcı listeleri koleksiyonunun sahibi olan üst hesap. Biçim: accountTypes/{account_type}/accounts/{account}

page_size

int32

İsteğe bağlıdır. Döndürülecek maksimum kullanıcı listesi sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmezse en fazla 50 kullanıcı listesi döndürülür. Maksimum değer 1.000'dir. 1.000'in üzerindeki değerler 1.000'e zorlanır.

page_token

string

İsteğe bağlıdır. Önceki bir ListUserLists çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken ListUserLists öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

filter

string

İsteğe bağlıdır. Filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: display_name = "list 1"). Alanlar, tümü camel case veya tümü snake case kullanılarak belirtilmelidir. Camel case ve snake case kombinasyonu kullanmayın.

Desteklenen işlemler:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=
  • : (var)

Desteklenen İşlevler: - IN(field, value1, value2, ...): Alan değerlerinden herhangi biriyle eşleşirse true değerini döndürür. Örnek: IN(display_name, "name1", "name2")

Desteklenen alanlar:

  • id
  • display_name
  • description
  • membership_status
  • integration_code
  • access_reason
  • ingested_user_list_info.upload_key_types

ListUserListsResponse

ListUserLists için yanıt mesajı.

Alanlar
user_lists[]

UserList

Belirtilen hesaptaki kullanıcı listeleri.

next_page_token

string

Bir sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

MatchRateRange

Yüklemenin veya kullanıcı listesinin eşleşme oranı aralığı.

Sıralamalar
MATCH_RATE_RANGE_UNKNOWN Eşleşme oranı aralığı bilinmiyor.
MATCH_RATE_RANGE_NOT_ELIGIBLE Eşleşme oranı aralığı uygun değil.
MATCH_RATE_RANGE_LESS_THAN_20 Eşleşme oranı aralığı %20'den azdır ([0, 20) aralığında).
MATCH_RATE_RANGE_20_TO_30 Eşleşme oranı aralığı% 20 ile %30 arasındadır ([20, 31) aralığında).
MATCH_RATE_RANGE_31_TO_40 Eşleşme oranı aralığı% 31 ile %40 arasındadır ([31, 41) aralığında).
MATCH_RATE_RANGE_41_TO_50 Eşleşme oranı aralığı% 41 ile %50 arasındadır ([41, 51) aralığında).
MATCH_RATE_RANGE_51_TO_60 Eşleşme oranı aralığı% 51 ile %60 arasındadır ([51, 61) aralığında).
MATCH_RATE_RANGE_61_TO_70 Eşleşme oranı aralığı% 61 ile %70 arasındadır ([61, 71) aralığında).
MATCH_RATE_RANGE_71_TO_80 Eşleşme oranı aralığı% 71 ile %80 arasındadır ([71, 81) aralığında).
MATCH_RATE_RANGE_81_TO_90 Eşleşme oranı aralığı% 81 ile %90 arasındadır ([81, 91) aralığında).
MATCH_RATE_RANGE_91_TO_100

Eşleşme oranı aralığı% 91 ile %100 arasındadır ([91, 100] aralığında).

MediaQuartile

Medyanın ayrı çeyrekler halinde oynatılan kısmı.

Sıralamalar
MEDIA_QUARTILE_UNSPECIFIED Belirtilmemiş medya çeyrekliği.
MEDIA_QUARTILE_START Başlat.
MEDIA_QUARTILE_FIRST_QUARTILE İlk çeyrek.
MEDIA_QUARTILE_MIDPOINT Orta nokta.
MEDIA_QUARTILE_THIRD_QUARTILE Üçüncü çeyrek.
MEDIA_QUARTILE_COMPLETE Tamamlandı.

MobileData

Kitle için mobil kimlikler. En az bir mobil kimlik gereklidir.

Alanlar
mobile_ids[]

string

Zorunlu. Mobil cihaz kimliklerinin listesi (Müşteri Eşleştirme kullanıcı listeleri için Android reklam kimliği, iOS IDFA ve temel kullanıcı listeleri için Android reklam kimliği, iOS IDFA, Xbox veya Microsoft kimliği, Amazon Fire TV kimliği, Roku kimliği, genel cihaz kimliği). Tek bir AudienceMember içinde en fazla 10 mobileIds sağlanabilir.

MobileIdInfo

MOBILE_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Alanlar
data_source_type

DataSourceType

İsteğe bağlıdır. Değiştirilemez. Yüklenen verilerin kaynağı.

key_space

KeySpace

Zorunlu. Değiştirilemez. Mobil kimliklerin anahtar alanı.

app_id

string

Zorunlu. Değiştirilemez. Verilerin toplandığı mobil uygulamayı benzersiz şekilde tanımlayan dize.

KeySpace

Mobil kimlik için anahtar alanı.

Sıralamalar
KEY_SPACE_UNSPECIFIED Belirtilmedi.
IOS iOS anahtar alanı.
ANDROID Android anahtar alanı.

PairData

Kitle için PAIR kimlikleri. En az bir PAIR ID gereklidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
pair_ids[]

string

Zorunlu. PAIR kullanıcı listesi için yayıncı anahtarı kullanılarak SHA256 ile karma oluşturma işlemi uygulanmış ve EC değişmeli şifreyle şifrelenmiş, temiz oda tarafından sağlanan kimliği tanımlayabilecek bilgiler (PII) verileri. Tek bir AudienceMember içinde en fazla 10 pairIds sağlanabilir.

PairIdInfo

PAIR_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
publisher_id

int64

Zorunlu. Değiştirilemez. Yayıncı-Reklamveren Kimlik Eşleşmesi kullanıcı listesinin eşleştirildiği yayıncıyı tanımlar. Bu alan, temiz oda sağlayıcı tarafından sağlanır ve yalnızca söz konusu temiz oda kapsamında benzersizdir. Bu, birden fazla temiz oda arasında genel tanımlayıcı olarak kullanılamaz.

publisher_name

string

Zorunlu. Daha iyi bir hedefleme deneyimi için kullanıcı arayüzünde gösterilecek yayıncının açıklayıcı adı.

match_rate_percentage

int32

Zorunlu. Bu alan, bu kullanıcı listesinin ilgili yayıncının birinci taraf verileriyle eşleşen üyelik yüzdesini gösterir. 0 ile 100 arasında (her iki değer de dahil) olmalıdır.

advertiser_identifier_count

int64

İsteğe bağlıdır. Bir temiz oda sağlayıcısına yüklenen reklamverenin birinci taraf veri kayıtlarının sayısı. Bu, bir PAIR kullanıcı listesinin boyutunu göstermez.

clean_room_identifier

string

Zorunlu. Değiştirilemez. Bir temiz oda sağlayıcısı ile veya birden fazla temiz oda sağlayıcısında benzersiz bir reklamveren-yayıncı ilişkisini tanımlar.

PartnerAudienceInfo

İş ortağı kitleleri için ek bilgiler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
partner_audience_source

PartnerAudienceSource

Zorunlu. Değiştirilemez. İş ortağı kitlesinin kaynağı.

commerce_partner

string

İsteğe bağlıdır. Ticaret iş ortağının adı. Yalnızca partner_audience_source COMMERCE_AUDIENCE ise izin verilir.

PartnerAudienceSource

İş ortağı kitle kaynağı.

Sıralamalar
PARTNER_AUDIENCE_SOURCE_UNSPECIFIED Belirtilmedi.
COMMERCE_AUDIENCE İş ortağı kitle kaynağı, ticari kitlelerdir.
LINEAR_TV_AUDIENCE İş ortağı kitle kaynağı, geleneksel TV kitlesidir.
AGENCY_PROVIDER_AUDIENCE İş ortağı kitle kaynağı, ajans/sağlayıcı kitlesidir.

PartnerCustomerAccount

İş ortağının sistemindeki bir müşteri hesabını temsil eder.

Alanlar
account_id

string

Zorunlu. İş ortağının kimlik alanındaki müşteri hesabının tanımlayıcısı.

account_name

string

İsteğe bağlıdır. Hesabın adı.

account_type

string

İsteğe bağlıdır. Hesabın türü. Örneğin, reklamveren hesapları ile işletme düzeyindeki hesapları ayırt etmek için kullanılabilir.

PartnerLinkMetadata

Bir iş ortağı bağlantısıyla ilişkili meta verileri temsil eder.

Alanlar
implicit_accounts[]

PartnerCustomerAccount

İsteğe bağlıdır. Örtülü hesapların listesi.

PartnerProvidedIdData

İş ortağı tarafından sağlanan tanımlayıcıları içeren, iş ortağı tarafından sağlanan veriler. En az bir iş ortağı tarafından sağlanan tanımlayıcı gereklidir.

Alanlar
partner_provided_ids[]

string

Zorunlu. İş ortağı tarafından sağlanan tanımlayıcıların listesi.

Platform

Reklamın yayınlandığı platformla ilgili daha fazla ayrıntı.

Sıralamalar
PLATFORM_UNSPECIFIED Platform belirtilmedi.
PLATFORM_IOS iOS platformu.
PLATFORM_ANDROID Android platformu.
PLATFORM_WEB Web platformu.

PlatformType

Reklamın yayınlandığı platformun türü.

Sıralamalar
PLATFORM_TYPE_UNSPECIFIED Belirtilmemiş platform türü.
PLATFORM_TYPE_MOBILE Mobil platform.
PLATFORM_TYPE_DESKTOP Masaüstü platformu.
PLATFORM_TYPE_CTV CTV platformu.
PLATFORM_TYPE_PHONE Telefon platformu.
PLATFORM_TYPE_TABLET Tablet platformu.

PpidData

PPID'leri içeren yayıncı tarafından sağlanan tanımlayıcılar verileri. En az bir ppid gereklidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
ppids[]

string

Zorunlu. Bir kullanıcı için yayıncı tarafından sağlanan tanımlayıcıların listesi.

ProcessingErrorReason

İşleme hatasının nedeni. Gelecekte yeni nedenler eklenebilir.

Sıralamalar
PROCESSING_ERROR_REASON_UNSPECIFIED İşleme hatasının nedeni bilinmiyor.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE Özelleştirilebilen değişken geçersiz.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED Özelleştirilebilen değişkenin durumu etkin değil.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD Dönüşüm, desteklenen maksimum yaştan daha eski.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID Aynı GCLID ve dönüşüm zamanına sahip bir dönüşüm zaten sistemde var.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID Aynı sipariş kimliği ve dönüşüm işlemi kombinasyonuna sahip bir dönüşüm zaten yüklenmiş.
PROCESSING_ERROR_REASON_INVALID_GBRAID GBRAID'in kodu çözülemedi.
PROCESSING_ERROR_REASON_INVALID_GCLID Google tıklama kimliğinin kodu çözülemedi.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID Satıcı kimliği, rakam olmayan karakterler içeriyor.
PROCESSING_ERROR_REASON_INVALID_WBRAID WBRAID'in kodu çözülemedi.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Dahili hata.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Gelişmiş dönüşüm şartları hedef hesapta imzalanmamış.
PROCESSING_ERROR_REASON_INVALID_EVENT Etkinlik geçersiz.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS Eşleşen işlemler, minimum eşiğin altında.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS İşlemler, minimum eşiğin altında.
PROCESSING_ERROR_REASON_INVALID_FORMAT Etkinlikte biçim hatası var.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR Etkinlikte şifre çözme hatası var.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR DEK'nin şifresi çözülemedi.
PROCESSING_ERROR_REASON_INVALID_WIP WIP yanlış biçimlendirilmiş veya WIP mevcut değil.
PROCESSING_ERROR_REASON_INVALID_KEK KEK, yanlış KEK olduğu veya mevcut olmadığı için verilerin şifresini çözemiyor.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED WIP, onay koşulu tarafından reddedildiği için kullanılamadı.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED Sistem, KEK'ye erişmek için gereken izinlere sahip değildi.
PROCESSING_ERROR_REASON_AWS_AUTH_FAILED Sistem, AWS ile kimlik doğrulaması yapamadı.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR DEK kullanılarak UserIdentifier verilerinin şifresi çözülemedi.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER Kullanıcı, işleten hesabın reklamlarına ait olmayan bir reklam tanımlayıcısıyla etkinlikleri alma girişiminde bulundu.
PROCESSING_ERROR_REASON_ONE_PER_CLICK_CONVERSION_ACTION_NOT_PERMITTED_WITH_BRAID Tıklama başına bir dönüşüm işlemleri BRAID'lerle kullanılamaz.
PROCESSING_ERROR_REASON_MATCH_ID_NOT_FOUND Maç kimliği bulunamıyor.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_MATCH_ID Eşleşme kimliği için kullanıcı kimliği bulunamıyor.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_GCLID GCLID için kullanıcı kimliği bulunamıyor.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_DCLID DCLID için kullanıcı kimliği bulunamıyor.
PROCESSING_ERROR_REASON_INVALID_AD_IDENTIFIERS Geçersiz reklam tanımlayıcılar var.
PROCESSING_ERROR_REASON_INVALID_MOBILE_ID_FORMAT Mobil kimlik biçimi geçersiz.
PROCESSING_ERROR_REASON_ORIGINAL_CONVERSIONS_NOT_FOUND Orijinal dönüşümler bulunamıyor.
PROCESSING_ERROR_REASON_EVENT_ID_DECODE_ERROR Etkinlik kimliğinin (dclid veya gösterim kimliği) kodu çözülemiyor.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND_FOR_IMPRESSION_ID Belirtilen gösterim kimliği için kullanıcı kimliği bulunamıyor.
PROCESSING_ERROR_REASON_USER_ID_NOT_FOUND Kullanıcı kimliği bulunamıyor.
PROCESSING_ERROR_REASON_CONVERSION_PRECEDES_CLICK Etkinlikteki etkinlik zaman damgası, ilişkili tıklamadan önceydi.
PROCESSING_ERROR_REASON_TOO_RECENT_CLICK Tıklama çok yakın zamanda gerçekleşti.
PROCESSING_ERROR_REASON_INVALID_CLICK Etkinlik bir tıklama (GCLID) ile ilişkilendirilemiyor. Bunun nedeni, tıklamanın örneğin bir Google Ads kampanyasından gelmemesi olabilir.
PROCESSING_ERROR_REASON_INVALID_OPERATING_ACCOUNT_FOR_CLICK Etkinlikten gelen tıklama, hedefin operating_account ile ilişkilendirilmiyor.
PROCESSING_ERROR_REASON_CLICK_NOT_FOUND Sağlanan özelliklerle eşleşen bir tıklama bulunamıyor.
PROCESSING_ERROR_REASON_EXTERNAL_ATTRIBUTION_DATA_MISSING Harici ilişkilendirme verileri eksik. Harici ilişkilendirme dönüşüm işlemi için bir hedefe etkinlik gönderme desteklenmez.

ProcessingWarningReason

İşleme uyarısının nedeni.

Sıralamalar
PROCESSING_WARNING_REASON_UNSPECIFIED İşleme uyarısı nedeni bilinmiyor.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED Sistem, KEK'ye erişmek için gereken izinlere sahip değildi.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR DEK'nin şifresi çözülemedi.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR Etkinlikte şifre çözme hatası var.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED WIP, onay koşulu tarafından reddedildiği için kullanılamadı.
PROCESSING_WARNING_REASON_INVALID_WIP WIP yanlış biçimlendirilmiş veya WIP mevcut değil.
PROCESSING_WARNING_REASON_INVALID_KEK KEK, yanlış KEK olduğu veya mevcut olmadığı için verilerin şifresini çözemiyor.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR DEK kullanılarak UserIdentifier verilerinin şifresi çözülemedi.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Dahili hata.
PROCESSING_WARNING_REASON_AWS_AUTH_FAILED Sistem, AWS ile kimlik doğrulaması yapamadı.

Ürün

Kullanımdan kaldırıldı. Bunun yerine AccountType politikasını kullanın. Belirli bir Google ürününü temsil eder.

Sıralamalar
PRODUCT_UNSPECIFIED Belirtilmemiş ürün. Hiç kullanılmamalıdır.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni.
DATA_PARTNER Veri İş Ortağı

ProductAccount

Belirli bir hesabı temsil eder.

Alanlar
product
(deprecated)

Product

Kullanımdan kaldırıldı. Bunun yerine account_type politikasını kullanın.

account_id

string

Zorunlu. Hesabın kimliği. Örneğin, Google Ads hesap kimliğiniz.

account_type

AccountType

Zorunlu. Hesabın türü. Örneğin, GOOGLE_ADS. account_type veya kullanımdan kaldırılan product zorunludur. İkisi de ayarlanmışsa değerler eşleşmelidir.

AccountType

Google Hesabı türlerini gösterir. Hesapları ve hedefleri bulmak için kullanılır.

Sıralamalar
ACCOUNT_TYPE_UNSPECIFIED Belirtilmemiş ürün. Hiç kullanılmamalıdır.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni.
DATA_PARTNER Veri İş Ortağı
GOOGLE_ANALYTICS_PROPERTY Google Analytics.
FLOODLIGHT_CONFIG Floodlight yapılandırması.
GOOGLE_AD_MANAGER Google Ad Manager

PseudonymousIdInfo

PSEUDONYMOUS_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Alanlar
sync_status

SyncStatus

Yalnızca çıkış. Kullanıcı listesinin senkronizasyon durumu.

billable_record_count

int64

İsteğe bağlıdır. Değiştirilemez. Faturalandırılabilir kayıtların sayısı (ör. yüklenen veya eşleşen).

SyncStatus

Kullanıcı listesinin senkronizasyon durumu.

Sıralamalar
SYNC_STATUS_UNSPECIFIED Belirtilmedi.
CREATED Kullanıcı listesi yer tutucu olarak oluşturuldu. Liste içerikleri ve/veya meta veriler hâlâ senkronize ediliyor. Kullanıcı listesi kullanıma hazır değil.
READY_FOR_USE Kullanıcı listesi kullanıma hazır. İçerikler ve çerezler doğru şekilde senkronize edildi.
FAILED Kullanıcı listesi içerikleri ve/veya meta verileri senkronize edilirken bir hata oluştu. Kullanıcı listesi kullanılamaz.

RemoveAllAudienceMembersRequest

Belirtilen hedeflerdeki bir kitleden tüm kullanıcıları kaldırma isteği. RemoveAllAudienceMembersResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Kullanıcıların kaldırılacağı hedeflerin listesi.

remove_as_of_time

Timestamp

İsteğe bağlıdır. Kaldırma zamanı. Ayarlanmışsa yalnızca bu saatten önce en son eklenen kitle üyeleri kaldırılır. Ayarlanmazsa varsayılan olarak geçerli saat kullanılır. Kaldırma tarihi gelecekteki bir tarih olmamalıdır.

validate_only

bool

İsteğe bağlıdır. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

RemoveAllAudienceMembersResponse

RemoveAllAudienceMembersRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan kimliği.

RemoveAudienceMembersRequest

Kullanıcıları, sağlanan hedeflerdeki bir kitleden kaldırma isteği. RemoveAudienceMembersResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Kullanıcıların kaldırılacağı hedeflerin listesi.

audience_members[]

AudienceMember

Zorunlu. Kaldırılacak kullanıcıların listesi.

validate_only

bool

İsteğe bağlıdır. Test amaçlıdır. true ise istek doğrulanır ancak yürütülmez. Sonuçlar değil, yalnızca hatalar döndürülür.

encoding

Encoding

İsteğe bağlıdır. UserData yüklemeleri için sağlanmalıdır. Kullanıcı tanımlayıcılarının kodlama türü. Yalnızca şifrelenmiş kullanıcı tanımlayıcılarının dış kodlaması için geçerlidir. UserData dışındaki yüklemelerde bu alan yoksayılır.

encryption_info

EncryptionInfo

İsteğe bağlıdır. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmazsa yüklenen kişisel verilerin karma oluşturma işlemi uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemelerde bu alan yoksayılır.

RemoveAudienceMembersResponse

RemoveAudienceMembersRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan kimliği.

RemoveUsersRequest

Kullanıcıların belirtilen hedeflerden kaldırılması isteği.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
destinations[]

Destination

Zorunlu. Olası alım hedeflerinin listesi.

user_data[]

UserData

Zorunlu. Kullanıcıların kaldırılacak anahtarları olarak işlev gören UserData'nın bağımsız bitleri.

encryption_info

EncryptionInfo

İsteğe bağlıdır. Verileri şifrelemek için kullanılan şifreleme anahtarlarıyla ilgili şifreleme bilgileri.

validate_only

bool

İsteğe bağlıdır. true ise istek doğrulanır ancak yürütülmez.

encoding

Encoding

Zorunlu. Kullanıcı tanımlayıcılarının kodlama türü. Şifrelenmiş kullanıcı tanımlayıcıları için bu yalnızca dış kodlama için geçerlidir.

RemoveUsersResponse

RemoveUsersRequest'in yanıtı.

Alanlar
request_id

string

Alım isteğinin oluşturulan istek kimliği.

RequestStatusPerDestination

Hedef başına bir istek durumu.

Alanlar
destination

Destination

DM API isteğindeki bir hedef.

request_status

RequestStatus

Hedefin istek durumu.

error_info

ErrorInfo

Yüklemeyle ilgili hata nedenini ve hata sayılarını içeren bir hata bilgisi hatası. Yalnızca request_status değeri FAILED veya PARTIAL_SUCCESS ise doldurulur. İstek request_status/PROCESSING durumundayken bu alan doldurulmaz.

warning_info

WarningInfo

Yüklemeyle ilgili uyarı nedenini ve uyarı sayısını içeren bir uyarı bilgisi. İstek request_status/PROCESSING durumundayken bu alan doldurulmaz.

status birleşik alanı. Hedefin durumu. status aşağıdakilerden yalnızca biri olabilir:
audience_members_ingestion_status

IngestAudienceMembersStatus

Kitle üyeleri isteğinin durumu.

events_ingestion_status

IngestEventsStatus

Alma etkinlikleri isteğinin durumu.

audience_members_removal_status

RemoveAudienceMembersStatus

Kitle üyelerini kaldırma isteğinin durumu.

remove_all_audience_members_status

RemoveAllAudienceMembersStatus

Tüm kitle üyelerini kaldırma isteğinin durumu.

DataType

Veri türü.

Sıralamalar
DATA_TYPE_UNSPECIFIED Veri türü belirtilmedi.
EMAIL Veriler bir e-posta adresidir.
PHONE_NUMBER Veriler telefon numarasıdır.
ADDRESS Veriler fiziksel adres olmalıdır.
IP_ADDRESS Veriler bir IP adresidir.

DataTypeCount

Belirli bir veri türünün sayısı.

Alanlar
type

DataType

Veri türü.

count

int64

Bu veri türünün sayısı.

IngestAudienceMembersStatus

Kitle üyeleri isteğinin durumu.

Alanlar
status birleşik alanı. Kitle üyelerinin hedefe aktarılma durumu. status aşağıdakilerden yalnızca biri olabilir:
user_data_ingestion_status

IngestUserDataStatus

Kullanıcı verilerinin hedefe veri kullanımı durumu.

mobile_data_ingestion_status

IngestMobileDataStatus

Mobil verilerin hedefe veri kullanımı durumu.

pair_data_ingestion_status

IngestPairDataStatus

Hedefe çift veri kullanımı durumu.

user_id_data_ingestion_status

IngestUserIdDataStatus

Kullanıcı kimliği verilerinin hedefe veri kullanımı durumu.

ppid_data_ingestion_status

IngestPpidDataStatus

PPID verilerinin hedefe veri kullanımı durumu.

composite_data_ingestion_status

IngestCompositeDataStatus

Hedefe bileşik veri kullanımı durumu.

google_user_id_data_ingestion_status

IngestGoogleUserIdDataStatus

Google kullanıcı kimliği verilerinin hedefe aktarılma durumu.

partner_provided_id_data_ingestion_status

IngestPartnerProvidedIdDataStatus

İş ortağı tarafından sağlanan kimlik verilerinin hedefte veri kullanımı durumu.

IngestCompositeDataStatus

İçeri aktarmayla ilgili istatistikleri içeren hedefe yönelik bileşik veri kullanımının durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

data_type_counts[]

DataTypeCount

Hedef için yükleme isteğinde gönderilen veri türlerinin toplam sayısı (veri türüne göre ayrılmış). Başarıyla alınmış olup olmamalarına bakılmaksızın, isteğin içerdiği tüm veri türlerini kapsar.

upload_match_rate_range

MatchRateRange

Yüklemenin eşleşme oranı aralığı.

IngestEventsStatus

Etkinliklerin hedefe aktarılma durumu.

Alanlar
record_count

int64

Yükleme isteğinde gönderilen etkinliklerin toplam sayısı. Başarıyla alınanlar da dahil olmak üzere, istekteki tüm etkinlikleri içerir.

IngestGoogleUserIdDataStatus

Google kullanıcı kimliği verilerinin, veri kullanımıyla ilgili istatistikleri içeren hedefe aktarılması durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

google_user_id_count

int64

Hedef için yükleme isteğinde gönderilen Google kullanıcı kimliklerinin toplam sayısı. Başarıyla yerleştirilip yerleştirilmediklerine bakılmaksızın, istekteki tüm Google kullanıcı kimliklerini içerir.

IngestMobileDataStatus

Hedefe mobil veri kullanımının durumu (kullanımla ilgili istatistikleri içerir).

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

mobile_id_count

int64

Hedef için yükleme isteğinde gönderilen mobil kimliklerin toplam sayısı. Başarıyla alınmış olup olmamalarına bakılmaksızın, istekteki tüm mobil kimlikleri içerir.

IngestPairDataStatus

İçeri aktarmayla ilgili istatistikleri içeren hedefteki çift veri kullanımı durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

pair_id_count

int64

Hedef için yükleme isteğinde gönderilen çift kimliklerinin toplam sayısı. Başarıyla alınmış olup olmamalarına bakılmaksızın, istekteki tüm çift kimliklerini içerir.

IngestPartnerProvidedIdDataStatus

İş ortağı tarafından sağlanan kimlik verilerinin, veri kullanımıyla ilgili istatistikleri içeren hedefe aktarılması durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

partner_provided_id_count

int64

Hedef için yükleme isteğinde gönderilen, iş ortağı tarafından sağlanan kimliklerin toplam sayısı. Başarıyla alınmış olup olmadıklarına bakılmaksızın, istekte bulunan iş ortağı tarafından sağlanan tüm kimlikleri içerir.

IngestPpidDataStatus

PPID verilerinin, almayla ilgili istatistikleri içeren hedefe alınma durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

ppid_count

int64

Hedef için yükleme isteğinde gönderilen ppıd'lerin toplam sayısı. Başarıyla alınmış olup olmamalarına bakılmaksızın, istekteki tüm ppıd'leri içerir.

IngestUserDataStatus

Hedefe kullanıcı verisi kullanımı durumu (kullanımla ilgili istatistikleri içerir).

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

user_identifier_count

int64

Hedef için yükleme isteğinde gönderilen kullanıcı tanımlayıcılarının toplam sayısı. Başarıyla alınmış olup olmamalarından bağımsız olarak, istekteki tüm kullanıcı tanımlayıcılarını içerir.

upload_match_rate_range

MatchRateRange

Yüklemenin eşleşme oranı aralığı.

IngestUserIdDataStatus

Kullanıcı kimliği verilerinin, almayla ilgili istatistikleri içeren hedefe veri kullanımının durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kitle üyelerini içerir.

user_id_count

int64

Hedef için yükleme isteğinde gönderilen kullanıcı kimliklerinin toplam sayısı. Başarıyla alındıklarından bağımsız olarak, istekteki tüm kullanıcı kimliklerini içerir.

RemoveAllAudienceMembersStatus

Bu türde alan yok.

Tüm kitle üyelerini kaldırma isteğinin durumu.

RemoveAudienceMembersStatus

Kitle üyelerini kaldırma isteğinin durumu.

Alanlar
status birleşik alanı. Kitle üyelerinin hedeften kaldırılma durumu. status aşağıdakilerden yalnızca biri olabilir:
user_data_removal_status

RemoveUserDataStatus

Hedefteki kullanıcı verilerinin kaldırılma durumu.

mobile_data_removal_status

RemoveMobileDataStatus

Mobil verilerin hedeften kaldırılma durumu.

pair_data_removal_status

RemovePairDataStatus

Hedefteki eşleme verilerinin kaldırılma durumu.

user_id_data_removal_status

RemoveUserIdDataStatus

Hedefteki kullanıcı kimliği verilerinin kaldırılma durumu.

ppid_data_removal_status

RemovePpidDataStatus

PPID verilerinin hedeften kaldırılma durumu.

composite_data_removal_status

RemoveCompositeDataStatus

Birleşik verilerin hedeften kaldırılma durumu.

google_user_id_data_removal_status

RemoveGoogleUserIdDataStatus

Google kullanıcı kimliği verilerinin hedeften kaldırılma durumu.

partner_provided_id_data_removal_status

RemovePartnerProvidedIdDataStatus

İş ortağı tarafından sağlanan kimlik verilerinin hedeften kaldırılma durumu.

RemoveCompositeDataStatus

Birleşik verilerin hedeften kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

data_type_counts[]

DataTypeCount

Kaldırma isteğinde gönderilen veri türlerinin toplam sayısı (veri türüne göre ayrılmış). Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm veri türlerini içerir.

RemoveGoogleUserIdDataStatus

Google kullanıcı kimliği verilerinin hedeften kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

google_user_id_count

int64

Kaldırma isteğinde gönderilen Google kullanıcı kimliklerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm Google kullanıcı kimliklerini içerir.

RemoveMobileDataStatus

Mobil verilerin hedeften kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

mobile_id_count

int64

Kaldırma talebinde gönderilen mobil kimliklerin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm mobil kimlikleri içerir.

RemovePairDataStatus

Hedefteki eşleme verilerinin kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

pair_id_count

int64

Kaldırma talebinde gönderilen eş kimliklerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm çift kimliklerini içerir.

RemovePartnerProvidedIdDataStatus

İş ortağı tarafından sağlanan kimlik verilerinin hedeften kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

partner_provided_id_count

int64

Kaldırma talebinde gönderilen, iş ortağı tarafından sağlanan kimliklerin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekte iş ortağı tarafından sağlanan tüm kimlikleri içerir.

RemovePpidDataStatus

PPID verilerinin hedeften kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

ppid_count

int64

Kaldırma talebinde gönderilen ppıd'lerin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm ppids'leri içerir.

RemoveUserDataStatus

Hedefteki kullanıcı verilerinin kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

user_identifier_count

int64

Kaldırma isteğinde gönderilen kullanıcı tanımlayıcılarının toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kullanıcı tanımlayıcılarını içerir.

RemoveUserIdDataStatus

Hedefteki kullanıcı kimliği verilerinin kaldırılma durumu.

Alanlar
record_count

int64

Kaldırma isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kitle üyelerini içerir.

user_id_count

int64

Kaldırma talebinde gönderilen kullanıcı kimliklerinin toplam sayısı. Başarıyla kaldırılıp kaldırılmadıklarına bakılmaksızın, istekteki tüm kullanıcı kimliklerini içerir.

RequestStatus

İsteğin durumu.

Sıralamalar
REQUEST_STATUS_UNKNOWN İstek durumu bilinmiyor.
SUCCESS Tüm kayıtlar hatasız olarak başarıyla işlendi. Ancak warning_info alanında uyarılar olabilir.
PROCESSING İstek işleniyor.
FAILED Tüm kayıtlar için işleme başarısız oldu. Hata ayrıntıları için error_info alanını, uyarı ayrıntıları için warning_info alanını kontrol edin.
PARTIAL_SUCCESS Bazı kayıtlar için işleme hatasız şekilde tamamlandı ancak diğer kayıtlar için hatalarla tamamlandı. Hata ayrıntıları için error_info alanını, uyarı ayrıntıları için warning_info alanını kontrol edin.

RetrieveInsightsRequest

DM API MarketingDataInsightsService.RetrieveInsights için istek mesajı

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. Kullanıcı listesinin sahibi olan ebeveyn hesabı. Biçim: accountTypes/{account_type}/accounts/{account}

baseline

Baseline

Zorunlu. İstenen analizlerin temeli.

user_list_id

string

Zorunlu. Analizlerin istendiği kullanıcı listesinin kimliği.

RetrieveInsightsResponse

DM API MarketingDataInsightsService.RetrieveInsights için yanıt mesajı

Alanlar
marketing_data_insights[]

MarketingDataInsight

Pazarlama verileriyle ilgili analizleri içerir.

MarketingDataInsight

Pazarlama verileriyle ilgili analizler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
dimension

AudienceInsightsDimension

Analizin ait olduğu boyut.

attributes[]

MarketingDataInsightsAttribute

Belirli bir boyutun değerleriyle ilgili analizler.

AudienceInsightsDimension

Analiz oluşturmada kullanılabilecek olası boyutlar.

Sıralamalar
AUDIENCE_INSIGHTS_DIMENSION_UNSPECIFIED Belirtilmedi.
AUDIENCE_INSIGHTS_DIMENSION_UNKNOWN Bu sürümde değer bilinmiyor.
AFFINITY_USER_INTEREST Bir yakın ilgi alanı UserInterest.
IN_MARKET_USER_INTEREST Pazardaki bir KullanıcıİlgiAlanı.
AGE_RANGE Yaş grubu.
GENDER Cinsiyet.

MarketingDataInsightsAttribute

Aynı boyuta ait bir grup ilgili özellik için analizler.

Alanlar
user_interest_id

int64

Kullanıcının ilgi alanı kimliği.

lift

float

Kitlenin, temel değerle karşılaştırıldığında özellik değeri için sahip olduğu artış ölçüsü. Aralık [0-1].

age_range

AgeRange

Artışın sağlandığı kitlenin yaş grubu.

gender

Gender

Artışın sağlandığı kitlenin cinsiyeti.

RetrieveRequestStatusRequest

Belirli bir istek kimliği için DM API'ye yapılan isteğin durumunu alma isteği. RetrieveRequestStatusResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
request_id

string

Zorunlu. Zorunlu. Data Manager API isteğinin istek kimliği.

RetrieveRequestStatusResponse

RetrieveRequestStatusRequest tarafından verilen yanıt.

Alanlar
request_status_per_destination[]

RequestStatusPerDestination

Hedef başına istek durumlarının listesi. Durumların sırası, orijinal istekteki hedeflerin sırasıyla eşleşir.

SearchPartnerLinksRequest

PartnerLink kaynaklarının aranmasını isteme SearchPartnerLinksResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
parent

string

Zorunlu. İş ortağı bağlantılarının aranacağı hesap. filter belirtilmezse bu hesabın owning_account veya partner_account olduğu tüm iş ortağı bağlantıları döndürülür.

Biçim: accountTypes/{account_type}/accounts/{account}

page_size

int32

Döndürülecek maksimum iş ortağı bağlantısı sayısı. Hizmet, bu değerden daha az sonuç döndürebilir. Belirtilmemesi halinde en fazla 50 iş ortağı bağlantısı döndürülür. Maksimum değer 100'dür. 100'den yüksek değerler 100'e zorlanır.

page_token

string

Önceki bir SearchPartnerLinks çağrısından alınan sayfa jetonu. Sonraki sayfayı almak için bunu sağlayın.

Sayfalara ayırma işlemi yapılırken SearchPartnerLinks öğesine sağlanan diğer tüm parametreler, sayfa jetonunu sağlayan çağrıyla eşleşmelidir.

filter

string

İsteğe bağlıdır. Filtre dizesi. Tüm alanlar her koşulun sol tarafında olmalıdır (örneğin: partner_link_id = 123456789). Alanlar, tümü camel case veya tümü snake case kullanılarak belirtilmelidir. Camel case ve snake case kombinasyonu kullanmayın.

Desteklenen işlemler:

  • AND
  • =
  • !=

Desteklenen alanlar:

  • partner_link_id
  • owning_account.account_type
  • owning_account.account_id
  • partner_account.account_type
  • partner_account.account_id
  • feature_set

FEATURE_SET_AD_EVENT_MANAGEMENT özellik setine sahip iş ortağı bağlantıları için aşağıdaki alanlar da desteklenir:

  • partner_customer_account.account_id
  • partner_link_metadata.implicit_accounts.account_id

Örnek: owning_account.account_type = "GOOGLE_ADS" AND partner_account.account_id = 987654321

SearchPartnerLinksResponse

SearchPartnerLinksRequest tarafından verilen yanıt.

Alanlar
next_page_token

string

Bir sonraki sayfayı almak için page_token olarak gönderilebilen bir jeton. Bu alan atlanırsa sonraki sayfa yoktur.

SizeInfo

Bu kullanıcı listesindeki üyelerin farklı hedef ağlardaki tahmini sayısı.

Alanlar
display_network_members_count

int64

Yalnızca çıkış. Google Görüntülü Reklam Ağı'ndaki bu kullanıcı listesinde bulunan üye sayısı tahmini.

search_network_members_count

int64

Yalnızca çıkış. google.com alanındaki bu kullanıcı listesinde tahmini üye sayısı. Bunlar, Arama Ağı kampanyalarında hedefleme için kullanılabilen üyelerdir.

youtube_members_count

int64

Yalnızca çıkış. YouTube'daki bu kullanıcı listesinde bulunan tahmini üye sayısı.

gmail_members_count

int64

Yalnızca çıkış. Bu kullanıcı listesindeki Gmail üyelerinin tahmini sayısı.

TargetNetworkInfo

Farklı hedef ağlar için uygunluk bilgileri.

Alanlar
eligible_for_display

bool

Yalnızca çıkış. Bu kullanıcı listesinin Google Görüntülü Reklam Ağı için uygun olduğunu gösterir.

TargetingType

Reklamı yayınlamak için kullanılan hedefleme türü.

Sıralamalar
TARGETING_TYPE_UNSPECIFIED Hedefleme türü belirtilmedi.
TARGETING_TYPE_AUDIENCE Kitle hedefleme.
TARGETING_TYPE_CONTEXTUAL İçeriğe dayalı hedefleme.
TARGETING_TYPE_DEMOGRAPHIC Demografik hedefleme.
TARGETING_TYPE_DEVICE Cihaz hedefleme.
TARGETING_TYPE_GEO Coğrafi hedefleme.
TARGETING_TYPE_INTEREST Kullanıcıların ilgilerine dayalı hedefleme.
TARGETING_TYPE_PURCHASE_INTENT Satın alma amacı hedefleme.
TARGETING_TYPE_REMARKETING Yeniden pazarlama hedefleme.

TermsOfService

Kullanıcının kabul ettiği/reddettiği hizmet şartları.

Alanlar
customer_match_terms_of_service_status

TermsOfServiceStatus

İsteğe bağlıdır. Müşteri Eşleştirme Hizmet Şartları: https://support.google.com/adspolicy/answer/6299717. Bu, UserData veya MobileData öğesi alınırken kabul edilmelidir. Bu alan, İş Ortağı Eşleştirme kullanıcı listesi için zorunlu değildir.

TermsOfServiceStatus

Arayanın hizmet şartlarını kabul etme veya reddetme kararını gösterir.

Sıralamalar
TERMS_OF_SERVICE_STATUS_UNSPECIFIED Belirtilmedi.
ACCEPTED Arayanın hizmet şartlarını kabul etmeyi seçtiğini gösteren durum.
REJECTED Arayanın hizmet şartlarını reddettiğini gösteren durum.

UpdateUserListDirectLicenseRequest

UserListDirectLicense kaynağının güncellenmesini isteme

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
user_list_direct_license

UserListDirectLicense

Zorunlu. Güncellenecek lisansı tanımlamak için lisansların name alanı kullanılır.

update_mask

FieldMask

İsteğe bağlıdır. Güncellenecek alanların listesi. * özel karakteri desteklenmez ve kullanılması durumunda INVALID_UPDATE_MASK hatası verilir.

UpdateUserListGlobalLicenseRequest

UserListGlobalLicense kaynağının güncellenmesini isteme

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
user_list_global_license

UserListGlobalLicense

Zorunlu. Güncellenecek lisansı tanımlamak için lisansların name alanı kullanılır.

update_mask

FieldMask

İsteğe bağlıdır. Güncellenecek alanların listesi. * özel karakteri desteklenmez ve kullanılması durumunda INVALID_UPDATE_MASK hatası verilir.

UpdateUserListRequest

UpdateUserList için istek mesajı.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
Alanlar
user_list

UserList

Zorunlu. Güncellenecek kullanıcı listesi.

Güncellenecek kullanıcı listesini belirlemek için kullanıcı listesinin name alanı kullanılır. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

update_mask

FieldMask

İsteğe bağlıdır. Güncellenecek alanların listesi.

validate_only

bool

İsteğe bağlıdır. Doğruysa istek doğrulanır ancak yürütülmez.

Kullanıcı

Tek bir kullanıcıyı temsil eder. Aynı kullanıcıya ait olan, kimliği tanımlayabilecek bilgiler ve mobil cihaz kimlikleri gibi tanımlayıcılar içerir.

Alanlar
user_data

UserData

Zorunlu. Kullanıcıyı tanımlamak için kullanılan, kullanıcı tarafından sağlanan veriler.

mobile_data

MobileData

Zorunlu. Tek bir kullanıcıyı temsil eden birden fazla mobil cihaz kimliği dizesi.

UserData

Kullanıcıyı tanımlayan veriler. En az bir tanımlayıcı gereklidir.

Alanlar
user_identifiers[]

UserIdentifier

Zorunlu. Kullanıcının tanımlayıcıları. Aynı türden verilerin birden fazla örneğini (örneğin, birden fazla e-posta adresi) sağlayabilirsiniz. Eşleşme olasılığını artırmak için mümkün olduğunca çok tanımlayıcı sağlayın. Tek bir AudienceMember veya Event içinde en fazla 10 userIdentifiers sağlanabilir.

UserIdData

Kullanıcı kimliğini içeren kullanıcı kimliği verileri.

Alanlar
user_id

string

Zorunlu. Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcı.

UserIdInfo

USER_ID, upload_key_types öğelerinden biri olduğunda ek bilgiler.

Alanlar
data_source_type

DataSourceType

İsteğe bağlıdır. Değiştirilemez. Yüklenen verilerin kaynağı.

UserIdentifier

Kullanıcı için tek bir tanımlayıcı.

Alanlar
identifier birleşik alanı. Tam olarak bir tane belirtilmelidir. identifier aşağıdakilerden yalnızca biri olabilir:
email_address

string

Normalleştirme işleminden sonra SHA-256 karma işlevi kullanılarak karma oluşturma işlemi uygulanmış e-posta adresi.

phone_number

string

Normalleştirme (E164 standardı) işleminden sonra SHA-256 karma işlevi kullanılarak karma oluşturma işlemi uygulanmış telefon numarası.

address

AddressInfo

Kullanıcının adresinin bilinen bileşenleri. Tüm tanımlayıcıların aynı anda eşleştirildiği bir gruplandırma içerir.

UserList

Kullanıcı listesi kaynağı.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesinin kaynak adı. Biçim: accountTypes/{account_type}/accounts/{account}/userLists/{user_list}

id

int64

Yalnızca çıkış. Kullanıcı listesinin benzersiz kimliği.

read_only

bool

Yalnızca çıkış. Kullanıcının listeyi düzenleyip düzenleyemeyeceğini belirten bir seçenek.

membership_duration

Duration

İsteğe bağlıdır. Bir kullanıcının kullanıcı listesinde kalma süresi. Geçerli süreler, 24 saatin (86.400 saniye) tam katlarıdır. 24 saatin tam katı olmayan bir değer girilmesi INVALID_ARGUMENT hatasına neden olur.

access_reason

AccessReason

Yalnızca çıkış. Bu hesaba listeye erişim izni verilmesinin nedeni.

size_info

SizeInfo

Yalnızca çıkış. Bu kullanıcı listesindeki üyelerin farklı hedef ağlardaki tahmini sayısı.

target_network_info

TargetNetworkInfo

İsteğe bağlıdır. Farklı hedef ağlar için uygunluk bilgileri.

display_name

string

Zorunlu. Kullanıcı listesinin görünen adı.

description

string

İsteğe bağlıdır. Kullanıcı listesinin açıklaması.

membership_status

MembershipStatus

İsteğe bağlıdır. Bu kullanıcı listesinin üyelik durumu.

integration_code

string

İsteğe bağlıdır. Harici sistemden alınan bir kimlik. Kullanıcı listesi satıcıları, sistemlerindeki kimlikleri ilişkilendirmek için bu parametreyi kullanır.

closing_reason

ClosingReason

Yalnızca çıkış. Bu kullanıcı listesi üyelik durumunun kapalı olmasının nedeni.

account_access_status

AccessStatus

İsteğe bağlıdır. Bu paylaşımın hâlâ etkin olup olmadığını gösterir. Bir kullanıcı listesi hesapla paylaşıldığında bu alan ENABLED olarak ayarlanır. Daha sonra kullanıcı listesi sahibi, paylaşımı iptal edip listeyi DISABLED yapabilir.

user_list_info birleşik alanı. Kullanıcı listesi hakkında ek bilgiler. user_list_info aşağıdakilerden yalnızca biri olabilir:
ingested_user_list_info

IngestedUserListInfo

İsteğe bağlıdır. Kullanıcı tarafından alınan verilerle doldurulan bir kullanıcı listesini temsil eder.

AccessReason

Olası erişim nedenlerini açıklayan enum veri türü.

Sıralamalar
ACCESS_REASON_UNSPECIFIED Belirtilmedi.
OWNED Kaynak, kullanıcının mülkiyetindedir.
SHARED Kaynak, kullanıcıyla paylaşılır.
LICENSED Kaynak, kullanıcıya lisanslanmıştır.
SUBSCRIBED Kullanıcı, kaynağa abone oldu.
AFFILIATED Kaynak, kullanıcı tarafından erişilebilir.

AccessStatus

Bu istemcinin listeye erişimi olup olmadığını gösterir.

Sıralamalar
ACCESS_STATUS_UNSPECIFIED Belirtilmedi.
ENABLED Erişim etkinleştirilmiş olmalıdır.
DISABLED Erişim devre dışı bırakıldı.

ClosingReason

Kullanıcı listesinin kapatılma nedenini gösterir. Bu enum yalnızca bir liste sistem tarafından otomatik olarak kapatıldığında kullanılır.

Sıralamalar
CLOSING_REASON_UNSPECIFIED Belirtilmedi.
UNUSED Kullanıcı listesi, son zamanlarda hedeflemede kullanılmadığı için kapatıldı. Ayrıntılı bilgi için https://support.google.com/google-ads/answer/2472738 adresine göz atın.

MembershipStatus

Kullanıcı listesinin durumu.

Sıralamalar
MEMBERSHIP_STATUS_UNSPECIFIED Belirtilmedi.
OPEN Açık durum: Kullanıcı listesine üye eklenmeye devam ediliyor ve liste hedeflenebiliyor.
CLOSED Kapalı durumu: Yeni üye eklenmez.

UserListDirectLicense

Kullanıcı listesi doğrudan lisansı.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesi doğrudan lisansının kaynak adı.

user_list_display_name

string

Yalnızca çıkış. Lisans verilen kullanıcı listesinin adı.

Bu alan salt okunurdur.

client_account_display_name

string

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin adı.

Bu alan salt okunurdur.

pricing

UserListLicensePricing

İsteğe bağlıdır. UserListDirectLicense fiyatlandırması.

historical_pricings[]

UserListLicensePricing

Yalnızca çıkış. Bu kullanıcı listesi lisansının fiyatlandırma geçmişi.

Bu alan salt okunurdur.

metrics

UserListLicenseMetrics

Yalnızca çıkış. Bu lisansla ilgili metrikler

Bu alan salt okunurdur ve yalnızca ListUserListDirectLicenses çağrısında başlangıç ve bitiş tarihleri ayarlanırsa doldurulur.

user_list_id

int64

Değiştirilemez. Lisans verilen kullanıcı listesinin kimliği.

client_account_type

UserListLicenseClientAccountType

Değiştirilemez. Kullanıcı listesinin lisanslandığı müşteri müşterisinin hesap türü.

client_account_id

int64

Değiştirilemez. Kullanıcı listesinin lisanslandığı müşteri müşterisinin kimliği.

status

UserListLicenseStatus

İsteğe bağlıdır. UserListDirectLicense'ın durumu: ENABLED veya DISABLED.

UserListGlobalLicense

Bir kullanıcı listesi genel lisansı.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesi genel lisansının kaynak adı.

user_list_display_name

string

Yalnızca çıkış. Lisans verilen kullanıcı listesinin adı.

Bu alan salt okunurdur.

pricing

UserListLicensePricing

İsteğe bağlıdır. UserListGlobalLicense fiyatlandırması.

historical_pricings[]

UserListLicensePricing

Yalnızca çıkış. Bu kullanıcı listesi lisansının fiyatlandırma geçmişi.

Bu alan salt okunurdur.

metrics

UserListLicenseMetrics

Yalnızca çıkış. Bu lisansla ilgili metrikler

Bu alan salt okunurdur ve yalnızca ListUserListGlobalLicenses çağrısında başlangıç ve bitiş tarihleri ayarlanırsa doldurulur.

user_list_id

int64

Değiştirilemez. Lisans verilen kullanıcı listesinin kimliği.

license_type

UserListGlobalLicenseType

Değiştirilemez. Kullanıcı listesinin lisanslandığı müşteri müşterisinin ürün türü.

status

UserListLicenseStatus

İsteğe bağlıdır. UserListGlobalLicense'ın durumu: ENABLED veya DISABLED.

UserListGlobalLicenseCustomerInfo

Kullanıcı listesi genel lisansının müşterisi hakkında bilgiler. Bu, bir müşteri global lisans satın aldığında sistem tarafından otomatik olarak oluşturulur.

Alanlar
name

string

Tanımlayıcı. Kullanıcı listesi global lisans müşterisinin kaynak adı.

user_list_id

int64

Yalnızca çıkış. Lisans verilen kullanıcı listesinin kimliği.

user_list_display_name

string

Yalnızca çıkış. Lisans verilen kullanıcı listesinin adı.

license_type

UserListGlobalLicenseType

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin ürün türü.

status

UserListLicenseStatus

Yalnızca çıkış. UserListDirectLicense'ın durumu: ENABLED veya DISABLED.

pricing

UserListLicensePricing

Yalnızca çıkış. UserListDirectLicense fiyatlandırması.

client_account_type

UserListLicenseClientAccountType

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin ürün türü.

client_account_id

int64

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin kimliği.

client_account_display_name

string

Yalnızca çıkış. Kullanıcı listesinin lisanslandığı müşteri müşterisinin adı.

historical_pricings[]

UserListLicensePricing

Yalnızca çıkış. Bu kullanıcı listesi lisansının fiyatlandırma geçmişi.

metrics

UserListLicenseMetrics

Yalnızca çıkış. Bu lisansla ilgili metrikler

Bu alan yalnızca ListUserListGlobalLicenseCustomerInfos çağrısında başlangıç ve bitiş tarihleri ayarlanmışsa doldurulur.

UserListGlobalLicenseType

Kullanıcı listesi genel lisans türleri.

Sıralamalar
USER_LIST_GLOBAL_LICENSE_TYPE_UNSPECIFIED BELİRTİLMEMİŞ.
USER_LIST_GLOBAL_LICENSE_TYPE_RESELLER Bayi lisansı.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_SELL_SIDE DataMart Sell Side lisansı.
USER_LIST_GLOBAL_LICENSE_TYPE_DATA_MART_BUY_SIDE DataMart Buy Side lisansı.

UserListLicenseClientAccountType

Kullanıcı listesi lisansı için bir müşteri hesabının olası ürünü.

Sıralamalar
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_UNKNOWN Bilinmiyor.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_GOOGLE_ADS Google Ads müşterisi.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
USER_LIST_LICENSE_CLIENT_ACCOUNT_TYPE_DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni.

UserListLicenseMetrics

Kullanıcı listesi lisansıyla ilgili metrikler.

Alanlar
click_count

int64

Yalnızca çıkış. Kullanıcı listesi lisansının tıklanma sayısı.

impression_count

int64

Yalnızca çıkış. Kullanıcı listesi lisansının gösterim sayısı.

revenue_usd_micros

int64

Yalnızca çıkış. ABD doları (mikro) cinsinden kullanıcı listesi lisansının geliri.

start_date

int64

Yalnızca çıkış. Metriklerin başlangıç tarihi (dahil) YYYYAAGG biçiminde. Örneğin, 20260102 ifadesi 2 Ocak 2026'yı gösterir. Filtrede end_date kullanılıyorsa start_date da gereklidir. Filtreye ne start_date ne de end_date dahil edilirse yanıtta UserListLicenseMetrics alanları doldurulmaz.

end_date

int64

Yalnızca çıkış. Metriklerin bitiş tarihi (dahil) YYYYAAGG biçiminde. Örneğin, 20260102 ifadesi 2 Ocak 2026'yı gösterir. Filtrede start_date kullanılıyorsa end_date da gereklidir. Filtreye ne start_date ne de end_date dahil edilirse yanıtta UserListLicenseMetrics alanları doldurulmaz.

UserListLicensePricing

Kullanıcı listesi lisans fiyatlandırması.

Alanlar
pricing_id

int64

Yalnızca çıkış. Bu fiyatlandırmanın kimliği.

start_time

Timestamp

Yalnızca çıkış. Fiyatlandırmanın başlangıç zamanı.

end_time

Timestamp

İsteğe bağlıdır. Fiyatlandırmanın bitiş zamanı.

pricing_active

bool

Yalnızca çıkış. Bu fiyatlandırmanın etkin olup olmadığı.

buyer_approval_state

UserListPricingBuyerApprovalState

Yalnızca çıkış. Bu fiyatlandırmanın alıcı onayı durumu.

Bu alan salt okunurdur.

cost_micros

int64

İsteğe bağlıdır. Modelle ilişkili maliyet, para birimi kodu alanında belirtilen para biriminde mikro birimler (10^-6) cinsinden. Örneğin, 2000000 değeri, currency_code USD ise 2 ABD doları anlamına gelir.

currency_code

string

İsteğe bağlıdır. Maliyet ve max_cost değerinin belirtildiği para birimi. ISO 4217'de tanımlanan üç harfli bir para birimi kodu olmalıdır.

cost_type

UserListPricingCostType

Değiştirilemez. Bu fiyatlandırmanın maliyet türü.

Yalnızca create işleminde ayarlanabilir. Mevcut bir lisans için güncellenemez.

max_cost_micros

int64

İsteğe bağlıdır. MEDIA_SHARE maliyet türü kullanıldığında ticari bir kitlenin ücretlendirilebileceği maksimum BGBM. Değer, mikro birimler (10^-6) cinsinden ve currency_code alanı tarafından belirtilen para birimindedir. Örneğin, 2000000 değeri, currency_code USD ise 2 ABD doları anlamına gelir.

Bu yalnızca cost_type MEDIA_SHARE olduğunda geçerlidir. cost_type MEDIA_SHARE olmadığında ve bu alan ayarlandığında MAX_COST_NOT_ALLOWED hatası döndürülür. Ayarlanmazsa veya 0 değerine ayarlanırsa sınır yoktur.

UserListPricingBuyerApprovalState

Kullanıcı listesi fiyatlandırması alıcı onayı durumu.

Sıralamalar
USER_LIST_PRICING_BUYER_APPROVAL_STATE_UNSPECIFIED BELİRTİLMEMİŞ.
PENDING Kullanıcı listesi istemcisi, kullanıcı listesi sahibi tarafından belirlenen fiyatlandırma şartlarını henüz kabul etmemiştir.
APPROVED Kullanıcı listesi istemcisi, kullanıcı listesi sahibi tarafından belirlenen fiyatlandırma şartlarını kabul etmiştir.
REJECTED Kullanıcı listesi istemcisi, kullanıcı listesi sahibi tarafından belirlenen fiyatlandırma şartlarını reddetti.

UserListPricingCostType

Kullanıcı listesi fiyatlandırması maliyet türü.

Sıralamalar
USER_LIST_PRICING_COST_TYPE_UNSPECIFIED Belirtilmedi.
CPC Tıklama başına maliyet.
CPM Bin gösterim başına maliyet.
MEDIA_SHARE Medya paylaşımı

UserListLicenseStatus

Kullanıcı listesi lisans durumu.

Sıralamalar
USER_LIST_LICENSE_STATUS_UNSPECIFIED Bilinmiyor.
USER_LIST_LICENSE_STATUS_ENABLED Etkin durum: Kullanıcı listesi lisanslanmaya devam ediyor.
USER_LIST_LICENSE_STATUS_DISABLED Etkin olmayan durum: Kullanıcı listesi artık lisanslanmıyor.

UserProperties

Etkinliğin gerçekleştiği sırada kullanıcı hakkında reklamveren tarafından değerlendirilen bilgiler. Daha fazla bilgi için https://support.google.com/google-ads/answer/14007601 adresini ziyaret edin.

Alanlar
customer_type

CustomerType

İsteğe bağlıdır. Etkinlikle ilişkili müşterinin türü.

customer_value_bucket

CustomerValueBucket

İsteğe bağlıdır. Müşterinin reklamveren tarafından değerlendirilen değeri.

additional_user_properties[]

UserProperty

İsteğe bağlıdır. Bu etkinlikle ilişkilendirilen kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir grup.

UserProperty

Bu etkinlikle ilişkilendirilen kullanıcı için ek kullanıcı özelliklerinin bulunduğu bir grup.

Alanlar
property_name

string

Zorunlu. Kullanılacak kullanıcı özelliğinin adı.

value

string

Zorunlu. Kullanılacak kullanıcı özelliği değerinin dize gösterimi.

ViewType

Etkinliğin türü.

Sıralamalar
VIEW_TYPE_UNSPECIFIED Belirtilmemiş görünüm türü.
VIEW_TYPE_MRC_VIEWED MRC görüntülendi.
VIEW_TYPE_MRC_RENDERED MRC oluşturuldu.

ViewabilityInfo

Yayınlanan reklamın görüntülenebilirliğiyle ilgili ayrıntılar.

Alanlar
view_type

ViewType

Zorunlu. Etkinliğin türü.

viewable_percent

int32

İsteğe bağlıdır. Görüntülenebilir piksellerin sayısal yüzdesi (0-100).

viewable_duration

Duration

İsteğe bağlıdır. Reklamın görüntülenebilir olduğu süre.

media_skippable

bool

İsteğe bağlıdır. Reklam medyasının atlanabilir olup olmadığı.

media_quartile

MediaQuartile

İsteğe bağlıdır. Medyanın ayrı çeyrekler halinde oynatılan kısmı.

media_duration

Duration

İsteğe bağlıdır. Reklam medyasının süresi.

media_volume_percent

int32

İsteğe bağlıdır. Medya oynatmanın ses düzeyinin sayısal yüzdesi (0-100).

playback_duration

Duration

İsteğe bağlıdır. Reklam medyasının görüntülenebilir olup olmadığına bakılmaksızın oynatma süresi.

WarningCount

Belirli bir uyarı nedenine ilişkin uyarı sayısı.

Alanlar
record_count

int64

Uyarı içeren kayıtların sayısı.

reason

ProcessingWarningReason

Uyarı nedeni.

WarningInfo

Her uyarı türü için uyarı sayısı.

Alanlar
warning_counts[]

WarningCount

Uyarı nedenine göre uyarı listesi ve sayısı.

WarningReason

Alım sırasında döndürülen engellemeyen uyarıların nedenleri.

Sıralamalar
WARNING_REASON_UNSPECIFIED Belirtilmeyen uyarı nedeni.
WARNING_REASON_CUSTOM_VARIABLE_NOT_ENABLED custom_variables'daki bir özelleştirilebilen değişken hesapta etkinleştirilmemiştir.
WARNING_REASON_CUSTOM_VARIABLE_NOT_PREDEFINED custom_variables içindeki bir özelleştirilebilen değişken değeri, hedef hesaptaki özelleştirilebilen değişken için yapılandırılmış önceden tanımlanmış izin verilen değerler arasında değil.
WARNING_REASON_CART_DATA_NOT_SUPPORTED_WITH_GBRAID_OR_WBRAID cart_data, gbraid veya wbraid ile desteklenmez.
WARNING_REASON_CART_DATA_ITEM_MERCHANT_PRODUCT_ID_MISSING Alışveriş sepeti öğesinde merchant_product_id eksik.
WARNING_REASON_CART_DATA_ITEM_UNIT_PRICE_MISSING Alışveriş sepeti öğesinde unit_price eksik.
WARNING_REASON_GENERIC Diğer belirli kategorilere uymayan sorunlar için genel uyarı nedeni.
WARNING_REASON_INVALID_CLIENT_ID client_id geçersiz.
WARNING_REASON_INVALID_SUBDIVISION_CODE subdivision_code geçersiz.
WARNING_REASON_INVALID_REGION_CODE region_code geçersiz.
WARNING_REASON_INVALID_SUBCONTINENT_CODE subcontinent_code geçersiz.
WARNING_REASON_INVALID_CONTINENT_CODE continent_code geçersiz.
WARNING_REASON_INVALID_DEVICE_CATEGORY category cihazı geçersiz.
WARNING_REASON_INVALID_DEVICE_SCREEN_RESOLUTION Cihaz screen_height veya screen_width geçersiz.
WARNING_REASON_INVALID_MERCHANT_ID merchant_id geçersiz.