Method: events.ingest

Destination से Event रिसॉर्स की सूची अपलोड करता है.

एचटीटीपी अनुरोध

POST https://datamanager.googleapis.com/v1/events:ingest

यह यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, इस स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "destinations": [
    {
      object (Destination)
    }
  ],
  "events": [
    {
      object (Event)
    }
  ],
  "consent": {
    object (Consent)
  },
  "validateOnly": boolean,
  "encoding": enum (Encoding),
  "encryptionInfo": {
    object (EncryptionInfo)
  }
}
फ़ील्ड
destinations[]

object (Destination)

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

object (Event)

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

object (Consent)

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

boolean

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

enum (Encoding)

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

object (EncryptionInfo)

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

जवाब का मुख्य भाग

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

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON फ़ॉर्मैट में दिखाया गया है 
{
  "requestId": string,
  "fieldWarnings": [
    {
      object (FieldWarning)
    }
  ]
}
फ़ील्ड
requestId

string

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

object (FieldWarning)

फ़ील्ड पाथ के साथ, पंक्ति के लेवल पर चेतावनियों की पूरी जानकारी.

अनुमति पाने के लिंक

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

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

इवेंट

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

JSON के काेड में दिखाना 
{
  "destinationReferences": [
    string
  ],
  "transactionId": string,
  "eventTimestamp": string,
  "lastUpdatedTimestamp": string,
  "userData": {
    object (UserData)
  },
  "consent": {
    object (Consent)
  },
  "adIdentifiers": {
    object (AdIdentifiers)
  },
  "currency": string,
  "eventSource": enum (EventSource),
  "eventDeviceInfo": {
    object (DeviceInfo)
  },
  "cartData": {
    object (CartData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "experimentalFields": [
    {
      object (ExperimentalField)
    }
  ],
  "userProperties": {
    object (UserProperties)
  },
  "eventName": string,
  "clientId": string,
  "userId": string,
  "additionalEventParameters": [
    {
      object (EventParameter)
    }
  ],
  "thirdPartyUserData": {
    object (UserData)
  },
  "eventLocation": {
    object (EventLocation)
  },
  "appInstanceId": string,
  "callInfo": {
    object (CallInfo)
  },
  "conversionValue": number,
  "conversionCount": number
}
फ़ील्ड
destinationReferences[]

string

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

string

ज़रूरी नहीं. इस इवेंट के लिए यूनीक आइडेंटिफ़ायर. टैग कन्वर्ज़न के लिए, अतिरिक्त डेटा सोर्स के तौर पर भेजे गए इवेंट के लिए ज़रूरी है.
eventTimestamp

string (Timestamp format)

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

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
lastUpdatedTimestamp

string (Timestamp format)

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

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
userData

object (UserData)

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

object (Consent)

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

object (AdIdentifiers)

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

string

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

enum (EventSource)

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

object (DeviceInfo)

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

object (CartData)

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

object (CustomVariable)

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

object (ExperimentalField)

ज़रूरी नहीं. एक्सपेरिमेंटल फ़ील्ड के लिए, की/वैल्यू पेयर की सूची. इन फ़ील्ड को बाद में एपीआई में शामिल किया जा सकता है.
userProperties

object (UserProperties)

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

string

ज़रूरी नहीं. इवेंट का नाम. GA4 इवेंट के लिए ज़रूरी है.
clientId

string

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

string

ज़रूरी नहीं. विज्ञापन देने वाले व्यक्ति या कंपनी के मुताबिक, किसी उपयोगकर्ता का यूनीक आइडेंटिफ़ायर.
additionalEventParameters[]

object (EventParameter)

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

object (UserData)

ज़रूरी नहीं. userData में दिया गया डेटा, उसी तरह का डेटा होता है जो तीसरे पक्ष के मालिकाना हक वाले डेटा के तौर पर फ़्लैग किया गया हो, न कि पहले पक्ष के विज्ञापन देने वाले के डेटा के तौर पर.
eventLocation

object (EventLocation)

ज़रूरी नहीं. इवेंट होने के समय, उपयोगकर्ता की जगह की जानकारी.
appInstanceId

string

ज़रूरी नहीं. इस GA4 ऐप्लिकेशन स्ट्रीम के लिए, ऐप्लिकेशन क्लाइंट के उपयोगकर्ता इंस्टेंस का यूनीक आइडेंटिफ़ायर.
callInfo

object (CallInfo)

ज़रूरी नहीं. कॉल के बारे में इकट्ठा की गई जानकारी (अगर कोई है), जिसकी वजह से यह इवेंट हुआ.
conversionValue

number

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

number

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

AdIdentifiers

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

JSON के काेड में दिखाना 
{
  "sessionAttributes": string,
  "gclid": string,
  "gbraid": string,
  "wbraid": string,
  "landingPageDeviceInfo": {
    object (DeviceInfo)
  },
  "mobileDeviceId": string,
  "dclid": string,
  "impressionId": string,
  "matchId": string,
  "encryptedUserIds": [
    {
      object (EncryptedUserId)
    }
  ],
  "ppid": string,
  "visitorPpid": string,
  "leadId": string
}
फ़ील्ड
sessionAttributes

string

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

string

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

string

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

string

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

object (DeviceInfo)

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

string

ज़रूरी नहीं. विज्ञापन देने वाले लोगों या कंपनियों के लिए मोबाइल आइडेंटिफ़ायर. यह iOS पर IDFA, Android पर AdID या विज्ञापन देने वाले लोगों या कंपनियों के लिए अन्य प्लैटफ़ॉर्म के आइडेंटिफ़ायर हो सकते हैं.
dclid

string

ज़रूरी नहीं. इस इवेंट से जुड़ा डिसप्ले क्लिक आईडी.
impressionId

string

ज़रूरी नहीं. इस इवेंट से जुड़ा इंप्रेशन आईडी.
matchId

string

ज़रूरी नहीं. इस इवेंट को पिछले इवेंट से जोड़ने के लिए, मैच आईडी फ़ील्ड का इस्तेमाल किया जाता है.
encryptedUserIds[]

object (EncryptedUserId)

ज़रूरी नहीं. एन्क्रिप्ट (सुरक्षित) किए गए यूज़र आईडी की कोई भी संख्या.
ppid

string

ज़रूरी नहीं. यह पुष्टि किए गए उपयोगकर्ता (साइन इन किया हुआ) के लिए एक यूनीक आइडेंटिफ़ायर होता है. इसे पब्लिशर तय करता है.
visitorPpid

string

ज़रूरी नहीं. बिना पुष्टि वाले उपयोगकर्ता (जिसने साइन-इन नहीं किया है) के लिए एक यूनीक आइडेंटिफ़ायर, जैसा कि पब्लिशर ने तय किया है.
leadId

string

ज़रूरी नहीं. Google से जनरेट किया गया आईडी, जो उपयोगकर्ता के लीड फ़ॉर्म सबमिट करने पर जारी किया जाता है.

EncryptedUserId

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

JSON के काेड में दिखाना 
{
  "encryptedId": string,
  "entityType": enum (EncryptionEntityType),
  "entityId": string,
  "source": enum (EncryptionSource)
}
फ़ील्ड
encryptedId

string

ज़रूरी है. अक्षरों और अंकों को मिलाकर बना एन्क्रिप्ट (सुरक्षित) किया गया आईडी.
entityType

enum (EncryptionEntityType)

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

string (int64 format)

ज़रूरी है. एन्क्रिप्ट करने वाली इकाई का आईडी. यह विज्ञापन दिखाने या डेटा ट्रांसफ़र के लिए, एन्क्रिप्ट करने के कॉन्फ़िगरेशन से मेल खाना चाहिए.
source

enum (EncryptionSource)

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

EncryptionEntityType

एन्क्रिप्ट (सुरक्षित) करने के लिए इस्तेमाल की जाने वाली इकाई का टाइप.

Enums
ENCRYPTION_ENTITY_TYPE_UNSPECIFIED एन्क्रिप्ट करने के लिए इस्तेमाल की जाने वाली इकाई के टाइप की जानकारी नहीं दी गई है.
CAMPAIGN_MANAGER_ACCOUNT Campaign Manager 360 खाता.
CAMPAIGN_MANAGER_ADVERTISER Campaign Manager 360 में, विज्ञापन देने वाले व्यक्ति या कंपनी का खाता.
DISPLAY_VIDEO_PARTNER Display & Video 360 पार्टनर.
DISPLAY_VIDEO_ADVERTISER Display & Video 360 पर विज्ञापन देने वाला.
GOOGLE_ADS_CUSTOMER Google Ads ग्राहक.
GOOGLE_AD_MANAGER_NETWORK_CODE Google Ad Manager नेटवर्क कोड.

EncryptionSource

एन्क्रिप्ट करने का सोर्स.

Enums
ENCRYPTION_SOURCE_UNSPECIFIED एन्क्रिप्ट करने के सोर्स की जानकारी नहीं दी गई है.
AD_SERVING विज्ञापन दिखाने के लिए, एन्क्रिप्ट करने का सोर्स.
DATA_TRANSFER डेटा ट्रांसफ़र के लिए एन्क्रिप्शन का सोर्स.

EventSource

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

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

CartData

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

JSON के काेड में दिखाना 
{
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "transactionDiscount": number,
  "items": [
    {
      object (Item)
    }
  ],
  "couponCodes": [
    string
  ]
}
फ़ील्ड
merchantId

string

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

string

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

string

ज़रूरी नहीं. Merchant Center फ़ीड में मौजूद आइटम की भाषा का आईएसओ 639-1 कोड.
transactionDiscount

number

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

object (Item)

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

string

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

अगर इवेंट किसी Google Analytics डेस्टिनेशन के लिए है, तो सिर्फ़ एक कूपन कोड दें. Google Analytics, अन्य कूपन कोड को अनदेखा कर देता है.

आइटम

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

JSON के काेड में दिखाना 
{
  "merchantProductId": string,
  "quantity": string,
  "unitPrice": number,
  "itemId": string,
  "additionalItemParameters": [
    {
      object (ItemParameter)
    }
  ],
  "merchantId": string,
  "merchantFeedLabel": string,
  "merchantFeedLanguageCode": string,
  "customVariables": [
    {
      object (ItemCustomVariable)
    }
  ],
  "conversionValue": number
}
फ़ील्ड
merchantProductId

string

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

string (int64 format)

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

number

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

string

ज़रूरी नहीं. आइटम को रेफ़रंस करने के लिए एक यूनीक आइडेंटिफ़ायर.
additionalItemParameters[]

object (ItemParameter)

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

string

ज़रूरी नहीं. आइटम से जुड़ा Merchant Center का आईडी. स्टोर में होने वाली सेल इवेंट के लिए, यह कार्ट लेवल पर सेट की गई वैल्यू को बदल देगा. अन्य इवेंट के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
merchantFeedLabel

string

ज़रूरी नहीं. Merchant Center फ़ीड का फ़ीड लेबल. अगर अब भी देशों के नाम इस्तेमाल किए जा रहे हैं, तो ISO-3166-1 ऐल्फ़ा-2 में दिए गए दो अक्षरों वाले देश के कोड का इस्तेमाल किया जा सकता है. स्टोर में होने वाली सेल इवेंट के लिए, यह कार्ट लेवल पर सेट की गई वैल्यू को बदल देगा. अन्य इवेंट के लिए, इस फ़ील्ड को अनदेखा कर दिया जाता है.
merchantFeedLanguageCode

string

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

object (ItemCustomVariable)

ज़रूरी नहीं. हर आइटम के कन्वर्ज़न ट्रैक करते समय, कन्वर्ज़न कंटेनर (कन्वर्ज़न ऐक्शन या Floodlight गतिविधि) को भेजने के लिए, कुंजी/वैल्यू पेयर की अतिरिक्त जानकारी.
conversionValue

number

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

ItemParameter

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

JSON के काेड में दिखाना 
{
  "parameterName": string,
  "value": string
}
फ़ील्ड
parameterName

string

ज़रूरी है. इस्तेमाल किए जाने वाले पैरामीटर का नाम.
value

string

ज़रूरी है. सेट किए जाने वाले पैरामीटर की वैल्यू को स्ट्रिंग के तौर पर दिखाया गया है.

ItemCustomVariable

विज्ञापन से होने वाले कन्वर्ज़न के लिए, आइटम-लेवल का कस्टम वैरिएबल.

JSON के काेड में दिखाना 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
फ़ील्ड
variable

string

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

string

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

string

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

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

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

JSON के काेड में दिखाना 
{
  "variable": string,
  "value": string,
  "destinationReferences": [
    string
  ]
}
फ़ील्ड
variable

string

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

string

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

string

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

ExperimentalField

एक्सपेरिमेंट के तौर पर उपलब्ध फ़ील्ड, जो गैर-आधिकारिक फ़ील्ड को दिखाता है.

JSON के काेड में दिखाना 
{
  "field": string,
  "value": string
}
फ़ील्ड
field

string

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

string

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

UserProperties

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

JSON के काेड में दिखाना 
{
  "customerType": enum (CustomerType),
  "customerValueBucket": enum (CustomerValueBucket),
  "additionalUserProperties": [
    {
      object (UserProperty)
    }
  ]
}
फ़ील्ड
customerType

enum (CustomerType)

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

enum (CustomerValueBucket)

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

object (UserProperty)

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

CustomerType

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

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

CustomerValueBucket

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

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

UserProperty

इस इवेंट से जुड़े उपयोगकर्ता के लिए, किसी भी अतिरिक्त उपयोगकर्ता प्रॉपर्टी का बकेट.

JSON के काेड में दिखाना 
{
  "propertyName": string,
  "value": string
}
फ़ील्ड
propertyName

string

ज़रूरी है. इस्तेमाल की जाने वाली उपयोगकर्ता प्रॉपर्टी का नाम.
value

string

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

EventParameter

GA4 इवेंट के लिए इवेंट पैरामीटर.

JSON के काेड में दिखाना 
{
  "parameterName": string,
  "value": string
}
फ़ील्ड
parameterName

string

ज़रूरी है. इस्तेमाल किए जाने वाले पैरामीटर का नाम.
value

string

ज़रूरी है. सेट किए जाने वाले पैरामीटर की वैल्यू को स्ट्रिंग के तौर पर दिखाया गया है.

EventLocation

वह जगह जहां इवेंट हुआ.

JSON के काेड में दिखाना 
{
  "storeId": string,
  "city": string,
  "subdivisionCode": string,
  "regionCode": string,
  "subcontinentCode": string,
  "continentCode": string
}
फ़ील्ड
storeId

string

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

string

ज़रूरी नहीं. उस शहर का नाम जहां इवेंट हुआ.
subdivisionCode

string

ज़रूरी नहीं. ISO 3166-2 सबडिवीज़न कोड, जहां इवेंट हुआ.
regionCode

string

ज़रूरी नहीं. उपयोगकर्ता के पते में मौजूद, दो अक्षरों वाला CLDR क्षेत्र कोड.
subcontinentCode

string

ज़रूरी नहीं. UN M49 फ़ॉर्मैट में उस उपमहाद्वीप का कोड जहां इवेंट हुआ.
continentCode

string

ज़रूरी नहीं. UN M49 फ़ॉर्मैट में उस महाद्वीप का कोड जहां इवेंट हुआ.

CallInfo

कॉल के बारे में इकट्ठा की गई जानकारी (अगर कोई है), जिसकी वजह से यह इवेंट हुआ.

JSON के काेड में दिखाना 
{
  "startTimestamp": string
}
फ़ील्ड
startTimestamp

string (Timestamp format)

ज़रूरी है. फ़ोन कॉल शुरू होने का वह समय जिसकी वजह से यह इवेंट हुआ.

यह आरएफ़सी 3339 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".