mParticle (추출)

Overview

버튼을 한 번만 누르면 Branch 데이터를 mParticle 대시보드로 보낼 수 있으므로 Branch가 유저 획득 경로로서 가지는 영향력을 이해하고 데이터를 전체 분석 도구 제품군으로 추출하고 Branch 데이터를 기반으로 커스텀 오디언스를 구축할 수 있습니다.

이 문서에서는 Branch 이벤트를 mParticle로 보내는 방법에 대해 설명합니다. mParticle은 이를 인바운드 피드 연동이라고 합니다.

If you'd like to send mParticle events to Branch through your app, please review the Branch/mParticle SDK Kit integration documentation for iOS and Android.

If you'd like to send mParticle events to Branch through a server-to-server integration, please review the mParticle (import) documentation.

작동 방식

Branch SDK가 앱에 연동되면 Branch는 어떤 링크가 설치, 재설치, 유저 액션으로 이어지는지 감지할 수 있습니다. 이 연동을 활성화하고 mParticle 키/비밀을 입력하면 Branch가 mParticle이 예상하는 정확한 형식으로 어트리뷰션된 이벤트를 mParticle에 자동으로 전달합니다.

Branch는 어떤 이벤트를 보내나요?

Branch will send attributed installs, opens, commerce events, user lifecycle events, content events, and custom events. Branch also sends all the data that is attached to the link that drove the attributed events. This will allow you to analyze which campaigns, channels, etc. are helping you acquire and engage users. You can see the list of fields that we send to mParticle here.

어떻게 생겼습니까?

Branch 이벤트는 mParticle에서 Custom Attribution Event 으로 나타납니다. 그런 다음 Branch 데이터를 다른 데이터 소스로 추출할 수 있습니다.

Branch 이벤트는 다음과 같이 매핑됩니다.

  • mParticle 이벤트 유형 = 커스텀 이벤트
  • mParticle 커스텀 이벤트 유형 = 어트리뷰션

mParticle 이벤트 이름은 이벤트 유형에 따라 다릅니다.

  • Install = 어트리뷰션
  • Open = 리인게이지먼트
  • 기타 모두 = Branch 이벤트 이름
13841384

For information on how to test your integration and see more detailed data, please review our testing instructions below.

Setup

전제 조건

mParticle 키 및 암호 검색

mParticle 키 및 암호를 찾아 Branch 대시보드에 입력합니다.

  1. Navigate to https://app.mparticle.com and log into the Dashboard.
  2. 대시보드에서 Directory로 이동하여 Branch를 검색하십시오.
  3. Branch 타일을 클릭하고, 다음을 클릭하세요 Add Branch Metrics to Setup
  4. Input Feed 연동 유형을 선택하고 Go to Setup를 클릭하십시오.
13841384
  1. 다음 설정 파라미터를 지정하십시오.
    • 설정 이름
    • 애플리케이션 역할 (여기에서 올바른 플랫폼 선택)
13841384
  1. 서버 키와 시크릿에 서버를 복사하세요 - 잠시 후 Branch 대시보드에 이를 입력하세요.
13841384

Enable the Integration

  1. On the Branch Dashboard (dashboard.branch.io), navigate to the Integrations page.

  2. mParticle을 검색하고 타일을 클릭합니다.

  3. mParticle 키와 암호를 입력하고 Enable 를 누르십시오.

    imageimage

🚧

연동을 반드시 테스트하세요!

Branch는 부정확한 API 키에 대해 책임지지 않습니다.

*추가 mParticle 리소스:**

mParticle 문서에서 Branch 및 mParticle 연동에 대한 추가 정보를 찾을 수 있습니다.

고급

Branch가 mParticle로 보내는 항목

속성 이름출처예시
event_name행사명하드 코딩된"어트리뷰션"
custom_event_type"어트리뷰션"하드 코딩된"어트리뷰션"
event_id이벤트의 유니크 IDBranch 이벤트 ID469939270182891107
custom_attributesBranch 링크 데이터 사전이벤트가 어트리뷰션된 링크에 대한 라스트 어트리뷰션 터치 데이터"campaign": "mParticle test", "channel": "Slack"
timestamp_unixtime_ms이벤트의 타임스탬프 (ms)event1513280479654
device_infoOS 버전 및 국가와 같은 디바이스 데이터디바이스를 위한 Branch User Data"os_version": "10.0","device_country": "US"
user_identitiesmParticle 고객 ID유저의 mParticle 고객 IDuser123abc
application_info패키지 이름과 같은 앱 정보Branch SDK/앱 세부 정보"application_name": "Branch-3rdParty-SDK-Testbed","application_version": "1.2.0"
IP이벤트의 IP디바이스192.82.115.928

mParticle Identity Strategy

Branch는 웹훅 페이로드의 일부로 여러 식별자를 mParticle에 보냅니다. 특히 주목할 만한 식별자는 다음과 같습니다:

식별자mParticle Field예시 참고
애플 광고 식별자 (IDFA)Apple's ID For Advertisingios_advertising_idEA7583CD-A667-48BC-B806-42ECB2B48606유저가 Limit Ad Tracking(광고 추적 제한)을 설정하지 않은 경우 iOS 이벤트와 함께 전송됩니다
IDFV공급업체에 대한 Apple의 IDios_idfv74683E89-E010-4A73-B3ED-2741D4E5FFFE대부분의 iOS 이벤트와 함께 보냄
AAID안드로이드의 안드로이드 광고 IDandroid_advertising_idcdda802e-fb9c-47ad-0794d394c913안드로이드 이벤트와 함께 전송
Android IDAndroid IDandroid_uuid404fc0aea39abcdfAAID가 없는 경우 가끔 안드로이드 이벤트에 전송됨
Customer IDmParticle Customer IDcustomeriduser123abcBranch에서 매핑된 고객 식별자 developer_identity
mPIDmParticle IDmpiduser123abcmParticle ID identifier mapped from Branch developer_identity

mParticle ID 전략이 Branch에서 보낸 식별자와 일치하는지 확인하십시오. 그렇지 않은 경우 mParticle은 이러한 이벤트를 올바른 기존 프로필에 연결하지 않고 Branch에서 보낸 이벤트에 대한 새 프로필을 생성할 수 있습니다.

The Customer ID or mPID is of particular importance. If you set developer_identity with Branch (docs here), Branch will automatically map this to mParticle's Customer ID or mPID. Make sure the value you set here with Branch corresponds to the value you're using for that user in mParticle.

If you're using a different value in developer_identity please reach out to your Branch account team.

연동 테스트

mParticle에 전달되는 데이터를 보다 자세히 보려면 Requestbin에 웹후크를 설정할 수 있습니다. 이를 통해 Branch 이벤트의 하위 집합만 Requestbin에 보내고 데이터가 예상대로 전달되는지 확인할 수 있습니다.

  1. 위의 Branch 데이터 연동을 활성화하십시오. mParticle에서 일부 데이터를 생성하려면 Branch 링크에서 앱을 설치하십시오. 커스텀 어트리뷰션이 mParticle에 표시되려면 최대 1시간이 걸릴 수 있습니다.

  2. branch_test 캠페인을 사용하여 대시보드의 Quick Links 섹션에서 Branch 링크를 작성하십시오.

    imageimage

  3. In mParticle, navigate to the Directory in mParticle and add Webhooks as an option. Add a Requestbin URL generated from https://requestb.in.

    imageimage

  4. 웹훅으로 전송되는 데이터를 구체화하려면 Connections > Connect 로 이동합니다.

  5. 입력으로 Branch 피드를 선택하고 출력으로 Webhooks 을 선택하십시오.

  6. Finally, view the Requestbin. You can do this by appending ?inspect to your requestbin URL. You should be able to copy paste the POST body from the request bin into a JSON formatter like https://jsonlint.com/ to view the event details.

  7. 테스트가 완료되면 웹훅을 삭제하십시오.

FAQ

Branch에 mParticle 고객 ID가 필요하지 않은 이유는 무엇입니까?

mParticle 고객 ID는 일반적으로 앱 설치 시 설정되지 않기 때문에 Branch는 mParticle 고객 ID를 요구하지 않습니다. 유저의 일반적인 워크플로는 앱 설치 후 약 30초 후에 로그인을 확인하는 것입니다. Branch 설치 이벤트는 설치 즉시 실행되므로 로그인 이벤트 전에 발생하여, mParticle로 전송되기 전에는 로그인한 고객 ID를 가지고 있지 않습니다. 그러나 설치 및 로그인 이벤트에 첨부된 디바이스 ID를 사용하여 고객의 설치 이벤트에 참여할 수 있습니다.

필터