Skip to content

tags_clicked ​

php
boolean|array tags_clicked (string $email, number $from, number|null $to = null, number &$returnCode = 0)

Returns an array of tags clicked by the specified email address within the specified time range. If $to is omitted, returns tags clicked from $from to the present.

If a variable is supplied as $returnCode, it receives the error code returned by the system.

  • -1 - syntactically invalid email address
  • -2 - email address does not exist
  • -3 - invalid $from parameter
  • -4 - invalid $to parameter
  • -5 - function is disabled

Example:

php
$email = 'cs@sare.pl';
$from = strtotime('-1 month');
$to = strtotime('now');
$returnCode = 0;

$tags = tags_clicked($email, $from, $to, $returnCode);
print_r($tags);

Result:

Array
(
    [tag1] => Array
        (
            [count] => 1
            [first_click] => 1755500712
            [last_click] => 1755500712
        )

    [tag2] => Array
        (
            [count] => 1
            [first_click] => 1755500712
            [last_click] => 1755500712
        )

    [tag3] => Array
        (
            [count] => 2
            [first_click] => 1755497975
            [last_click] => 1755500714
        )

)