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

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

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

  1. শ্রোতাদের ডেটা পাওয়ার জন্য একটি Destination প্রস্তুত করুন।
  2. পাঠানোর জন্য দর্শকদের ডেটা প্রস্তুত করুন।
  3. দর্শক সদস্যদের জন্য একটি IngestionService অনুরোধ তৈরি করুন।
  4. Google APIs এক্সপ্লোরার দিয়ে অনুরোধ পাঠান।
  5. সফলতা এবং ব্যর্থতার প্রতিক্রিয়া বুঝুন।

একটি গন্তব্য প্রস্তুত করুন

আপনি ডেটা পাঠানোর আগে, আপনাকে ডেটা পাঠানোর জন্য গন্তব্য প্রস্তুত করতে হবে। আপনার ব্যবহারের জন্য এখানে একটি নমুনা Destination রয়েছে:

    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "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": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "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_TYPE , OPERATING_ACCOUNT_ID , এবং AUDIENCE_ID এর মতো স্থানধারকগুলিকে আপডেট করুন৷
  2. পরিবর্তনগুলি প্রয়োগ না করেই অনুরোধটি যাচাই করার জন্য validateOnly true সেট করুন৷ আপনি যখন পরিবর্তনগুলি প্রয়োগ করার জন্য প্রস্তুত হবেন, validateOnly সেট করুন false ।
  3. ব্যবহারকারী গ্রাহক ম্যাচের পরিষেবার শর্তাবলী স্বীকার করেছেন তা নির্দেশ করার জন্য termsOfService সেট করুন।
  4. মনে রাখবেন এই অনুরোধটি নির্দেশ করে যে consent দেওয়া হয়েছে, এবং এনক্রিপশন ব্যবহার করে না।

অনুরোধ পাঠান

  1. নমুনার উপরের ডানদিকে অনুলিপি বোতামটি ব্যবহার করে অনুরোধের অংশটি অনুলিপি করুন।
  2. টুলবারে API বোতামে ক্লিক করুন।
  3. অনুলিপি করা রিকোয়েস্ট বডি রিকোয়েস্ট বডি বক্সে পেস্ট করুন।
  4. এক্সিকিউট বোতামে ক্লিক করুন, অনুমোদনের অনুরোধগুলি সম্পূর্ণ করুন এবং প্রতিক্রিয়া পর্যালোচনা করুন।

সফল প্রতিক্রিয়া

একটি সফল অনুরোধ একটি requestId ধারণকারী একটি বস্তুর সাথে একটি প্রতিক্রিয়া প্রদান করে।

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

requestId ফেরত রেকর্ড করুন যাতে অনুরোধের প্রতিটি গন্তব্য প্রক্রিয়া করা হলে আপনি ডায়াগনস্টিকস পুনরুদ্ধার করতে পারেন।

ব্যর্থ প্রতিক্রিয়া

একটি ব্যর্থ অনুরোধের ফলে একটি ত্রুটি প্রতিক্রিয়া স্ট্যাটাস কোড যেমন 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"
          }
        ]
      }
    ]
  }
}

একাধিক গন্তব্যের জন্য ইভেন্ট পাঠান

যদি আপনার ডেটাতে বিভিন্ন গন্তব্যের জন্য শ্রোতা সদস্য থাকে, আপনি গন্তব্য রেফারেন্স ব্যবহার করে একই অনুরোধে তাদের পাঠাতে পারেন।

উদাহরণস্বরূপ, যদি আপনার ব্যবহারকারী তালিকা আইডি 11112222 এর জন্য একজন দর্শক সদস্য এবং ব্যবহারকারী তালিকা আইডি 77778888 এর জন্য অন্য দর্শক সদস্য থাকে, তাহলে প্রতিটি Destination reference সেট করে উভয় শ্রোতা সদস্যকে একক অনুরোধে পাঠান। reference ব্যবহারকারী-সংজ্ঞায়িত—একমাত্র প্রয়োজন হল প্রতিটি Destination একটি অনন্য reference রয়েছে। অনুরোধের জন্য পরিবর্তিত destinations তালিকা এখানে রয়েছে: 

  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "11112222",
      "reference": "audience_1"
    },
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ADS",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "productDestinationId": "77778888",
      "reference": "audience_2"
    }
  ]

এক বা একাধিক নির্দিষ্ট গন্তব্যে পাঠাতে প্রতিটি AudienceMember এর destination_references সেট করুন। উদাহরণস্বরূপ, এখানে একটি AudienceMember আছে যা শুধুমাত্র প্রথম Destination জন্য, তাই এর destination_references তালিকায় শুধুমাত্র প্রথম Destination reference রয়েছে: 

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

destination_references ক্ষেত্রটি একটি তালিকা, তাই আপনি একজন দর্শক সদস্যের জন্য একাধিক গন্তব্য নির্দিষ্ট করতে পারেন। আপনি যদি AudienceMember এর destination_references সেট না করেন, তাহলে ডেটা ম্যানেজার API শ্রোতা সদস্যকে অনুরোধের সমস্ত গন্তব্যে পাঠায়।

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

পূর্ববর্তী
দর্শক ওভারভিউ