앱스플라이어 SDK를 사용하여 전환 데이터 가져오기–리타겟팅

어트리뷰션 링크

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

전환 데이터 페이로드

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

• retargeting_conversion_type 파라미터 - 이 파라미터는 리타겟팅 유형을 나타냅니다. 리어트리뷰션, 리인게이지먼트 또는 없음일 수 있습니다.
• is_retargeting: true 파라미터 - 이 파라미터는 인스톨이 리어트리뷰션된 인스톨임을 나타냅니다
• af_reengagement_window: 리인게이지먼트 어트리뷰션 윈도우는 이벤트가 재참여한 유저에게 어트리뷰션될 수 있는 일수입니다. 이는 리어트리뷰션 전환이므로 이 파라미터는 중복됩니다.

SRN 캠페인에 정의된 딥링크 파라미터는 SRN 외부에서 사용할 수 없습니다. 여기에는 af_dp 파라미터가 포함되며, 앱의 스킴 경로가 있습니다. 따라서 디퍼드 딥링킹을 구현하려면 SRN 캠페인에 추가 로직을 적용해야 합니다. onConversionSuccess 응답에 캠페인, 광고 세트, 광고 그룹과 같은 데이터를 사용하여 프로그래밍 방식으로 유저를 리디렉션합니다.

Meta 광고와의 디퍼드 딥링킹에 대한 전환 데이터

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

getConversionData 응답에서 캠페인, 광고 세트 등과 같은 데이터를 사용하여 프로그래밍 방식으로 유저를 리디렉션하고 관련 콘텐츠를 제공합니다.

유저를 딥링크하는 방법에는 세 가지가 있습니다.

URI 스킴

URI 스킴을 사용할 때 어트리뷰션 링크와 원링크 모두에 대해 어트리뷰션 링크와 페이로드는 다음과 같습니다.

어트리뷰션 링크

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

원링크

// 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
  

페이로드

{
      "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 - 이 파라미터가 나타나고 true로 설정되면 scheme 및 host 필드를 찾습니다.
• scheme 및 host - 이 필드는 어트리뷰션 링크에서 af_dp 파라미터를 가져오며 유저가 딥링크되어야 하는 스킴과 액티비티를 나타냅니다

iOS 유니버설 링크 및 안드로이드 앱 링크

이것은 딥링킹을 수행하는 세 가지 방법 중 다른 두 가지입니다.

유니버설 링크 또는 앱 링크를 사용할 때 원링크 및 페이로드는 다음과 같습니다.

원링크

// 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
  

페이로드

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

• shortlink필드 - 유저가 유입된 특정 원링크를 나타내는 필드입니다. 개발자가 액티비티를 시작하고 콘텐츠를 제공하는 방법을 알 수 있도록 도와줍니다. campaign와 같은 다른 필드도 이 목적으로 사용할 수 있습니다.

    중요!

  긴 원링크를 사용할 때 페이로드에 shortlink 필드가 나타나지 않습니다.

  두 경우 모두(짧거나 긴 원링크) 액티비티를 나타내는 커스텀 파라미터를 추가하는 것이 좋습니다. 예를 들어 &deep_link_activity=shoes_cateogry

리인게이지된 유저가 SRN에서 온 경우 전환 데이터를 사용할 수 없습니다. 개발자는 SRN 메서드를 사용하여 앱 실행 시 가져와야 합니다.

유저가 리인게이지하고 앱이 실행되면 onAppOpenAttribution 메서드에서 다음 전환 데이터를 사용할 수 있습니다.

iOS와 안드로이드에서 단축 버전의 원링크를 사용할 때, 전환 데이터는 링크상에 있는 모든 파라미터의 구조화된 맵입니다.

예시:

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

• 앱 개발자는 af_dp 및 캠페인 이름과 같은 파라미터를 사용하여 유저를 특정 액티비티로 보내고 관련 콘텐츠를 제공할 수 있습니다.

단축 버전의 원링크를 사용하는 또 다른 이유는 긴 버전이 반환하는 전환 데이터 구조 때문입니다. 긴 버전을 사용할 때 전환 데이터는 긴 원링크 전체를 포함하는 link라는 단일 필드가 있는 맵입니다.

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