DocumentaçãoExperience PlatformGuia dos conectores de origem

[Beta]{class="badge informative"}

Pinterest Ads

Última atualização: 2 de outubro de 2026

Criado para:

  • Desenvolvedor
NOTE
A origem Pinterest Ads está na versão beta. Leia a Visão geral das fontes para conhecer os termos e condições.
IMPORTANT
A origem Pinterest Ads está disponível como parte da SKU Customer Journey Analytics.

Use a fonte Pinterest Ads para conectar suas contas de publicidade e assimilar metadados de mídia paga e métricas de desempenho. Adobe Experience Platform publica esses dados em conjuntos de dados de mídia paga. Use esses conjuntos de dados no Adobe Customer Journey Analytics para analisar suas campanhas de marketing.

Para conectar sua conta, entre no Pinterest e autorize o Experience Platform a acessar seus dados de publicidade. Não é necessário gerar ou inserir credenciais de API manualmente.

Como a assimilação funciona how-it-works

Depois de criar um fluxo de dados e selecionar suas contas de anúncio, o Experience Platform provisiona automaticamente a assimilação de conjuntos de dados e agendamentos.

Processo
Comportamento
Provisionamento do conjunto de dados
Reutiliza conjuntos de dados de mídia paga existentes na organização e os cria se não existirem.
Preenchimento retroativo inicial
É executado 30 minutos após a criação do fluxo de dados e recupera metadados e métricas dos últimos 30 dias.
Assimilação diária
É executado uma vez por dia, iniciando no dia seguinte à criação do fluxo de dados, e recupera metadados e métricas do dia anterior.
Reexpressão
É executado três vezes para cada execução diária de assimilação: um, dois e três dias após essa execução.

A reexpressão recupera dados históricos atualizados para levar em conta as alterações nas métricas relatadas anteriormente. Você não configura as programações de preenchimento retroativo, assimilação diária ou reexpressão sozinho.

Pré-requisitos da conta prerequisites

Antes de conectar sua conta, verifique se você tem o seguinte:

  • Uma conta de anúncio Pinterest existente.
  • Campanhas e anúncios já configurados nessa conta de publicidade.
  • Acesse para entrar no Pinterest e autorizar o Experience Platform a acessar as contas de anúncio que você selecionar.

Configuração automática do conjunto de dados schema-and-dataset-provisioning

O conector atribui conjuntos de dados, esquemas e mapeamentos de campo automaticamente. Você não cria um esquema de destino, seleciona um conjunto de dados de destino ou mapeia campos durante a criação do fluxo de dados.

Os tipos de entidade mapeados são conta, campanha, grupo de anúncios, anúncio, ativo, experiência e métricas de resumo. Assets representa Pinterest Pins. Os registros de experiência combinam informações de Pins e anúncios em vez de uma API de experiência separada.

Mapeamentos de campo XDM pinterest-fields

Use as tabelas a seguir para entender os campos principais mapeados para esquemas do Experience Data Model (XDM). O conector mapeia paidMedia.adNetwork a pinterest.

Campos de conta account-fields

O esquema de conta armazena a identidade e os detalhes da conta do anúncio.

Campo do Pinterest
Campo XDM
Descrição
id
paidMedia.accountID
O identificador da conta do anúncio.
name
paidMedia.accountDetails.accountName
O nome da conta do anúncio.
country
paidMedia.accountDetails.country
O código do país.
currency
paidMedia.accountDetails.currency
O código da moeda.
permissions
paidMedia.accountDetails.permissions
Uma matriz de permissões de conta.
time_zone
paidMedia.accountDetails.timezone
O fuso horário da conta de publicidade.
created_time
paidMedia.metadata.createdTime
O carimbo de data e hora de criação, convertido em ISO 8601.
updated_time
paidMedia.metadata.updatedTime
O carimbo de data e hora da modificação, convertido em ISO 8601.

Campos de campanha campaign-fields

O schema de campanha armazena a identidade, o status e os relacionamentos da campanha para contas de anúncios.

Campo do Pinterest
Campo XDM
Descrição
id
paidMedia.campaignID
O identificador da campanha.
ad_account_id
paidMedia.accountID
O identificador da conta do anúncio principal.
name
paidMedia.metadata.name
O nome da campanha.
status
paidMedia.metadata.status
O status normalizado da campanha.
summary_status
paidMedia.metadata.servingStatus
O status do delivery normalizado.
created_time
paidMedia.metadata.createdTime
O carimbo de data e hora de criação, convertido em ISO 8601.
updated_time
paidMedia.metadata.updatedTime
O carimbo de data e hora da modificação, convertido em ISO 8601.

Para campanhas, grupos de anúncios e anúncios, o conector normaliza ACTIVE, PAUSED, ARCHIVED e DRAFT para valores de status em minúsculas. Mapeia DELETED_DRAFT a deleted.

Campos de grupo de anúncios ad-group-fields

O esquema de grupo de anúncios armazena a identidade do grupo de anúncios e os relacionamentos com campanhas e contas.

Campo do Pinterest
Campo XDM
Descrição
id
paidMedia.adGroupID
O identificador do grupo de publicidade.
ad_account_id
paidMedia.accountID
O identificador da conta do anúncio principal.
campaign_id
paidMedia.campaignID
O identificador da campanha principal.
name
paidMedia.metadata.name
O nome do grupo de anúncios.
status
paidMedia.metadata.status
O status do grupo de anúncios normalizado.
summary_status
paidMedia.metadata.servingStatus
O status do delivery normalizado.

Campos de publicidade ad-fields

O esquema de publicidade armazena a identidade do anúncio, o status da análise e os relacionamentos com outras entidades de mídia paga.

Campo do Pinterest
Campo XDM
Descrição
id
paidMedia.adID
O identificador do anúncio.
ad_group_id
paidMedia.adGroupID
O identificador do grupo de anúncios principal.
campaign_id
paidMedia.campaignID
O identificador da campanha principal.
ad_account_id
paidMedia.accountID
O identificador da conta do anúncio principal.
pin_id
paidMedia.assetID
O identificador PIN relacionado.
name
paidMedia.metadata.name
O nome do anúncio.
status
paidMedia.metadata.status
O status do anúncio normalizado.
review_status
adDetails.reviewStatus
O status da revisão, como pending, rejected, approved ou not_reviewed.

Os títulos e descrições do Creative vêm do Pin relacionado, em vez do objeto de anúncio.

Campos de ativos asset-fields

O esquema de ativo armazena as propriedades de conteúdo e mídia do Pin. Os mapeamentos a seguir descrevem Pins com uma única imagem ou vídeo.

Campo do Pinterest
Campo XDM
Descrição
id
paidMedia.assetID
O identificador do PIN.
title
assetDetails.title
O título do PIN.
description
assetDetails.description
A descrição do PIN.
media.media_type
assetDetails.assetType
O tipo de ativo, como image ou video.
media.images["1200x"].url
assetDetails.mediaProperties.url
O maior URL de imagem disponível.
media.images["150x150"].url
assetDetails.mediaProperties.thumbnailURL
O URL da miniatura da imagem.
media.video_url
assetDetails.mediaProperties.url
O URL do vídeo para um Pin de vídeo.
media.cover_image_url
assetDetails.mediaProperties.thumbnailURL
O URL da imagem da capa de um Pin de vídeo.
media.duration
assetDetails.videoProperties.duration
A duração do vídeo, fornecida por Pinterest em milissegundos.

Para Pins com várias imagens, vídeos ou mídia mista, cada item se torna um registro de ativo separado. O conector gera um identificador de ativo usando {pin_id}_{index}, onde index é a posição do item começando de zero. Esses ativos usam o tipo de ativo carousel_card.

Campos de experiência experience-fields

Os registros de experiência descrevem a experiência criativa derivada do PIN e do anúncio. O identificador de experiência usa o identificador de PIN.

Tipo de criação do Pinterest
Tipo de experiência XDM
REGULAR
single_image
VIDEO, MAX_VIDEO, CTV_VIDEO
single_video
CAROUSEL
carousel
COLLECTION, MAX_WIDTH_REGULAR_COLLECTION, MAX_WIDTH_VIDEO_COLLECTION
collection
IDEA, SHOWCASE
instant_experience
QUIZ, SHOPPING, COLLAGE, APP
other

Para Pins com vários itens de mídia, o conector preenche experienceDetails.carouselProperties.cards[] com uma entrada por item. Cada cartão faz referência ao identificador de ativo gerado.

Campos de métricas de resumo summary-metrics-fields

As métricas de resumo armazenam dados de desempenho de publicidade. O conector mapeia as métricas de anúncio e de ativo da análise de anúncio, usando PIN_ID como a chave de agrupamento de ativo.

Campo do Pinterest
Campo XDM
Descrição
SPEND_IN_MICRO_DOLLAR, SPEND_IN_DOLLAR
metrics.spend
Gastos com Advertising.
PAID_IMPRESSION, TOTAL_IMPRESSION
metrics.impressions
Contagem de impressões.
TOTAL_CLICKTHROUGH, CLICKTHROUGH_1, CLICKTHROUGH_2
metrics.clicks
Clique em count.
CTR, ECTR, CTR_2
metrics.ctr
Taxa de cliques.
TOTAL_ENGAGEMENT, ENGAGEMENT_1, ENGAGEMENT_2
metrics.engagements
Contagem de engajamento.
TOTAL_CONVERSIONS
metrics.conversions
Contagem de conversões.
CHECKOUT_ROAS
metrics.roas
Retorno do investimento em publicidade para conversões de check-out.
TOTAL_VIDEO_MRC_VIEWS, VIDEO_MRC_VIEWS_1, VIDEO_MRC_VIEWS_2
metrics.videoViews
Contagem de visualizações de vídeo.
TOTAL_VIDEO_P100_COMPLETE, VIDEO_P100_COMPLETE_2
metrics.videoCompletions
Contagem de visualizações de vídeo concluída.

Os mapeamentos adicionais incluem métricas de custo, conversão, vídeo, atribuição e envolvimento.

As métricas de resumo da experiência incluem detalhamentos de dispositivo e posicionamento da análise de direcionamento de anúncios. O conector solicita APPTYPE para detalhamentos de dispositivo e PLACEMENT para detalhamentos de posicionamento. Outros detalhamentos de direcionamento não são solicitados.

Conectar sua conta connect-to-platform

Para criar um fluxo de dados, siga o tutorial da interface do usuário do Pinterest Ads.

Use a documentação da API do Pinterest para obter informações sobre as APIs de anúncio subjacentes.

recommendation-more-help
experience-platform-help-sources