Add partner_client_id to AttributionData

Summary:
Add partner_client_id as a String field to the Java Business SDK's AttributionData class.
This field is a partner workspace/dashboard identifier used for deduplication across shared pixels,
added as part of the Custom Attribution schema extension (D96265092).

Changes:
- Added SerializedName field, constructor param, fluent builder, getter/setter
- Updated equals(), hashCode(), and toString()
- Updated tests for builder, equality, and inequality
- Bumped version to v24.0.3

Reviewed By: daegwang

Differential Revision: D101088146

fbshipit-source-id: c67cd8752eee873f8f57aa868c87ef98bc0484e6

Author: Kaden Kang

CHANGELOG.md

@@ -5,6 +5,10 @@ All notable changes to this project will be documented in this file.
 
 ## Unreleased
 
+## v24.0.4
+### Added
+- Add partner_client_id field to AttributionData
+
 ## v24.0.3
 ### Added
 - Add total_credit field to AttributionData

src/main/java/com/facebook/ads/sdk/serverside/AttributionData.java

@@ -78,6 +78,9 @@ public class AttributionData {
     @SerializedName("total_credit")
     private Float totalCredit = null;
 
+    @SerializedName("partner_client_id")
+    private String partnerClientId = null;
+
     /**
      * Default constructor
      */
@@ -106,12 +109,13 @@ public AttributionData() {
      * @param touchpointId Unique identifier for touchpoint events shared by Meta with advertisers.
      * @param attributionSetting The attribution setting with inactivity and reattribution window configuration.
      * @param totalCredit Total credit attributed to all publishers for this conversion.
+     * @param partnerClientId Partner workspace/dashboard identifier for dedup across shared pixels.
      */
     public AttributionData(String scope, Long visitTime, String adId, String adsetId, String campaignId,
         Float attributionShare, AttributionModelEnum attributionModel, Integer attributionWindow, Float attributionValue,
         String attributionSource, String touchpointType, Integer touchpointTs, AttributionMethodEnum attributionMethod,
         DeclineReasonEnum declineReason, String auditingToken, String linkageKey, String touchpointId, AttributionSetting attributionSetting,
-        Float totalCredit) {
+        Float totalCredit, String partnerClientId) {
       this.scope = scope;
       this.visitTime = visitTime;
       this.adId = adId;
@@ -131,6 +135,7 @@ public AttributionData(String scope, Long visitTime, String adId, String adsetId
       this.touchpointId = touchpointId;
       this.attributionSetting = attributionSetting;
       this.totalCredit = totalCredit;
+      this.partnerClientId = partnerClientId;
     }
 
     /**
@@ -684,6 +689,35 @@ public void setTotalCredit(Float totalCredit) {
       this.totalCredit = totalCredit;
     }
 
+    /**
+     * Set partnerClientId
+     *
+     * @param partnerClientId Partner workspace/dashboard identifier for dedup across shared pixels.
+     * @return AttributionData
+     */
+    public AttributionData partnerClientId(String partnerClientId) {
+      this.partnerClientId = partnerClientId;
+      return this;
+    }
+
+    /**
+     * Get partnerClientId
+     *
+     * @return partnerClientId
+     */
+    public String getPartnerClientId() {
+      return partnerClientId;
+    }
+
+    /**
+     * Set partnerClientId
+     *
+     * @param partnerClientId Partner workspace/dashboard identifier for dedup across shared pixels.
+     */
+    public void setPartnerClientId(String partnerClientId) {
+      this.partnerClientId = partnerClientId;
+    }
+
     @Override
     public boolean equals(Object o) {
       if (this == o) return true;
@@ -709,12 +743,13 @@ public boolean equals(Object o) {
         && Objects.equals(this.linkageKey, attributionData.linkageKey)
         && Objects.equals(this.touchpointId, attributionData.touchpointId)
         && Objects.equals(this.attributionSetting, attributionData.attributionSetting)
-        && Objects.equals(this.totalCredit, attributionData.totalCredit);
+        && Objects.equals(this.totalCredit, attributionData.totalCredit)
+        && Objects.equals(this.partnerClientId, attributionData.partnerClientId);
     }
 
     @Override
     public int hashCode() {
-      return Objects.hash(scope, visitTime, adId, adsetId, campaignId, attributionShare, attributionModel, attributionWindow, attributionValue, attributionSource, touchpointType, touchpointTs, attributionMethod, declineReason, auditingToken, linkageKey, touchpointId, attributionSetting, totalCredit);
+      return Objects.hash(scope, visitTime, adId, adsetId, campaignId, attributionShare, attributionModel, attributionWindow, attributionValue, attributionSource, touchpointType, touchpointTs, attributionMethod, declineReason, auditingToken, linkageKey, touchpointId, attributionSetting, totalCredit, partnerClientId);
     }
 
     @Override
@@ -740,6 +775,7 @@ public String toString() {
       sb.append("    touchpointId: ").append(toIndentedString(touchpointId)).append("\n");
       sb.append("    attributionSetting: ").append(toIndentedString(attributionSetting)).append("\n");
       sb.append("    totalCredit: ").append(toIndentedString(totalCredit)).append("\n");
+      sb.append("    partnerClientId: ").append(toIndentedString(partnerClientId)).append("\n");
       sb.append("}");
       return sb.toString();
     }

src/test/java/com/facebook/ads/sdk/serverside/AttributionDataTest.java

@@ -45,6 +45,7 @@ public void TestAttributionDataBuilderAndGetters() {
         String touchpointId = "tp_test_touchpoint_id_123";
         AttributionSetting attributionSetting = new AttributionSetting(24, 48);
         float totalCredit = 0.85f;
+        String partnerClientId = "partner_workspace_123";
 
         attributionData
                      .scope(scope)
@@ -65,7 +66,8 @@ public void TestAttributionDataBuilderAndGetters() {
                      .linkageKey(linkageKey)
                      .touchpointId(touchpointId)
                      .attributionSetting(attributionSetting)
-                     .totalCredit(totalCredit);
+                     .totalCredit(totalCredit)
+                     .partnerClientId(partnerClientId);
 
         assertEquals(attributionData.getScope(), scope);
         assertEquals(attributionData.getAdId(), adId);
@@ -88,6 +90,7 @@ public void TestAttributionDataBuilderAndGetters() {
         assertEquals((int)attributionData.getAttributionSetting().getInactivityWindowHours(), 24);
         assertEquals((int)attributionData.getAttributionSetting().getReattributionWindowHours(), 48);
         assertEquals((float)attributionData.getTotalCredit(), totalCredit, 0);
+        assertEquals(attributionData.getPartnerClientId(), partnerClientId);
     }
 
     @Test
@@ -113,6 +116,7 @@ public void TestWhenInstancesAreEqual() {
         String touchpointId = "tp_test_touchpoint_id_123";
         AttributionSetting attributionSetting = new AttributionSetting(24, 48);
         float totalCredit = 0.85f;
+        String partnerClientId = "partner_workspace_123";
 
         attributionData1
                      .scope(scope)
@@ -133,7 +137,8 @@ public void TestWhenInstancesAreEqual() {
                      .linkageKey(linkageKey)
                      .touchpointId(touchpointId)
                      .attributionSetting(attributionSetting)
-                     .totalCredit(totalCredit);
+                     .totalCredit(totalCredit)
+                     .partnerClientId(partnerClientId);
 
         attributionData2
                      .scope(scope)
@@ -154,7 +159,8 @@ public void TestWhenInstancesAreEqual() {
                      .linkageKey(linkageKey)
                      .touchpointId(touchpointId)
                      .attributionSetting(attributionSetting)
-                     .totalCredit(totalCredit);
+                     .totalCredit(totalCredit)
+                     .partnerClientId(partnerClientId);
 
         assertEquals(attributionData1, attributionData2);
         assertEquals(attributionData1.hashCode(), attributionData2.hashCode());
@@ -202,7 +208,8 @@ public void TestWhenInstancesAreNotEqual() {
                      .linkageKey(linkageKey)
                      .touchpointId("tp_test_touchpoint_id_123")
                      .attributionSetting(attributionSetting1)
-                     .totalCredit(0.85f);
+                     .totalCredit(0.85f)
+                     .partnerClientId("partner_workspace_123");
 
         attributionData2
                      .scope(scope)
@@ -223,7 +230,8 @@ public void TestWhenInstancesAreNotEqual() {
                      .linkageKey(linkageKey)
                      .touchpointId("tp_test_touchpoint_id_456")
                      .attributionSetting(attributionSetting2)
-                     .totalCredit(0.35f);
+                     .totalCredit(0.35f)
+                     .partnerClientId("partner_workspace_456");
 
         assertNotEquals(attributionData1, attributionData2);
         assertNotEquals(attributionData1.hashCode(), attributionData2.hashCode());