Configurar destinos e cabeçalhos

O conceito Destination e os cabeçalhos da solicitação aparecem com frequência ao trabalhar com a API Data Manager. Leia este guia para entender como configurar destinos e cabeçalhos para diferentes cenários.

Quando usar destinos ou cabeçalhos

  • Use um Destination em solicitações de ingestão. Uma solicitação de ingestão usa o IngestionService para adicionar ou remover membros de um público-alvo ou enviar eventos. A lista destinations em um IngestAudienceMembersRequest ou IngestEventsRequest define:

    1. A conta que recebe os dados. Por exemplo, uma conta do Google Ads ou uma propriedade do Google Analytics.
    2. A entidade de destino dos dados na conta, como uma ação de conversão do Google Ads ou um fluxo do Google Analytics.
    3. O caminho de acesso das credenciais da solicitação para a conta que recebe os dados.

    É possível incluir vários destinos na mesma solicitação de ingestão.

  • Use cabeçalhos da solicitação em solicitações de gerenciamento de recursos que criam, atualizam, excluem ou recuperam recursos. Os cabeçalhos definem o caminho de acesso das credenciais da solicitação para a conta de destino da solicitação de gerenciamento de recursos. Confira a lista de recursos com métodos de gerenciamento de recursos que aceitam cabeçalhos da solicitação:

Por exemplo, se você quiser criar um público-alvo, adicionar membros a ele, verificar os diagnósticos e recuperar o público-alvo para verificar o tamanho, veja cada etapa, o tipo de solicitação a ser usado e se você deve usar destinos ou cabeçalhos da solicitação:

Etapa Tipo de solicitação Cabeçalhos de destino ou de solicitação
Criar um público-alvo Gerenciamento de recursos Cabeçalhos das solicitações
Adicionar participantes a um público-alvo Ingestão Destinos
Verificar diagnósticos Ingestão Destinos
Recuperar o público-alvo Gerenciamento de recursos Cabeçalhos das solicitações

Para alternar entre os detalhes de cada tipo de solicitação neste guia, clique na guia Ingestão ou Gerenciamento de recursos ao redor de cada tabela.

Se você é anunciante ou agência, acesse os cenários de anunciante para ver exemplos de como definir cabeçalhos e criar um Destination:

Se você for um parceiro de dados, acesse os cenários de parceiro de dados para ver exemplos de como definir cabeçalhos e criar um Destination para gerenciar recursos e enviar dados para uma conta com um link de parceiro para sua conta de parceiro de dados:

A seção Requisitos detalhados aborda os requisitos e as regras de validação em detalhes.

Cenários de anunciantes

Veja como configurar um Destination ou cabeçalhos da solicitação para cenários comuns de anunciantes e agências. Este diagrama mostra como a API Data Manager usa as credenciais e os campos Destination para acessar a conta do anunciante.

Caminho de acesso do anunciante

Google Ads

Veja um diagrama que mostra um exemplo de um conjunto de contas e usuários do Google Ads.

Contas e usuários do Google Ads

Conta de administrador M1

A M1 tem duas contas secundárias diretas:

  1. Conta de administrador M2
  2. Conta de cliente C1

A Conta do Google cloudysanfrancisco@gmail.com é um usuário na M1.

Conta de administrador M2

A M2 tem duas contas secundárias diretas:

  1. Conta de cliente C1
  2. Conta de cliente C2

A Conta do Google baklavainthebalkans@gmail.com é um usuário em M2.

Conta de cliente C1

C1 tem duas contas de administrador principais diretas:

  1. Conta de administrador M1
  2. Conta de administrador M2

A Conta do Google jeffersonloveshiking@gmail.com é um usuário em C1.

Conta de cliente C2

A conta de administrador M2 é a única conta principal direta de C2.

Nenhuma das Contas do Google listadas é um usuário em C2.

O cenário de acesso direto e o cenário de acesso de administrador mostram como configurar um destino para enviar dados a essas contas.

Cenário de acesso direto

Se você quiser enviar dados para uma conta do Google Ads e suas credenciais forem de uma Conta do Google que é um usuário na conta do Google Ads:

Ingestão
Destino
operating_account
account_id O ID de cliente da conta do Google Ads
account_type GOOGLE_ADS
login_account Não defina o login_account ou defina-o com os mesmos valores de operating_account.
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo ou da ação de conversão.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account Não defina o cabeçalho linked-account.

Veja um exemplo de cenário de acesso direto, usando as contas do diagrama e as credenciais da Conta do Google jeffersonloveshiking@gmail.com:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account Não defina o cabeçalho linked-account.

Cenário de acesso de administrador

Se você quiser enviar dados para uma conta do Google Ads e suas credenciais forem de uma Conta do Google que é um usuário em uma conta de administrador do Google Ads em que a conta do anunciante é uma conta secundária:

Ingestão
Destino
operating_account
account_id O ID de cliente da conta de cliente do Google Ads
account_type GOOGLE_ADS
login_account
account_id O ID de cliente da conta de administrador do Google Ads
account_type GOOGLE_ADS
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo ou da ação de conversão.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account Não defina o cabeçalho linked-account.

Confira um exemplo de cenário de acesso de administrador para a conta de cliente do Google Ads C2 do diagrama e as credenciais da Conta do Google baklavainthebalkans@gmail.com:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account Não defina o cabeçalho linked-account.

Veja outro exemplo de cenário de acesso de administrador para a conta de cliente do Google Ads C2 e as credenciais da Conta do Google cloudysanfrancisco@gmail.com, que é um usuário na conta de administrador do Google Ads M1:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account Não defina o cabeçalho linked-account.

Display & Video 360

É possível enviar dados para o Display & Video 360 usando duas abordagens:

  1. Acesso direto, em que as credenciais são de uma Conta do Google que é um usuário na conta de anunciante ou de parceiro do Display & Video 360.
  2. Acesso de parceiro do Display & Video 360, em que as credenciais são de uma Conta do Google que é um usuário na conta de parceiro do Display & Video 360, e a conta operacional é uma conta de anunciante do Display & Video 360 na conta de parceiro.

Cenários de acesso direto

Se você quiser enviar dados para uma conta de anunciante do Display & Video 360 e suas credenciais forem de uma Conta do Google que é um usuário na conta do anunciante:

Ingestão
Destino
operating_account
account_id O ID da conta de anunciante do Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account Não defina o login_account ou defina-o com os mesmos valores de operating_account.
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account Não defina o cabeçalho linked-account.

Confira um exemplo de Destination para um cenário de acesso direto para enviar dados a um anunciante do Display & Video 360:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account Não defina o cabeçalho linked-account.

Da mesma forma, se você quiser enviar dados para uma conta de parceiro do Display & Video 360 e suas credenciais forem de uma Conta do Google que é um usuário na conta de parceiro:

Ingestão
Destino
operating_account
account_id O ID da conta de parceiro do Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account Não defina o login_account ou defina-o com os mesmos valores de operating_account.
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Confira um exemplo de Destination para um cenário de acesso direto para enviar dados a um parceiro do Display & Video 360:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Cenário de acesso de parceiro do Display & Video 360

Se você quiser enviar dados para um anunciante do Display & Video 360 e suas credenciais forem de uma Conta do Google que é um usuário na conta de parceiro principal do anunciante no Display & Video 360:

Ingestão
Destino
operating_account
account_id O ID da conta de anunciante do Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id O ID da conta de parceiro do Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Veja um exemplo de Destination para um cenário de acesso de parceiro para enviar dados a um anunciante do Display & Video 360. Nesse cenário, as credenciais precisam ser de uma Conta do Google que seja um usuário na conta de parceiro do Display & Video 360 DISPLAY_VIDEO_PARTNER_ID, e a conta de anunciante do Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID precisa ser filha da conta de parceiro DISPLAY_VIDEO_PARTNER_ID.

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Google Analytics

Observação:se o operating_account for uma conta do Google Analytics, não defina o login_account ou defina-o com os mesmos valores do operating_account. Caso contrário, a solicitação falhará com o erro OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Ingestão
Destino
operating_account
account_id O ID da propriedade do Google Analytics
account_type GOOGLE_ANALYTICS_PROPERTY
login_account Não defina login_account ou defina com os mesmos valores de operating_account.
linked_account Não defina o campo linked_account.
product_destination_id
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account Não defina o cabeçalho linked-account.

Confira um exemplo de Destination para enviar eventos ao Google Analytics:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account Não defina o cabeçalho linked-account.

Floodlight

Ingestão
Destino
operating_account
account_id O ID de configuração do Floodlight
Se o anunciante for filho de um anunciante pai, use o ID do anunciante pai no Campaign Manager 360 como o ID de configuração do Floodlight. Caso contrário, use o ID do seu anunciante. Saiba como encontrar o ID do anunciante na interface do Campaign Manager 360.
account_type FLOODLIGHT_CONFIG
login_account Não defina o login_account ou defina-o com os mesmos valores de operating_account.
linked_account Não defina o campo linked_account.
product_destination_id O ID da atividade do Floodlight

Veja um exemplo de Destination para enviar eventos ao Floodlight:

Ingestão
        {
          "destinations": [
            {
              "operatingAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "loginAccount": {
                "accountId": "FLOODLIGHT_CONFIG_ID",
                "accountType": "FLOODLIGHT_CONFIG"
              },
              "productDestinationId": "FLOODLIGHT_ACTIVITY_ID"
            }
          ]
        }

Cenários de parceiros de dados

Veja como configurar um Destination para cenários comuns de um parceiro de dados que envia dados para contas de anunciantes com um link de parceiro estabelecido para a conta do parceiro de dados.

Este diagrama mostra como a API Data Manager usa as credenciais e os campos Destination para acessar a conta do anunciante por um link de parceiro.

Caminho de acesso do parceiro de dados

Google Ads

Veja um diagrama que mostra um exemplo de um conjunto de contas do Google Ads e de parceiros de dados. O diagrama também mostra qual Conta do Google é um usuário em cada conta do Google Ads ou do parceiro de dados, bem como as vinculações de parceiros entre as contas.

Contas e usuários do parceiro de dados e da conta do Google Ads

Parceiro de dados D1

Há um link de parceiro entre D1 e a conta de administrador do Google Ads M2.

A Conta do Google 222larabrown@gmail.com é um usuário no D1.

Parceiro de dados D2

Há um link de parceiro entre D2 e a conta de cliente do Google Ads C1.

A Conta do Google jeffersonloveshiking@gmail.com é um usuário no D2.

Conta de administrador M1

A M1 tem duas contas secundárias diretas:

  1. Conta de administrador M2
  2. Conta de cliente C1
Conta de administrador M2

A M2 tem duas contas secundárias diretas:

  1. Conta de cliente C1
  2. Conta de cliente C2
Conta de cliente C1

C1 tem duas contas de administrador principais diretas:

  1. Conta de administrador M1
  2. Conta de administrador M2
Conta de cliente C2

A conta de administrador M2 é a única conta principal direta de C2.

Confira o que você pode fazer com esse conjunto de contas:

Atuar como parceiro de dados D1

Para atuar como parceiro de dados D1, use as credenciais da Conta do Google 222larabrown@gmail.com para:

  • Enviar dados para a conta de cliente C1 ou C2 usando um destino com login_account definido como a conta de parceiro de dados D1 e linked_account definido como a conta de administrador M2.

  • Envie dados diretamente para a conta de administrador M2 usando um destino com login_account definido como a conta de parceiro de dados D1. Não defina linked_account.

Como parceiro de dados D1, você não pode enviar dados para a conta de administrador M1 porque não há um link de parceiro entre D1 e M1.

Atuar como parceiro de dados D2

Para atuar como o parceiro de dados D2, use as credenciais da Conta do Google jeffersonloveshiking@gmail.com para enviar dados à conta de cliente C1, usando um destino com login_account definido como a conta do parceiro de dados D2. Não defina linked_account.

Como parceiro de dados D2, você não pode enviar dados para a conta de administrador M1, a conta de administrador M2 ou a conta de cliente C2 porque não há um link de parceiro entre D2 e nenhuma dessas contas ou as contas de administrador principais delas.

A principal diferença entre os parceiros de dados D1 e D2 é como eles são vinculados às contas do Google Ads.

Cenário de link direto do parceiro

Se você quiser enviar dados para uma conta do Google Ads e o link de parceiro estiver entre a conta do Google Ads e sua conta de parceiro de dados:

Ingestão
Destino
operating_account
account_id O ID de cliente da conta do Google Ads
account_type GOOGLE_ADS
login_account
account_id O ID de cliente da conta do parceiro de dados
account_type DATA_PARTNER
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo ou da ação de conversão.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Veja um exemplo de cenário de link de parceiro direto usando contas do diagrama e os cabeçalhos da solicitação correspondentes para solicitações de gerenciamento de recursos. Nesse cenário, o parceiro de dados D2 envia dados de membros do público-alvo para a relação de cliente C1 do Google Ads usando o link de parceiro entre D2 e C1 e as credenciais da Conta do Google jeffersonloveshiking@gmail.com:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account Não defina o cabeçalho linked-account.

Cenário de vinculação de parceiro administrador

Se você quiser enviar dados para uma conta do Google Ads e o link do parceiro estiver entre uma conta de admin do Google Ads e sua conta de parceiro de dados:

Ingestão
Destino
operating_account
account_id O ID de cliente da conta de cliente do Google Ads
account_type GOOGLE_ADS
login_account
account_id O ID de cliente da conta do parceiro de dados
account_type DATA_PARTNER
linked_account
account_id O ID de cliente da conta de administrador do Google Ads
account_type GOOGLE_ADS
product_destination_id O ID do público-alvo ou da ação de conversão.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Veja um exemplo de cenário de vinculação de parceiro administrador usando contas do diagrama. Nesse cenário, o parceiro de dados D1 envia dados de membros do público-alvo para a relação de cliente C2 do Google Ads usando o link de parceiro entre D1 e M2 e as credenciais da Conta do Google 222larabrown@gmail.com:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

Como parceiro de dados, você pode enviar dados para uma conta do Display & Video 360 usando duas abordagens:

  1. Use um link de parceiro direto entre uma conta de parceiro de dados e a conta de parceiro ou anunciante do Display & Video 360.
  2. Envie dados para um anunciante do Display & Video 360 usando um link de parceiro entre uma conta de parceiro de dados e a conta de parceiro principal do Display & Video 360 do anunciante.

Se você quiser enviar dados para um anunciante do Display & Video 360 e o link do parceiro estiver entre a conta do anunciante do Display & Video 360 e sua conta de parceiro de dados:

Ingestão
Destino
operating_account
account_id O ID da conta de anunciante do Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id O ID de cliente da conta do parceiro de dados
account_type DATA_PARTNER
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo ou da ação de conversão.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Confira um exemplo de Destination para um cenário de link de parceiro direto para enviar dados a um anunciante do Display & Video 360 e os cabeçalhos de solicitação correspondentes para solicitações de gerenciamento de recursos:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Se você quiser enviar dados para uma conta de parceiro do Display & Video 360, é necessário ter um link de parceiro entre a conta de parceiro do Display & Video 360 e sua conta de parceiro de dados.

Ingestão
Destino
operating_account
account_id O ID da conta de parceiro do Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id O ID de cliente da conta do parceiro de dados
account_type DATA_PARTNER
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo ou da ação de conversão.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Veja um exemplo de Destination para um cenário de link de parceiro direto para enviar dados a um parceiro do Display & Video 360 e os cabeçalhos da solicitação correspondentes para solicitações de gerenciamento de recursos:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Se você quiser enviar dados para um anunciante do Display & Video 360 e o link do parceiro para sua conta de parceiro de dados estiver em uma conta de parceiro do Display & Video 360 em que a conta do anunciante é uma conta infantil:

Ingestão
Destino
operating_account
account_id O ID da conta de anunciante do Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id O ID de cliente da conta do parceiro de dados
account_type DATA_PARTNER
linked_account
account_id O ID da conta de parceiro do Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
product_destination_id O ID do público-alvo ou da ação de conversão.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Confira um exemplo de Destination para um cenário de link de parceiro para enviar dados a um anunciante do Display & Video 360 usando um link de parceiro entre o parceiro de dados e o parceiro principal do Display & Video 360 do anunciante:

Ingestão
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

Se você quiser enviar dados para uma conta do Google Ad Manager e tiver um link de parceiro entre sua conta de parceiro de dados e a conta do Google Ad Manager:

Ingestão
Destino
operating_account
account_id O ID do link de público-alvo da conta de admin do Google Ad Manager
account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account
account_id O ID de cliente da conta do parceiro de dados
account_type DATA_PARTNER
linked_account Não defina o campo linked_account.
product_destination_id O ID do público-alvo.
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Veja um exemplo de Destination para enviar dados a uma conta do Google Ad Manager usando um link de parceiro:

Ingestão
      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
Gerenciamento de recursos
Cabeçalhos das solicitações
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Não defina o cabeçalho linked-account.

Google Analytics

A API Data Manager não permite o envio de dados para uma conta do Google Analytics usando um link de parceiro. Em vez disso, use a abordagem de cenários do anunciante para o Google Analytics.

Floodlight

A API Data Manager não permite o envio de dados para uma configuração do Floodlight usando um link de parceiro. Em vez disso, use a abordagem de cenários do anunciante para o Floodlight.

Requisitos detalhados

Esta seção contém requisitos detalhados para os campos de conta de um Destination para uma solicitação IngestionService, os cabeçalhos da solicitação equivalentes para solicitações de gerenciamento de recursos, dicas sobre como definir o product_destination_id e como determinar onde suas credenciais têm acesso.

Campos da conta

Uma Destination pode ter até três contas diferentes:

operating_account

O operating_account é obrigatório.

O operating_account indica qual conta recebe os dados na solicitação. O operating_account pode ser qualquer um dos seguintes:

Não há um cabeçalho da solicitação que corresponda ao campo operating_account de um Destination. Ao enviar uma solicitação de gerenciamento de recursos, a conta de destino é a conta operacional.

Campo login_account e cabeçalho da solicitação login-account

O login_account nem sempre é obrigatório e, por padrão, é o operating_account em uma solicitação IngestionService e a conta de destino em uma solicitação de gerenciamento de recursos. Em uma solicitação de gerenciamento de recursos, use o cabeçalho da solicitação login-account para identificar a conta de login.

A API Data Manager verifica se:

  1. A Conta do Google das credenciais é um usuário na conta de faturamento.

  2. A conta de login é uma das seguintes:

    • O mesmo que o operating_account. Esse é o padrão se você não definir o login_account de um Destination em uma solicitação IngestionService ou não definir o cabeçalho login-account em uma solicitação de gerenciamento de recursos.

    • Uma conta de administrador do Google Ads ou de parceiro do Display & Video 360 que é mãe do operating_account em uma solicitação IngestionService ou mãe da conta de destino em uma solicitação de gerenciamento de recursos.

    • Uma conta de parceiro de dados com um link de parceiro para o linked_account em uma solicitação IngestionService ou o cabeçalho linked-account em uma solicitação de gerenciamento de recursos.

Campo linked_account e cabeçalho da solicitação linked-account

O linked_account indica qual conta tem um link de parceiro para o login_account de uma solicitação IngestionService ou a conta de destino de uma solicitação de gerenciamento de recursos.

ID de destino do produto

O product_destination_id de um Destination identifica qual objeto no operating_account recebe os dados. Por exemplo, pode ser um ID de público-alvo do Google Ads ou do Display & Video 360, um ID da ação de conversão do Google Ads ou um ID de métricas de um fluxo de dados do Google Analytics.

Veja como encontrar o ID de cada tipo de destino do produto.

Público-alvo do Google Ads

O ID de destino do produto para ingestão de membros do público-alvo é o ID do público-alvo. Recupere esse ID usando a interface do Google Ads ou a API Data Manager.

Para encontrar o ID do público-alvo na interface do Google Ads:

  1. Acesse o Gerenciador de públicos-alvo na interface do Google Ads.
  2. Clique no nome do público-alvo para ver os detalhes.
  3. O ID do público-alvo aparece ao lado de ID da lista.

API Data Manager

Recupere o UserList usando o método List, fornecendo cabeçalhos da solicitação, se necessário, e use o id do UserList para o ID de destino do produto.

Evento do Google Ads

O ID de destino do produto para ingestão de eventos é o ID da ação de conversão. Recupere esse ID usando a interface ou a API Google Ads.

Para encontrar o ID da ação de conversão na interface do Google Ads:

  1. Acesse Conversões na interface do Google Ads.
  2. Clique no nome da ação de conversão.
  3. Acesse a guia Detalhes.
  4. O ID da ação de conversão é o número ao lado de ID do tipo de conversão.

Para encontrar o ID da ação de conversão na API Google Ads:

  1. Envie uma solicitação Search ou SearchStream para GoogleAdsService com a seguinte consulta:

      SELECT
    conversion_action.id,
    conversion_action.name
  FROM conversion_action
  WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'

  2. Encontre o ID da ação de conversão no campo id em conversion_action na resposta.

      [
    {
      "results": [
        {
          "conversionAction": {
            "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
            "id": "CONVERSION_ACTION_ID",
            "name": "CONVERSION_ACTION_NAME"
          }
        }
      ]
    }
  ]

Público-alvo do Display & Video 360

O ID de destino do produto para ingestão de membros do público-alvo é o ID do público-alvo. Recupere esse ID usando a interface do Display & Video 360 ou a API Data Manager.

Interface do Display & Video 360

Para encontrar o ID do público-alvo na interface do Display & Video 360:

  1. Faça login na interface do Display & Video 360 em https://displayvideo.google.com.
  2. Acesse o parceiro ou anunciante do Display & Video 360 que você está usando para o operating_account.
  3. Acesse Públicos-alvo no menu à esquerda e selecione Todos os públicos-alvo.
  4. Encontre o público-alvo na lista. O ID do público-alvo é o número ao lado do nome na coluna Nome.

API Data Manager

Recupere o UserList usando o método List, fornecendo cabeçalhos da solicitação, se necessário, e use o id do UserList para o ID de destino do produto.

Evento do Google Analytics

O ID de destino do produto depende do tipo de fluxo de dados.

Fluxo de dados da Web
Use o ID de métricas do fluxo de dados.
Fluxo de dados do app

Use o ID do app do Firebase do fluxo de dados. Veja duas opções para encontrar o ID do app do Firebase:

Evento do Floodlight

O ID de destino do produto para ingerir eventos no Floodlight é o ID da atividade do Floodlight. Recupere esse ID usando a interface ou a API do Campaign Manager 360.

Interface do Campaign Manager 360

Para encontrar o ID da atividade do Floodlight na interface do Campaign Manager 360:

  1. Faça login na interface do Campaign Manager 360.
  2. Acesse o anunciante do Campaign Manager 360 que você está usando para o operating_account.
  3. Acesse Floodlight no menu à esquerda e selecione Atividades.
  4. Encontre a atividade do Floodlight na lista. O ID é o número ao lado do nome na coluna Nome da atividade.

API Campaign Manager 360

Para receber o ID da atividade do Floodlight na API Campaign Manager 360:

  1. Envie uma solicitação list para o recurso floodlightActivities.
  2. Especifique o floodlightConfigurationId da configuração do Floodlight.
  3. Se quiser, use o parâmetro searchString para filtrar por nome da atividade.
  4. Encontre o ID da atividade do Floodlight no campo id do FloodlightActivity selecionado na resposta.

Determinar onde as credenciais têm acesso

As credenciais usadas para autorizar uma solicitação da API Data Manager estão associadas a uma Conta do Google específica.

  • Se você usar credenciais de usuário, as solicitações serão autorizadas como a Conta do Google do usuário que concedeu permissão para agir em nome dele quando você gerou as credenciais.
  • Se você usar credenciais de conta de serviço, as solicitações serão autorizadas como a Conta do Google da conta de serviço.

Veja como verificar se a Conta do Google das suas credenciais tem acesso a uma conta do Google Ads, Display & Video 360, Google Analytics ou Campaign Manager 360.

Google Ads ou parceiro de dados

  1. Acesse Acesso e segurança na interface do Google Ads para o login_account.
  2. Selecione a guia Usuários.
  3. Se o login_account for uma conta de administrador do Google Ads, desative a opção Mostrar os usuários na hierarquia completa para ocultar os usuários das contas secundárias.
  4. Verifique se a Conta do Google das suas credenciais está na lista de contas mostrada na guia Usuários.

Display & Video 360

  1. Acesse Gerenciamento de usuários e preferências de e-mail na interface do Display & Video 360.
  2. Verifique se o Gerenciamento de usuários mostra que a Conta do Google das suas credenciais é um usuário no login_account.

Google Analytics

  1. Acesse Gerenciamento de acesso à propriedade na interface do Google Analytics.
  2. Confirme se a propriedade do Google Analytics especificada em login_account está selecionada.
  3. Verifique se a Conta do Google das suas credenciais tem a função de editor ou administrador na propriedade.

Floodlight (Campaign Manager 360)

  1. Faça login na interface do Campaign Manager 360.
  2. Acesse Administrador > Perfis de usuário no menu à esquerda.
  3. Verifique se a Conta do Google das suas credenciais está na lista de perfis mostrados.
  4. Clique no perfil e verifique se ele tem acesso à conta de anunciante usada como login_account. Se você não definir um login_account na solicitação, o padrão será operating_account. Verifique se a conta tem uma função do usuário com a permissão Inserir conversões off-line.
Avançar
Formatar dados do usuário