Package google.ads.datamanager.v1

इंडेक्स

IngestionService

यह सेवा, ऑडियंस का डेटा उन डेस्टिनेशन को भेजती है जहां यह सुविधा काम करती है.

IngestAudienceMembers

rpc IngestAudienceMembers(IngestAudienceMembersRequest) returns (IngestAudienceMembersResponse)

यह फ़ंक्शन, दिए गए Destination में AudienceMember संसाधनों की सूची अपलोड करता है.

अनुमति के स्कोप

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

rpc IngestEvents(IngestEventsRequest) returns (IngestEventsResponse)

इस फ़ंक्शन की मदद से, दी गई Destination से Event रिसॉर्स की सूची अपलोड की जाती है.

अनुमति के स्कोप

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

rpc RemoveAudienceMembers(RemoveAudienceMembersRequest) returns (RemoveAudienceMembersResponse)

यह फ़ंक्शन, दिए गए Destination से AudienceMember संसाधनों की सूची को हटाता है.

अनुमति के स्कोप

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

AdIdentifiers

इस कुकी में आइडेंटिफ़ायर और अन्य जानकारी होती है. इसका इस्तेमाल, कन्वर्ज़न इवेंट को अन्य ऑनलाइन गतिविधि (जैसे कि विज्ञापन पर क्लिक) से मैच करने के लिए किया जाता है.

फ़ील्ड
session_attributes

string

ज़रूरी नहीं. इवेंट एट्रिब्यूशन और मॉडलिंग के लिए सेशन एट्रिब्यूट.
gclid

string

ज़रूरी नहीं. इस इवेंट से जुड़ा Google क्लिक आईडी (gclid).
gbraid

string

ज़रूरी नहीं. iOS डिवाइसों से होने वाले ऐप्लिकेशन इवेंट से जुड़े क्लिक के लिए क्लिक आइडेंटिफ़ायर. ये डिवाइस, iOS14 या इसके बाद के वर्शन वाले होते हैं.
wbraid

string

ज़रूरी नहीं. iOS डिवाइसों से होने वाले वेब इवेंट से जुड़े क्लिक के लिए क्लिक आइडेंटिफ़ायर. ये डिवाइस, iOS14 या इसके बाद के वर्शन वाले होते हैं.
landing_page_device_info

DeviceInfo

ज़रूरी नहीं. विज्ञापन से इंटरैक्ट करने के बाद, विज्ञापन देने वाले व्यक्ति या कंपनी की साइट पर पहुंचने के समय इस्तेमाल किए जा रहे डिवाइस के बारे में इकट्ठा की गई जानकारी.

AddressInfo

उपयोगकर्ता के पते की जानकारी.

फ़ील्ड
given_name

string

ज़रूरी है. उपयोगकर्ता का नाम, सभी छोटे अक्षरों में, बिना किसी विराम चिह्न के, बिना किसी शुरुआती या आखिरी स्पेस के, और SHA-256 के तौर पर हैश किया गया हो.
family_name

string

ज़रूरी है. उपयोगकर्ता का सरनेम. यह पूरी तरह से लोअरकेस में होना चाहिए. इसमें कोई विराम चिह्न नहीं होना चाहिए. साथ ही, इसके पहले या बाद में कोई खाली जगह नहीं होनी चाहिए. इसे SHA-256 के तौर पर हैश किया गया हो.
region_code

string

ज़रूरी है. उपयोगकर्ता के पते में, ISO-3166-1 ऐल्फ़ा-2 में दिया गया दो अक्षरों वाला क्षेत्र का कोड.
postal_code

string

ज़रूरी है. उपयोगकर्ता के पते का पिन कोड.

AudienceMember

ऑडियंस में शामिल वह सदस्य जिसके लिए कार्रवाई करनी है.

फ़ील्ड
consent

Consent

ज़रूरी नहीं. उपयोगकर्ता के लिए सहमति की सेटिंग.
यूनियन फ़ील्ड data. पहचान करने वाले डेटा का वह टाइप जिस पर कार्रवाई करनी है. data इनमें से सिर्फ़ एक हो सकता है:
user_data

UserData

उपयोगकर्ता से मिला ऐसा डेटा जिससे उपयोगकर्ता की पहचान होती है.
pair_data

PairData

पब्लिशर और विज्ञापन देने वाले लोगों या कंपनियों के लिए, पहले पक्ष (ग्राहक) के डेटा का इस्तेमाल करने से जुड़े समाधान (पीएआईआर) आईडी.
mobile_data

MobileData

उपयोगकर्ता के मोबाइल डिवाइसों की पहचान करने वाला डेटा.

CartData

इवेंट से जुड़ा कार्ट डेटा.

फ़ील्ड
merchant_id

string

ज़रूरी नहीं. आइटम से जुड़ा Merchant Center आईडी.
merchant_feed_label

string

ज़रूरी नहीं. आइटम के फ़ीड से जुड़ा Merchant Center का फ़ीड लेबल.
merchant_feed_language_code

string

ज़रूरी नहीं. Merchant Center के उस फ़ीड से जुड़ा आईएसओ 639-1 भाषा कोड जिसमें आपके आइटम अपलोड किए जाते हैं.
transaction_discount

double

ज़रूरी नहीं. लेन-देन से जुड़ी सभी छूटों का योग.
items[]

Item

ज़रूरी नहीं. इवेंट से जुड़े आइटम की सूची.

उपयोगकर्ता के लिए, डिजिटल मार्केट ऐक्ट (डीएमए) के तहत सहमति की सेटिंग.

फ़ील्ड
ad_user_data

ConsentStatus

ज़रूरी नहीं. इससे पता चलता है कि उपयोगकर्ता ने विज्ञापन दिखाने के लिए, उपयोगकर्ता के डेटा को इस्तेमाल करने की सहमति दी है या नहीं.
ad_personalization

ConsentStatus

ज़रूरी नहीं. इससे पता चलता है कि उपयोगकर्ता ने दिलचस्पी के मुताबिक विज्ञापन दिखाने के लिए सहमति दी है या नहीं.

ConsentStatus

इससे पता चलता है कि उपयोगकर्ता ने सहमति दी है, सहमति नहीं दी है या सहमति के बारे में कोई जानकारी नहीं दी है.

Enums
CONSENT_STATUS_UNSPECIFIED जानकारी नहीं दी गई है.
CONSENT_GRANTED अनुमति दी गई.
CONSENT_DENIED मंज़ूरी नहीं दी गई.

कस्टम वैरिएबल

विज्ञापन कन्वर्ज़न के लिए कस्टम वैरिएबल.

फ़ील्ड
variable

string

ज़रूरी नहीं. सेट किए जाने वाले कस्टम वैरिएबल का नाम. अगर दिए गए डेस्टिनेशन के लिए वैरिएबल नहीं मिलता है, तो इसे अनदेखा कर दिया जाएगा.
value

string

ज़रूरी नहीं. कस्टम वैरिएबल के लिए सेव की जाने वाली वैल्यू.
destination_references[]

string

ज़रूरी नहीं. रेफ़रंस स्ट्रिंग का इस्तेमाल यह तय करने के लिए किया जाता है कि कस्टम वैरिएबल को Event.destination_references में से किस पर भेजा जाना चाहिए. अगर यह फ़ील्ड खाली है, तो Event.destination_references का इस्तेमाल किया जाएगा.

CustomerType

इवेंट से जुड़े ग्राहक का टाइप.

Enums
CUSTOMER_TYPE_UNSPECIFIED CustomerType की जानकारी नहीं दी गई है. इसका इस्तेमाल कभी नहीं किया जाना चाहिए.
NEW खरीदार, विज्ञापन देने वाले व्यक्ति या कंपनी के लिए नया है.
RETURNING खरीदार, विज्ञापन देने वाले व्यक्ति या कंपनी की वेबसाइट पर वापस आ रहा है.
REENGAGED ग्राहक ने विज्ञापन देने वाले व्यक्ति या कंपनी के साथ फिर से इंटरैक्ट किया है.

CustomerValueBucket

विज्ञापन देने वाले व्यक्ति या कंपनी के हिसाब से ग्राहक की वैल्यू.

Enums
CUSTOMER_VALUE_BUCKET_UNSPECIFIED CustomerValueBucket तय नहीं किया गया है. इसका इस्तेमाल कभी नहीं किया जाना चाहिए.
LOW ग्राहक की वैल्यू कम है.
MEDIUM ग्राहक, कारोबार के हिसाब से न कम न ज़्यादा खास है.
HIGH ग्राहक, कारोबार के हिसाब से ज़्यादा अहम है.

मंज़िल

Google का वह प्रॉडक्ट जिसमें डेटा भेजा जा रहा है. उदाहरण के लिए, Google Ads खाता.

फ़ील्ड
reference

string

ज़रूरी नहीं. इस Destination संसाधन का आईडी. यह आईडी, अनुरोध में यूनीक होता है. इस Destination को IngestEventsRequest में रेफ़रंस के तौर पर इस्तेमाल करने के लिए.
login_account

ProductAccount

ज़रूरी नहीं. इस एपीआई कॉल के लिए इस्तेमाल किया गया खाता. operating_account में डेटा जोड़ने या हटाने के लिए, इस login_account के पास operating_account में बदलाव करने का ऐक्सेस होना चाहिए. उदाहरण के लिए, operating_account का मैनेजर खाता या operating_account से लिंक किया गया कोई खाता.
linked_account

ProductAccount

ज़रूरी नहीं. ऐसा खाता जिसे कॉल करने वाले उपयोगकर्ता के login_account के पास ऐक्सेस हो. इसके लिए, खाते को लिंक करना ज़रूरी है. उदाहरण के लिए, डेटा पार्टनर के login_account के पास क्लाइंट के linked_account का ऐक्सेस हो सकता है. पार्टनर इस फ़ील्ड का इस्तेमाल, linked_account से दूसरे operating_account में डेटा भेजने के लिए कर सकता है.
operating_account

ProductAccount

ज़रूरी है. वह खाता जिसमें डेटा भेजना है या जिससे डेटा हटाना है.
product_destination_id

string

ज़रूरी है. प्रॉडक्ट खाते में मौजूद वह ऑब्जेक्ट जिसमें डेटा डालना है. उदाहरण के लिए, Google Ads ऑडियंस आईडी या Display & Video 360 ऑडियंस आईडी.

DeviceInfo

इवेंट के होने पर इस्तेमाल किए जा रहे डिवाइस के बारे में जानकारी.

फ़ील्ड
user_agent

string

ज़रूरी नहीं. दिए गए कॉन्टेक्स्ट के लिए, डिवाइस की उपयोगकर्ता-एजेंट स्ट्रिंग.
ip_address

string

ज़रूरी नहीं. दिए गए कॉन्टेक्स्ट के लिए, डिवाइस का आईपी पता.

ध्यान दें: Google Ads, यूरोपियन इकनॉमिक एरिया (ईईए), यूनाइटेड किंगडम (यूके) या स्विट्ज़रलैंड (सीएच) में रहने वाले असली उपयोगकर्ताओं के लिए, आईपी पते के मिलान की सुविधा उपलब्ध नहीं कराता. इन देशों/इलाकों के उपयोगकर्ताओं के आईपी पते शेयर न करने के लिए, लॉजिक जोड़ें. साथ ही, पक्का करें कि उपयोगकर्ताओं को आपकी साइटों, ऐप्लिकेशन, और अन्य प्रॉपर्टी पर इकट्ठा किए जाने वाले डेटा के बारे में पूरी और सही जानकारी दी जा रही हो. साथ ही, जहां कानूनी तौर पर या Google की लागू होने वाली किसी नीति के तहत ज़रूरी हो वहां उनकी सहमति भी ली जा रही हो. ज़्यादा जानकारी के लिए, ऑफ़लाइन कन्वर्ज़न इंपोर्ट के बारे में जानकारी पेज देखें.

एन्कोडिंग

पहचान से जुड़ी हैश की गई जानकारी का एन्कोडिंग टाइप.

Enums
ENCODING_UNSPECIFIED कोडिंग के टाइप की जानकारी नहीं है. इसका इस्तेमाल कभी नहीं किया जाना चाहिए.
HEX हेक्स एन्कोडिंग.
BASE64 Base 64 एन्कोडिंग.

EncryptionInfo

डेटा को एन्क्रिप्ट (सुरक्षित) करने के तरीके की जानकारी.

फ़ील्ड
यूनियन फ़ील्ड wrapped_key. डेटा को एन्क्रिप्ट (सुरक्षित) करने के लिए इस्तेमाल की गई रैप्ड की. wrapped_key इनमें से सिर्फ़ एक हो सकता है:
gcp_wrapped_key_info

GcpWrappedKeyInfo

Google Cloud Platform की रैप की गई कुंजी की जानकारी.

इवेंट

यह इवेंट, विज्ञापन देने वाले व्यक्ति या कंपनी की वेबसाइट या ऐप्लिकेशन पर उपयोगकर्ता के इंटरैक्शन को दिखाता है.

फ़ील्ड
destination_references[]

string

ज़रूरी नहीं. यह रेफ़रंस स्ट्रिंग है. इसका इस्तेमाल मंज़िल तय करने के लिए किया जाता है. अगर यह फ़ील्ड खाली है, तो इवेंट को अनुरोध में शामिल सभी destinations को भेजा जाएगा.
transaction_id

string

ज़रूरी है. इस इवेंट के लिए यूनीक आइडेंटिफ़ायर.
event_timestamp

Timestamp

ज़रूरी है. इवेंट होने का समय.
last_updated_timestamp

Timestamp

ज़रूरी नहीं. इवेंट को पिछली बार इस समय अपडेट किया गया था.
user_data

UserData

ज़रूरी नहीं. उपयोगकर्ता से मिले डेटा के ऐसे हिस्से जिनसे यह पता चलता है कि इवेंट किस उपयोगकर्ता से जुड़ा है.
consent

Consent

ज़रूरी नहीं. इस कुकी से यह पता चलता है कि उपयोगकर्ता ने अलग-अलग तरह की सहमति दी है या नहीं.
ad_identifiers

AdIdentifiers

ज़रूरी नहीं. इस कुकी में आइडेंटिफ़ायर और अन्य जानकारी होती है. इसका इस्तेमाल, कन्वर्ज़न इवेंट को अन्य ऑनलाइन गतिविधि (जैसे कि विज्ञापन पर क्लिक) से मैच करने के लिए किया जाता है.
currency

string

ज़रूरी नहीं. इस इवेंट में मौजूद सभी मॉनेटरी वैल्यू से जुड़ा मुद्रा कोड.
conversion_value

double

ज़रूरी नहीं. वैल्यू के आधार पर कन्वर्ज़न के लिए, इवेंट से जुड़ी कन्वर्ज़न वैल्यू.
event_source

EventSource

ज़रूरी नहीं. यह सिग्नल बताता है कि इवेंट कहां हुआ (वेब, ऐप्लिकेशन, स्टोर में वगैरह).
event_device_info

DeviceInfo

ज़रूरी नहीं. इवेंट के ट्रिगर होने पर, इस्तेमाल किए जा रहे डिवाइस के बारे में इकट्ठा की गई जानकारी (अगर कोई जानकारी इकट्ठा की गई हो).
cart_data

CartData

ज़रूरी नहीं. लेन-देन और इवेंट से जुड़े आइटम के बारे में जानकारी.
custom_variables[]

CustomVariable

ज़रूरी नहीं. कन्वर्ज़न कंटेनर (कन्वर्ज़न ऐक्शन या FL गतिविधि) को भेजने के लिए, अतिरिक्त कुंजी/वैल्यू पेयर की जानकारी.
experimental_fields[]

ExperimentalField

ज़रूरी नहीं. एक्सपेरिमेंट के तौर पर उपलब्ध फ़ील्ड के लिए, कुंजी/वैल्यू पेयर की सूची. ऐसा हो सकता है कि ये फ़ील्ड, एपीआई का हिस्सा बन जाएं.
user_properties

UserProperties

ज़रूरी नहीं. विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से, इवेंट के समय उपयोगकर्ता के बारे में इकट्ठा की गई जानकारी.

EventSource

इवेंट का सोर्स.

Enums
EVENT_SOURCE_UNSPECIFIED EventSource की जानकारी नहीं दी गई है. इसका इस्तेमाल कभी नहीं किया जाना चाहिए.
WEB यह इवेंट, वेब ब्राउज़र से जनरेट किया गया था.
APP यह इवेंट किसी ऐप्लिकेशन से जनरेट किया गया था.
IN_STORE यह इवेंट, स्टोर में हुए लेन-देन से जनरेट हुआ था.
PHONE यह इवेंट, फ़ोन कॉल से जनरेट किया गया था.
OTHER यह इवेंट, दूसरे सोर्स से जनरेट किया गया था.

ExperimentalField

यह एक्सपेरिमेंटल फ़ील्ड, अनौपचारिक फ़ील्ड के बारे में बताता है.

फ़ील्ड
field

string

ज़रूरी नहीं. इस्तेमाल किए जाने वाले फ़ील्ड का नाम.
value

string

ज़रूरी नहीं. फ़ील्ड की वैल्यू सेट करें.

GcpWrappedKeyInfo

Google Cloud Platform की रैप्ड कुंजी के बारे में जानकारी.

फ़ील्ड
key_type

KeyType

ज़रूरी है. डेटा को एन्क्रिप्ट (सुरक्षित) करने के लिए इस्तेमाल किए गए एल्गोरिदम का टाइप.
wip_provider

string

ज़रूरी है. KEK का इस्तेमाल करने के लिए, Workload Identity Pool Provider की ज़रूरत होती है.
kek_uri

string

ज़रूरी है. Google Cloud Platform Cloud Key Management Service संसाधन आईडी.
encrypted_dek

string

ज़रूरी है. base64 कोड में बदली गई, एन्क्रिप्ट यानी सुरक्षित की गई डेटा एन्क्रिप्शन की.

KeyType

डेटा को एन्क्रिप्ट (सुरक्षित) करने के लिए इस्तेमाल किए गए एल्गोरिदम का टाइप.

Enums
KEY_TYPE_UNSPECIFIED कुंजी के टाइप की जानकारी नहीं दी गई है. इसका इस्तेमाल कभी नहीं किया जाना चाहिए.
XCHACHA20_POLY1305 एल्गोरिदम XChaCha20-Poly1305

IngestAudienceMembersRequest

इस अनुरोध का इस्तेमाल, ऑडियंस के सदस्यों को दिए गए डेस्टिनेशन पर अपलोड करने के लिए किया जाता है. यह IngestAudienceMembersResponse दिखाता है.

फ़ील्ड
destinations[]

Destination

ज़रूरी है. ऑडियंस के सदस्यों को भेजने के लिए डेस्टिनेशन की सूची.
audience_members[]

AudienceMember

ज़रूरी है. उन उपयोगकर्ताओं की सूची जिन्हें तय किए गए डेस्टिनेशन पर भेजना है. एक अनुरोध में ज़्यादा से ज़्यादा 10,000 AudienceMember संसाधन भेजे जा सकते हैं.
consent

Consent

ज़रूरी नहीं. अनुरोध के स्तर पर सहमति, ताकि अनुरोध में शामिल सभी उपयोगकर्ताओं पर लागू हो सके. उपयोगकर्ता-लेवल की सहमति, अनुरोध-लेवल की सहमति को बदल देती है. इसे हर AudienceMember में तय किया जा सकता है.
validate_only

bool

ज़रूरी नहीं. इसका इस्तेमाल सिर्फ़ जांच के लिए किया जाता है. अगर true है, तो अनुरोध की पुष्टि की जाती है, लेकिन उसे पूरा नहीं किया जाता. सिर्फ़ गड़बड़ियां दिखती हैं, नतीजे नहीं.
encoding

Encoding

ज़रूरी नहीं. UserData अपलोड करने के लिए ज़रूरी है. उपयोगकर्ता आइडेंटिफ़ायर का एन्कोडिंग टाइप. हैश किए गए उपयोगकर्ता आइडेंटिफ़ायर के लिए, यह हैश की गई स्ट्रिंग का एन्कोडिंग टाइप होता है. एन्क्रिप्ट (सुरक्षित) किए गए हैश किए गए उपयोगकर्ता आइडेंटिफ़ायर के लिए, यह एन्क्रिप्ट (सुरक्षित) की गई बाहरी स्ट्रिंग का एन्कोडिंग टाइप है. हालांकि, यह ज़रूरी नहीं है कि यह हैश की गई अंदरूनी स्ट्रिंग का एन्कोडिंग टाइप भी हो. इसका मतलब है कि हैश की गई अंदरूनी स्ट्रिंग को, एन्क्रिप्ट (सुरक्षित) की गई बाहरी स्ट्रिंग से अलग तरीके से एन्कोड किया जा सकता है. UserData के अलावा अन्य फ़ीड अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
encryption_info

EncryptionInfo

ज़रूरी नहीं. UserData के अपलोड किए गए डेटा को एन्क्रिप्ट (सुरक्षित) करने के तरीके की जानकारी. अगर इसे सेट नहीं किया जाता है, तो यह माना जाता है कि अपलोड की गई पहचान ज़ाहिर करने वाली जानकारी को हैश किया गया है, लेकिन एन्क्रिप्ट (सुरक्षित) नहीं किया गया है. UserData के अलावा अन्य फ़ीड अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
terms_of_service

TermsOfService

ज़रूरी नहीं. सेवा की वे शर्तें जिन्हें उपयोगकर्ता ने स्वीकार/अस्वीकार किया है.

IngestAudienceMembersResponse

IngestAudienceMembersRequest से मिला जवाब.

फ़ील्ड
request_id

string

अनुरोध का अपने-आप जनरेट हुआ आईडी.

IngestEventsRequest

इस अनुरोध का इस्तेमाल, ऑडियंस के सदस्यों को दिए गए डेस्टिनेशन पर अपलोड करने के लिए किया जाता है. यह IngestEventsResponse दिखाता है.

फ़ील्ड
destinations[]

Destination

ज़रूरी है. उन डेस्टिनेशन की सूची जहां इवेंट भेजे जाने हैं.
events[]

Event

ज़रूरी है. चुने गए डेस्टिनेशन पर भेजे जाने वाले इवेंट की सूची. एक अनुरोध में ज़्यादा से ज़्यादा 2,000 Event संसाधन भेजे जा सकते हैं.
consent

Consent

ज़रूरी नहीं. अनुरोध के स्तर पर सहमति, ताकि अनुरोध में शामिल सभी उपयोगकर्ताओं पर लागू हो सके. उपयोगकर्ता-लेवल की सहमति, अनुरोध-लेवल की सहमति को बदल देती है. इसे हर Event में तय किया जा सकता है.
validate_only

bool

ज़रूरी नहीं. इसका इस्तेमाल सिर्फ़ जांच के लिए किया जाता है. अगर true है, तो अनुरोध की पुष्टि की जाती है, लेकिन उसे पूरा नहीं किया जाता. सिर्फ़ गड़बड़ियां दिखती हैं, नतीजे नहीं.
encoding

Encoding

ज़रूरी नहीं. UserData अपलोड करने के लिए ज़रूरी है. उपयोगकर्ता आइडेंटिफ़ायर का एन्कोडिंग टाइप. हैश किए गए उपयोगकर्ता आइडेंटिफ़ायर के लिए, यह हैश की गई स्ट्रिंग का एन्कोडिंग टाइप होता है. एन्क्रिप्ट (सुरक्षित) किए गए हैश किए गए उपयोगकर्ता आइडेंटिफ़ायर के लिए, यह एन्क्रिप्ट (सुरक्षित) की गई बाहरी स्ट्रिंग का एन्कोडिंग टाइप है. हालांकि, यह ज़रूरी नहीं है कि यह हैश की गई अंदरूनी स्ट्रिंग का एन्कोडिंग टाइप भी हो. इसका मतलब है कि हैश की गई अंदरूनी स्ट्रिंग को, एन्क्रिप्ट (सुरक्षित) की गई बाहरी स्ट्रिंग से अलग तरीके से एन्कोड किया जा सकता है. UserData के अलावा अन्य फ़ीड अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
encryption_info

EncryptionInfo

ज़रूरी नहीं. UserData के अपलोड किए गए डेटा को एन्क्रिप्ट (सुरक्षित) करने के तरीके की जानकारी. अगर इसे सेट नहीं किया जाता है, तो यह माना जाता है कि अपलोड की गई पहचान ज़ाहिर करने वाली जानकारी को हैश किया गया है, लेकिन एन्क्रिप्ट (सुरक्षित) नहीं किया गया है. UserData के अलावा अन्य फ़ीड अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.

IngestEventsResponse

IngestEventsRequest से मिला जवाब.

फ़ील्ड
request_id

string

अनुरोध का अपने-आप जनरेट हुआ आईडी.

आइटम

यह इवेंट से जुड़े कार्ट में मौजूद किसी आइटम को दिखाता है.

फ़ील्ड
merchant_product_id

string

ज़रूरी नहीं. Merchant Center खाते में मौजूद प्रॉडक्ट आईडी.
quantity

int64

ज़रूरी नहीं. इवेंट से जुड़े इस आइटम की संख्या.
unit_price

double

ज़रूरी नहीं. यूनिट की कीमत. इसमें टैक्स, शिपिंग, और लेन-देन पर मिलने वाली किसी भी तरह की छूट शामिल नहीं है.

MobileData

ऑडियंस के लिए मोबाइल आईडी. कम से कम एक मोबाइल आईडी होना ज़रूरी है.

फ़ील्ड
mobile_ids[]

string

ज़रूरी है. मोबाइल डिवाइस आईडी (विज्ञापन आईडी/आईडीएफ़ए) की सूची. एक AudienceMember में ज़्यादा से ज़्यादा 10 mobileIds दिए जा सकते हैं.

PairData

ऑडियंस के लिए PAIR आईडी. कम से कम एक PAIR ID होना ज़रूरी है.

फ़ील्ड
pair_ids[]

string

ज़रूरी है. क्लीनरूम से मिला पीआईआई डेटा, जिसे SHA256 का इस्तेमाल करके हैश किया गया है. साथ ही, जिसे PAIR की उपयोगकर्ता सूची के लिए, पब्लिशर के पास मौजूद पासकोड का इस्तेमाल करके ईसी कम्यूटेटिव सिफ़र से एन्क्रिप्ट (सुरक्षित) किया गया है. एक AudienceMember में ज़्यादा से ज़्यादा 10 pairIds दिए जा सकते हैं.

प्रॉडक्ट

इससे किसी Google प्रॉडक्ट के बारे में पता चलता है. इस कुकी का इस्तेमाल, खातों और डेस्टिनेशन का पता लगाने के लिए किया जाता है.

Enums
PRODUCT_UNSPECIFIED प्रॉडक्ट की जानकारी नहीं दी गई है. इसका इस्तेमाल कभी नहीं किया जाना चाहिए.
GOOGLE_ADS Google Ads.
DISPLAY_VIDEO_PARTNER Display & Video 360 पार्टनर.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 की मदद से विज्ञापन देने वाला व्यक्ति या कंपनी.
DATA_PARTNER डेटा पार्टनर.

ProductAccount

यह किसी खास खाते को दिखाता है.

फ़ील्ड
product

Product

ज़रूरी है. वह प्रॉडक्ट जिससे खाता जुड़ा है. उदाहरण के लिए, GOOGLE_ADS.
account_id

string

ज़रूरी है. खाते का आईडी. उदाहरण के लिए, आपके Google Ads खाते का आईडी.

RemoveAudienceMembersRequest

इस अनुरोध की मदद से, दिए गए डेस्टिनेशन में मौजूद किसी ऑडियंस से उपयोगकर्ताओं को हटाया जा सकता है. इससे RemoveAudienceMembersResponse मिलता है.

फ़ील्ड
destinations[]

Destination

ज़रूरी है. उन डेस्टिनेशन की सूची जिनसे उपयोगकर्ताओं को हटाना है.
audience_members[]

AudienceMember

ज़रूरी है. हटाए जाने वाले उपयोगकर्ताओं की सूची.
validate_only

bool

ज़रूरी नहीं. इसका इस्तेमाल सिर्फ़ जांच के लिए किया जाता है. अगर true है, तो अनुरोध की पुष्टि की जाती है, लेकिन उसे पूरा नहीं किया जाता. सिर्फ़ गड़बड़ियां दिखती हैं, नतीजे नहीं.
encoding

Encoding

ज़रूरी नहीं. UserData अपलोड करने के लिए ज़रूरी है. उपयोगकर्ता आइडेंटिफ़ायर का एन्कोडिंग टाइप. यह नीति, एन्क्रिप्ट किए गए उपयोगकर्ता आइडेंटिफ़ायर के सिर्फ़ बाहरी एन्कोडिंग पर लागू होती है. UserData के अलावा अन्य फ़ीड अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
encryption_info

EncryptionInfo

ज़रूरी नहीं. UserData के अपलोड किए गए डेटा को एन्क्रिप्ट (सुरक्षित) करने के तरीके की जानकारी. अगर इसे सेट नहीं किया जाता है, तो यह माना जाता है कि अपलोड की गई पहचान ज़ाहिर करने वाली जानकारी को हैश किया गया है, लेकिन एन्क्रिप्ट (सुरक्षित) नहीं किया गया है. UserData के अलावा अन्य फ़ीड अपलोड के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.

RemoveAudienceMembersResponse

RemoveAudienceMembersRequest से मिला जवाब.

फ़ील्ड
request_id

string

अनुरोध का अपने-आप जनरेट हुआ आईडी.

TermsOfService

सेवा की वे शर्तें जिन्हें उपयोगकर्ता ने स्वीकार/अस्वीकार किया है.

फ़ील्ड
customer_match_terms_of_service_status

TermsOfServiceStatus

ज़रूरी नहीं. कस्टमर मैच की सेवा की शर्तें: https://support.google.com/adspolicy/answer/6299717. कस्टमर मैच की उपयोगकर्ता सूचियों में सभी अपलोड के लिए, इसे स्वीकार करना ज़रूरी है.

TermsOfServiceStatus

इससे पता चलता है कि कॉलर ने सेवा की शर्तों को स्वीकार किया है या अस्वीकार किया है.

Enums
TERMS_OF_SERVICE_STATUS_UNSPECIFIED जानकारी नहीं दी गई है.
ACCEPTED यह स्टेटस दिखाता है कि कॉलर ने सेवा की शर्तें स्वीकार कर ली हैं.
REJECTED यह स्टेटस दिखाता है कि कॉल करने वाले व्यक्ति ने सेवा की शर्तों को अस्वीकार कर दिया है.

UserData

उपयोगकर्ता की पहचान करने वाला डेटा. कम से कम एक आइडेंटिफ़ायर होना ज़रूरी है.

फ़ील्ड
user_identifiers[]

UserIdentifier

ज़रूरी है. उपयोगकर्ता के लिए आइडेंटिफ़ायर. एक ही तरह के डेटा के कई इंस्टेंस दिए जा सकते हैं. उदाहरण के लिए, एक से ज़्यादा ईमेल पते. मैच होने की संभावना बढ़ाने के लिए, ज़्यादा से ज़्यादा आइडेंटिफ़ायर उपलब्ध कराएं. एक AudienceMember या Event में ज़्यादा से ज़्यादा 10 userIdentifiers दिए जा सकते हैं.

UserIdentifier

उपयोगकर्ता के लिए एक आइडेंटिफ़ायर.

फ़ील्ड
यूनियन फ़ील्ड identifier. इनमें से किसी एक को तय करना ज़रूरी है. identifier इनमें से सिर्फ़ एक हो सकता है:
email_address

string

नॉर्मलाइज़ करने के बाद, SHA-256 हैश फ़ंक्शन का इस्तेमाल करके हैश किया गया ईमेल पता.
phone_number

string

नॉर्मलाइज़ेशन (E164 स्टैंडर्ड) के बाद, SHA-256 हैश फ़ंक्शन का इस्तेमाल करके हैश किया गया फ़ोन नंबर.
address

AddressInfo

उपयोगकर्ता के पते के बारे में जानकारी. यह कुकी, आइडेंटिफ़ायर का ऐसा ग्रुप सेव करती है जिन्हें एक साथ मैच किया जाता है.

UserProperties

विज्ञापन देने वाले व्यक्ति या कंपनी की ओर से, इवेंट के समय उपयोगकर्ता के बारे में इकट्ठा की गई जानकारी. ज़्यादा जानकारी के लिए, https://support.google.com/google-ads/answer/14007601 पर जाएं.

फ़ील्ड
customer_type

CustomerType

ज़रूरी नहीं. इवेंट से जुड़े ग्राहक का टाइप.
customer_value_bucket

CustomerValueBucket

ज़रूरी नहीं. विज्ञापन देने वाले व्यक्ति या कंपनी के हिसाब से ग्राहक की वैल्यू.