고급 매칭

이 문서에서는 고급 매칭을 위해 앱 이벤트 사용자 데이터를 Facebook으로 전송하는 방법을 설명합니다. 이 정보는 Facebook에 공유되기 전에 해시됩니다. Facebook은 이 해시된 정보를 사용해 광고에 반응하여 행동을 취한 사람들을 더욱 정확하게 확인할 수 있습니다. Facebook은 이 데이터로 전환 이벤트와 고객을 매칭하여 광고를 최적화하고 더욱 큰 규모의 리마케팅 타겟을 빌드할 수 있습니다.

매칭되면 Facebook에서는 해시된 데이터를 신속히 삭제합니다.

다음 방법 중 하나를 사용하여 고급 매칭을 설정할 수 있습니다.

• Facebook SDK – Android 또는 iOS 모바일 앱에 코드를 추가하여 데이터를 Facebook에 수동으로 전송합니다.
• Facebook 앱 이벤트 API - 코드에 쿼리를 추가하여 데이터를 Facebook에 수동으로 전송합니다.
• 이벤트 관리자 – 이벤트 관리자 대시보드에서 앱을 구성하고 Facebook에 데이터를 전송하려면 자동 고급 매칭을 활성화합니다.
• Mobile Measurement Partner(MMP) SDK – Adjust 대시보드에 데이터를 전송하려면 Android 또는 iOS 앱에 코드를 추가합니다.

Facebook SDK 사용

FB SDK를 사용하여 사용자 앱 이벤트 데이터를 Facebook에 전송하는 경우 모든 사용자 데이터가 해시됩니다. 이 해시된 데이터는 앱 인스턴스 사이에서 그대로 유지됩니다.

요구 사항

• Facebook SDK 4.36 이상

Android

setUserData 함수로 AppEventsLogger를 초기화하는 동시에 사용자 데이터를 설정합니다. 이 함수는 사용자 데이터를 해시합니다.

AppEventsLogger logger = AppEventsLogger.newLogger(MainActivity.this);
AppEventsLogger.setUserData(
  “jsmith@example.com”,     //email
  “john”,                   //first name
  “smith”,                  //last name
  “16505554444”,            //phone number
  “19910526”,               //birthdate
  “f”,                      //gender
  “menlopark”,              //city
  “ca”,                     //state
  “94025”,                  //zip code
  “us”                      //country
);

iOS

setUserData 함수로 FBSDKAppEvents를 초기화하는 동시에 사용자 데이터를 설정합니다. 사용자 데이터는 해시되고 앱 인스턴스 사이에서 그대로 유지됩니다.

권장 사항

• 고급 매칭이 올바르게 작동하도록 하려면 Facebook iOS SDK를 최신 버전으로 업그레이드하는 것이 좋습니다. 자세한 내용은 iOS SDK 변경 사항을 참조하세요.

한 가지 데이터 유형을 설정하기 위한 샘플 코드

[FBSDKAppEvents setUserData: @"jsmith@example.com" forType:FBSDKAppEventEmail];

여러 데이터 유형을 설정하기 위한 샘플 코드

NSDictionary *const userData = @{
        @"em": @"jsmith@example.com",
        @"fn": @"john",
        @"ln": @"smith",
        @"ph": @"16505554444",
        @"db": @"19910526",
        @"ge": @"f",
        @"ct": @"menlopark",
        @"zp": @"94025",
        @"cn": @"us"};
[FBSDKAppEvents setUserEmail:(NSString *)userData["@em"]
     firstName:(NSString*)userData["@fn"]
     lastName:(NSString *)userData[@"ph"]
     phone:(NSString *)userData[@"ph"]
     dateOfBirth:(NSString *)userData[@"db"]
     gender:(NSString *)userData[@"ge"]
     city:(NSString *)userData[@"ct"]
     state:(NSString *)userData[@"st"]
     zip:(NSString *)userData[@"zp"]
     country:(NSString *)userData[@"cn"]];

이벤트 관리자 사용

자동 고급 매칭은 Facebook SDK가 이벤트 또는 작업과 함께 앱에서 발생한 사용자 데이터를 탐지하고 수신하도록 자동 구성합니다. 이 데이터는 Facebook으로 전송되기 전에 해시됩니다.

자동 고급 매칭을 활성화하려면 이벤트 관리자에서 앱의 설정 탭을 선택하고 자동 고급 매칭을 ON으로 전환합니다. 해시된 이메일 주소와 전화번호를 공유할 수도 있습니다.

단, Facebook SDK 5.8.0 이상을 구현한 상태여야 합니다.

Adjust SDK 사용

고객 데이터를 Adjust 이벤트에 추가

Adjust Mobile Measurement Partner(MMP) SDK를 사용할 때는 아래의 예시와 같이 해시 함수를 사용하세요. MMP SDK는 이를 자동으로 해시하지 않습니다. 해시 함수를 사용하지 않으면 API에서 예외를 발생시키고 일반 텍스트를 허용하지 않습니다.

ADJEvent 인스턴스에서 addPartnerParameter 메서드를 호출하여 Adjust 대시보드에서 활성화된, 네트워크 파트너에게 전송할 고객 데이터 매개변수를 추가합니다.

참고로 Facebook SDK를 구현할 필요는 없습니다.

Android 예시 코드

AdjustEvent event = new AdjustEvent('abc123');
event.addPartnerParameter('em', 'sha256_hashed_email');
event.addPartnerParameter('ph', 'sha256_hashed_phone');
Adjust.trackEvent(event);

iOS 예시 코드

ADJEvent *event = [ADJEvent eventWithEventToken:@'abc123'];

[event addPartnerParameter:@'em' value:@'sha256_hashed_email'];
[event addPartnerParameter:@'ph' value:@'sha256_hashed_phone'];

[Adjust trackEvent:event];

자세한 내용은 Github 코드 예시를 참조하세요.

Adjust 매개변수를 Facebook 매개변수에 매핑

Adjust 대시보드에서 다음 단계에 따라 Adjust 매개변수를 Facebook 매개변수에 매핑하세요.

1. Adjust 대시보드에서 파트너 매개변수를 매핑하려는 앱의 설정을 클릭합니다.
2. 파트너 설정을 선택합니다.
3. 관심 있는 파트너를 클릭합니다.
4. 파트너 매개변수 매핑을 선택합니다.
5. 왼쪽 보내는 앱 열에 SDK에서 Adjust로 보낼 파트너 매개변수 이름을 입력합니다. 이 이름은 모든 파트너에 대해 동일해야 합니다. 예를 들어 Adjust SDK에서 email을 매개변수 이름으로 사용하는 경우 'email'을 입력합니다.
6. 오른쪽 받는 파트너 열에 이 파트너가 원하는 파트너 매개변수 이름을 입력합니다. 이 이름은 파트너별로 다릅니다. Facebook SDK에서 사용한 매개변수는 ud[pii_type_name] 형식이어야 합니다. 예를 들어 'email'은 ud[em]을 사용하고 전화번호는 ud[ph]를 사용해야 합니다.

자세한 내용은 Adjust 문서를 참조하세요.