শ্রোতা সদস্যদের পাঠান

আপনি ডেটা ম্যানেজার API এর সাথে পরিচিত হওয়ার জন্য এই কুইকস্টার্টের মাধ্যমে কাজ করতে পারেন। আপনি দেখতে চান কুইকস্টার্টের সংস্করণটি চয়ন করুন:

এই দ্রুত শুরুতে, আপনি নিম্নলিখিত পদক্ষেপগুলি সম্পূর্ণ করুন:

  1. শ্রোতাদের ডেটা পাওয়ার জন্য একটি Destination প্রস্তুত করুন।
  2. পাঠানোর জন্য দর্শকদের ডেটা প্রস্তুত করুন।
  3. দর্শক সদস্যদের জন্য একটি IngestionService অনুরোধ তৈরি করুন।
  4. Google APIs এক্সপ্লোরার দিয়ে অনুরোধ পাঠান।
  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. হেক্সাডেসিমাল (হেক্স) বা বেস64 এনকোডিং ব্যবহার করে হ্যাশ বাইট এনকোড করুন। এই গাইডের উদাহরণগুলি হেক্স এনকোডিং ব্যবহার করে।

এখানে ফর্ম্যাট করা ডেটা রয়েছে:

#,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 সেট করুন।
  4. মনে রাখবেন এই অনুরোধটি নির্দেশ করে যে consent দেওয়া হয়েছে, এবং এনক্রিপশন ব্যবহার করে না।

অনুরোধ পাঠান

  1. নমুনার উপরের ডানদিকে অনুলিপি বোতামটি ব্যবহার করে অনুরোধের অংশটি অনুলিপি করুন।
  2. audienceMembers.ingest পৃষ্ঠাতে যান।
  3. ডানদিকে API বোতামে ক্লিক করুন, তারপর চেষ্টা করুন! প্রসারিত বিভাগে বোতাম।
  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"
          }
        ]
      }
    ]
  }
}

পরবর্তী পদক্ষেপ