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

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

এই কুইকস্টার্টে, আপনি নিম্নলিখিত পদক্ষেপগুলি সম্পন্ন করবেন:

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

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

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

    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "AUDIENCE_ID"
    }
  • operatingAccount সেই অ্যাকাউন্টের ধরণ এবং আইডিতে সেট করুন যা দর্শকদের ডেটা গ্রহণ করবে।
  • যদি আপনার OAuth শংসাপত্রগুলি এমন কোনও ব্যবহারকারীর জন্য হয় যার Google Ads ম্যানেজার অ্যাকাউন্টে অ্যাক্সেস আছে, যার একটি সাবঅ্যাকাউন্ট হিসাবে operatingAccount আছে, তাহলে loginAccount কে ম্যানেজার অ্যাকাউন্টের অ্যাকাউন্টের ধরণ এবং আইডিতে সেট করুন।
  • যদি OAuth শংসাপত্রগুলি এমন কোনও ব্যবহারকারীর জন্য হয় যার operatingAccount এ সরাসরি অ্যাক্সেস আছে, তাহলে আপনাকে loginAccount সেট করার দরকার নেই।

দর্শকদের তথ্য প্রস্তুত করুন

কমা দ্বারা পৃথক করা ফাইলে নিম্নলিখিত নমুনা ডেটা বিবেচনা করুন। ফাইলের প্রতিটি লাইন দর্শকদের একজন সদস্যের সাথে সম্পর্কিত, এবং প্রতিটি সদস্যের সর্বাধিক তিনটি ইমেল ঠিকানা রয়েছে।

#,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. হেক্সাডেসিমেল (হেক্স) অথবা বেস৬৪ এনকোডিং ব্যবহার করে হ্যাশ বাইট এনকোড করুন। এই নির্দেশিকার উদাহরণগুলিতে হেক্স এনকোডিং ব্যবহার করা হয়েছে।

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

#,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"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_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": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "11112222",
      "reference": "audience_1"
    },
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_2_TYPE",
        "accountId": "OPERATING_ACCOUNT_2_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_2_TYPE",
        "accountId": "LOGIN_ACCOUNT_2_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 অডিয়েন্স সদস্যকে অনুরোধের সমস্ত গন্তব্যে পাঠায়।

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

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