Add additional AMM fields to AttributionData

Summary:
This diff adds four new AMM (Advanced Measurement and Matching) fields to the PHP Business SDK AttributionData class:

1. **attribution_method** (AttributionMethod): The attribution method used to attribute the event (constants: ARD, DEEPLINK, GPIR, INVALID_RESPONSE, MIR, SRN with lowercase string values)
2. **decline_reason** (DeclineReason): The decline reason for the attribution (constants: ATTRIBUTE_TO_OTHER_SOURCE, OUT_OF_LOOKBACK_WINDOW, LOOKBACK, INACTIVE, FRAUD_DETECTED, etc. with lowercase string values)
3. **auditing_token** (string): The auditing token for the attribution
4. **linkage_key** (string): The linkage key for the attribution

These fields are part of the ongoing work to enhance attribution tracking capabilities in the Conversions API. This builds upon the initial AMM fields added in v24.0.0.

**Changes:**
- Created new enum classes extending AbstractEnum: `AttributionMethod.php` and `DeclineReason.php`
- Updated `AttributionData.php` with new fields, param_types, attributeMap, setters, getters, constructor initialization, and normalize method
- Updated `AttributionDataTest.php` to test the new fields in both builder and constructor patterns
- Updated CHANGELOG.md to version v24.0.1

Reviewed By: shuaiwa-meta, satwikareddy3

Differential Revision: D85200641

fbshipit-source-id: d245aa3a7261a4957db2d1beb2881387819929b9

Author: Ji Li

CHANGELOG.md

@@ -5,8 +5,13 @@ All notable changes to this project will be documented in this file.
 
 ## Unreleased
 
+## v24.0.1
+### Added
+- Add additional AMM fields: attribution_method, decline_reason, auditing_token, linkage_key
+- Add attribution_setting nested field with inactivity_window_hours, reattribution_window_hours
+
 ## v24.0.0
-### Changed
+### Added
 - Add AMM fields to attribution data
 
 ## v22.0.3

src/FacebookAds/Object/ServerSide/AttributionData.php

@@ -46,6 +46,11 @@ class AttributionData implements ArrayAccess {
   private $attribution_source;
   private $touchpoint_type;
   private $touchpoint_ts;
+  private $attribution_method;
+  private $decline_reason;
+  private $auditing_token;
+  private $linkage_key;
+  private $attribution_setting;
 
   protected static $param_types = array(
     'scope' => 'string',
@@ -60,6 +65,11 @@ class AttributionData implements ArrayAccess {
     'attribution_source' => 'string',
     'touchpoint_type' => 'string',
     'touchpoint_ts' => 'int',
+    'attribution_method' => 'FacebookAds\Object\ServerSide\AttributionMethod',
+    'decline_reason' => 'FacebookAds\Object\ServerSide\DeclineReason',
+    'auditing_token' => 'string',
+    'linkage_key' => 'string',
+    'attribution_setting' => 'FacebookAds\Object\ServerSide\AttributionSetting',
   );
 
   protected static $attributeMap = array(
@@ -75,6 +85,11 @@ class AttributionData implements ArrayAccess {
     'attribution_source' => 'attribution_source',
     'touchpoint_type' => 'touchpoint_type',
     'touchpoint_ts' => 'touchpoint_ts',
+    'attribution_method' => 'attribution_method',
+    'decline_reason' => 'decline_reason',
+    'auditing_token' => 'auditing_token',
+    'linkage_key' => 'linkage_key',
+    'attribution_setting' => 'attribution_setting',
   );
 
   protected static $setters = array(
@@ -90,6 +105,11 @@ class AttributionData implements ArrayAccess {
     'attribution_source' => 'setAttributionSource',
     'touchpoint_type' => 'setTouchpointType',
     'touchpoint_ts' => 'setTouchpointTs',
+    'attribution_method' => 'setAttributionMethod',
+    'decline_reason' => 'setDeclineReason',
+    'auditing_token' => 'setAuditingToken',
+    'linkage_key' => 'setLinkageKey',
+    'attribution_setting' => 'setAttributionSetting',
   );
 
   protected static $getters = array(
@@ -105,6 +125,11 @@ class AttributionData implements ArrayAccess {
     'attribution_source' => 'getAttributionSource',
     'touchpoint_type' => 'getTouchpointType',
     'touchpoint_ts' => 'getTouchpointTs',
+    'attribution_method' => 'getAttributionMethod',
+    'decline_reason' => 'getDeclineReason',
+    'auditing_token' => 'getAuditingToken',
+    'linkage_key' => 'getLinkageKey',
+    'attribution_setting' => 'getAttributionSetting',
   );
 
   protected $container = array();
@@ -122,6 +147,11 @@ public function __construct(?array $data = null) {
     $this->container['attribution_source'] = isset($data['attribution_source']) ? $data['attribution_source'] : null;
     $this->container['touchpoint_type'] = isset($data['touchpoint_type']) ? $data['touchpoint_type'] : null;
     $this->container['touchpoint_ts'] = isset($data['touchpoint_ts']) ? $data['touchpoint_ts'] : null;
+    $this->container['attribution_method'] = isset($data['attribution_method']) ? $data['attribution_method'] : null;
+    $this->container['decline_reason'] = isset($data['decline_reason']) ? $data['decline_reason'] : null;
+    $this->container['auditing_token'] = isset($data['auditing_token']) ? $data['auditing_token'] : null;
+    $this->container['linkage_key'] = isset($data['linkage_key']) ? $data['linkage_key'] : null;
+    $this->container['attribution_setting'] = isset($data['attribution_setting']) ? $data['attribution_setting'] : null;
   }
 
   public static function paramTypes() {
@@ -281,6 +311,61 @@ public function setTouchpointTs($touchpoint_ts) {
     return $this;
   }
 
+  /**
+   * Sets attribution_method
+   * @param string $attribution_method The attribution method used to attribute the event.
+   * @return $this
+   */
+  public function setAttributionMethod($attribution_method) {
+    $this->container['attribution_method'] = $attribution_method;
+
+    return $this;
+  }
+
+  /**
+   * Sets decline_reason
+   * @param string $decline_reason The decline reason for the attribution.
+   * @return $this
+   */
+  public function setDeclineReason($decline_reason) {
+    $this->container['decline_reason'] = $decline_reason;
+
+    return $this;
+  }
+
+  /**
+   * Sets auditing_token
+   * @param string $auditing_token The auditing token for the attribution.
+   * @return $this
+   */
+  public function setAuditingToken($auditing_token) {
+    $this->container['auditing_token'] = $auditing_token;
+
+    return $this;
+  }
+
+  /**
+   * Sets linkage_key
+   * @param string $linkage_key The linkage key for the attribution.
+   * @return $this
+   */
+  public function setLinkageKey($linkage_key) {
+    $this->container['linkage_key'] = $linkage_key;
+
+    return $this;
+  }
+
+  /**
+   * Sets attribution_setting
+   * @param AttributionSetting $attribution_setting The attribution setting for the attribution.
+   * @return $this
+   */
+  public function setAttributionSetting($attribution_setting) {
+    $this->container['attribution_setting'] = $attribution_setting;
+
+    return $this;
+  }
+
   /**
    * Gets touchpoint type.
    * @return string
@@ -377,6 +462,46 @@ public function getTouchpointTs() {
     return $this->container['touchpoint_ts'];
   }
 
+  /**
+   * Gets attribution method.
+   * @return string
+   */
+  public function getAttributionMethod() {
+    return $this->container['attribution_method'];
+  }
+
+  /**
+   * Gets decline reason.
+   * @return string
+   */
+  public function getDeclineReason() {
+    return $this->container['decline_reason'];
+  }
+
+  /**
+   * Gets auditing token.
+   * @return string
+   */
+  public function getAuditingToken() {
+    return $this->container['auditing_token'];
+  }
+
+  /**
+   * Gets linkage key.
+   * @return string
+   */
+  public function getLinkageKey() {
+    return $this->container['linkage_key'];
+  }
+
+  /**
+   * Gets attribution setting.
+   * @return AttributionSetting
+   */
+  public function getAttributionSetting() {
+    return $this->container['attribution_setting'];
+  }
+
   /**
    * Returns true if offset exists. False otherwise.
    * @param integer $offset Offset
@@ -433,6 +558,12 @@ public function normalize() {
     $normalized_payload['attribution_source'] = $this->getAttributionSource();
     $normalized_payload['touchpoint_type'] = $this->getTouchpointType();
     $normalized_payload['touchpoint_ts'] = $this->getTouchpointTs();
+    $normalized_payload['attribution_method'] = $this->getAttributionMethod();
+    $normalized_payload['decline_reason'] = $this->getDeclineReason();
+    $normalized_payload['auditing_token'] = $this->getAuditingToken();
+    $normalized_payload['linkage_key'] = $this->getLinkageKey();
+    $attribution_setting = $this->getAttributionSetting();
+    $normalized_payload['attribution_setting'] = $attribution_setting != null ? $attribution_setting->normalize() : null;
     return $normalized_payload;
   }
 

src/FacebookAds/Object/ServerSide/AttributionMethod.php

@@ -0,0 +1,52 @@
+<?php
+/**
+ * Copyright (c) 2015-present, Facebook, Inc. All rights reserved.
+ *
+ * You are hereby granted a non-exclusive, worldwide, royalty-free license to
+ * use, copy, modify, and distribute this software in source code or binary
+ * form for use in connection with the web services and APIs provided by
+ * Facebook.
+ *
+ * As with any software that integrates with the Facebook platform, your use
+ * of this software is subject to the Facebook Developer Principles and
+ * Policies [http://developers.facebook.com/policy/]. This copyright notice
+ * shall be included in all copies or substantial portions of the software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+ * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+ * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+ * DEALINGS IN THE SOFTWARE.
+ *
+ */
+
+namespace FacebookAds\Object\ServerSide;
+
+use FacebookAds\Enum\AbstractEnum;
+
+/**
+ * Class AttributionMethod
+ * @package FacebookAds\Object\ServerSide
+ */
+class AttributionMethod extends AbstractEnum {
+
+  const ARD = 'ard';
+  const DEEPLINK = 'deeplink';
+  const GPIR = 'gpir';
+  const INVALID_RESPONSE = 'invalid_response';
+  const MIR = 'mir';
+  const SRN = 'srn';
+
+  public function getFieldTypes() {
+    return array(
+      'ARD' => 'string',
+      'DEEPLINK' => 'string',
+      'GPIR' => 'string',
+      'INVALID_RESPONSE' => 'string',
+      'MIR' => 'string',
+      'SRN' => 'string',
+    );
+  }
+}