進階配對

本文件說明如何將應用程式事件用戶資料傳送至 Facebook，以便進行進階配對。系統會先進行雜湊處理，再與我們分享此資訊。我們會使用已雜湊處理過的資訊，更準確地辨識採取行動回應您廣告的用戶。透過這項資料，Facebook 可將轉換事件與顧客配對，以最佳化您的廣告並建立更多的再行銷廣告受眾。

配對完成後，Facebook 會立即捨棄雜湊資料。

您可以使用下列其中一種方法設定進階配對：

• Facebook SDK：在 Android 或 iOS 行動應用程式中新增程式碼，手動將資料傳送至 Facebook。
• Facebook 應用程式事件 API：在程式碼中新增查詢，手動將資料傳送至 Facebook。
• 事件管理工具：在事件管理工具主控板中設定應用程式，開啟自動進階配對來將資料傳送至 Facebook。
• Mobile Measurement Partner（MMP）SDK：在 Android 或 iOS 應用程式中新增程式碼，將資料傳送至 Adjust 主控板。

使用 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

請在使用 FBSDKAppEvents 函式初始化 setUserData 時設定用戶資料，系統隨即會對用戶資料進行雜湊處理，並將其保存在各個應用程式執行個體中。

建議處理方式

• 若要確保進階配對能正常運作，建議您升級至最新版的 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。

若要開啟自動進階配對，請前往事件管理工具，然後選擇應用程式的設定頁籤，並將自動進階配對開關切換至開啟。您還可以分享經過雜湊的電子郵件地址和電話號碼。

請注意，您必須已經實作 Facebook SDK 5.8.0 或以上版本。

使用 Adjust SDK

在 Adjust 事件中新增顧客資料

使用 Adjust Mobile Measurement Partner（MMP）SDK 時，請使用下方範例所示的雜湊函式，因為 MMP SDK 不會自動進行雜湊處理。如果您沒有使用雜湊函式，則我們的 API 會擲回例外狀況，且無法接受純文字內容。

請先前往 Adjust 主控板啟動網路合作夥伴，然後在 ADJEvent 執行個體上呼叫 addPartnerParameter 方法，新增要傳送給網路合作夥伴的顧客資料參數。

請注意，您不需要實作 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 主控版中找到要對應合作夥伴參數的應用程式，然後點擊 Settings（設定）。
2. 選擇 Partner Setup（合作夥伴設定）。
3. 點擊感興趣的合作夥伴。
4. 選擇 Partner Parameter Mapping（合作夥伴參數對應）。
5. 在左側的 FROM APP（來自應用程式）欄中，輸入 SDK 傳送至 Adjust 的合作夥伴參數名稱。您在此處為每個合作夥伴輸入的內容都應相同。例如，如果您在 Adjust SDK 中使用 email 作為參數名稱，請輸入「email」。
6. 在右側的 TO PARTNER（對應至合作夥伴）欄中，輸入此合作夥伴需要的合作夥伴參數名稱。這是合作夥伴專屬的參數。您在 Facebook SDK 中使用的參數格式應為 ud[pii_type_name]。例如，「email」應使用 ud[em]，「phone」應使用 ud[ph]。

如需詳細資訊，請參閱 Adjust 文件。