For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ative e visualize feeds de dados

Faça o curso PXA

Atualização da versão: A versão mais recente do feed de ações é Versão 5 (V5). Se você estiver usando uma versão mais antiga, veja a seção de atualização para aprender como atualizar.

Os Data Feeds são arquivos automatizados e agendados que podem reportar vários dados diferentes da sua campanha. O recurso principal é o Feed de ações, que informa tanto novas ações quanto quaisquer atualizações nas ações existentes.

Um Feed de ações pode ser personalizado em termos de frequência de entrega, formato de dados e método de entrega.

Ativar o feed de ações

  1. Na barra de navegação superior, selecione [Perfil do usuário] → Configurações.

  2. Na coluna da esquerda, role até Técnico seção.

  3. Selecione Feeds de dados.

  4. No lado direito da tela, selecione [Editar].

  5. Selecione [Ativar] para ativar o feed de ações.

A partir daqui, você pode personalizar os detalhes do seu feed de ações.

Frequência

Escolha a frequência com que você deseja receber o feed, de hora em hora até mensalmente.

Formato de dados

Isso determina o tipo de arquivo do feed de ações:

• XML entrega os dados em um arquivo de Extensible Markup Language (XML).

• TAB entrega os dados em um arquivo .txt com itens separados por tabulações.

• PIPE entrega os dados em um arquivo .txt com itens separados por barras verticais (

Método de entrega

Escolha seu método de entrega preferido: FTP da impact.com (ou seja, você baixa seu feed de ações de nossos servidores FTP), FTP do parceiro (ou seja, enviamos o arquivo do feed de ações para o seu servidor FTP) ou e-mail (ou seja, enviamos este arquivo como anexo para um endereço de e-mail).

Personalizar o feed de ações

Depois que o feed de ações estiver ativado, você sempre poderá desativá-lo ou alterar detalhes sobre ele — como a frequência, o formato de dados e muito mais.

  1. Na barra de navegação superior, selecione [Perfil do usuário] → Configurações.

  2. Na coluna da esquerda, role até Técnico seção.

  3. Selecione Notificações de evento.

  4. Na parte superior da tela, selecione o Feeds de dados aba.

  5. No lado direito da tela, selecione [Editar].

Consulte a lista de descrições na seção anterior para obter detalhes sobre cada configuração.

Entenda o arquivo do feed de ações

O arquivo do feed de ações pode ser lido usando um editor de texto simples ou importado para uma planilha.

Consulte a tabela abaixo como referência dos cabeçalhos de Feed de ações Versão 5 (V5).

Referência de cabeçalhos do Feed de ações V5

Campo

Formato

Descrição

AdvertiserId

Inteiro

O ID exclusivo da conta do anunciante à qual a ação foi registrada.

CampaignId

Inteiro

O ID exclusivo da campanha à qual a ação corresponde.

CampaignName

String

O nome da campanha à qual a ação corresponde.

ActionTrackerId

Inteiro

O ID exclusivo do rastreador de ações ao qual a ação corresponde.

ActionTrackerName

String

O nome do rastreador de ações ao qual a ação corresponde.

TemplateTermName

String

O nome do termo do modelo ao qual a ação corresponde.

MediaPartnerId

Inteiro

O ID exclusivo do parceiro de mídia ao qual a ação foi creditada.

MediaPartnerName

String

O nome do parceiro de mídia ao qual a ação foi creditada.

ActionId

String

O ID exclusivo que a impact.com atribuiu à ação.

Status

String

Importante: Este é um campo obsoleto e não está disponível na versão mais recente do Feed de ações (versão 4).

Uma ação pode ter um dos status abaixo:

Padrão: O status da ação quando ela é criada pela primeira vez. Se nenhuma alteração for feita na ação, então este permanecerá como o status.

Aprovada: O anunciante decidiu que esta era uma ação válida, mas ainda pode fazer uma alteração antes da data de bloqueio.

Rejeitada: O anunciante decidiu que esta era uma ação inválida, portanto o parceiro de mídia não deve receber pagamento.

Modificado: O anunciante decidiu que parte da ação era inválida (por exemplo, o cliente devolveu um item do pedido), então o pagamento foi reduzido.

Observação: Todas as ações com um acima do limite status podem ser aprovadas manualmente pelo anunciante.

Acima do limite - limite de dias úteis: A ação ocorreu depois que o limite de dias úteis já havia sido atingido.

Acima do limite - limite de fim de semana: A ação ocorreu depois que o limite de fim de semana já havia sido atingido.

Acima do limite - orçamento: A ação ocorreu depois que o orçamento especificado na ordem de inserção já havia sido atingido.

Acima do limite - limite de ações: A ação ocorreu depois que o número máximo de ações especificado na ordem de inserção já havia sido atingido.

Acima do limite - IO expirada: A ação ocorreu depois que a ordem de inserção foi encerrada ou expirou.

Acima do limite - chamadas simultâneas: A ação ocorreu depois que o número de chamadas simultâneas especificado na ordem de inserção já havia sido atingido.

Status

String

Este valor é um status que indica a resposta do anunciante à ação, com um dos seguintes valores: "APPROVED", "PENDING" ou "REVERSED". Este valor não pode ser alterado após a data de bloqueio da ação.

ModificationReason

String

Importante: este é um campo obsoleto e não está disponível na versão mais recente do Feed de ações (versão 4).

AdId

Inteiro

O ID exclusivo do anúncio com o qual o consumidor interagiu para iniciar a ação.

ClientCost

Decimal (8,2)

O "custo" líquido da ação para o anunciante.

Pagamento

Decimal (8,2)

O pagamento a ser recebido pelo parceiro de mídia. Para ações modificadas, este é o pagamento líquido. Para ações acima do limite, o pagamento é de US$ 0,00.

Delta de pagamento

Decimal (8,2)

A mudança no pagamento em relação ao estado anterior. Por exemplo, se o anunciante modificou a ação como resultado de uma devolução do cliente, este valor representa o ajuste negativo no pagamento. Se a ação não tiver sido modificada, este será o mesmo valor que Payout.

Pagamento pretendido

Decimal (8,2)

O pagamento da ação antes de ser modificada. Se a ação não tiver sido modificada, este será o mesmo valor que Payout.

Amount

Decimal (8,2)

O valor da venda, ou receita, da ação. Este valor só é relevante para eventos de pagamento por venda.

Delta de valor

Decimal (8,2)

A mudança no valor da venda, caso a ação tenha sido modificada. Se a ação não tiver sido modificada, este será o mesmo valor que Amount.

Valor pretendido

Decimal (8,2)

O valor da venda antes de a ação ser modificada. Se a ação não tiver sido modificada, este será o mesmo valor que Amount.

Moeda

String (3)

O código da moeda com a qual a ação foi enviada (a moeda nas configurações do anunciante é o padrão se o valor do código da moeda não for enviado).

OriginalCurrency

String (3)

O código da moeda original detectado com a ação.

ReferringDate

Carimbo de data e hora, ISO 8601

A data e a hora da referência associada à ação. Isso será igual ao EventDate para ações agrupadas sem um ClickId.

EventDate

Carimbo de data e hora, ISO 8601

A data e a hora em que o evento ocorreu.

CreationDate

Carimbo de data e hora, ISO 8601

A data e a hora em que a ação foi processada e criada no sistema da impact.com.

LockingDate

Carimbo de data e hora, ISO 8601

A data em que a ação é bloqueada. Após essa data, a ação não pode ser modificada pelo anunciante e se torna pagável ao parceiro de mídia.

ClearedDate

Carimbo de data e hora, ISO 8601

Se o parceiro de mídia já tiver sido pago por esta ação, esta é a data e a hora em que os fundos foram transferidos para a conta dele.

ReferringType

String

O tipo de referência correspondente a esta ação. Por exemplo, ‘CLICK_COOKIE’ para uma referência de clique, ou ‘REPORTED_PARTNER_ID’ se a ação foi agrupada com um ID de parceiro de mídia.

ReferringDomain

String

A URL de onde veio a referência de clique.

IpAddress

String

O endereço IP do cliente.

PromoCode

String (64)

O código promocional enviado com a ação, se houver.

Oid

String (64)

O ID exclusivo e rastreável do pedido da ação.

CustomerId

String (50)

O ID do cliente enviado com a ação.

CustomerPostCode

Numérico

O código postal do cliente, se tiver sido enviado com a ação.

CustomerStatus

String (40)

O status do cliente (Novo ou Recorrente), se tiver sido enviado com a ação.

Observação

String (255)

Uma nota pode incluir qualquer informação adicional que o anunciante queira incluir na ação. Se uma Nota tiver sido enviada com a ação, ela aparecerá aqui.

CallerId

Inteiro

Se esta for uma ação de Rastreamento de chamadas, o valor obrigatório de CallerId para a ação aparecerá aqui.

CustomerArea

String

A área geográfica do cliente, se tiver sido detectada com a ação (ou seja, código DMA).

CustomerCity

String

A cidade do cliente, se tiver sido detectada com a ação.

CustomerRegion

String

A região do cliente, se tiver sido detectada com a ação.

CustomerCountry

String

O país do cliente.

SharedId

String (32)

Este valor é específico do parceiro de mídia, mas está disponível tanto para o parceiro de mídia quanto para o anunciante.

Itens

String (255)

Categoria em nível de item, SKU, valor, quantidade, pagamento, nome, desconto do item e lista de itens (respectivamente) separados pelo caractere “^”. Vários itens são separados pelo caractere “~”.

Atualizado

Isto foi útil?