=== AdvisorPPC ===
Contributors: advisorppcai
Tags: analytics, tracking tags, consent mode, click tracking, tag manager
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Tracking tags, Consent Mode and advertising click-ID capture. No account, sign-up or key required.

== Description ==

AdvisorPPC loads your advertising and analytics tags, connects them to your consent banner, and captures advertising click identifiers on your own site. No account is required.

* Tracking tags: GA4, Google Ads, Google Tag Manager, Meta Pixel, TikTok, Microsoft UET, LinkedIn Insight and Pinterest. Enter the IDs for the platforms you use; leave the rest blank.
* Consent Mode: off, basic and advanced settings, with a bridge to the consent banner you already run.
* Click-ID capture: saves gclid, gbraid, wbraid, fbclid, msclkid, ttclid, li_fat_id, twclid and epik from landing URLs in a first-party cookie.

**Privacy and local storage**

The plugin does not send data to AdvisorPPC. Configured tags communicate with their advertising or analytics platform, as described below. The optional debug log stays on your own server and is never uploaded.

The plugin uses first-party cookies on your domain: `advisorppc_cids` holds advertising click IDs, a random session identifier, landing page and referrer for 90 days; `advisorppc_consent` holds the choices your consent banner reports for 180 days; `advisorppc_pending` can hold a signed browser cart-event hand-off for 10 minutes.

== External services ==

= AdvisorPPC hosts =

`advisorppc.com`, `advisorppc.ai` and their subdomains, including `mcp.advisorppc.com` and `shield.advisorppc.ai`, are not contacted by the plugin in this version. Workspace features are disabled in the WordPress.org 1.0.0 build. There is no connection flow, version check or usage telemetry to AdvisorPPC.

AdvisorPPC terms and privacy links are provided for reference. They open only if you choose to follow them:

* Terms of service: https://advisorppc.com/terms
* Privacy policy: https://advisorppc.com/privacy

= Advertising and analytics platforms you configure =

Powers the "Tracking tags" module. Each of these is contacted **only if you enter that platform's measurement ID** in the plugin settings, and only on the pages where the tag is loaded. No AdvisorPPC account is needed or involved. Leave a field blank and its host is never contacted.

* Analytics measurement ID, Google Ads conversion ID: `www.googletagmanager.com`, operated by Google LLC. The Google tag then sends its measurements to Google's collection hosts, such as `www.google-analytics.com`, `region1.google-analytics.com`, `googleads.g.doubleclick.net`, `www.google.com` and `www.googleadservices.com`.
* Tag Manager container ID: `www.googletagmanager.com`, operated by Google LLC. A Tag Manager container also loads whatever tags its owner has added to it inside Google Tag Manager; those are set up in your Google account, not in this plugin.
* Meta pixel ID: `connect.facebook.net` and `www.facebook.com`, operated by Meta Platforms, Inc.
* TikTok pixel ID: `analytics.tiktok.com`, operated by TikTok Ltd.
* Microsoft UET tag ID: `bat.bing.com`, operated by Microsoft Corporation.
* LinkedIn partner ID: `snap.licdn.com` and `px.ads.linkedin.com`, operated by LinkedIn Corporation.
* Pinterest tag ID: `s.pinimg.com` and `ct.pinterest.com`, operated by Pinterest, Inc.

*What is sent:* whatever that platform's own tag collects, which is typically the page address, referrer, a platform cookie identifier and the conversion events you have enabled. This is the same data the platform would receive if you pasted its snippet into your theme or loaded it through any tag manager. AdvisorPPC does not add fields to it and does not receive a copy.

*Consent:* if you set Consent Mode to basic or advanced, these tags are held or run in restricted mode until your consent banner reports a decision.

Each platform's own terms and privacy policy apply to the data its tag collects:

* Google: https://policies.google.com/terms and https://policies.google.com/privacy
* Meta: https://www.facebook.com/legal/terms and https://www.facebook.com/privacy/policy
* TikTok: https://ads.tiktok.com/i18n/official/policy/terms and https://www.tiktok.com/legal/privacy-policy
* Microsoft: https://about.ads.microsoft.com/en-us/resources/policies/microsoft-advertising-agreement and https://privacy.microsoft.com/privacystatement
* LinkedIn: https://www.linkedin.com/legal/l/ads-agreement and https://www.linkedin.com/legal/privacy-policy
* Pinterest: https://policy.pinterest.com/en/advertising-services-agreement and https://policy.pinterest.com/en/privacy-policy

== Installation ==

1. Install and activate the plugin.
2. Open **AdvisorPPC** in the WordPress admin menu.
3. Enter the measurement IDs for the platforms you use.
4. Choose your Consent Mode setting and connect your existing consent banner to the plugin's consent bridge.
5. Save changes. No AdvisorPPC account is needed.

== Frequently Asked Questions ==

= Do I need an account? =

No. Tracking tags, Consent Mode and click-ID capture work without an AdvisorPPC account or key. You use your existing advertising or analytics platform IDs to configure tags.

= Does this plugin send anything to AdvisorPPC? =

No. AdvisorPPC hosts are not contacted in this version, including on installation and activation. If you enter a measurement ID, that platform's own tag loads on your pages and receives its normal measurements. The hosts and privacy policies are listed under "External services".

= Does this plugin include a consent banner? =

No. It provides a consent bridge for your existing banner. Choose basic or advanced mode and have your banner report choices through `window.advisorppc.consent.update()`.

= What happens if I delete the plugin? =

Deleting the plugin removes its settings from your database. The plugin no longer loads tags. Existing first-party cookies expire according to their lifetimes.

= Where is the debug log written? =

To your own site's PHP error log, and only if you switch it on. It is never uploaded.

== Screenshots ==

1. The settings page with tracking tags available and no account required.
2. Google Analytics, Google Ads and Tag Manager measurement ID fields.
3. Measurement ID fields for Meta, TikTok, Microsoft, LinkedIn and Pinterest.
4. Consent Mode, the local debug log switch, and information about data sent by configured tags.

== Changelog ==

= 1.0.0 =
* First public release.
* Tracking tags for GA4, Google Ads, Google Tag Manager, Meta Pixel, TikTok, Microsoft UET, LinkedIn Insight and Pinterest.
* Consent Mode with off, basic and advanced settings and a bridge to an existing consent banner.
* Advertising click-ID capture in a first-party cookie.

== Upgrade Notice ==

= 1.0.0 =
First public release.
