การผสานรวม DDM สำหรับการติดตามแอปของบุคคลที่สาม

ขั้นตอนแบบครบวงจรต่อไปนี้อธิบายทั้งการตั้งค่าของผู้ลงโฆษณาและการติดตั้งใช้งานของบุคคลที่สาม ที่จำเป็นต่อการเรียกใช้แคมเปญในผลิตภัณฑ์ฝั่งซื้อของ DoubleClick โดยใช้โซลูชันการติดตามแอปของบุคคลที่สาม

ดูข้อมูลเพิ่มเติมเกี่ยวกับการตลาดดิจิทัล DoubleClick โดยทั่วไป รวมถึง ภาพรวมของฟีเจอร์การระบุแหล่งที่มาในแอปได้ที่หน้าข้อมูลพื้นฐานเกี่ยวกับการตลาดดิจิทัล DoubleClick

1. ผู้ลงโฆษณาตั้งค่าเหตุการณ์ Conversion ใน DDM เพื่อแสดงการติดตั้งหรือ Conversion (เฉพาะ Bid Manager - พิกเซล Conversion) (Campaign Manager - กิจกรรม Floodlight)

2. ผู้ลงโฆษณา "ลิงก์" เหตุการณ์ Conversion ของ DDM ในอินเทอร์เฟซของบุคคลที่สาม และ ระบุตัวแปรสําคัญที่ระบุผู้ลงโฆษณาและกลุ่มกิจกรรม Conversion

   • src คือรหัสผู้ลงโฆษณาที่เป็นแหล่งที่มาของกิจกรรม Floodlight
   • cat คือสตริงแท็กกิจกรรมที่เซิร์ฟเวอร์ Floodlight ใช้เพื่อระบุ กลุ่มกิจกรรมที่กิจกรรมนั้นๆ สังกัดอยู่
   • type คือสตริงแท็กกลุ่มซึ่งระบุกลุ่มกิจกรรมที่เชื่อมโยงกับกิจกรรม Floodlight
   • u1, u2, ... (หากมี) คือค่าคีย์ของตัวแปร Floodlight ที่กำหนดเอง

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 ได้
     • ตรวจสอบพารามิเตอร์ DMA ทั้งหมดและแสดงคำเตือน
     • แสดงผลการตอบกลับหลายรายการด้วยการคลิกปลอม
     • บันทึก Conversion เป็น Conversion การทดสอบ

4. นอกจากนี้ ผู้ลงโฆษณายังต้องระบุโทเค็นการให้สิทธิ์ที่เฉพาะเจาะจงของตนเองแก่บุคคลที่สามด้วย

   token คือสตริงตัวอักษรและตัวเลขเฉพาะผู้ลงโฆษณาที่ต้องส่ง พร้อมกับคำขอเซิร์ฟเวอร์แต่ละรายการไปยัง DDM

5. ผู้ลงโฆษณาดำเนินแคมเปญโฆษณาในแอปโดยใช้แท็กโฆษณาที่ DBM แสดงในการแลกเปลี่ยนการเสนอราคาแบบเรียลไทม์ หรือใช้แท็กโฆษณาที่ DCM แสดงในสื่อที่ซื้อโดยตรง

6. ผู้ใช้ปลายทางเห็นและคลิกโฆษณา ซึ่ง DDM จะบันทึกไว้

7. เมื่อผู้ใช้ปลายทางติดตั้งแอปหรือทําเหตุการณ์ Conversion เสร็จสมบูรณ์ เช่น "game play" เซิร์ฟเวอร์ของบุคคลที่สามจะ "ping" DDM ในทุกกิจกรรมของแอป

   ตัวอย่าง URL สำหรับผู้ใช้ที่ไม่ได้อยู่ใน EEA

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

   ตัวอย่าง URL สำหรับผู้ใช้ใน EEA

   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 ที่แสดงแอปที่เกิดกิจกรรม Conversion ใช้ app: {} หากแอปที่เกิดกิจกรรม Conversion ไม่พร้อมใช้งาน
   • bundle (หากมี) คือฟิลด์ออบเจ็กต์แอปที่มีค่าสตริง ของชื่อแพ็กเกจ Play Store หรือรหัส App Store
   • device คือออบเจ็กต์ JSON ที่แสดงอุปกรณ์ที่เกิดกิจกรรม Conversion
   • ua คือฟิลด์ออบเจ็กต์อุปกรณ์ที่แสดงสตริง User Agent ของ แอปที่บันทึกกิจกรรม ต้องระบุพารามิเตอร์นี้
   • ip (หากมี) คือที่อยู่ IPv4 ของอุปกรณ์ที่กำหนดให้กับอุปกรณ์ ต้องระบุพารามิเตอร์นี้
   • didmd5 คือสตริงแฮช MD5 ของค่า IDFA หรือรหัสโฆษณา Google Play ที่เป็นตัวพิมพ์ใหญ่
   • lmt เป็นจำนวนเต็ม โดยมีค่าเป็น 1 หากผู้ใช้เปิดใช้ตัวเลือก "จำกัด การติดตามโฆษณา" ด้วย IDFA หรือ AdID หรือ 0 หากไม่ได้ตั้งค่า

   DDM จะตอบกลับด้วยการตอบกลับ JSON ว่าเหตุการณ์ Conversion ระบุแหล่งที่มาเป็นการดูหรือคลิกที่ 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 (หากระบุแหล่งที่มาของ Conversion เป็นการแสดงผลหรือคลิกได้) หรือ 0 (หากระบุแหล่งที่มาไม่ได้)
   • last_impression_ad_id (if attributed = 1) คือรหัสโฆษณาของการแสดงผลสุดท้าย
   • last_impression_site_id (if attributed = 1) คือรหัสเว็บไซต์สำหรับการแสดงผลสุดท้าย
   • last_impression_placement_id (หากระบุแหล่งที่มา = 1) คือรหัสตำแหน่งสำหรับการแสดงผลสุดท้าย
   • last_impression_creative_id (if attributed = 1) คือรหัสครีเอทีฟโฆษณาสำหรับการแสดงผลครั้งสุดท้าย
   • last_click_ad_id (หากระบุแหล่งที่มา = 1 และมีการระบุแหล่งที่มาของคลิก) คือ รหัสโฆษณาของคลิกสุดท้าย
   • last_click_site_id (หากระบุแหล่งที่มา = 1 และมีการระบุแหล่งที่มาของคลิก) คือ รหัสเว็บไซต์สําหรับคลิกล่าสุด
   • last_click_placement_id (if attributed = 1 and a click was attributed) คือรหัสตําแหน่งสําหรับคลิกสุดท้าย
   • last_click_creative_id (หากระบุแหล่งที่มา = 1 และมีการระบุแหล่งที่มาของคลิก) คือ รหัสครีเอทีฟโฆษณาสำหรับคลิกสุดท้าย
   • last_click_exclid สอดคล้องกับรหัสการคลิกที่ไม่ซ้ำกันซึ่งสร้างขึ้นโดยใช้มาโคร %eiid!

   ตั้งแต่การบังคับใช้ DMA ในเดือนมีนาคม 2024 เป็นต้นไป ฟิลด์ต่อไปนี้ จะพร้อมใช้งานด้วย

   • cps ระบุบริการแพลตฟอร์มหลักที่เหตุการณ์เป็นของ
     • a : โฆษณา
     • m : Maps
     • p : Play Store
     • s : ค้นหา
     • h : Shopping
     • y : YouTube
   • ad_events คืออาร์เรย์ของออบเจ็กต์ ad_event ที่มีเหตุการณ์ Conversion ทั้งหมด
     • ออบเจ็กต์ ad_event มีฟิลด์ต่อไปนี้
     • product_type คือสตริงที่รายงานผลิตภัณฑ์ที่รับผิดชอบต่อ Conversion ซึ่งอาจเป็น DCM หรือ DBM
     • interaction_type คือประเภทของการโต้ตอบที่นำไปสู่เหตุการณ์ impression หรือ click
     • conversion_metric คือเมตริก Conversion ที่ใช้สำหรับการระบุแหล่งที่มา conversion หรือ view_through_conversion
     • timestamp คือการประทับเวลา UNIX ที่เหตุการณ์โฆษณาเกิดขึ้นโดยมีความแม่นยำระดับไมโครวินาที ค่านี้ควรใช้สำหรับการระบุแหล่งที่มาของคลิกสุดท้าย
     • 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 คืออาร์เรย์ของคำเตือนที่เกิดจากเหตุการณ์ Conversion

   • errors คืออาร์เรย์ของข้อผิดพลาดที่เกิดจากเหตุการณ์ Conversion ที่มีรหัสข้อผิดพลาด HTTP สำหรับสถานการณ์ต่อไปนี้

     • HTTP 204 หากใช้โควต้าคำขอเกินขีดจำกัดแล้ว
     • HTTP 400 เมื่อระบบพิจารณาว่าคำขอไม่ถูกต้อง เช่น ไม่มีพารามิเตอร์ที่จำเป็น และเซิร์ฟเวอร์กลับไปใช้การติดตามพิกเซล
     • HTTP 401 หากโทเค็นการให้สิทธิ์ไม่ถูกต้อง
     • HTTP 404 สำหรับคำขอที่ไม่ถูกต้อง

   ผู้ลงโฆษณาจะดูรายงานแคมเปญในระบบของคุณได้ และจะดูรายงาน Conversion ใน DCM ที่มีพารามิเตอร์เดียวกันได้ด้วย

   ตัวอย่างคำตอบเพิ่มเติมหลังจากบังคับใช้ DMA ในเดือนมีนาคม 2024

   ตัวอย่างการตอบกลับการติดตาม Conversion ที่ระบุแหล่งที่มาซึ่ง Conversion ระบุแหล่งที่มาเป็นการโต้ตอบของโฆษณา Search + YouTube แต่ มีการปฏิเสธความยินยอมในการใช้ข้าม 5(2)(b) + 5(2)(c) ระหว่าง CPS ของ Search + 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
         },
     ]}
   

   ตัวอย่างการตอบกลับการวัด Conversion ที่ยืนยันสําหรับแคมเปญ 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"
     }
   ]}