進階配對

本文件會講解如何將您的應用程式事件用戶資料傳送至 Facebook，以便執行進階配對。這些資訊會先經過雜湊處理，完成後才與我們分享。我們會使用這些經雜湊的資訊，以更準確地確認哪些用戶因您的廣告而採取了行動。憑藉這些數據，Facebook 可以將轉換事件與您的顧客配對，以優化您的廣告並建立更大型的再營銷受眾。

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

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

• Facebook SDK：將程式碼加至您的 Android 或 iOS 流動應用程式，以便手動將資料傳送至 Facebook。
• Facebook 應用程式事件 API：將查詢加至程式碼，以便手動將資料傳送至 Facebook。
• 事件管理工具：在事件管理工具管理中心配置您的應用程式為開啟「自動進階配對」功能，以便將資料傳送至 Facebook。
• 流動衡量合作夥伴 (MMP) SDK：將程式碼加至 Android 或 iOS 應用程式，以便將資料傳送至 Adjust 管理中心。

使用 Facebook SDK

使用 Facebook 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 流動衡量合作夥伴 (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 的合作夥伴參數名稱。每個合作夥伴的相應名稱應為一致。例如，如果您使用 email 作為 Adjust SDK 的參數名稱，則請輸入「email」。
6. 在右側目標合作夥伴欄中，輸入此合作夥伴所要求的合作夥伴參數名稱。每個合作夥伴的相應名稱都不相同。Facebook SDK 所用參數的格式應為 ud[pii_type_name]。例如，「email」應該使用 ud[em]，手機應該使用 ud[ph]。

如需了解詳情，請瀏覽 Adjust 文件。