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

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 cihazla ilgili 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ı (son 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.
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
consent

Consent

İsteğe bağlıdır. Kullanıcının izin ayarı.
Birleştirme alanı data. Üzerinde işlem yapılacak tanımlayıcı verilerin türü. data yalnızca aşağıdakilerden 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'in 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ı (DPY) 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şsa 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 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ıdan veri eklemek veya kaldırmak için bu login_account kullanıcısının operating_account adlı kullanıcıya yazma erişimi 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 bir hesap. Örneğin, bir veri iş ortağının login_account, bir müşterinin linked_account erişebilir. İş ortağı, bu alanı linked_account hizmetinden başka bir operating_account hizmetine veri göndermek için 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 veya Display & Video 360 kitle 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ılarla paylaşılmasını koşullu olarak hariç tutacak bir 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
Birleştirme alanı wrapped_key. Verileri şifrelemek için kullanılan sarmalanmış anahtar. wrapped_key yalnızca aşağıdakilerden biri olabilir:
gcp_wrapped_key_info

GcpWrappedKeyInfo

Google Cloud Platform ile ilgili özet bilgiler.

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'lara gönderilir.
transaction_id

string

Zorunlu. Bu etkinliğin benzersiz tanımlayıcısı.
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 içi 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.
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.

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, isteğin 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.

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, isteğin 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.

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 verileri. Tek bir AudienceMember içinde en fazla 10 pairIds sağlanabilir.

Ürün

Belirli bir Google ürününü temsil eder. Hesapları ve hedefleri bulmak için kullanılır.

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

Product

Zorunlu. Hesabın ait olduğu ürün. Örneğin, GOOGLE_ADS.
account_id

string

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

RemoveAudienceMembersRequest

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

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.

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, Müşteri Eşleştirme kullanıcı listelerine yapılan tüm yüklemeler için kabul edilmelidir.

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
Birleştirme alanı identifier. Tam olarak bir tane belirtilmelidir. identifier yalnızca aşağıdakilerden 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. 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.