Files
2026-04-28 15:13:50 +02:00

502 lines
15 KiB
PHP

<?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 FacebookPixelPlugin\FacebookAds\Object\ServerSide;
use ArrayAccess;
use FacebookPixelPlugin\FacebookAds\Api;
use FacebookPixelPlugin\FacebookAds\ApiConfig;
use FacebookPixelPlugin\FacebookAds\Object\AdsPixel;
/**
* Conversions API Event Request
*
* @category Class
*/
class EventRequest implements ArrayAccess {
/**
* Array of property to type mappings. Used for (de)serialization
* @var string[]
*/
protected static $param_types = array(
'events' => '\FacebookPixelPlugin\FacebookAds\Object\ServerSide\Event[]',
'test_event_code' => 'string',
'partner_agent' => 'string',
'namespace_id' => 'string',
'upload_id' => 'string',
'upload_tag' => 'string',
'upload_source' => 'string'
);
/**
* Array of attributes where the key is the local name, and the value is the original name
* @var string[]
*/
protected static $attributeMap = array(
'events' => 'events',
'test_event_code' => 'test_event_code',
'partner_agent' => 'partner_agent',
'namespace_id' => 'namespace_id',
'upload_id' => 'upload_id',
'upload_tag' => 'upload_tag',
'upload_source' => 'upload_source'
);
/**
* Array of attributes to setter functions (for deserialization of responses)
* @var string[]
*/
protected static $setters = array(
'events' => 'setEvents',
'test_event_code' => 'setTestEventCode',
'partner_agent' => 'setPartnerAgent',
'namespace_id' => 'setNamespaceId',
'upload_id' => 'setUploadId',
'upload_tag' => 'setUploadTag',
'upload_source' => 'setUploadSource'
);
/**
* Array of attributes to getter functions (for serialization of requests)
* @var string[]
*/
protected static $getters = array(
'events' => 'getEvents',
'test_event_code' => 'getTestEventCode',
'partner_agent' => 'getPartnerAgent',
'namespace_id' => 'getNamespaceId',
'upload_id' => 'getUploadId',
'upload_tag' => 'getUploadTag',
'upload_source' => 'getUploadSource'
);
/**
* Associative array for storing property values
* @var mixed[]
*/
protected $container = array();
protected $http_client = null;
protected $endpoint_request = null;
/**
* Constructor
* @param string $pixel_id pixel id
* @param mixed[] $data Associated array of property value initializing the model
*/
public function __construct($pixel_id, ?array $data = null) {
$this->container['pixel_id'] = $pixel_id;
$this->container['events'] = isset($data['events']) ? $data['events'] : null;
$this->container['test_event_code'] = isset($data['test_event_code']) ? $data['test_event_code'] : null;
$this->container['partner_agent'] = isset($data['partner_agent']) ? $data['partner_agent'] : null;
$this->container['namespace_id'] = isset($data['namespace_id']) ? $data['namespace_id'] : null;
$this->container['upload_id'] = isset($data['upload_id']) ? $data['upload_id'] : null;
$this->container['upload_tag'] = isset($data['upload_tag']) ? $data['upload_tag'] : null;
$this->container['upload_source'] = isset($data['upload_source']) ? $data['upload_source'] : null;
}
public static function paramTypes() {
return self::$param_types;
}
public static function attributeMap() {
return self::$attributeMap;
}
public static function setters() {
return self::$setters;
}
public static function getters() {
return self::$getters;
}
/**
* show all the invalid properties with reasons.
*
* @return array invalid properties with reasons
*/
public function listInvalidProperties() {
$invalid_properties = array();
if ($this->container['events'] === null) {
$invalid_properties[] = "'events' can't be null";
}
return $invalid_properties;
}
/**
* validate all the properties in the model
* return true if all passed
*
* @return bool True if all properties are valid
*/
public function valid() {
if ($this->container['events'] === null) {
return false;
}
return true;
}
/**
* Sets an array of Server Event objects
* @param \FacebookAds\Object\ServerSide\Event[] $events An array of Server Event objects
* @return $this
*/
public function setEvents($events) {
$this->container['events'] = $events;
return $this;
}
/**
* Gets code used to verify that your server events are received correctly by Facebook. Use this
* code to test your server events in the Test Events feature in Events Manager.
* See Test Events Tool
* (https://developers.facebook.com/docs/marketing-api/conversions-api/using-the-api#testEvents)
* for an example.
* @return string
*/
public function getTestEventCode() {
return $this->container['test_event_code'];
}
/**
* Sets code used to verify that your server events are received correctly by Facebook. Use this
* code to test your server events in the Test Events feature in Events Manager.
* See Test Events Tool
* (https://developers.facebook.com/docs/marketing-api/conversions-api/using-the-api#testEvents)
* for an example.
* @param string $test_event_code Code used to verify that your server events are received correctly by Facebook.
* Use this code to test your server events in the Test Events feature in Events Manager. See Test Events Tool
* (https://developers.facebook.com/docs/marketing-api/conversions-api/using-the-api#testEvents)
* for an example.
* @return $this
*/
public function setTestEventCode($test_event_code) {
$this->container['test_event_code'] = $test_event_code;
return $this;
}
/**
* Sets Partner Agent, which specifies who is sending the event.
* @param string $partner_agent The partner agent who is sending the event
* @return $this
*/
public function setPartnerAgent($partner_agent) {
$this->container['partner_agent'] = $partner_agent;
return $this;
}
/**
* Sets a custom HTTP Client object, which overrides the default HTTP service
* used to send the event request.
* @param HttpServiceInterface $http_client An object that implements the HttpServiceInterface
* @return $this
*/
public function setHttpClient($http_client) {
$this->http_client = $http_client;
return $this;
}
/**
* Sets a custom Endpoint Request that is used to send the event request
* in addition to CAPI Request.
* @param CustomEndpointRequest $custom_endpoint An object that implements the CustomEndpointRequest
* @return $this
*/
public function setCustomEndpoint(CustomEndpointRequest $custom_endpoint) {
$this->endpoint_request = $custom_endpoint;
return $this;
}
/**
* Execute the request
*/
public function execute()
{
if ($this->endpoint_request != null && $this->endpoint_request->isSendToEndpointOnly()) {
// do not send to CAPI Endpoint. If no exception was thrown, we can assume all events were sent successfully
$customEndpointResponses = $this->sendEventsToCustomEndpoint();
return new EventResponse(array(
'data' => array('events_received' => count($this->container['events']), 'custom_endpoint_responses'=>$customEndpointResponses)
));
} else if ($this->endpoint_request != null) {
$capiResponse = $this->sendToCAPIEndpoint();
$capiResponse->setCustomEndpointResponses(array($this->endpoint_request->getEndpoint() => $this->sendEventsToCustomEndpoint()));
return $capiResponse;
}
return $this->sendToCAPIEndpoint();
}
/**
* Synchronously send events to Custom Endpoint.
*
* @return array
*/
private function sendEventsToCustomEndpoint(): array
{
$customEndpointResponse = $this->endpoint_request->sendEvent($this->container['pixel_id'], $this->container['events']);
return array($this->endpoint_request->getEndpoint() => $customEndpointResponse);
}
/**
* Synchronously send events to Facebook Conversions API.
*
* @return EventResponse response
*/
private function sendToCAPIEndpoint(): EventResponse
{
if ($this->http_client != null) {
$http_client = $this->http_client;
} else {
$http_client = HttpServiceClientConfig::getInstance()->getClient();
}
if ($http_client != null) {
return $this->httpClientExecute($http_client);
}
return $this->defaultExecute();
}
private function defaultExecute() {
$fields = array();
$normalized_param = $this->normalize();
$ads_pixel = new AdsPixel($this->container['pixel_id']);
$response = $ads_pixel->createEvent(
$fields,
$normalized_param
);
return new EventResponse($response->exportAllData());
}
private function httpClientExecute($http_client) {
$base_url = 'https://graph.facebook.com/v' . ApiConfig::APIVersion;
$url = $base_url . '/' . $this->container['pixel_id'] . '/events';
$headers = array(
'User-Agent' => 'fbbizsdk-php-v' . ApiConfig::SDKVersion,
'Accept-Encoding' => '*',
);
$curl_options = array(
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 60,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HEADER => true,
CURLOPT_CAINFO => Util::getCaBundlePath(),
);
$params = $this->normalize();
if (HttpServiceClientConfig::getInstance()->getAccessToken() == null) {
$params['access_token'] = Api::instance()->getSession()->getAccessToken();
} else {
$params['access_token'] = HttpServiceClientConfig::getInstance()->getAccessToken();
}
$appsecret = null;
if (HttpServiceClientConfig::getInstance()->getAppsecret() == null) {
$appsecret = Api::instance()->getSession()->getAppSecret();
} else {
$appsecret = HttpServiceClientConfig::getInstance()->getAppsecret();
}
if ($appsecret != null) {
$params['appsecret_proof'] = Util::getAppsecretProof($params['access_token'], $appsecret);
}
return $http_client->executeRequest(
$url,
HttpMethod::POST,
$curl_options,
$headers,
$params
);
}
/**
* Normalize
* @return array
*/
public function normalize() {
$normalized_events = array();
$events = $this->getEvents();
if (!is_null($events)) {
foreach ($events as $event) {
$normalized_event = $event->normalize();
array_push($normalized_events, $normalized_event);
}
}
$normalized_payload = array(
'data' => $normalized_events,
'test_event_code' => $this->container['test_event_code'],
'partner_agent' => $this->container['partner_agent'],
'namespace_id' => $this->container['namespace_id'],
'upload_id' => $this->container['upload_id'],
'upload_tag' => $this->container['upload_tag'],
'upload_source' => $this->container['upload_source'],
);
$normalized_payload = array_filter($normalized_payload);
return $normalized_payload;
}
/**
* Gets an array of Server Event objects
* @return FacebookAds\Object\ServerSide\Event[]
*/
public function getEvents() {
return $this->container['events'];
}
/**
* Gets Partner Agent, which specifies who is sending the event.
* @return string
*/
public function getPartnerAgent() {
return $this->container['partner_agent'];
}
/**
* Gets namespace_id, a scope used to resolve extern_id or Third-party ID.
* Can be another data set or data partner ID.
* @return string
*/
public function getNamespaceId() {
return $this->container['namespace_id'];
}
/**
* Sets namespace_id, a scope used to resolve extern_id or Third-party ID.
* Can be another data set or data partner ID.
* @return $this
*/
public function setNamespaceId($namespace_id) {
$this->container['namespace_id'] = $namespace_id;
return $this;
}
/**
* Gets upload_id, a unique id used to denote the current set being uploaded.
* @return string
*/
public function getUploadId() {
return $this->container['upload_id'];
}
/**
* Sets upload_id, a unique id used to denote the current set being uploaded.
* @return $this
*/
public function setUploadId($upload_id) {
$this->container['upload_id'] = $upload_id;
return $this;
}
/**
* Gets upload_tag, a tag string added to track your Offline event uploads.
* @return string
*/
public function getUploadTag() {
return $this->container['upload_tag'];
}
/**
* Sets upload_tag, a tag string added to track your Offline event uploads.
* @return $this
*/
public function setUploadTag($upload_tag) {
$this->container['upload_tag'] = $upload_tag;
return $this;
}
/**
* Gets upload_source, the origin/source of data for the dataset to be uploaded.
* @return string
*/
public function getUploadSource() {
return $this->container['upload_source'];
}
/**
* Sets upload_source, the origin/source of data for the dataset to be uploaded.
* @return $this
*/
public function setUploadSource($upload_source) {
$this->container['upload_source'] = $upload_source;
return $this;
}
/**
* Returns true if offset exists. False otherwise.
* @param integer $offset Offset
* @return boolean
*/
public function offsetExists($offset) : bool {
return isset($this->container[$offset]);
}
/**
* Gets offset.
* @param integer $offset Offset
* @return mixed
*/
public function offsetGet($offset) : mixed {
return isset($this->container[$offset]) ? $this->container[$offset] : null;
}
/**
* Sets value based on offset.
* @param integer $offset Offset
* @param mixed $value Value to be set
* @return void
*/
public function offsetSet($offset, $value) : void {
if (is_null($offset)) {
$this->container[] = $value;
} else {
$this->container[$offset] = $value;
}
}
/**
* Unsets offset.
* @param integer $offset Offset
* @return void
*/
public function offsetUnset($offset) : void {
unset($this->container[$offset]);
}
/**
* Gets the string presentation of the object
* @return string
*/
public function __toString() {
if (defined('JSON_PRETTY_PRINT')) { // use JSON pretty print
return json_encode($this, JSON_PRETTY_PRINT);
}
return json_encode($this);
}
}