Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Insights conectados de produtos e mídias cruzadas
Esta página descreve as configurações necessárias para usar o acelerador Cross Media & Product Connected Insights (Cross Media) do Cortex Framework Data Foundation.
Com esse acelerador de mídia cruzada, a Cortex Framework Data Foundation é enriquecida com um conjunto inicial de KPIs para entender a eficácia das campanhas de marketing veiculadas em plataformas de mídia, como o Google Ads, o YouTube (com o DV360), o Meta e o TikTok, para a performance de vendas de produtos e categorias.
O diagrama a seguir descreve como os insights de mídia cruzada estão disponíveis nas
cargas de trabalho de marketing do Cortex Framework Data Foundation:
Figura 1. Arquitetura cross media.
Arquivo de configuração
O arquivo config.json configura as configurações necessárias para se conectar a fontes de dados para transferir dados de várias cargas de trabalho. Esse arquivo contém os seguintes
parâmetros para Cross Media:
A tabela a seguir descreve o valor de cada parâmetro:
Parâmetro
Significado
Valor padrão
k9.deployCrossMedia
Se a mídia cruzada será implantada. É necessário implantar pelo menos um dos serviços do Google Ads, do YouTube (com o DV360), do Meta ou do TikTok. Caso contrário, a implantação vai falhar.
False
k9.CrossMedia.productHierarchyType
Quais das hierarquias de produtos usar na dimensão do produto. Depende
dos dados reais. Defina esse valor como o mesmo valor de
productHierarchyType para a dimensão "Hierarquia de produtos".
SAP
k9.CrossMedia.maxProductHierarchyMatchLevel
Limita o nível da hierarquia de produtos para correspondência. Empresas
com muitos SKUs podem ter hierarquias muito profundas com especificações de
embalagens (por exemplo, Coca-Cola em garrafas de vidro ou latas, embaladas individualmente ou
em lotes). Alguns sistemas, como o SAP, têm um limite de profundidade
que você pode alcançar.
9
k9.CrossMedia.targetCurrencies
Moedas de destino usadas para relatórios e BI. Todas as moedas de origem serão convertidas para essas moedas.
["USD"]
k9.CrossMedia.additionalPrompt
Opcional: transmita outras instruções ao modelo de LLM.
k9.CrossMedia.lookbackWindowDays
Quantidade de dias de lookback ao fazer a atualização incremental
7
VertexAI.region
Região da Vertex AI (considerando o projeto de origem para a API Vertex AI). Ele precisa estar em colocalização com o BigQuery e
não pode ser uma multirregião. Se o BigQuery estiver em uma multirregião,
qualquer região da mesma multirregião será aceita
us-central1 (que corresponde ao local padrão do BigQuery, us)
VertexAI.processingDataset
O conjunto de dados do BigQuery para jobs da Vertex AI precisa estar
no local VertexAI.region e não em uma multirregião.
CORTEX_VERTEX_AI_PROCESSING
Modelo de dados
Esta seção descreve o modelo de dados de insights conectados de produtos e mídias cruzadas
usando o diagrama de relacionamento de entidades (ERD, na sigla em inglês).
Figura 2. Insights de cross media e produto conectados: diagrama de relacionamento de entidades.
Implantação de cross media
Crie um conjunto de dados do BigQuery no projeto de origem para
processamento da Vertex AI.
Configure uma ou mais das seguintes fontes de dados de marketing para implantação,
seguindo os próprios guias:
Defina k9.CrossMedia.productHierarchyType como o mesmo valor de
dataSourceType na etapa anterior.
Na seção VertexAI, defina o conjunto de dados como o que você criou na etapa 1.
region precisa corresponder ao local do conjunto de dados de processamento da Vertex AI.
Ajuste outras configurações conforme necessário. Em seguida, está tudo pronto para iniciar a
implantação.
Carregue dados nas tabelas de conversão de moeda e
hierarquia de produtos.
Execute os DAGs cross_media. Há duas variações: "Atualização completa" ou "
Atualização incremental". Use a que for mais adequada ao seu caso de uso.
Problemas conhecidos
Se a tabela "Conversão de moeda" não for preenchida, a coluna TotalCostInTargetCurrency da tabela de saída final vai ficar vazia para todas as linhas. Nesse caso, ainda é possível usar a coluna TotalCostInSourceCurrency para informar os custos na moeda de origem.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-04 UTC."],[[["\u003cp\u003eThis page outlines the configuration process for the Cross Media & Product Connected Insights accelerator within the Cortex Framework Data Foundation.\u003c/p\u003e\n"],["\u003cp\u003eThe Cross Media accelerator provides KPIs for analyzing marketing campaign effectiveness across platforms like Google Ads, YouTube (DV360), Meta, and TikTok, relating them to product sales.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration involves setting parameters in the \u003ccode\u003econfig.json\u003c/code\u003e file, including product hierarchy, target currencies, and lookback window, as well as ensuring that the region and processing dataset for Vertex AI are correct.\u003c/p\u003e\n"],["\u003cp\u003eDeployment requires configuring at least one marketing data source (Google Ads, YouTube, Meta, or TikTok), enabling Common Dimensions (Country, Product, Currency Conversion), and running the \u003ccode\u003ecross_media\u003c/code\u003e DAGs.\u003c/p\u003e\n"],["\u003cp\u003eIf the Currency Conversion table is not populated, reporting on cost in target currencies will not be possible, but reporting on cost in source currencies is still possible.\u003c/p\u003e\n"]]],[],null,["# Cross Media & Product Connected Insights\n\nCross Media \\& Product Connected Insights\n=========================================\n\nThis page describes the required configurations to utilize Cross Media \\&\nProduct Connected Insights (Cross Media) accelerator of\nCortex Framework Data Foundation.\n\nWith this Cross Media accelerator, Cortex Framework Data\nFoundation is enriched with an initial set of KPIs to understand the\neffectiveness of marketing campaigns running across media platforms such as\nGoogle Ads, YouTube (with DV360), Meta, and TikTok for product\nand product category sales performance.\n\nThe following diagram describes how Cross Media insights are available through\nthe marketing workloads of Cortex Framework Data Foundation:\n\n**Figure 1**. Cross media architecture.\n\n### Configuration file\n\nThe [config.json](https://github.com/GoogleCloudPlatform/cortex-data-foundation/blob/main/config/config.json) file configures the settings required to connect to data sources for\ntransferring data from various workloads. This file contains the following\nparameters for Cross Media: \n\n \"k9\": {\n \"datasets\": {... },\n \"crossMedia\": {\n \"productHierarchyType\": \"\",\n \"maxProductHierarchyMatchLevel\": 9,\n \"targetCurrencies\": [\"USD\"],\n \"additionalPrompt\": \"\",\n \"lookbackWindowDays\": 7\n }\n },\n \"VertexAI\": {\n \"region\": \"us-central1\",\n \"processingDataset\": \"CORTEX_VERTEX_AI_PROCESSING\"\n },\n ...\n\nThe following table describes the value for each parameter:\n\n### Data Model\n\nThis section describes the Cross Media \\& Product Connected Insights Data Model\nusing the Entity Relationship Diagram (ERD).\n\n[](/static/cortex/docs/images/erd_cross_media.png)\n**Figure 2**. Cross Media \\& Product Connected Insights: Entity Relationship Diagram.\n\n### Deploying Cross Media\n\n1. Create a BigQuery dataset in the source project for\n Vertex AI processing.\n\n | **Note:** The location of this dataset should be in the same general region as your datasets, but it can't be in a multi-region. For example, if your other datasets are in `us` then this dataset can be in `us-central1`, but not `us`.\n2. Configure one or more of the following Marketing data sources for deployment,\n following their own guides:\n\n 1. [Google Ads](/cortex/docs/marketing-googleads)\n 2. [Meta](/cortex/docs/meta)\n 3. [Youtube (with DV360)](/cortex/docs/marketing-gdv360)\n 4. [TikTok](/cortex/docs/marketing-tiktok)\n3. Enable and configure required [Common Dimensions](/cortex/optional-step-common-dimensions):\n\n 1. Country Dimension\n 2. Product Dimension\n 3. Currency Conversion\n4. Configure Cross Media settings:\n\n 1. Set `k9.deployCrossMedia` to `True`.\n 2. Set `k9.CrossMedia.productHierarchyType` to the same value as `dataSourceType` in the previous step.\n 3. In `VertexAI` section, set the dataset to the one you created in step 1, and `region` should match where the Vertex AI processing dataset is.\n5. Adjust any other settings as necessary. Then you are ready to start the\n deployment.\n\n### Running the DAGs\n\n1. Set up [Cloud Composer Airflow environment](/composer/docs/composer-3/composer-overview) as required. Make sure the `k9_reporting` connection is [configured](/cortex/docs/gathering-settings) correctly.\n2. [Load data](/cortex/optional-step-common-dimensions) into Currency Conversion and Product Hierarchy tables.\n3. Run the `cross_media` DAGs. There are two flavors: \"Full refresh\" or \" Incremental refresh\". Use whichever that fits your use case.\n\n### Known issues\n\nIf the Currency Conversion table is not populated, `TotalCostInTargetCurrency`\ncolumn of the final output table will be empty for all rows. In this case you\ncan still use `TotalCostInSourceCurrency` column to report on costs in\nsource currency.\n\nWhat's next?\n------------\n\n- For more information about other data sources and workloads, see [Data sources and workloads](/cortex/docs/data-sources-and-workloads).\n- For more information about the steps for deployment in production environments, see [Cortex Framework Data Foundation deployment prerequisites](/cortex/docs/deployment-prerequisites)."]]