Package google.ads.datamanager.v1

Dizin

IngestionService

Kitle verilerini desteklenen hedeflere gönderme hizmeti.

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
RemoveAudienceMembers

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

Belirtilen Destination içinden AudienceMember kaynak listesini kaldırır.

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

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 modelleme 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önlendirme sırasında kullanılan cihaz hakkında toplanan bilgiler (varsa).

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ı (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ış).
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.

AudienceMember

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

Alanlar
destination_references[]

string

İsteğe bağlıdır. Kitle üyesinin hangi Destination'ye 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.
mobile_data

MobileData

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

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 feed'deki öğelerin 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.

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 izin belirtip belirtmediğini gösterir.

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

Ö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 değerlerinden 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çbir zaman 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çbir zaman kullanılmamalıdır.
LOW Müşterinin değeri düşük.
MEDIUM Müşteri, orta değere sahip.
HIGH Müşteri yüksek değere sahip.

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 kaynağına başvuruda bulunmak 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 adlı kullanıcı, operating_account adlı kullanıcının verilerini eklemek veya kaldırmak için operating_account adlı kullanıcıya yazma erişimine sahip olmalıdır.login_account Ö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 bir 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

Zorunlu. Ürün hesabında verilerin alınacağı nesne. Örneğin, Google Ads kitle kimliği, Display & Video 360 kitle kimliği veya Google Ads dönüşüm işlemi kimliği.

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.

Not: Google Ads, Avrupa Ekonomik Alanı (AEA), Birleşik Krallık (UK) veya İsviçre'deki (CH) son kullanıcılar için IP adresi eşleştirmeyi desteklemez. IP adreslerinin bu bölgelerdeki kullanıcılardan paylaşımını koşullu olarak hariç tutmak için mantık ekleyin ve kullanıcılara sitelerinizde, uygulamalarınızda ve diğer mülklerinizde topladığınız verilerle ilgili açık ve kapsamlı bilgiler sağladığınızdan ve yasalar veya geçerli Google politikaları uyarınca gerekli olduğu durumlarda izin aldığınızdan emin olun. Daha fazla bilgi için Çevrimdışı dönüşümlerin içe aktarılması hakkında başlıklı sayfayı inceleyin.

Kodlama

Karma oluşturma işlemi uygulanmış tanımlayıcı bilgilerin kodlama türü.

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

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 ile ilgili özet bilgiler.

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ıları. Bazı durumlarda doldurulmayabilir.

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ş bırakılırsa etkinlik, istekteki tüm destinations'lara gönderilir.
transaction_id

string

İsteğe bağlıdır. Bu etkinliğin benzersiz tanımlayıcısı. Birden fazla veri kaynağı kullanan dönüşümler 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üncellenme 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ı türlerde izin verip vermediğiyle ilgili 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.
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.
event_source

EventSource

İsteğe bağlıdır. Etkinliğin gerçekleştiği yerle ilgili sinyal (web, uygulama, mağaza vb.).
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 bilgiler.
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.

EventSource

Etkinliğin kaynağı.

Sıralamalar
EVENT_SOURCE_UNSPECIFIED Belirtilmemiş EventSource. Hiçbir zaman kullanılmamalıdır.
WEB Etkinlik bir 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.
OTHER Etkinlik, diğer kaynaklardan oluşturuldu.

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ın ayarlanacağı değer.

GcpWrappedKeyInfo

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

Alanlar
key_type

KeyType

Zorunlu. Verileri şifrelemek için kullanılan algoritmanın türü.
wip_provider

string

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

string

Zorunlu. Google Cloud Platform Cloud Key Management Service kaynak kimliği. "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 algoritmanın türü.

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

IngestAudienceMembersRequest

Kitle üyelerinin, belirtilen hedeflere yüklenmesi isteği. IngestAudienceMembersResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
REST ile deneyin
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. İstek düzeyinde izin, istekteki tüm kullanıcılar için geçerli olur. 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 gereklidir. 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 kullanıcı tanımlayıcıları için bu, içteki karma dizeyi değil, dıştaki şifrelenmiş dizenin kodlama türüdür. Yani içteki karma dize, dıştaki şifrelenmiş dizeden farklı bir şekilde kodlanabilir. UserData dışındaki yüklemeler için bu alan yoksayılır.
encryption_info

EncryptionInfo

İsteğe bağlıdır. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için 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.

IngestEventsRequest

Kitle üyelerinin, belirtilen hedeflere yüklenmesi isteği. IngestEventsResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
REST ile deneyin
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. İstek düzeyinde izin, istekteki tüm kullanıcılar için geçerli olur. 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 gereklidir. 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 kullanıcı tanımlayıcıları için bu, içteki karma dizeyi değil, dıştaki şifrelenmiş dizenin kodlama türüdür. Yani içteki karma dize, dıştaki şifrelenmiş dizeden farklı bir şekilde kodlanabilir. UserData dışındaki yüklemeler için bu alan yoksayılır.
encryption_info

EncryptionInfo

İsteğe bağlıdır. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için bu alan yoksayılır.

IngestEventsResponse

IngestEventsRequest tarafından verilen yanıt.

Alanlar
request_id

string

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

Öğ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.

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 az ([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).

MobileData

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

Alanlar
mobile_ids[]

string

Zorunlu. Mobil cihaz kimliklerinin (reklam kimliği/IDFA) listesi. Tek bir AudienceMember içinde en fazla 10 mobileIds sağlanabilir.

PairData

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

Alanlar
pair_ids[]

string

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

ProcessingErrorReason

İşleme hatasının nedeni.

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ış 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_USER_IDENTIFIER_DECRYPTION_ERROR DEK kullanılarak UserIdentifier verilerinin şifresi çözülemedi.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER Kullanıcı, işletim hesabının reklamlarına ait olmayan bir reklam tanımlayıcısıyla etkinlikleri alma girişiminde bulundu.

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ış 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.

Ü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çbir zaman kullanılmamalıdır.
GOOGLE_ADS Google Ads
DISPLAY_VIDEO_PARTNER Display & Video 360 iş ortağı.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 reklamvereni olmanız gerekir.
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

İsteğe bağlıdır. Hesabın türü. Örneğin, GOOGLE_ADS. account_type veya kullanımdan kaldırılan product gereklidir. Her ikisi de ayarlanmışsa değerler eşleşmelidir.

AccountType

Google Hesabı türlerini temsil eder. Hesapları ve hedefleri bulmak için kullanılır.

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

RemoveAudienceMembersRequest

Kullanıcıların, sağlanan hedeflerdeki bir kitleye erişiminin kaldırılması isteği. RemoveAudienceMembersResponse değerini döndürür.

Bu yöntemi REST API Gezgini'nde deneyebilirsiniz:
REST ile deneyin
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 gereklidir. 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üklemeler için bu alan yoksayılır.
encryption_info

EncryptionInfo

İsteğe bağlıdır. UserData yüklemeleri için şifreleme bilgileri. Ayarlanmamışsa yüklenen tanımlayıcı bilgilerin hashing uygulandığı ancak şifrelenmediği varsayılır. UserData dışındaki yüklemeler için bu alan yoksayılır.

RemoveAudienceMembersResponse

RemoveAudienceMembersRequest tarafından verilen yanıt.

Alanlar
request_id

string

İsteğin otomatik olarak oluşturulan 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ı.
warning_info

WarningInfo

Yüklemeyle ilgili uyarı nedenini ve uyarı sayısını içeren bir uyarı bilgisi.
status birleşik alanı. Hedefin durumu. status aşağıdakilerden yalnızca biri olabilir:
audience_members_ingestion_status

IngestAudienceMembersStatus

Kitle üyelerinin alım isteğinin durumu.
events_ingestion_status

IngestEventsStatus

Alma etkinlikleri isteğinin durumu.
audience_members_removal_status

RemoveAudienceMembersStatus

Kitle üyelerini kaldırma isteğinin durumu.

IngestAudienceMembersStatus

Kitle üyelerinin alım isteğinin durumu.

Alanlar
status birleşik alanı. Kitle üyelerinin hedefte yerleştirilme durumu. status aşağıdakilerden yalnızca biri olabilir:
user_data_ingestion_status

IngestUserDataStatus

Kullanıcı verilerinin hedefe aktarılma durumu.
mobile_data_ingestion_status

IngestMobileDataStatus

Hedefe mobil veri alımının durumu.
pair_data_ingestion_status

IngestPairDataStatus

Hedefe çift veri alımının durumu.

IngestEventsStatus

Etkinliklerin hedefe aktarılma durumu.

Alanlar
record_count

int64

Yükleme isteğinde gönderilen etkinliklerin toplam sayısı. Başarıyla alınan veya alınmayan tüm etkinlikleri içerir.

IngestMobileDataStatus

İçeri aktarmayla ilgili istatistikleri içeren hedefe mobil veri alı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ınmış olsun veya olmasın, isteğe dahil edilen 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 beslenip beslenmediklerine bakılmaksızın, istekteki tüm mobil kimlikleri içerir.

IngestPairDataStatus

İçe aktarma ile ilgili istatistikleri içeren hedefteki çift verilerin içe aktarılma durumu.

Alanlar
record_count

int64

Hedef için yükleme isteğinde gönderilen kitle üyelerinin toplam sayısı. Başarıyla alınmış olsun veya olmasın, isteğe dahil edilen 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 beslenip beslenmediklerine bakılmaksızın, istekteki tüm çift kimliklerini içerir.

IngestUserDataStatus

Hedefe kullanıcı verisi alımının durumu (alım ile 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ınmış olsun veya olmasın, isteğe dahil edilen 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 olmadıklarına bakılmaksızın, istekteki tüm kullanıcı tanımlayıcılarını içerir.
upload_match_rate_range

MatchRateRange

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

RemoveAudienceMembersStatus

Kitle üyelerini kaldırma isteğinin durumu.

Alanlar
status birleşik alanı. Kitle üyelerinin hedef kitleden 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.

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 isteğinde 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.

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 talebinde 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.

RequestStatus

İsteğin durumu.

Sıralamalar
REQUEST_STATUS_UNKNOWN İstek durumu bilinmiyor.
SUCCESS İstek başarılı oldu.
PROCESSING İstek işleniyor.
FAILED İstek gerçekleştirilemedi.
PARTIAL_SUCCESS İstek kısmen başarılı oldu.

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:
REST ile deneyin
Alanlar
request_id

string

Zorunlu. Zorunlu. Veri Yöneticisi 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.

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. UserData veya MobileData öğeleri içe aktarılırken bu 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.

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 fazla tanımlayıcı sağlayın. Tek bir AudienceMember veya Event içinde en fazla 10 userIdentifiers sağlanabilir.

UserIdentifier

Kullanıcı için tek 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şturulmuş 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. Bir kerede eşleştirilen tanımlayıcıların gruplandırmasını içerir.

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.

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ıların listesi ve sayısı.