Tải trọng dữ liệu chuyển đổi và các tình huống

Không được đặt thông số tùy chỉnh là name (chữ thường "n". Name thì hợp lệ).

Nếu một thông số được đặt là name, thì thông số đó sẽ bị xóa khỏi tải trọng.

Đường dẫn phân bổ:

https://app.appsflyer.com/com.company.app?af_ad=ad_name&af_ad_type=INTER
  &af_channel=video&af_siteid=123_site_id&af_c_id=b8******************************&
  af_adset=_DEFAULT&pid=applovin_int&c=campaign_name
  &af_click_lookback=7d&clickid=10****************
  &advertising_id=50********************************&af_ip=

Tải trọng:

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "applovin_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:49:54.186",
      "adgroup_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-24 14:29:33.738",
      "agency": null,
      "cost_cents_USD": "0",
      "af_ad_type": "INTER",
      "af_c_id": "b8******************************",
      "adset": null,
      "advertising_id": "50********************************",
      "af_sub1": null,
      "clickid": "10****************",
      "af_click_lookback": "7d",
      "af_siteid": "123_site_id",
      "af_ad": "ad_name",
      "http_referrer": null,
      "af_channel": "video",
      "af_adset": "_DEFAULT",
      "af_sub5": null,
      "af_sub4": null,
      "af_cpi": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  

• Các thông số trong đường dẫn phân bổ xuất hiện dưới dạng các trường trong tải trọng
• Các trường khác trong tải trọng không có trong đường dẫn phân bổ xuất hiện với giá trị null
• AppLovin hỗ trợ chia sẻ chi phí quảng cáo nhưng gửi hàng loạt dữ liệu chi phí tới AppsFlyer. Các trường liên quan đến chi phí sẽ trả về 0.

Đường dẫn phân bổ:

https://app.appsflyer.com/id123456789?
  af_ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &clickid=ab*******************&redirect=false
  &ua=Mozilla/5.0+(iPhone;+CPU+iPhone+OS+12_1_2+like+Mac+OS+X)+AppleWebKit/605.1.15+(KHTML,+like+Gecko)+Mobile/16C101
  &af_lang=pt&imei=&af_sub1=&advertising_id=&af_ip=192.168.0.1&pid=ironsource_int
  &device_ip=192.168.0.1&c=campaign_name
  &idfa=01**********************************&af_siteid=123_site_id&
  af_enc_data=cN*********************************************************************

Tải trọng:

{
      "adgroup": null,
      "af_enc_data": "cN**************************************************************************************",
      "campaign": "campaign_name",
      "media_source": "ironsource_int",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "install_time": "2018-12-30 23:59:32.194",
      "adgroup_id": null,
      "redirect": "false",
      "orig_cost": "0.75",
      "click_time": "2018-12-30 23:58:54.517",
     "agency": null,
      "cost_cents_USD": "75",
      "adset": null,
      "advertising_id": "35**********************************",
      "af_sub1": null,
      "af_ip": "192.168.0.1",
      "clickid": "ab*******************",
      "af_sub3": null,
      "af_cost_value": "0.75",
      "af_ref": "ironsource_5f******************************************",
      "af_siteid": "123_site_id",
      "http_referrer": null,
      "af_cost_model": "cpi",
      "af_ua": "Mozilla/5.0 (Linux; Android 8.0.0; SM-N950F Build/R16NW; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/71.0.3578.99 Mobile Safari/537.36",
      "af_cost_currency": "USD",
      "af_sub5": null,
      "af_sub4": null,
      "af_lang": "en",
      "af_cpi": null,
      "af_click_lookback": "7d",
      "af_sub2": null,
      "af_status": "Non-organic"
  }
  

ironSource chia sẻ dữ liệu liên quan đến chi phí với AppsFlyer khi chuyển đổi bằng cách sử dụng các trường orig_cost, costs_cents_USD và af_cost_value.

Tuy nhiên, dữ liệu liên quan đến chi phí không xuất hiện trong đường dẫn phân bổ. ironSource mã hóa dữ liệu chi phí và lưu trữ dữ liệu đó trong trường af_enc_data.

Đường dẫn phân bổ

https://app.appsflyer.com/id1234567895?pid=criteo_int&af_click_lookback=30d&
  c=campaign_name&is_retargeting=true&redirect=false&idfa=68**********************************
  &af_reengagement_window=30d

Tải trọng dữ liệu chuyển đổi

{
      "adgroup": null,
      "campaign": "campaign_name",
      "media_source": "criteo_int",
      "retargeting_conversion_type": "re-attribution",
      "adset_id": null,
      "campaign_id": null,
      "af_reengagement_window": "30d",
      "install_time": "2018-12-01 23:13:03.126",
      "adgroup_id": null,
      "redirect": "false",
      "af_sub5": null,
      "click_time": "2018-11-18 20:02:31.559",
      "agency": null,
      "cost_cents_USD": "0",
      "is_retargeting": "true",
      "af_cpi": null,
      "af_click_lookback": "30d",
      "af_siteid": null,
      "idfa": "68**********************************",
      "http_referrer": null,
      "orig_cost": "0.0",
      "af_sub4": null,
      "adset": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic"
  }

• Thông số retargeting_conversion_type - thông số này cho biết loại hình nhắm mục tiêu lại. Có thể là phân bổ lại, thu hút lại hoặc không.
• Thông số is_retargeting: true - thông số này cho biết rằng lượt cài đặt là lượt cài đặt được phân bổ lại
• af_reengagement_window: Khung thời gian phân bổ thu hút lại là số ngày mà một sự kiện có thể được phân bổ cho người dùng được thu hút lại. Vì đây là chuyển đổi phân bổ lại nên thông số này là không cần thiết.

Thông số Liên kết sâu được xác định trong các chiến dịch SRN không có sẵn bên ngoài SRN. Điều này bao gồm thông số af_dp, chứa đường dẫn lược đồ trong ứng dụng. Ngoại lệ duy nhất cho điều này là khi sử dụng Chiến dịch ứng dụng của Google trong Nguồn cấp dữ liệu. Để triển khai liên kết sâu bị trì hoãn, logic bổ sung phải được áp dụng cho các chiến dịch SRN. Sử dụng dữ liệu trong phản hồi onConversionSuccess, chẳng hạn như chiến dịch, bộ quảng cáo, nhóm quảng cáo để chuyển hướng người dùng của bạn theo chương trình.

Dữ liệu chuyển đổi cho liên kết sâu bị trì hoãn với Meta ads

{
     "adset":"Adidas Running Shoes Women",
       "adgroup": null,
     "campaign_id":"6**********",
     "af_status":"Non-organic",
     "retargeting_conversion_type": "none",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
     "is_first_launch":true,
     "click_time":"2017-07-18 12:55:05",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "campaign":"running shoes summer collection",
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "media_source":"Meta ads",
     "install_time":"2017-07-19 08:06:56.189",
     "af_sub2":null
  }

  {
     "media_source":"Meta ads",
     "campaign":"running shoes summer collection",
     "adset":"Running Shoes Women",
     "adgroup":null,
     "campaign_id":"6**********",
     "retargeting_conversion_type": "none",
     "af_status":"Non-organic",
     "agency":null,
     "af_sub3":null,
     "af_siteid":null,
     "adset_id":"6**********",
     "is_fb":true,
   "is_first_launch":true,
     "click_time":"2017-07-17 16:23:18",
     "iscache":false,
     "ad_id":"6**********",
     "af_sub1":null,
     "is_paid":true,
     "af_sub4":null,
     "adgroup_id":"6**********",
     "is_mobile_data_terms_signed":true,
     "af_channel":"Facebook",
     "af_sub5":null,
     "install_time":"2017-07-18 15:10:50.190",
     "af_sub2":null
  }
  

Bạn có thể sử dụng dữ liệu trong phản hồi getConversionData, chẳng hạn như chiến dịch, bộ quảng cáo, v.v. để chuyển hướng người dùng của bạn theo cách lập trình và cung cấp cho họ nội dung có liên quan.

Có ba cách để liên kết sâu người dùng:

Lược đồ URI

Khi sử dụng Lược đồ URI, đối với cả đường dẫn phân bổ và OneLink, đường dẫn phân bổ và tải trọng sẽ như sau:

Đường dẫn phân bổ

http://app.appsflyer.com/com.appsflyer.nivisampleapp?pid=media_source_name
  &c=campaign_name&af_dp=superapp%3A%2F%2deeplink-activity

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true&af_dp=superapp%3A%2F%2deeplink-activity
  

Tải trọng

{
      "af_deeplink": true,
      "campaign": "campaign_name",
      "media_source": "media_source_name",
      "retargeting_conversion_type": "none",
      "adset_id": null,
      "campaign_id": null,
      "orig_cost": "0.0",
      "click_time": "2018-12-30 23:59:09",
      "install_time": "2018-12-30 23:59:39.330",
      "agency": null,
      "cost_cents_USD": "0",
      "adset": "AD_SET_NAME",
      "ad_id": "AD_ID",
      "af_siteid": null,
      "http_referrer": null,
      "af_cpi": null,
      "af_sub5": null,
      "af_sub4": null,
      "af_sub1": null,
      "af_sub3": null,
      "af_sub2": null,
      "af_status": "Non-organic",
      "scheme": "superapp",
      "host": "deeplink_activity"
  }

• af_deeplink: true - khi thông số này xuất hiện và được đặt thành true, hãy tìm các trường scheme và host
• scheme và host - các trường này đến từ thông số af_dp trong đường dẫn phân bổ và cho biết lược đồ và hoạt động mà người dùng sẽ được liên kết sâu

Liên kết chung iOS và liên kết ứng dụng Android

Đây là hai trong số ba cách khác để thực hiện liên kết sâu.

Khi sử dụng liên kết chung hoặc liên kết ứng dụng, OneLink và tải trọng sẽ như sau:

OneLink

// short OneLink
  https://dhba.onelink.me/2rAD/71ba577e
  
  //long OneLink
  https://dhba.onelink.me/2rAD?pid=media_source_name&c=campaign_name
  &is_retargeting=true
  

Tải trọng

{
      "install_time": "2019-01-08 16:24:49.853",
      "cost_cents_USD": "0",
      "campaign": "campaign_name",
      "retargeting_conversion_type": "none",
      "is_first_launch": true,
      "click_time": "2019-01-08 16:24:14.322",
      "af_click_lookback": "7d",
      "orig_cost": "0.0",
      "af_status": "Non-organic",
      "iscache": "true",
      "shortlink": "71ba577e",
      "media_source": "media_source_name",
      "is_retargeting": true
  }

• Trường shortlink - đây là trường cho biết OneLink cụ thể mang đến người dùng. Trường này giúp nhà phát triển biết cách tiến hành khởi chạy một hoạt động và cung cấp nội dung. Các trường khác như campaign cũng có thể được sử dụng cho mục đích này.

   Quan trọng!

  Trường shortlink không xuất hiện trong tải trọng khi sử dụng OneLink đầy đủ.

  Trong cả hai trường hợp (OneLink rút gọn hoặc đầy đủ), bạn nên thêm thông số tùy chỉnh cho biết hoạt động. Ví dụ &deep_link_activity=shoes_cateogry

Dữ liệu chuyển đổi không có sẵn khi người dùng được thu hút lại đến từ SRN. Nhà phát triển cần sử dụng các phương thức SRN để có được nó khi khởi chạy ứng dụng.

Khi người dùng được thu hút lại và ứng dụng khởi chạy, dữ liệu chuyển đổi sau sẽ có sẵn trong phương thức onAppOpenAttribution:

Đối với cả iOS và Android, khi dùng phiên bản rút gọn của OneLink, dữ liệu chuyển đổi sẽ là một bản đồ có cấu trúc chứa tất cả các thông số trong liên kết:

Ví dụ:

{
     af_dp: "superapp://Deeplink",
     pid: "media_source_name"
     c: "campaign_name",
     link: "https://abcd.onelink.me/12ab/12ab34c"
     is_retargeting: true
  }

• Nhà phát triển ứng dụng có thể sử dụng các thông số như vậy, như af_dp và tên chiến dịch, để đưa người dùng đến một hoạt động cụ thể và cung cấp nội dung có liên quan.

Một lý do khác để sử dụng phiên bản rút gọn của OneLink là cấu trúc dữ liệu chuyển đổi mà phiên bản đầy đủ trả về. Khi sử dụng phiên bản đầy đủ, dữ liệu chuyển đổi là một bản đồ với một trường duy nhất được gọi là link chứa toàn bộ OneLink đầy đủ.

{
     "link": "https://abcd.onelink.me/12ab?pid=media_source&c=campaign_name&is_retargeting=true&af_dp=superapp%3A%2F%2FDeepLink"
  }