থার্ড-পার্টি অ্যাপ ট্র্যাকিংয়ের জন্য DDM ইন্টিগ্রেশন

নিম্নলিখিত এন্ড-টু-এন্ড ফ্লো একটি তৃতীয়-পক্ষ অ্যাপ ট্র্যাকিং সমাধান ব্যবহার করে DoubleClick বাই-সাইড পণ্যগুলিতে একটি প্রচারাভিযান চালানোর জন্য প্রয়োজনীয় বিজ্ঞাপনদাতা সেটআপ এবং তৃতীয়-পক্ষ বাস্তবায়ন উভয়ই বর্ণনা করে৷

সাধারণভাবে DoubleClick ডিজিটাল মার্কেটিং সম্পর্কে আরও তথ্যের পাশাপাশি ইন-অ্যাপ অ্যাট্রিবিউশন বৈশিষ্ট্যগুলির একটি ওভারভিউয়ের জন্য, DoubleClick ডিজিটাল মার্কেটিং পটভূমি পৃষ্ঠাটি দেখুন।

1. বিজ্ঞাপনদাতা ইন্সটল বা রূপান্তর (শুধুমাত্র বিড ম্যানেজার - রূপান্তর পিক্সেল) (ক্যাম্পেইন ম্যানেজার - ফ্লাডলাইট কার্যকলাপ) প্রতিনিধিত্ব করতে DDM-তে রূপান্তর ইভেন্ট সেট আপ করে।

2. বিজ্ঞাপনদাতা তৃতীয় পক্ষের ইন্টারফেসে DDM রূপান্তর ইভেন্টকে "লিঙ্ক" করে এবং একটি বিজ্ঞাপনদাতা এবং রূপান্তর কার্যকলাপ গোষ্ঠীকে চিহ্নিত করে এমন মূল ভেরিয়েবল সরবরাহ করে।

   • src হল বিজ্ঞাপনদাতা আইডি যা ফ্লাডলাইট কার্যকলাপের উৎস।
   • cat হল অ্যাক্টিভিটি ট্যাগ স্ট্রিং, যেটি ফ্লাডলাইট সার্ভারগুলি অ্যাক্টিভিটি গ্রুপের সাথে জড়িত তা চিহ্নিত করতে ব্যবহার করে।
   • type হল গ্রুপ ট্যাগ স্ট্রিং, যা অ্যাক্টিভিটি গ্রুপকে চিহ্নিত করে যার সাথে ফ্লাডলাইট অ্যাক্টিভিটি যুক্ত।
   • u1, u2, ... (যদি পাওয়া যায়) হল কাস্টম ফ্লাডলাইট পরিবর্তনশীল কী-মান।

3. বিজ্ঞাপনদাতা DMA সম্মতির জন্য সম্মতি সংগ্রহকে বোঝাতে ভেরিয়েবল যোগ করে।

   • eea ব্যবহার করা হয় EEA ব্যবহারকারীদের সনাক্ত করতে।
     • eea=0 নির্দেশ করে যে ব্যবহারকারী EEA থেকে নয়।
     • eea=1 নির্দেশ করে যে ব্যবহারকারী EEA থেকে এসেছেন ।
   • ad_user_data হল বিজ্ঞাপনের উদ্দেশ্যে ব্যবহারকারীর ডেটা ব্যবহারের জন্য সম্মতির পতাকা।
     • শুধুমাত্র eea=1 হলেই সেট করতে হবে
     • ad_user_data=0 নির্দেশ করে যে ব্যবহারকারী বিজ্ঞাপনের উদ্দেশ্যে Google-এ ব্যবহারকারী স্তরের ডেটা প্রেরণের জন্য সম্মতি অস্বীকার করেছেন।
     • ad_user_data=1 নির্দেশ করে যে ব্যবহারকারী বিজ্ঞাপনের উদ্দেশ্যে Google-এ ব্যবহারকারী স্তরের ডেটা প্রেরণের জন্য সম্মতি দিয়েছেন।
   • npa বিজ্ঞাপন ব্যক্তিগতকরণ সামগ্রীর জন্য ব্যবহৃত হয়।
     • npa=0 ব্যবহারকারীর ব্যক্তিগতকরণে সম্মতি নির্দেশ করে।
     • npa=1 নির্দেশ করে যে ব্যবহারকারী ব্যক্তিগতকরণে সম্মতি দেননি ।
   • test_request_reason=dma ডিএমএ প্যারামিটার পরীক্ষা করতে ব্যবহার করা যেতে পারে
     • সমস্ত DMA প্যারামিটার যাচাই করে এবং সতর্কতা প্রদান করে।
     • জাল ক্লিকের সাথে বহু-প্রতিক্রিয়া প্রদান করে।
     • পরীক্ষা রূপান্তর হিসাবে রূপান্তর লগ.

4. উপরন্তু, বিজ্ঞাপনদাতাকে তার নির্দিষ্ট অনুমোদন টোকেন সহ তৃতীয় পক্ষগুলি প্রদান করতে হবে:

   token হল একটি বিজ্ঞাপনদাতা-নির্দিষ্ট আলফানিউমেরিক স্ট্রিং যা অবশ্যই DDM-এ প্রতিটি সার্ভারের অনুরোধের সাথে পাস করতে হবে।

5. বিজ্ঞাপনদাতা রিয়েল-টাইম বিডিং এক্সচেঞ্জে DBM দ্বারা পরিবেশিত বিজ্ঞাপন ট্যাগ সহ অ্যাপ-মধ্যস্থ বিজ্ঞাপন প্রচার চালায় বা সরাসরি কেনা মিডিয়াতে DCM দ্বারা পরিবেশিত হয়।

6. শেষ ব্যবহারকারী বিজ্ঞাপনগুলি দেখে এবং ক্লিক করে, যেগুলি DDM দ্বারা লগ করা হয়৷

7. যখন শেষ ব্যবহারকারী অ্যাপটি ইনস্টল করেন বা একটি রূপান্তর ইভেন্ট সম্পূর্ণ করেন, যেমন "গেম প্লে", তৃতীয় পক্ষের সার্ভারগুলি প্রতিটি অ্যাপ কার্যকলাপে "পিং" ডিডিএম:

   EEA-তে নেই এমন ব্যবহারকারীর জন্য একটি উদাহরণ URL

   https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
   

   EEA ব্যবহারকারীর জন্য একটি উদাহরণ URL

   https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
   

   কোথায়:

   • src হল বিজ্ঞাপনদাতা আইডি যা ফ্লাডলাইট কার্যকলাপের উৎস।
   • cat হল অ্যাক্টিভিটি ট্যাগ স্ট্রিং, যেটি ফ্লাডলাইট সার্ভারগুলি অ্যাক্টিভিটি গ্রুপের সাথে জড়িত তা চিহ্নিত করতে ব্যবহার করে।
   • type হল গ্রুপ ট্যাগ স্ট্রিং, যা অ্যাক্টিভিটি গ্রুপকে চিহ্নিত করে যার সাথে ফ্লাডলাইট অ্যাক্টিভিটি যুক্ত।
   • ord হল একটি এলোমেলো সংখ্যা যা ফ্লাডলাইট ট্যাগটিকে অনন্য করতে ব্যবহৃত হয়।
   • u1, u2, ... (যদি পাওয়া যায়) হল কাস্টম ফ্লাডলাইট পরিবর্তনশীল কী-মান।
   • ব্যবহারকারী EEA-তে থাকলে eea সনাক্ত করে।
   • ad_user_data চিহ্নিত করে যদি ব্যবহারকারী কুকি এবং পরিমাপ করতে সম্মত হয়।
   • ব্যবহারকারী ব্যক্তিগতকরণে সম্মত হলে npa সনাক্ত করে।

   একটি HTTP পোস্টে একটি JSON পেলোডের মাধ্যমে পাঠানো অতিরিক্ত পরামিতি সহ:

   {
     "app": {
       "bundle": "com.rovio.angrybirds"
     },
     "device": {
       "ua": "Mozilla/5.0 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
       "ip": "108.176.57.230",
       "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
       "lmt": 1
     }
   }
   

   এবং বিজ্ঞাপনদাতা অনুমোদন টোকেন HTTP অনুমোদন শিরোনামে পাস করা হয়েছে:

   Authorization: Token token="[advertiser authorization token string]"
   

   কোথায়:

   • app (প্রয়োজনীয়) হল JSON অবজেক্ট যা অ্যাপের প্রতিনিধিত্ব করে যেখানে রূপান্তর কার্যকলাপ হয়েছে। app: {} যদি অ্যাপ যেখানে রূপান্তর কার্যকলাপ সংঘটিত হয় সেটি উপলব্ধ না হয়।
   • bundle (যদি পাওয়া যায়) হল অ্যাপ অবজেক্ট ফিল্ড যাতে প্লে স্টোর বান্ডেল নাম বা অ্যাপ স্টোর আইডির একটি স্ট্রিং মান থাকে।
   • device হল JSON অবজেক্ট যে ডিভাইসটিতে রূপান্তর কার্যকলাপ সংঘটিত হয়েছে।
   • ua হল ডিভাইস অবজেক্ট ক্ষেত্র যা অ্যাপের ব্যবহারকারী এজেন্ট স্ট্রিংকে প্রতিনিধিত্ব করে যেখানে একটি কার্যকলাপ রেকর্ড করা হয়েছিল। এই পরামিতি প্রয়োজন.
   • ip (যদি পাওয়া যায়) হল ডিভাইসের IPv4 ঠিকানাটি ডিভাইসে বরাদ্দ করা হয়েছে। এই পরামিতি প্রয়োজন.
   • didmd5 হল বড় হাতের IDFA বা Google Play Advertising ID মানের MD5-হ্যাশ স্ট্রিং।
   • lmt হল একটি পূর্ণসংখ্যা, যার মান 1 যদি ব্যবহারকারী IDFA বা AdID-এর সাথে "সীমা বিজ্ঞাপন ট্র্যাকিং" বিকল্পটি সক্ষম করে থাকেন, অথবা 0 সেট না করলে।

   রূপান্তর ইভেন্টটি DCM দ্বারা পরিবেশিত ভিউ বা ক্লিকের জন্য দায়ী কিনা এবং "হ্যাঁ" হলে, ইভেন্ট সম্পর্কে অতিরিক্ত তথ্য (শেষ দেখা বা ক্লিক):

   • বিজ্ঞাপন আইডি
   • সাইট আইডি
   • প্লেসমেন্ট আইডি
   • ক্রিয়েটিভ আইডি
   • টাইমস্ট্যাম্প

   একটি উদাহরণ JSON প্রতিক্রিয়া এর মত দেখতে হতে পারে:

   {
     "attributed": 1,  // Whether the conversion can be attributed to a DCM event.
     "last_impression_ad_id":283641088,
     "last_impression_site_id":1408067,
     "last_impression_placement_id":107616368,
     "last_impression_creative_id":60162352,
     "last_impression_timestamp":1415647607,
     "last_click_ad_id":283641088,
     "last_click_site_id":1408067,
     "last_click_placement_id":107616368,
     "last_click_creative_id":60162352,
     "last_click_timestamp":1415647657,
     "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A",
     "cps": <cps>,
     "ad_events": [
       <ad event objects>
     ],
     "warnings": [<warning strings>],
     "errors": [<error strings>],
   }
   

   কোথায়:

   • attributed মান 1 (যদি রূপান্তরটি একটি ইমপ্রেশন বা ক্লিকের জন্য দায়ী করা যেতে পারে) বা 0 (যদি বৈশিষ্ট্যযুক্ত না হয়)।
   • last_impression_ad_id (যদি অ্যাট্রিবিউট করা হয় = 1) শেষ ইম্প্রেশনের বিজ্ঞাপন আইডি।
   • last_impression_site_id (যদি অ্যাট্রিবিউট করা হয় = 1) শেষ ইম্প্রেশনের জন্য সাইট আইডি।
   • last_impression_placement_id (যদি অ্যাট্রিবিউট করা হয় = 1) শেষ ইম্প্রেশনের জন্য প্লেসমেন্ট আইডি।
   • last_impression_creative_id (যদি অ্যাট্রিবিউট করা হয় = 1) শেষ ইম্প্রেশনের ক্রিয়েটিভ আইডি।
   • last_click_ad_id (যদি অ্যাট্রিবিউট করা হয় = 1 এবং একটি ক্লিক অ্যাট্রিবিউট করা হয়) শেষ ক্লিকের বিজ্ঞাপন আইডি।
   • last_click_site_id (যদি অ্যাট্রিবিউট করা হয় = 1 এবং একটি ক্লিক অ্যাট্রিবিউট করা হয়) শেষ ক্লিকের জন্য সাইট আইডি।
   • last_click_placement_id (যদি অ্যাট্রিবিউট করা হয় = 1 এবং একটি ক্লিক অ্যাট্রিবিউট করা হয়) শেষ ক্লিকের জন্য প্লেসমেন্ট আইডি।
   • last_click_creative_id (যদি অ্যাট্রিবিউট করা হয় = 1 এবং একটি ক্লিক অ্যাট্রিবিউট করা হয়) শেষ ক্লিকের ক্রিয়েটিভ আইডি।
   • last_click_exclid একটি অনন্য ক্লিক আইডির সাথে সঙ্গতিপূর্ণ যা %eiid! ম্যাক্রো

   মার্চ 2024 সালে DMA প্রয়োগের সাথে শুরু করে, নিম্নলিখিত ক্ষেত্রগুলিও উপলব্ধ হবে:

   • cps নির্দেশ করে যে ইভেন্টটি কোন মূল প্ল্যাটফর্ম পরিষেবার অন্তর্গত
     • a : বিজ্ঞাপন
     • m : মানচিত্র
     • p : প্লে স্টোর
     • s : অনুসন্ধান করুন
     • h : কেনাকাটা
     • y : ইউটিউব
   • ad_events হল ad_event অবজেক্টের একটি অ্যারে যাতে সমস্ত রূপান্তর ইভেন্ট থাকে।
     • ad_event অবজেক্টে নিম্নলিখিত ক্ষেত্র রয়েছে:
     • product_type হল একটি স্ট্রিং যা রূপান্তরের জন্য দায়ী পণ্যের রিপোর্ট করে। এটি হয় DCM বা DBM হবে।
     • interaction_type হল ইন্টারঅ্যাকশনের ধরন যা ইভেন্টে নিয়ে যায়। হয় impression বা click .
     • conversion_metric হল এট্রিবিউশনের জন্য ব্যবহৃত রূপান্তর মেট্রিক। হয় conversion অথবা view_through_conversion ।
     • timestamp হল ইউনিক্স টাইমস্ট্যাম্প যেটি বিজ্ঞাপন ইভেন্টটি মাইক্রোসেকেন্ড নির্ভুলতার সাথে ঘটেছে। এই মানটি লাস্ট-ক্লিক অ্যাট্রিবিউশনের জন্য ব্যবহার করা উচিত।
     • campaign_type বিজ্ঞাপন ইভেন্ট তৈরি করে এমন প্রচারণার ধরন চিহ্নিত করে।
     • line_item_id (শুধুমাত্র DBM) হল DBM লাইন আইটেম আইডি যেটি বিজ্ঞাপন ইভেন্ট তৈরি করেছে।
     • line_item_name (শুধুমাত্র DBM) হল DBM লাইন আইটেমের নাম যা বিজ্ঞাপন ইভেন্টটি তৈরি করেছে।
     • placement_id (শুধুমাত্র DCM) হল DCM প্লেসমেন্ট ট্যাগ আইডি যেটি বিজ্ঞাপন ইভেন্ট তৈরি করেছে।
     • placement_name (শুধুমাত্র DCM) হল DCM প্লেসমেন্ট ট্যাগের নাম যা বিজ্ঞাপন ইভেন্টটি তৈরি করেছে।
     • external_customer_id হল বিজ্ঞাপনদাতা শনাক্তকারী যে প্রচারাভিযানের মালিক যে বিজ্ঞাপন ইভেন্টটি তৈরি করেছে৷
       • যদি product DBM হয় তবে এই ক্ষেত্রটি DBM বিজ্ঞাপনদাতা আইডিকে প্রতিনিধিত্ব করে৷
       • যদি product DCM হয় তবে এই ক্ষেত্রটি DCM বিজ্ঞাপনদাতার ID প্রতিনিধিত্ব করে।
     • creative_id হল সৃজনশীল বিজ্ঞাপন ইউনিটের আইডি যেটি বিজ্ঞাপন ইভেন্ট তৈরি করেছে।
       • যদি product DBM হয় তবে এই ক্ষেত্রটি DBM ক্রিয়েটিভ আইডি উপস্থাপন করে।
       • যদি product DCM হয় তবে এই ক্ষেত্রটি DCM ক্রিয়েটিভ আইডি প্রতিনিধিত্ব করে।
     • exchange_id (শুধুমাত্র DBM) হল সেই এক্সচেঞ্জের ID যা DBM বিজ্ঞাপন পরিবেশন করে।
     • insertion_order_id (শুধুমাত্র DBM) হল DBM সন্নিবেশ অর্ডার আইডি।
     • site_id (শুধুমাত্র DCM) হল বিজ্ঞাপন ইভেন্টের জন্য DCM সাইট আইডি।
     • cps নির্দেশ করে যে বিজ্ঞাপন ইভেন্টটি কোন মূল প্ল্যাটফর্ম পরিষেবার অন্তর্গত। আরও বিস্তারিত জানার জন্য ডকুমেন্টেশনে আগে cps ক্ষেত্রের সম্পূর্ণ ব্যাখ্যা পড়ুন।
   • warnings হল রূপান্তর ইভেন্ট দ্বারা উত্পাদিত সতর্কতার একটি অ্যারে।

   • errors হল নিম্নোক্ত পরিস্থিতিগুলির জন্য HTTP ত্রুটি কোড সহ রূপান্তর ইভেন্ট দ্বারা উত্পাদিত ত্রুটিগুলির একটি বিন্যাস:

     • অনুরোধ কোটা অতিক্রম করা হলে HTTP 204 ।
     • HTTP 400 যখন অনুরোধটি অবৈধ বলে বিবেচিত হয়—উদাহরণস্বরূপ, প্রয়োজনীয় প্যারামিটারগুলি অনুপস্থিত, এবং সার্ভার পিক্সেল ট্র্যাকিংয়ে ফিরে এসেছে।
     • অনুমোদন টোকেন অবৈধ হলে HTTP 401 ।
     • কোনো খারাপ অনুরোধের জন্য HTTP 404 ।

   বিজ্ঞাপনদাতা আপনার সিস্টেমে প্রচারাভিযান রিপোর্ট দেখতে সক্ষম হবে; বিজ্ঞাপনদাতাও একই প্যারামিটার সহ DCM-এ রূপান্তর প্রতিবেদন দেখতে সক্ষম হবেন।

   মার্চ 2024-এ DMA কার্যকর হওয়ার পরে অতিরিক্ত উদাহরণের প্রতিক্রিয়া

   একটি বৈশিষ্ট্যযুক্ত রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার একটি উদাহরণ যেখানে রূপান্তরটি অনুসন্ধান + YouTube বিজ্ঞাপনের ইন্টারঅ্যাকশন উভয়ের জন্য দায়ী করা হয় তবে 5(2)(b) + 5(2)(c) সার্চ + YouTube CPS-এর মধ্যে ক্রস-ব্যবহারের সম্মতি অস্বীকার করা হয়:

   {
     attributed: 1,
     last_impression_ad_id: 283641088,
     last_impression_site_id: 1408067,
     last_impression_placement_id: 107616368,
     last_impression_creative_id: 60162352,
     last_impression_timestamp: 1415647607,
     last_click_ad_id: 283641088,
     last_click_site_id: 1408067,
     last_click_placement_id: 107616368,
     last_click_creative_id: 60162352,
     last_click_timestamp: 1415647655,
     last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
     cps: "s",
     ad_events: [{
         cps : "s",
         product_type: "DCM",
         interaction_type: "click",
         ad_event_type: "click",
         campaign_type: "Display",
         placement_id: 107616368,
         placement_name: "TEST PLACEMENT NAME",
         external_customer_id: 7480542,
         creative_id: 60162352,
         timestamp: 1415647655.123456,
         site_id: 1408067,
         }, {
         cps : "s",
         product_type:"DCM",
         interaction_type: "impression",
         ad_event_type: "impression",
         campaign_type: "Display",
         placement_id: 107616368,
         placement_name: "TEST PLACEMENT NAME",
         external_customer_id: 7480542,
         creative_id: 60162352,
         timestamp: 1415647607.123456,
         site_id: 1408067
         },{
         cps : "y",
         product_type: "DCM",
         ad_event_type: "click",
         campaign_type: "Display",
         placement_id: 107616370,
         placement_name: "Placement on Youtube",
         external_customer_id: 7480542,
         creative_id: 6016444,
         timestamp: 14344344.123456,
         site_id: 140806
         },
     ]}
   

   একটি DBM ক্যাম্পেইনের জন্য একটি ইতিবাচক রূপান্তর ট্র্যাকিং প্রতিক্রিয়ার উদাহরণ:

   {
     attributed: 1,
     last_click_ad_id: 283641088,
     last_click_site_id: 1408067,
     last_click_placement_id: 107616368,
     last_click_creative_id :60162352,
     last_click_timestamp: 1415647655,
     last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
     cps: "y",
     ad_events: [{
       product_type: "DBM",
       interaction_type: "click",
       ad_event_type: "click",
       campaign_type: "Display",
       line_item_id: 123456789,
       line_item_name: "TEST LINE ITEM NAME",
       external_customer_id: 2550,
       creative_id: 512333,
       exchange_id: 132,
       insertion_order_id: 523423,
       timestamp: 1432681913.123456
       cps: "y"
     },
     {
       product_type: "DCM",
       interaction_type: "click",
       campaign_type: "Display",
       placement_id: 9342323,
       placement_name: "TEST PLACEMENT NAME",
       external_customer_id: 7480542,
       creative_id: 8234234,
       timestamp: 1432681913.123456,
       cps: "y"
     }
   ]}