diff --git a/content/manuals/docker-hub/repos/manage/trusted-content/insights-analytics.md b/content/manuals/docker-hub/repos/manage/trusted-content/insights-analytics.md index c4616e4ad86..2cb03e66264 100644 --- a/content/manuals/docker-hub/repos/manage/trusted-content/insights-analytics.md +++ b/content/manuals/docker-hub/repos/manage/trusted-content/insights-analytics.md @@ -42,18 +42,15 @@ organization's DVP subscription tier: - Growth tier - [Summary](#summary-report) - [Trends](#trends-report) - - [Technographic companies](#technographic-companies-report) - - [Tracked companies](#tracked-companies-report) + - [Domain-level reports](#domain-level-reports) - [Benchmark](#benchmark-report) -The Tracked companies, Technographic companies, and Benchmark reports each -provide a different slice of reporting on the companies tracked under your -subscription: +The Domain-level reports and Benchmark report each provide a different slice +of reporting on consuming domains: -- Tracked companies shows how those companies use your own images. -- Technographic companies shows which other images those companies use - alongside yours. -- Benchmark shows how those companies use the specific images you've configured to +- Domain-level reports show how those domains use your own images, and which + other images they use alongside yours. +- Benchmark shows how those domains use the specific images you've configured to benchmark against, such as a single repository. After your organization is provisioned for DVP analytics, it takes up to one @@ -142,18 +139,23 @@ The trends report is a CSV file that contains the following data points: | `UNIQUE_AUTHENTICATED_USERS` | The number of unique authenticated users who performed pulls. | | `UNIQUE_UNAUTHENTICATED_USERS` | The number of unique unauthenticated users who performed pulls. | -#### Technographic companies report +#### Domain-level reports -The technographic companies report provides a detailed view of which specific -companies (identified by their domains) are using your Docker Verified Publisher -(DVP) images together with other container images. This report gives you -visibility into the actual organizations adopting your technology stack -combinations, enabling targeted business development and partnership -opportunities. +Domain-level reports provide detailed insights into how specific consuming +domains use your Docker Verified Publisher (DVP) images, both on their own and +alongside other container images. These reports help you understand usage +patterns, deployment environments, adoption trends, and technology stack +combinations across your customer base and potential prospects. -You can use this report to answer questions like: +You can use these reports to answer questions like: -- Which companies are using my image alongside specific complementary +- How are specific consuming domains using my images across different + environments? +- What deployment patterns do I see across local development, CI/CD, and + production? +- Which consuming domains are heavy users of my images? +- How does usage vary by geography and cloud providers for consuming domains? +- Which consuming domains are using my image alongside specific complementary technologies? - What technology stacks are adopted by enterprise customers in my target market? @@ -161,6 +163,14 @@ You can use this report to answer questions like: - How can I identify potential customers who are already using related technologies? +##### Technographic report + +The technographic report provides a detailed view of which specific consuming +domains are using your DVP images together with other container images. This +report gives you visibility into the actual organizations adopting your +technology stack combinations, enabling targeted business development and +partnership opportunities. + To access the report: 1. Sign in to [Docker Hub](https://hub.docker.com/). @@ -170,20 +180,21 @@ To access the report: 5. Select **DATA BY WEEK** or **DATA BY MONTH** to choose the data granularity. 6. Select **Download report** for the desired week or month. -The technographic companies report is a CSV file that contains the following +The technographic report is a CSV file that contains the following data points: -| Field | Description | -| ------------------ | ---------------------------------------------------------------------------------------------- | -| `DATE_GRANULARITY` | Weekly or monthly granularity of the data. | -| `DATE_REFERENCE` | The start date of the week or month in YYYY-MM-DD format. | -| `PUBLISHER_NAME` | The name of the organization that owns the DVP repository. | -| `DOMAIN` | The company domain that pulled both your DVP image and the paired image (e.g., `example.com`). | -| `DVPP_IMAGE` | Your Docker Verified Publisher image repository name. | -| `PAIRED_IMAGE` | The other image repository that was used together with your DVP image by this company. | +| Field | Description | +| ------------------ | ---------------------------------------------------------------------------------------------------- | +| `DATE_GRANULARITY` | Weekly or monthly granularity of the data. | +| `DATE_REFERENCE` | The start date of the week or month in YYYY-MM-DD format. | +| `PUBLISHER_NAME` | The name of the organization that owns the DVP repository. | +| `DOMAIN` | The consuming domain that pulled both your DVP image and the paired image (e.g., `example.com`). | +| `DVPP_IMAGE` | Your Docker Verified Publisher image repository name. | +| `PAIRED_IMAGE` | The other image repository that was used together with your DVP image by this domain. | -Each row represents a unique combination of a company domain, your DVP image, -and another image that were used together during the specified time period. +Each row represents a unique combination of a consuming domain, your DVP +image, and another image that were used together during the specified time +period. > [!NOTE] > @@ -191,31 +202,23 @@ and another image that were used together during the specified time period. > email domains, disposable email services, and university domains. Only > business and organizational domains are included in the analysis. -#### Tracked companies report +##### Consuming domains report -The tracked companies report provides detailed insights into how specific -companies are using your Docker Verified Publisher (DVP) images. This report -helps you understand usage patterns, deployment environments, and adoption -trends across your customer base and potential prospects. - -You can use this report to answer questions like: - -- How are specific companies using my images across different environments? -- What deployment patterns do I see across local development, CI/CD, and - production? -- Which companies are heavy users of my images? -- How does usage vary by geography and cloud providers for tracked companies? +The consuming domains report provides detailed insights into how specific +consuming domains use your Docker Verified Publisher (DVP) images. This +report helps you understand usage patterns, deployment environments, and +adoption trends across your customer base and potential prospects. To access the report: 1. Sign in to [Docker Hub](https://hub.docker.com/). 2. Select **My Hub** in the top navigation. 3. Select your organization in the left navigation. -4. Select **Analytics** > **Tracked Companies** in the left navigation. +4. Select **Analytics** > **Consuming Domains** in the left navigation. 5. Select **DATA BY WEEK** or **DATA BY MONTH** to choose the data granularity. 6. Select **Download report** for the desired week or month. -The tracked companies report is a CSV file that contains the following data +The consuming domains report is a CSV file that contains the following data points: | Field | Description | @@ -223,7 +226,7 @@ points: | `DATE_GRANULARITY` | Weekly or monthly granularity of the data. | | `DATE_REFERENCE` | The start date of the week or month in YYYY-MM-DD format. | | `PUBLISHER_NAME` | The name of the organization that owns the DVP repository. | -| `DOMAIN` | The company domain (e.g., `docker.com`) associated with the image pulls. | +| `DOMAIN` | The consuming domain (e.g., `docker.com`) associated with the image pulls. | | `IP_COUNTRY` | The country code (ISO 3166-1 alpha-2) where the pull request originated from. | | `CLOUD_SERVICE_PROVIDER` | The cloud service provider used for the pull request or `no csp` for non-cloud providers. | | `USER_AGENT` | The client application or tool used to pull the image. | @@ -243,8 +246,8 @@ points: #### Benchmark report -The benchmark report shows how companies interact with the specific images you've -configured to benchmark against, such as a single repository. +The benchmark report shows how consuming domains interact with the specific +images you've configured to benchmark against, such as a single repository. The report is generated per repository, so each benchmark repository you configure produces its own report. @@ -264,11 +267,11 @@ The benchmark report is a CSV file that contains the following data points: | `DATE_GRANULARITY` | Weekly or monthly granularity of the data. | | `DATE_REFERENCE` | The start date of the week or month in YYYY-MM-DD format. | | `PUBLISHER_NAME` | The name of the organization that owns the DVP repository. | -| `DOMAIN` | The company domain associated with the pulls. | +| `DOMAIN` | The consuming domain associated with the pulls. | | `IP_COUNTRY` | The country code (ISO 3166-1 alpha-2) where the pull request originated from. | | `CLOUD_SERVICE_PROVIDER` | The cloud service provider used for the pull request, or `no csp` for non-cloud providers. | | `USER_AGENT` | The client application or tool used to pull the image. | -| `INFERRED_USE_CASE` | The inferred deployment environment, using the same rules as the [tracked companies report](#tracked-companies-report). | +| `INFERRED_USE_CASE` | The inferred deployment environment, using the same rules as the [consuming domains report](#consuming-domains-report). | | `IMAGE_REPOSITORY` | The benchmark-configured image repository that was pulled. | | `DATA_DOWNLOADS` | The number of actual image layer downloads for this combination. | | `VERSION_CHECKS` | The number of version checks (HEAD requests) performed without downloading the full image. | @@ -281,19 +284,19 @@ settings](#configure-dvp-analytics-settings). ### Configure DVP analytics settings Organization owners and editors can configure DVP analytics settings through the -Admin Console to control tracked companies and benchmark report allocations for +Admin Console to control consuming domain and benchmark report allocations for your verified publisher namespaces. 1. Sign in to [Docker Home](https://app.docker.com) and select your organization. 2. Select **Admin Console** > **Verified Publisher**. 3. Configure the settings: - - **Tracked companies**: Set the number of companies to track for reporting - purposes. This setting determines how many company domains appear in your - [Tracked companies report](#tracked-companies-report). You can only set - this number up to the maximum included in your DVP subscription. + - **Consuming domains**: Set the number of consuming domains to track for + reporting purposes. This setting determines how many domains appear in + your [Domain-level reports](#domain-level-reports). You can only set this + number up to the maximum included in your DVP subscription. - **Benchmark report allocations**: If your organization has benchmark - reports enabled, enter the number of companies to include in the benchmark - report for each namespace listed. + reports enabled, enter the number of consuming domains to include in the + benchmark report for each namespace listed. 4. Select **Save** to apply your changes. Changes to your report configuration take effect at the next reporting diff --git a/content/manuals/subscription/_index.md b/content/manuals/subscription/_index.md index a22ec41e229..b54399835c0 100644 --- a/content/manuals/subscription/_index.md +++ b/content/manuals/subscription/_index.md @@ -48,7 +48,7 @@ You can subscribe to plans for individual or organization accounts, or plans for | [Docker Hardened Images (DHI)](/manuals/subscription/plans/dhi.md) | Graduated security features for hardened container images | DHI Community, DHI Select, DHI Enterprise | | [Gordon](/manuals/subscription/plans/gordon.md) | Prepaid usage for the Gordon AI agent | Gordon Plus, Gordon Max, Gordon Ultra | | [AI Governance](/manuals/subscription/plans/ai-governance.md) | Purchase set amount of licenses | AI Governance | -| [Docker Verified Publisher (DVP)](/manuals/subscription/plans/docker-verified-publisher.md) | Annual plans based on tracked companies | DVP Starter, DVP Growth | +| [Docker Verified Publisher (DVP)](/manuals/subscription/plans/docker-verified-publisher.md) | Annual plans based on consuming domains | DVP Starter, DVP Growth | Docker plans that upgrade your account (Docker Pro or Docker Team and Business) can provide a foundation for most use cases. Some product plans may require an upgraded Docker account while other product plans let you subscribe without an upgraded account. To learn more, see [Docker plans](/manuals/subscription/plans/_index.md). @@ -62,7 +62,7 @@ Plans come with usage entitlements that can be extended without upgrading to a d | Licenses | Access to specific products or features. | AI Governance, Docker Offload | | Minutes | Cloud build capacity, sold in blocks and consumed within the billing period. | Docker Build Cloud | | Repositories | Additional container repositories covered by security scanning and analysis features. | DHI | -| Tracked companies | Additional companies tracked in publisher analytics, sold in blocks of 25. | DVP Starter, DVP Growth | +| Consuming domains | Additional consuming domains tracked in publisher analytics, sold in blocks of 25. | DVP Starter, DVP Growth | ## Manage your plans diff --git a/content/manuals/subscription/plans/docker-verified-publisher.md b/content/manuals/subscription/plans/docker-verified-publisher.md index 73862a4c920..23d524821f8 100644 --- a/content/manuals/subscription/plans/docker-verified-publisher.md +++ b/content/manuals/subscription/plans/docker-verified-publisher.md @@ -3,10 +3,10 @@ title: Docker Verified Publisher plans linkTitle: Docker Verified Publisher description: Manage DVP Starter and DVP Growth for organization accounts, - including how to apply, add tracked companies, and handle billing. + including how to apply, add consuming domains, and handle billing. keywords: - docker verified publisher, dvp, dvp starter, dvp growth, tracked - companies, publisher analytics, organization subscription, apply + docker verified publisher, dvp, dvp starter, dvp growth, consuming + domains, publisher analytics, organization subscription, apply for dvp, auto-renewal, billing portal, docker hub weight: 50 --- @@ -19,9 +19,9 @@ publisher analytics and reporting to verified publisher status. - DVP Starter includes a verified publisher badge, prioritized search ranking, [Docker Scout](/manuals/scout/_index.md) vulnerability scanning, and weekly and monthly summary reports. -- DVP Growth includes everything in DVP Starter, plus trends, tracked - companies, technographic companies, and benchmark reports, with 25 - tracked companies included. +- DVP Growth includes everything in DVP Starter, plus trends, + domain-level reports, and benchmark reports, with 25 consuming + domains included. For a plan comparison, see the [DVP landing page](https://hub.docker.com/publisher-program). @@ -37,10 +37,10 @@ namespace. If you operate multiple namespaces, each one needs its own DVP application. If you only have a Docker Personal or Docker Pro account, you can create an organization when you apply. -Tracked companies are unique company domains that pull your images. -On DVP Growth, you can add more tracked companies in increments of +Consuming domains are unique company domains that pull your images. +On DVP Growth, you can add more consuming domains in increments of 25 from the billing portal. For steps, see -[Add tracked companies](#add-tracked-companies). +[Add consuming domains](#add-consuming-domains). For details on the reports available to verified publishers, see [Insights and analytics](/manuals/docker-hub/repos/manage/trusted-content/insights-analytics.md). @@ -67,17 +67,17 @@ approves your application, complete checkout to subscribe. > Docker emails a checkout link after it approves your application. > You're charged when you complete payment. -## Add tracked companies +## Add consuming domains -On a DVP Growth plan, you can add tracked companies from the billing +On a DVP Growth plan, you can add consuming domains from the billing portal: 1. Sign in to [Docker Home](https://app.docker.com/) and go to **Billing**. 1. From **Active plans**, select **Manage** next to **Docker Verified Publisher**. -1. Select **Add tracked companies** under **Tracked companies**. -1. Select the number of tracked companies you want to add to your +1. Select **Add consuming domains** under **Consuming Domains**. +1. Select the number of consuming domains you want to add to your subscription. 1. Verify your billing details, continue to payment, and complete checkout. @@ -88,13 +88,13 @@ DVP Starter and DVP Growth are billed annually. You can upgrade from DVP Starter to DVP Growth without a new application. Upgrades take effect immediately. -On DVP Growth, tracked company add-ons are prorated from the purchase +On DVP Growth, consuming domain add-ons are prorated from the purchase date through the rest of your billing period, and they expire at the end of your annual subscription. You can reduce your add-on count at any time. Removals take effect at the end of the current billing cycle. > [!IMPORTANT] -> No mid-cycle refunds are issued when you reduce tracked company +> No mid-cycle refunds are issued when you reduce consuming domain > add-ons or end a DVP plan. ## Disable auto-renewal @@ -108,5 +108,5 @@ auto-renewal: 1. From **Active plans**, select **Manage** next to **Docker Verified Publisher**. 1. Select **Disable auto-renewal**. -1. Optional. To remove tracked companies, select **Remove tracked - companies**, then choose the number to remove. +1. Optional. To remove consuming domains, select **Remove consuming + domains**, then choose the number to remove.