ادغام DDM برای ردیابی برنامه شخص ثالث

جریان پایان به انتها زیر هم راه‌اندازی تبلیغ‌کننده و هم اجرای شخص ثالث مورد نیاز برای اجرای کمپین روی محصولات سمت خرید DoubleClick با استفاده از راه‌حل ردیابی برنامه شخص ثالث را توضیح می‌دهد.

برای اطلاعات بیشتر درباره بازاریابی دیجیتال DoubleClick به طور کلی و همچنین مروری بر ویژگی‌های اسناد درون برنامه‌ای، به صفحه پس‌زمینه DoubleClick Digital Marketing مراجعه کنید.

1. تبلیغ‌کننده رویداد تبدیل را در DDM تنظیم می‌کند تا نصب یا تبدیل را نشان دهد (فقط مدیر پیشنهاد - پیکسل تبدیل) (مدیر کمپین - فعالیت Floodlight).

2. تبلیغ‌کننده رویداد تبدیل DDM را در رابط شخص ثالث «پیوند» می‌کند و متغیرهای کلیدی را ارائه می‌کند که تبلیغ‌کننده و گروه فعالیت تبدیل را شناسایی می‌کند.

   • src شناسه تبلیغ‌کننده‌ای است که منبع فعالیت Floodlight است.
   • cat رشته تگ فعالیت است که سرورهای Floodlight از آن برای شناسایی گروه فعالیتی که فعالیت به آن تعلق دارد استفاده می کنند.
   • type رشته تگ گروهی است که گروه فعالیتی را که فعالیت Floodlight با آن مرتبط است مشخص می کند.
   • u1, u2, ... (در صورت موجود بودن) کلید-مقدارهای متغیر Floodlight سفارشی هستند.

3. آگهی‌دهنده متغیرهایی را برای نشان دادن جمع‌آوری رضایت برای مطابقت با DMA اضافه می‌کند.

   • eea برای شناسایی کاربران EEA استفاده می شود.
     • eea=0 نشان می دهد که کاربر از منطقه اقتصادی اروپا نیست.
     • eea=1 نشان می دهد که کاربر از منطقه اقتصادی اروپا است .
   • 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 استفاده شود
     • تمام پارامترهای DMA را تأیید می کند و هشدارها را برمی گرداند.
     • چند پاسخ را با کلیک های جعلی برمی گرداند.
     • تبدیل ها را به عنوان تبدیل های آزمایشی ثبت می کند.

4. علاوه بر این، تبلیغ‌کننده باید رمز مجوز خاص خود را به اشخاص ثالث ارائه دهد:

   token یک رشته الفبایی خاص تبلیغ کننده است که باید همراه با هر درخواست سرور به DDM ارسال شود.

5. تبلیغ‌کننده کمپین تبلیغاتی درون‌برنامه‌ای را با برچسب‌های تبلیغاتی اجرا می‌کند که توسط DBM در مبادلات پیشنهادی بی‌درنگ ارائه می‌شوند یا توسط DCM در رسانه‌هایی که مستقیماً خریداری می‌شوند، ارائه می‌شوند.

6. کاربر نهایی تبلیغاتی را می بیند و روی آن کلیک می کند که توسط DDM ثبت شده است.

7. هنگامی که کاربر نهایی برنامه را نصب می‌کند یا یک رویداد تبدیل را تکمیل می‌کند، مانند "بازی"، سرورهای شخص ثالث در هر فعالیت برنامه DDM را "پینگ" می‌کنند:

   یک URL مثال برای کاربری که در منطقه اقتصادی اروپا نیست

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

   یک 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 شناسه تبلیغ‌کننده‌ای است که منبع فعالیت Floodlight است.
   • cat رشته تگ فعالیت است که سرورهای Floodlight از آن برای شناسایی گروه فعالیتی که فعالیت به آن تعلق دارد استفاده می کنند.
   • type رشته تگ گروهی است که گروه فعالیتی را که فعالیت Floodlight با آن مرتبط است مشخص می کند.
   • ord یک عدد تصادفی است که برای منحصر به فرد کردن تگ Floodlight استفاده می شود.
   • u1, u2, ... (در صورت موجود بودن) کلید-مقدارهای متغیر Floodlight سفارشی هستند.
   • eea مشخص می کند که آیا کاربر در EEA است یا خیر.
   • ad_user_data مشخص می کند که آیا کاربر به کوکی ها و اندازه گیری رضایت دارد یا خیر.
   • npa تشخیص می دهد که آیا کاربر به شخصی سازی رضایت می دهد.

   با پارامترهای اضافی ارسال شده از طریق یک بار JSON در یک HTTP POST:

   {
     "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 (در صورت موجود بودن) فیلد شی برنامه است که حاوی مقدار رشته ای از نام بسته نرم افزاری فروشگاه Play یا شناسه فروشگاه App است.
   • device شیء JSON است که نشان دهنده دستگاهی است که فعالیت تبدیل در آن انجام شده است.
   • ua فیلد شی دستگاه است که نشان دهنده رشته عامل کاربر برنامه است که در آن یک فعالیت ثبت شده است. این پارامتر مورد نیاز است.
   • ip (در صورت وجود) آدرس IPv4 دستگاه است که به دستگاه اختصاص داده شده است. این پارامتر مورد نیاز است.
   • didmd5 رشته هش MD5 از IDFA یا مقدار شناسه تبلیغاتی Google Play با حروف بزرگ است.
   • lmt یک عدد صحیح است که اگر کاربر گزینه "Limit Ad Tracking" را با IDFA یا AdID فعال کرده باشد، مقدار آن 1 است، یا اگر تنظیم نشده باشد 0 است.

   DDM با یک پاسخ JSON پاسخ می دهد که آیا رویداد تبدیل به یک نما نسبت داده می شود یا کلیکی که توسط 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! کلان

   با شروع اجرای DMA در مارس 2024، فیلدهای زیر نیز در دسترس خواهند بود:

   • cps نشان می دهد که رویداد متعلق به کدام سرویس پلتفرم اصلی است
     • a : تبلیغات
     • m : نقشه ها
     • p : فروشگاه Play
     • 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 است.
     • creative_id شناسه واحد تبلیغات خلاقی است که رویداد تبلیغاتی را تولید کرده است.
       • اگر product DBM باشد، این قسمت نشان دهنده شناسه خلاقانه DBM است.
       • اگر product DCM باشد، این قسمت نشان دهنده شناسه خلاقیت DCM است.
     • exchange_id (فقط DBM) شناسه صرافی است که تبلیغ DBM را ارائه کرده است.
     • insertion_order_id (فقط DBM) شناسه سفارش درج DBM است.
     • site_id (فقط DCM) شناسه سایت DCM برای رویداد تبلیغاتی است.
     • cps نشان می دهد که رویداد تبلیغاتی به کدام سرویس پلتفرم اصلی تعلق دارد. برای جزئیات بیشتر به توضیح کامل فیلد cps در اسناد قبلی مراجعه کنید.
   • warnings مجموعه ای از اخطارهای تولید شده توسط رویداد تبدیل است.

   • errors آرایه ای از خطاهایی است که توسط رویداد تبدیل با کدهای خطای HTTP برای سناریوهای زیر ایجاد می شود:

     • HTTP 204 اگر از سهمیه درخواست فراتر رفته باشد.
     • HTTP 400 زمانی که درخواست نامعتبر در نظر گرفته شود - به عنوان مثال، پارامترهای مورد نیاز را از دست داده است، و سرور به ردیابی پیکسل بازگشته است.
     • اگر کد مجوز نامعتبر باشد، HTTP 401 .
     • HTTP 404 برای هر درخواست بد.

   تبلیغ‌کننده می‌تواند گزارش‌های کمپین را در سیستم شما ببیند. تبلیغ‌کننده همچنین می‌تواند گزارش‌های تبدیل را در DCM با همان پارامترها ببیند.

   پاسخ‌های نمونه اضافی پس از DMA در مارس 2024 اجرا می‌شود

   نمونه ای از پاسخ ردیابی تبدیل نسبت داده شده که در آن تبدیل به هر دو تعامل جستجو + آگهی YouTube نسبت داده می شود اما رضایت استفاده متقابل 5(2)(b) + 5(2)(c) بین CPS های جستجو + YouTube رد می شود:

   {
     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"
     }
   ]}