क्विकस्टार्ट

Data Manager API के बारे में जानने के लिए, इस क्विकस्टार्ट का इस्तेमाल करें. आपको क्विकस्टार्ट का जो वर्शन देखना है उसे चुनें:

इस शुरुआती लेख में, आपको यह तरीका अपनाना होगा:

  1. ऑडियंस डेटा पाने के लिए, Destination तैयार करें.
  2. भेजने के लिए ऑडियंस डेटा तैयार करें.
  3. IngestionService अनुरोध बनाएं.
  4. Google APIs Explorer की मदद से अनुरोध भेजें.
  5. सफलता और गड़बड़ी के जवाबों को समझना.

डेस्टिनेशन तैयार करना

डेटा भेजने से पहले, आपको डेटा भेजने के लिए डेस्टिनेशन तैयार करना होगा. यहां Destination का एक सैंपल दिया गया है, जिसका इस्तेमाल किया जा सकता है:

    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "AUDIENCE_ID"
    }

  • operatingAccount को उस प्रॉडक्ट और खाते के आईडी पर सेट करें जिसे ऑडियंस डेटा मिलेगा.

ऑडियंस डेटा तैयार करना

कॉमा से अलग किए गए डेटा वाली फ़ाइल में, नीचे दिया गया सैंपल डेटा देखें. फ़ाइल की हर लाइन, ऑडियंस के एक सदस्य से जुड़ी होती है. साथ ही, हर सदस्य के पास ज़्यादा से ज़्यादा तीन ईमेल पते होते हैं.

#,email_1,email_2,email_3
1,dana@example.com,DanaM@example.com,
2,ALEXJ@example.com, AlexJ@cymbalgroup.com,alexj@altostrat.com
3,quinn@CYMBALGROUP.com,baklavainthebalkans@gmail.com  ,
4,rosario@example.org,cloudySanFrancisco@GMAIL.com,

ईमेल पतों के लिए, फ़ॉर्मैट और हैश करने से जुड़ी ये ज़रूरी शर्तें हैं:

  1. शुरू, आखिर, और बीच में मौजूद सभी खाली जगहों को हटाएं.
  2. ईमेल पते को छोटे अक्षरों में बदलें.
  3. SHA-256 एल्गोरिदम का इस्तेमाल करके, ईमेल पते को हैश करें.
  4. हेक्साडेसिमल (हेक्स) या Base64 कोड में बदलने की सुविधा का इस्तेमाल करके, हैश बाइट को कोड में बदलें. इस गाइड में दिए गए उदाहरणों में हेक्स एन्कोडिंग का इस्तेमाल किया गया है.

फ़ॉर्मैट किया गया डेटा यहां दिया गया है:

#,email_1,email_2,email_3
1,dana@example.com,danam@example.com,
2,alexj@example.com,alexj@cymbalgroup.com,alexj@altostrat.com
3,quinn@cymbalgroup.com,baklavainthebalkans@gmail.com,
4,rosario@example.org,cloudysanfrancisco@gmail.com,

हैश और कोड किए जाने के बाद, डेटा इस तरह दिखता है:

#,email_1,email_2,email_3
1,07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3,1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7
2,2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3,54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51,e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478
3,05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0,f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5
4,83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f,223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4

यहां इनपुट डेटा की पहली पंक्ति में मौजूद dana@example.com और danam@example.com के फ़ॉर्मैट किए गए, हैश किए गए, और कोड किए गए ईमेल पते के लिए AudienceMember का एक सैंपल दिया गया है:

{
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
      },
      {
        "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
      }
    ]
  }
}

अनुरोध का मुख्य हिस्सा बनाना

अनुरोध के मुख्य हिस्से के लिए, Destination और userData को जोड़ें:

{
  "destinations": [
    {
      "operatingAccount": {
        "product": "OPERATING_ACCOUNT_PRODUCT",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "AUDIENCE_ID"
    }
  ],
  "audienceMembers": [
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
          },
          {
            "emailAddress": "1df6b43bc68dd38eca94e6a65b4f466ae537b796c81a526918b40ac4a7b906c7"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "2ef46c4214c3fc1b277a2d976d55194e12b899aa50d721f28da858c7689756e3"
          },
          {
            "emailAddress": "54e410b14fa652a4b49b43aff6eaf92ad680d4d1e5e62ed71b86cd3188385a51"
          },
          {
            "emailAddress": "e8bd3f8da6f5af73bec1ab3fbf7beb47482c4766dfdfc94e6bd89e359c139478"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "05bb62526f091b45d20e243d194766cca8869137421047dc53fa4876d111a6f0"
          },
          {
            "emailAddress": "f1fcde379f31f4d446b76ee8f34860eca2288adc6b6d6c0fdc56d9eee75a2fa5"
          }
        ]
      }
    },
    {
      "userData": {
        "userIdentifiers": [
          {
            "emailAddress": "83a834cc5327bc4dee7c5408988040dc5813c7662611cd93b707aff72bf7d33f"
          },
          {
            "emailAddress": "223ebda6f6889b1494551ba902d9d381daf2f642bae055888e96343d53e9f9c4"
          }
        ]
      }
    }
  ],
  "consent": {
    "adUserData": "CONSENT_GRANTED",
    "adPersonalization": "CONSENT_GRANTED"
  },
  "encoding": "HEX",
  "termsOfService": {
    "customerMatchTermsOfServiceStatus": "ACCEPTED"
  },
  "validateOnly": true
}
  1. अपने खाते और डेस्टिनेशन की वैल्यू के साथ, मुख्य हिस्से में मौजूद प्लेसहोल्डर को अपडेट करें. जैसे, OPERATING_ACCOUNT_PRODUCT, OPERATING_ACCOUNT_ID, और AUDIENCE_ID.
  2. बदलावों को लागू किए बिना अनुरोध की पुष्टि करने के लिए, validateOnly को true पर सेट करें. जब आप बदलाव लागू करने के लिए तैयार हों, तो validateOnly को false पर सेट करें.
  3. termsOfService सेट करें, ताकि यह पता चल सके कि उपयोगकर्ता ने Customer Match की सेवा की शर्तें स्वीकार कर ली हैं.
  4. ध्यान दें कि इस अनुरोध से पता चलता है कि consent को अनुमति दी गई है और वह एन्क्रिप्शन का इस्तेमाल नहीं करता.

अनुरोध भेजना

  1. सैंपल के सबसे ऊपर दाईं ओर मौजूद, 'कॉपी करें' बटन का इस्तेमाल करके, अनुरोध का मुख्य हिस्सा कॉपी करें.
  2. audienceMembers.ingest पेज पर जाएं.
  3. दाईं ओर मौजूद एपीआई बटन पर क्लिक करें. इसके बाद, बड़ा किए गए सेक्शन में मौजूद इसे आज़माएं! बटन पर क्लिक करें.
  4. अनुरोध का कॉपी किया गया मुख्य हिस्सा, अनुरोध का मुख्य हिस्सा बॉक्स में चिपकाएं.
  5. कार्रवाई करें बटन पर क्लिक करें. इसके बाद, अनुमति के लिए पूछे गए सवालों के जवाब दें और रिस्पॉन्स की समीक्षा करें.

सफलता के जवाब

अनुरोध पूरा होने पर, जवाब के तौर पर एक ऑब्जेक्ट मिलता है, जिसमें requestId होता है.

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

गड़बड़ी के जवाब

अनुरोध पूरा न होने पर, गड़बड़ी के जवाब का स्टेटस कोड मिलता है. जैसे, 400 Bad Request. साथ ही, गड़बड़ी की जानकारी वाला जवाब भी मिलता है.

उदाहरण के लिए, हेक्स कोड में बदली गई वैल्यू के बजाय, सामान्य टेक्स्ट स्ट्रिंग वाले email_address से यह जवाब मिलता है:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "audience_members.audience_members[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

हैश नहीं किया गया और सिर्फ़ हेक्स कोड में बदला गया email_address, यह रिस्पॉन्स दिखाता है:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "audience_members.audience_members[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

अगले चरण