Metadata-Version: 2.4
Name: ocyan.plugin.facebook
Version: 0.1.3
Summary: Configurable Meta Conversions API integration for Ocyan
Author: MandelBlog
License-Expression: LicenseRef-Proprietary
Classifier: Framework :: Django
Classifier: Environment :: Plugins
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: <3.14,>=3.12
Description-Content-Type: text/markdown
Requires-Dist: ocyan.core
Requires-Dist: requests>=2.31
Provides-Extra: test
Requires-Dist: Django>=4.2; extra == "test"

# Ocyan Meta Conversions API plugin

This package registers the Ocyan Django application and offers a small,
consumer-configured client for Meta's Conversions API. It does not provision a
pixel, access token, consent policy, test-event code, or external connection.

## Consumer configuration

The consuming Django project must explicitly provide `FACEBOOK_PIXEL_ID`,
`FACEBOOK_ACCESS_TOKEN`, and a currently supported
`FACEBOOK_GRAPH_API_VERSION`. Configure an explicit test-event code only in a
non-production verification call. The caller remains responsible for consent,
event schema, data minimisation, and Meta account policy.

`send_view_content()` sends no request until the consumer invokes it. The
client uses a bounded ten-second HTTP timeout and sends the access token as a
request parameter rather than embedding it in the endpoint URL.
