Trang này được dịch bởi Cloud Translation API.

Tích hợp DDM để theo dõi ứng dụng của bên thứ ba

Quy trình toàn diện sau đây mô tả cả chế độ thiết lập của nhà quảng cáo và việc triển khai của bên thứ ba cần thiết để chạy một chiến dịch trên các sản phẩm phía mua của DoubleClick bằng giải pháp theo dõi ứng dụng của bên thứ ba.

Để biết thêm thông tin về Tiếp thị kỹ thuật số của DoubleClick nói chung cũng như thông tin tổng quan về các tính năng phân bổ trong ứng dụng, hãy xem trang thông tin cơ bản về Tiếp thị kỹ thuật số của DoubleClick.

Nhà quảng cáo thiết lập Sự kiện chuyển đổi trong DDM để biểu thị lượt cài đặt hoặc lượt chuyển đổi (Chỉ Bid Manager – pixel chuyển đổi) (Campaign Manager – Hoạt động Floodlight).
Nhà quảng cáo "liên kết" sự kiện chuyển đổi DDM trong giao diện bên thứ ba và cung cấp các biến chính để xác định nhà quảng cáo và nhóm hoạt động chuyển đổi.
- src là mã nhận dạng nhà quảng cáo, nguồn của hoạt động Floodlight.
- cat là chuỗi thẻ hoạt động mà máy chủ Floodlight sử dụng để xác định nhóm hoạt động mà hoạt động đó thuộc về.
- type là chuỗi thẻ nhóm, xác định nhóm hoạt động được liên kết với hoạt động Floodlight.
- u1, u2, ... (nếu có) là các giá trị-khoá biến Floodlight tuỳ chỉnh.
Nhà quảng cáo thêm các biến để biểu thị việc thu thập sự đồng ý nhằm tuân thủ DMA.
- eea được dùng để xác định người dùng ở Khu vực kinh tế Châu Âu (EEA).
  - eea=0 cho biết người dùng không ở Khu vực kinh tế Châu Âu (EEA).
  - eea=1 cho biết người dùng đến từ Khu vực kinh tế Châu Âu (EEA).
- ad_user_data là cờ đồng ý cho việc sử dụng dữ liệu người dùng cho mục đích quảng cáo.
  - Bạn chỉ cần đặt nếu eea=1
  - ad_user_data=0 cho biết người dùng đã từ chối đồng ý truyền dữ liệu ở cấp người dùng đến Google cho mục đích quảng cáo.
  - ad_user_data=1 cho biết người dùng đã đồng ý truyền dữ liệu ở cấp người dùng đến Google cho mục đích quảng cáo.
- npa được dùng cho nội dung cá nhân hoá quảng cáo.
  - npa=0 cho biết người dùng đồng ý cá nhân hoá.
  - npa=1 cho biết người dùng chưa đồng ý cho phép cá nhân hoá.
- Bạn có thể dùng test_request_reason=dma để kiểm thử các tham số DMA
  - Xác thực tất cả các tham số DMA và trả về cảnh báo.
  - Trả về nhiều phản hồi với các lượt nhấp giả.
  - Ghi lại lượt chuyển đổi dưới dạng lượt chuyển đổi thử nghiệm.
Ngoài ra, nhà quảng cáo cần cung cấp mã thông báo uỷ quyền cụ thể cho bên thứ ba:

token là một chuỗi gồm chữ và số dành riêng cho nhà quảng cáo, phải được truyền cùng với mỗi yêu cầu máy chủ đến DDM.
Nhà quảng cáo chạy chiến dịch quảng cáo trong ứng dụng với thẻ quảng cáo do DBM phân phát trên các đối tác trao đổi đặt giá thầu theo thời gian thực hoặc do DCM phân phát trên phương tiện được mua trực tiếp.
Người dùng cuối nhìn thấy và nhấp vào quảng cáo, những lượt nhấp này được DDM ghi lại.
Khi người dùng cuối cài đặt ứng dụng hoặc hoàn tất một sự kiện chuyển đổi, chẳng hạn như "chơi trò chơi", các máy chủ bên thứ ba sẽ "ping" DDM trên mọi hoạt động của ứng dụng:

Ví dụ về URL cho người dùng không ở Khu vực kinh tế Châu Âu (EEA)
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
Ví dụ về URL cho người dùng ở Khu vực kinh tế Châu Âu (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
```
trong đó:
- src là mã nhận dạng nhà quảng cáo, nguồn của hoạt động Floodlight.
- cat là chuỗi thẻ hoạt động mà máy chủ Floodlight sử dụng để xác định nhóm hoạt động mà hoạt động đó thuộc về.
- type là chuỗi thẻ nhóm, xác định nhóm hoạt động được liên kết với hoạt động Floodlight.
- ord là một số ngẫu nhiên được dùng để tạo thẻ Floodlight riêng biệt.
- u1, u2, ... (nếu có) là các cặp giá trị/khoá biến Floodlight tuỳ chỉnh.
- eea xác định xem người dùng có ở Khu vực kinh tế Châu Âu (EEA) hay không.
- ad_user_data xác định xem người dùng có đồng ý với cookie và hoạt động đo lường hay không.
- npa xác định xem người dùng có đồng ý cá nhân hoá hay không.
với các tham số bổ sung được gửi qua tải trọng JSON trong yêu cầu POST của giao thức HTTP:
```
{
  "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
  }
}
```
và mã thông báo uỷ quyền của nhà quảng cáo được truyền trong Tiêu đề uỷ quyền HTTP:
```
Authorization: Token token="[advertiser authorization token string]"
```
trong đó:
- app (bắt buộc) là đối tượng JSON đại diện cho ứng dụng nơi diễn ra hoạt động chuyển đổi. Sử dụng app: {} nếu không có ứng dụng nơi diễn ra hoạt động chuyển đổi.
- bundle (nếu có) là trường đối tượng ứng dụng chứa một giá trị chuỗi là tên gói của Cửa hàng Play hoặc mã nhận dạng App Store.
- device là đối tượng JSON đại diện cho thiết bị mà hoạt động chuyển đổi diễn ra.
- ua là trường đối tượng thiết bị đại diện cho chuỗi tác nhân người dùng của ứng dụng nơi một hoạt động được ghi lại. Tham số này là bắt buộc.
- ip (nếu có) là địa chỉ IPv4 của thiết bị được chỉ định cho thiết bị. Tham số này là bắt buộc.
- didmd5 là chuỗi băm MD5 của giá trị IDFA hoặc Mã nhận dạng quảng cáo trên Google Play viết hoa.
- lmt là một số nguyên, có giá trị là 1 nếu người dùng đã bật chế độ "Giới hạn việc theo dõi quảng cáo" bằng IDFA hoặc AdID, hoặc 0 nếu không được đặt.
DDM sẽ phản hồi bằng một phản hồi JSON về việc sự kiện chuyển đổi có được phân bổ cho một lượt xem hay lượt nhấp do DCM phân phát hay không. Nếu "CÓ", thì thông tin bổ sung về sự kiện (lượt xem hoặc lượt nhấp gần đây nhất):
- ID Quảng cáo
- Mã trang web
- Mã vị trí
- Mã mẫu quảng cáo
- Dấu thời gian
Phản hồi JSON mẫu có thể có dạng như sau:
```
{
  "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>],
}
```
trong đó:
- attributed là giá trị 1 (nếu lượt chuyển đổi có thể được phân bổ cho một lượt hiển thị hoặc lượt nhấp) hoặc 0 (nếu không thể phân bổ).
- last_impression_ad_id (nếu được phân bổ = 1) là mã quảng cáo cho lượt hiển thị cuối cùng.
- last_impression_site_id (nếu được phân bổ = 1) là mã nhận dạng trang web cho lượt hiển thị cuối cùng.
- last_impression_placement_id (nếu attributed = 1) là mã vị trí cho lượt hiển thị cuối cùng.
- last_impression_creative_id (nếu được phân bổ = 1) là mã mẫu quảng cáo cho lượt hiển thị cuối cùng.
- last_click_ad_id (nếu attributed = 1 và một lượt nhấp được phân bổ) là mã quảng cáo cho lượt nhấp cuối cùng.
- last_click_site_id (nếu attributed = 1 và một lượt nhấp được phân bổ) là mã nhận dạng trang web cho lượt nhấp cuối cùng.
- last_click_placement_id (nếu được phân bổ = 1 và một lượt nhấp được phân bổ) là mã vị trí cho lượt nhấp cuối cùng.
- last_click_creative_id (nếu được phân bổ = 1 và một lượt nhấp được phân bổ) là mã quảng cáo cho lượt nhấp cuối cùng.
- last_click_exclid tương ứng với một mã lượt nhấp duy nhất được điền sẵn bằng macro %eiid!
Kể từ khi DMA có hiệu lực vào tháng 3 năm 2024, các trường sau đây cũng sẽ có sẵn:
- cps cho biết sự kiện thuộc Dịch vụ nền tảng cốt lõi nào
  - a : Quảng cáo
  - m : Maps
  - p : Cửa hàng Play
  - s : Tìm kiếm
  - h : Mua sắm
  - y : YouTube
- ad_events là một mảng gồm các đối tượng ad_event chứa tất cả các sự kiện chuyển đổi.
  - Đối tượng ad_event có các trường sau:
  - product_type là một chuỗi báo cáo sản phẩm chịu trách nhiệm về lượt chuyển đổi. Giá trị này sẽ là DCM hoặc DBM.
  - interaction_type là loại tương tác dẫn đến sự kiện. impression hoặc click.
  - conversion_metric là chỉ số lượt chuyển đổi được dùng cho mô hình phân bổ. conversion hoặc view_through_conversion.
  - timestamp là dấu thời gian UNIX mà sự kiện quảng cáo xảy ra với độ chính xác đến từng phần triệu giây. Bạn nên sử dụng giá trị này cho mô hình phân bổ theo lượt nhấp cuối cùng.
  - campaign_type xác định loại chiến dịch đã tạo ra sự kiện quảng cáo.
  - line_item_id (Chỉ DBM) là mã mục hàng DBM đã tạo ra sự kiện quảng cáo.
  - line_item_name (Chỉ DBM) là tên của mục hàng DBM đã tạo ra sự kiện quảng cáo.
  - placement_id (Chỉ DCM) là mã thẻ vị trí DCM đã tạo sự kiện quảng cáo.
  - placement_name (Chỉ DCM) là tên của thẻ vị trí DCM đã tạo ra sự kiện quảng cáo.
  - external_customer_id là giá trị nhận dạng nhà quảng cáo sở hữu chiến dịch đã tạo ra sự kiện quảng cáo.
    - Nếu product là DBM, thì trường này sẽ đại diện cho Mã nhận dạng nhà quảng cáo DBM.
    - Nếu product là DCM, thì trường này sẽ đại diện cho Mã nhận dạng nhà quảng cáo DCM.
  - creative_id là mã nhận dạng của đơn vị quảng cáo mẫu quảng cáo đã tạo ra sự kiện quảng cáo.
    - Nếu product là DBM, thì trường này sẽ đại diện cho Mã mẫu quảng cáo DBM.
    - Nếu product là DCM, thì trường này sẽ đại diện cho Mã mẫu quảng cáo DCM.
  - exchange_id (Chỉ dành cho DBM) là mã nhận dạng của sàn giao dịch đã phân phát quảng cáo DBM.
  - insertion_order_id (Chỉ DBM) là mã thứ tự chèn DBM.
  - site_id (Chỉ DCM) là mã nhận dạng trang web DCM cho sự kiện quảng cáo.
  - cps cho biết sự kiện quảng cáo thuộc Dịch vụ nền tảng cốt lõi nào. Hãy tham khảo phần giải thích đầy đủ về trường cps ở phần đầu tài liệu để biết thêm thông tin chi tiết.
- warnings là một mảng các cảnh báo do sự kiện chuyển đổi tạo ra.
- errors là một mảng các lỗi do sự kiện chuyển đổi tạo ra với mã lỗi HTTP, cho các trường hợp sau:
  - HTTP 204 nếu đã vượt quá hạn mức yêu cầu.
  - HTTP 400 khi yêu cầu được coi là không hợp lệ – ví dụ: thiếu các tham số bắt buộc và máy chủ đã quay lại tính năng theo dõi bằng pixel.
  - HTTP 401 nếu mã thông báo uỷ quyền không hợp lệ.
  - HTTP 404 đối với mọi yêu cầu không hợp lệ.
Nhà quảng cáo sẽ có thể xem báo cáo chiến dịch trong hệ thống của bạn; nhà quảng cáo cũng sẽ có thể xem báo cáo lượt chuyển đổi trong DCM với các thông số tương tự.

Các ví dụ khác về câu trả lời sau khi DMA có hiệu lực vào tháng 3 năm 2024

Ví dụ về một phản hồi theo dõi lượt chuyển đổi được phân bổ, trong đó lượt chuyển đổi được phân bổ cho cả lượt tương tác với quảng cáo trên Mạng Tìm kiếm và YouTube, nhưng sự đồng ý sử dụng chéo theo mục 5(2)(b) + 5(2)(c) bị từ chối giữa các CPS trên Mạng Tìm kiếm và 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
      },
  ]}
```
Ví dụ về phản hồi khẳng định của tính năng theo dõi lượt chuyển đổi cho một chiến dịch trên 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"
  }
]}
```

Tích hợp DDM để theo dõi ứng dụng của bên thứ ba Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Tích hợp DDM để theo dõi ứng dụng của bên thứ ba