{"id":18034662,"url":"https://github.com/austinkregel/tamber-php-sdk","last_synced_at":"2025-04-04T23:12:21.962Z","repository":{"id":57009174,"uuid":"85658651","full_name":"austinkregel/tamber-php-sdk","owner":"austinkregel","description":"A PHP SDK for the Tamber API","archived":false,"fork":false,"pushed_at":"2019-08-12T19:20:33.000Z","size":11,"stargazers_count":2,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-10T07:30:05.315Z","etag":null,"topics":["hacktoberfest","recommendation-engine","suggestion-engine","tamber","tamber-php"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/austinkregel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-03-21T04:21:02.000Z","updated_at":"2020-02-25T04:07:10.000Z","dependencies_parsed_at":"2022-08-21T13:10:11.798Z","dependency_job_id":null,"html_url":"https://github.com/austinkregel/tamber-php-sdk","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austinkregel%2Ftamber-php-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austinkregel%2Ftamber-php-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austinkregel%2Ftamber-php-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/austinkregel%2Ftamber-php-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/austinkregel","download_url":"https://codeload.github.com/austinkregel/tamber-php-sdk/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247261605,"owners_count":20910108,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","recommendation-engine","suggestion-engine","tamber","tamber-php"],"created_at":"2024-10-30T11:13:08.568Z","updated_at":"2025-04-04T23:12:21.945Z","avatar_url":"https://github.com/austinkregel.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# The [Tamber](https://tamber.com) PHP SDK\nThis is an UNOFFICIAL SDK.\n\n## Get your api Token by creating an account\nThe first thing to do is head to the [official Tamber website](https://tamber.com) to register\n\n## Download the project\nWhen this package is finally on packagist, you'll be able to install it using\n\n```\ncomposer require kregel/tamber\n```\n\n# Usage of this package\n\n### Event\n```php\n\u003c?php\nrequire 'vendor/autoload.php';\nuse Kregel\\Tamber\\Tamber;\nuse Kregel\\Tamber\\Event;\n\nTamber::setProjectKey('...');\nTamber::setEngineKey('...'); // If you just created your account you won't be able to set or create an engine until you track at least 1 event.\n\ntry {\n    $response = (new Event)-\u003etrack([\n        /**\n         * This will be created if it doesn't exist by default (via Tamber's code not this package)  \n         */\n        'user' =\u003e 'your user id using whatever format you want',\n        \n        /**\n         * This can be anything from likes, dislikes, purchases, clicks, reads, ect.\n         * This will be created if it doesn't exist by default (via Tamber's code not this package) \n         */\n        'behavior' =\u003e 'like', \n        \n        /**\n         * If I were using Laravel I might do something like `App\\User:1` or `App\\Models\\Transaction:810`. Something to signify the thing performing\n         * that's performing said beahvior and the identifier to track that thing's previous behaviors.\n         */\n        'item' =\u003e 'spotify:track:1JIgaRnqtzS7DuGM3hVZU9',\n        \n        /**\n         * The Tamber docs mention the context could be related to A/B testing for interface changes.\n         * but it could also be used to track the user's current url, previous things the user clicked on or other actions that the user preformed\n         * like whether or not they played the song or read the book.\n         */\n        'context' =\u003e [\n            'home-page',\n        ],\n        /**\n         * This is just to indicate whether or not this specific behavior was related to a recommened/suggested action.\n         * i.e. Did they play the song because it was in your recommended list? \n         */\n        'hit' =\u003e false,\n    ]);\n    print_r($response-\u003egetContents());\n} catch (\\Kregel\\Tamber\\Exceptions\\TamberException $e) {\n    echo $e-\u003egetMessage() . \"\\n\";\n    print_r($e-\u003egetContext());\n}\n```\n\n### Behaviors\n```php\n\u003c?php\n\nuse Kregel\\Tamber\\Tamber;\nuse Kregel\\Tamber\\Behavior;\n\nTamber::setProjectKey($projectToken);\n\ntry {\n    $behavior = (new Behavior)-\u003ecreate([\n        'name' =\u003e 'purchase',\n        'desirability' =\u003e 0.6\n    ]);\n} catch (\\Kregel\\Tamber\\Exceptions\\TamberException $e) {\n    echo $e-\u003egetMessage() . \"\\n\";\n    print_r($e-\u003egetContext());\n}\n\n```\n\n### Items\nCreating\n```php\n\u003c?php\n\nuse Kregel\\Tamber\\Tamber;\nuse Kregel\\Tamber\\Item;\n\nTamber::setProjectKey($projectToken);\n\ntry {\n    $item = (new Item)-\u003ecreate([\n        'id' =\u003e 'App\\Song:1', // This just needs to be some kind of unique identifier.\n        'properties' =\u003e [\n            'artist' =\u003e 'Logic',\n            'title' =\u003e 'Under Pressure',\n            'length' =\u003e '9:20',\n            'explicit' =\u003e true\n        ],\n        'tags' =\u003e [\n            'rap', 'hip-hop'\n        ],\n        'created' =\u003e App\\Song::find(1)-\u003ecreated_at // This is just to represent when the song was created in your system.\n    ]);\n} catch (\\Kregel\\Tamber\\Exceptions\\TamberException $e) {\n    echo $e-\u003egetMessage() . \"\\n\";\n    print_r($e-\u003egetContext());\n}\n```\n\nGetting an item\n```php\n\u003c?php\nuse Kregel\\Tamber\\Tamber;\nuse Kregel\\Tamber\\Item;\n\nTamber::setProjectKey($projectToken);\n\n$item = (new Item)-\u003eretrieve([\n    'id' =\u003e 'spotify:track:5LME7YULt0enp6UAB8VoDn'\n]);\n\n```\n\n### Side notes\nIt should be noted that each item in the Tamber API uses the `TransformRequest` trait. That means we hijack the \ncalls to the SDK and transform them into something a bit more usable.\n\nUsing the behavior creation example above. You can access any of the response data by simply trying to access it from the behavior variable.\n\n```php\n$behavior-\u003eresult-\u003ename // purchase\n$behavior-\u003estatus // 200\n$behavior-\u003esuccess // true\n// ect...\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faustinkregel%2Ftamber-php-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faustinkregel%2Ftamber-php-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faustinkregel%2Ftamber-php-sdk/lists"}