Migração do DT v1.0

Como acessar arquivos

O processo de ingestão para DTv2 é semelhante ao DTv1, mas há algumas mudanças importantes que você precisa fazer durante a migração.

Processamento de arquivos

A DTv2 processa arquivos por hora (impressão, clique e rich media) e arquivos diários (atividade e tabelas de correspondência). Os arquivos por hora (o nome do arquivo contém AAAA MM DD HH) são processados no horário UTC. Os arquivos diários (o nome do arquivo contém AAAAMMDD) são processados no fuso horário local do período do relatório consulte o formato do nome do arquivo. A diferença entre o horário local e o UTC varia de acordo com sua localização.

Os arquivos também são processados de forma independente, e o tempo de processamento pode variar. É comum que um arquivo de um horário posterior termine o processamento antes de um arquivo anterior (como o horário 6 antes do horário 5). Não confie na ordem dos arquivos para o processo de ingestão. Caso contrário, ele pode ser interrompido.

Os eventos podem aparecer em arquivos processados antes ou depois em relação ao horário do evento. Os eventos nem sempre são processados na hora em que ocorreram.

Ordem da coluna

Não dependa da ordem das colunas como um mecanismo para consumir seus arquivos. Queremos que seu processamento seja resiliente a mudanças. Se você solicitar colunas extras ou se fizermos mudanças no futuro, a ordem e o número de colunas nos seus relatórios poderão mudar. Leia a linha de cabeçalho de cada arquivo e mapeie-a para os campos no data warehouse antes de tentar gravar dados.

Arquivos duplicados

Às vezes, arquivos duplicados são gravados para a mesma data e hora. Se mais de um arquivo tiver o mesmo carimbo de data/hora, use aquele com os minutos/segundos mais recentes, com base no carimbo de data/hora do nome do arquivo. Os arquivos duplicados são criados porque os processos de back-end determinaram que havia um problema com o arquivo original.

Campos

Os nomes e o formato dos campos mudaram, mas há um mapeamento de antigo para novo (quando disponível) na migração de campos do DCM, incluindo tabelas de correspondência. Se você não usa o DBM, esses campos vão estar vazios, e você pode ignorá-los.

Você também pode encontrar campos do DBM no arquivo. Se você for um usuário do DBM, esses campos só serão preenchidos quando a permissão relevante for concedida no nível do anunciante do DBM em que os anunciantes estão vinculados. Há um mapeamento do antigo para o novo (quando disponível) em Migração de campos do DBM. Os arquivos de leitura de entidades do DBM ainda serão usados para fins de mapeamento.

Nomes de bucket

Os padrões de nomenclatura para DTv1 e DTv2 são diferentes. Especificamente, não é possível mudar o prefixo no nome do bucket atual para descobrir o nome do bucket da DTv2. O nome do intervalo será fornecido pelo representante de suporte quando sua conta for configurada.

Em geral, os nomes de bucket da DTv2 são parecidos com gs://dcdt_-dcm_account1234

Para ver o conteúdo do bucket em um navegador, acesse https://cloud.google.com/console#/storage/browser/dcdt_-dcm_account1234

Formato do nome do arquivo

Cada nome de arquivo terá uma string de números, por exemplo:
dcm_account1234_impression_2016022601_20160225_234912_218211994.csv.gz
2016022601 está no formato AAAAMMDDHH. É a hora UTC dos eventos nesse arquivo (as horas são numeradas de 0 a 23).
20160225_234912 está no formato AAAAMMDD_HHMMSS. É o momento em que o relatório foi gerado.
218211994 é o ID do arquivo.

Arquivos de atividade

Você recebe um arquivo de atividade por dia, e o nome do arquivo é assim:
dcm_account1234_activity_20160727_20160728_035750_268669761.csv.gz
Esse arquivo contém dados de 27 de julho de 2016 e foi gerado às 3h57min50 de 28 de julho de 2016.

Clique em "Arquivos".

Você recebe 24 arquivos de clique por dia, e o nome do arquivo é assim:
dcm_account1234_click_2016072717_20160728_012331_268381796.csv.gz
Observe a hora UTC após a string de data no nome do arquivo. As horas são numeradas de 0 a 23. Portanto, um 17 indica que os eventos neste arquivo são das 17h às 17h59 (horário de 24 horas) ou das 17h às 18h.
Este arquivo contém dados das 17h às 18h de 27 de julho de 2016 e foi gerado às 1h23min31s de 28 de julho de 2016.

Arquivos de impressão

Você recebe 24 arquivos de impressão por dia, e o nome do arquivo é assim:
dcm_account7312_impression_2016072717_20160728_012355_268381795.csv.gz
Além do nome, o comportamento é o mesmo dos arquivos de clique.

Arquivos de tabela de correspondências

Os arquivos da tabela de correspondência são gerados uma vez por dia, e os nomes de arquivo são assim:
dcm_account1234_match_table_activity_cats_20160727_20160728_032226_268648829.csv.gz
Esse arquivo contém dados de 27 de julho de 2016 e foi gerado às 3h22min26 de 28 de julho de 2016.
Observação: para algumas tabelas de correspondência novas, os dados são estáticos e nenhum arquivo diário para download é produzido. Você pode acessar os dados desses arquivos nas páginas de referência, por exemplo, Tipos de eventos padrão de rich media.

Campos da Transferência de dados

1.0 nome do campo Nome do campo DT v2.0
Tempo Descontinuado
User-ID ID do usuário
Advertiser-ID ID do anunciante
Buy-ID Descontinuado
Order-ID ID da campanha
ID do anúncio ID do anúncio
Creative-ID ID de renderização
Creative-Version Versão do anúncio
Creative-Size-ID Suspenso (recuperado da tabela de correspondência como tamanho do criativo em pixels)
Site-ID Código do site (DCM)
Page-ID ID da posição
Palavra-chave Descontinuado
Country-ID Código do país
Estado/Província Estado/região
Areacode Descontinuado
User-ID do navegador Código da plataforma/navegador
Browser-Version Versão de navegador/plataforma
OS-ID Código do sistema operacional
DMA-ID Código da área de mercado designada (AMD)
City-ID ID da cidade
Código postal CEP
Time-UTC-Sec Descontinuado
Local-User-ID Descontinuado
Activity-Type Descontinuado (recuperado da tabela de correspondência "activity_cats")
Activity-Sub-Type Descontinuado (recuperado da tabela de correspondência "activity_cats")
Other-Data Outros dados
Ordinal Valor ORD
Tempo do clique Tempo de interação
Event-ID ID de conversão
SV1 Valor de segmento 1
PartnerID1 ID do parceiro 1
PartnerID2 ID do parceiro 2
Quantidade Conversões totais
Receita Receita total

Fazer a correspondência de nomes de arquivos de tabela de correspondências

1.0 nome do arquivo Nome do arquivo 2.0
activity_cat activity_cats
activity_type activity_types
ad ads
ad_page_assignments ad_placement_assignments
advertiser advertisers
browser browsers
campaign campaigns
cities cities
countries countries
creative creatives
creative_ad_assignments creative_ad_assignments
custom_creative_fields custom_creative_fields
dartsearch paid_search
designated_market_area designated_market_areas
keyval keyword_values
met_event rich_media_events
operating_system operating_systems
page placements
page_cost/page_flight_cost placement_cost
site sites
states states
user-defined_spot_vars custom_floodlight_variables

Campos da tabela de correspondências

activity_cats

1.0 nome do campo Nome do campo 2.0 Tipo
Spot-ID Floodlight Configuration número inteiro
Activity-Type-ID Activity Group ID número inteiro
Activity-Type Activity Type string
Activity-ID Activity ID integer
Activity Sub-Type Activity Sub-Type string
Report-Name Activity string
Tag-Method-ID Tag Counting Method ID número inteiro

activity_types

1.0 nome do campo Nome do campo 2.0 Tipo
Spot-ID Floodlight Configuration número inteiro
Activity-Group-ID Activity Group ID número inteiro
Activity-Type Activity Type string
Report-Name Activity Group string

anúncios

1.0 nome do campo Nome do campo 2.0 Tipo
Advertiser-ID Advertiser ID número inteiro
Buy-ID Campaign ID número inteiro
Ad-ID Ad ID número inteiro
Ad-Description Ad string
Click-URL Ad Click URL string
Ad-Type Ad Type string
Creative-Size-ID Creative Pixel Size string
Ad-Comments Ad Comments string

ad_placement_assignments

1.0 nome do campo Nome do campo 2.0 Tipo
Ad-ID Ad ID número inteiro
Page-ID Placement ID número inteiro

anunciantes

1.0 nome do campo Nome do campo 2.0 Tipo
Spot-ID Floodlight Configuration número inteiro
Advertiser-ID Advertiser ID número inteiro
Advertiser Advertiser string
Advertiser-Group-ID Advertiser Group ID integer
Advertiser-Group Advertiser Group string

navegadores

1.0 nome do campo Nome do campo 2.0 Tipo
Browser-ID Browser/Platform ID número inteiro
Browser Browswer/Platform string

de campanhas

1.0 nome do campo Nome do campo 2.0 Tipo
Advertiser-ID Advertiser ID número inteiro

Order-ID (antes Buy-ID )

Campaign ID número inteiro
Order (anteriormente Buy) Campaign string
Start-Date Campaign Start Date data
End-Date Campaign End Date data
Billing-Invoice-Code Billing Invoice Code string

cidades

1.0 nome do campo Nome do campo 2.0 Tipo
City-ID City ID número inteiro
City City string
Creative-Library-Enabled Deprecated (now always 1) número inteiro

países

1.0 nome do campo Nome do campo 2.0 Tipo
Country-ID Deprecated número inteiro
Country Deprecated string

creatives

1.0 nome do campo Nome do campo 2.0 Tipo
Advertiser-ID Advertiser ID número inteiro
Rendering-ID Rendering ID número inteiro
UI-Creative-ID descontinuado número inteiro
Creative Creative string
Last-Modified-Date Creative Last Modified Date data
Creative-Type Creative Type string
Creative-Sub-Type Deprecated string
Creative-Size-ID Creative Pixel Size string
Image-URL Creative Image URL string
Creative-Version Creative Version integer

creative_ad_assignments

1.0 nome do campo Nome do campo 2.0 Tipo
Ad-ID Ad ID número inteiro
Creative-ID Creative ID número inteiro
Start-Date Creative Start Date data
End-Date Creative End Date data
Rotation-Type Creative Rotation Type string
Creative-Group-1 Creative Groups 1 string
Creative-Group-2 Creative Groups 2 string
Click-URL Ad Click URL string

custom_creative_fields

1.0 nome do campo Nome do campo 2.0 Tipo
Advertiser-ID Advertiser ID número inteiro
Creative-ID Creative ID número inteiro
Custom-Field-Number Creative Custom Field Number número inteiro
Custom-Field-Name Creative Custom Field Name string
Custom-Field-Value Creative Custom Field Value string

custom_rich_media

1.0 nome do campo Nome do campo 2.0 Tipo
Advertiser-ID Advertiser ID número inteiro
Met-Event-ID Rich Media Event ID número inteiro
Met-Event-Name Rich Media Event string
Met-Event-Type-ID Rich Media Event Type ID integer
Met-Event-Type-Name Rich Media Event Type string

designated_market_areas

1.0 nome do campo Nome do campo 2.0 Tipo
DMA-ID Designated Market Area (DMA) ID número inteiro
DMA Designated Market Area string

keyword_values

1.0 nome do campo Nome do campo 2.0 Tipo
Ad-ID Ad ID número inteiro
Keyword-Expression Keyword string
1.0 nome do campo Nome do campo 2.0 Tipo
Ad-ID Ad ID número inteiro
Advertiser-ID Advertiser ID número inteiro
Buy-ID Campaign ID número inteiro
DS-Ad-ID Paid Search Ad ID número inteiro
Extended-Keyword-ID Paid Search Keyword ID número inteiro
Keyword-ID Paid Search Legacy Keyword ID número inteiro
DS-Campaign-Name Paid Search Campaign string
KW-Ad-Group-Name Paid Search Ad Group string
Bid-Strategy-Name Paid Search Bid Strategy string
Landing-Page-URL Paid Search Landing Page URL string
Keyword-Name Paid Search Keyword string
Match-Type Paid Search Match Type string

operating_systems

1.0 nome do campo Nome do campo 2.0 Tipo
OS-ID Operating System ID número inteiro
OS Operating System string

posicionamentos

1.0 nome do campo Nome do campo 2.0 Tipo
Buy-ID Campaign ID número inteiro
Site-ID Site ID (DCM) número inteiro
Page-ID Placement ID número inteiro
Page Site keyname string
Site-Placement Placement string
Content-Category Content Category string
Strategy Placement Strategy string
Start-Date Placement Start Date data
End-Date Placement End Date data
Group-Type Tipo de grupo de posições string
Group-Parent-ID Código do pacote/roadblock número inteiro
Price-Type Placement Cost Structure string
Cap-Cost Placement Cap Cost Option float
CPA-Activity-ID Activity ID número inteiro

placement_cost

1.0 nome do campo Nome do campo 2.0 Tipo
Page-ID Placement ID número inteiro
Effective-Date Placement Start Date data
End-Date Placement End Date data
Units Placement Total Booked Units número inteiro
Rate Placement Rate float
Comments Placement Comments string

sites

1.0 nome do campo Nome do campo 2.0 Tipo
Site-ID Site ID (DCM) número inteiro
Site Site (DCM) string
Directory-Site-ID Site ID (Site Directory) integer
Directory-Site Site (Site Directory) string

estados

1.0 nome do campo Nome do campo 2.0 Tipo
State/Province State/Region string
State/Province Name State/Region Full Name string

custom_floodlight_variables

1.0 nome do campo Nome do campo 2.0 Tipo
Spot-ID Floodlight Configuration ID número inteiro
Variable-ID Floodlight Variable ID string
Variable-Name Floodlight Variable Name string