Configurar destinos e cabeçalhos

O conceito de Destination e os cabeçalhos de 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 para as credenciais da solicitação à conta que recebe os dados.

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

  Dica: não defina cabeçalhos de solicitação em uma solicitação IngestionService. A API Data Manager ignora os cabeçalhos em uma solicitação de ingestão.

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

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

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

Etapa	Tipo de solicitação	Cabeçalhos de destino ou solicitação
Criar um público-alvo	Gerenciamento de recursos	Cabeçalhos de solicitação
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 de solicitação

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

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

• Google Ads
• Display & Video 360
• Google Analytics

Se você é 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 a uma conta com um link de produto para sua conta de parceiro de dados:

• Google Ads
• Display & Video 360
• Google Analytics

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

Situações com anunciantes

Saiba como configurar um Destination ou cabeçalhos de 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.

Google Ads

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

Conta de administrador M1

M1 tem duas contas secundárias diretas:

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

A Conta do Google [e-mail] é um usuário do 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 [e-mail] é 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 [e-mail] é um usuário em C1.

Conta de cliente C2

A conta de administrador M2 é a única mãe direta de C2.

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

Os cenários de acesso direto e 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 os mesmos valores que 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 de solicitação
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	Não defina o cabeçalho linked-account.

Confira um exemplo de cenário de acesso direto, usando as contas do diagrama e as credenciais da Conta do Google [e-mail]:

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 de solicitação
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 é usuária em uma conta de administrador do Google Ads em que a conta de anunciante é 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 de solicitação
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 C2 do Google Ads no diagrama e as credenciais da Conta do Google [e-mail]:

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 de solicitação
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	Não defina o cabeçalho linked-account.

Confira outro exemplo de um cenário de acesso de administrador para a conta de cliente C2 do Google Ads e as credenciais da Conta do Google [e-mail], que é um usuário da conta de administrador M1 do Google Ads:

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 de solicitação
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	Não defina o cabeçalho linked-account.

Display & Video 360

Você pode 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 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.

Situações 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 os mesmos valores que 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 de solicitação
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 de solicitação
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 os mesmos valores que 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 de solicitação
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 de solicitação
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 principal de parceiro do Display & Video 360 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	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 de solicitação
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 de parceiro em que dados são enviados 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 uma conta secundária 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 de solicitação
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 o login_account ou defina os mesmos valores que operating_account.
linked_account	Não defina o campo linked_account.
product_destination_id	O ID da métrica do fluxo de dados.

Gerenciamento de recursos

Cabeçalhos de solicitação
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 de solicitação
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Não defina o cabeçalho linked-account.

Cenários de parceiros de dados

Saiba como configurar um Destination para cenários comuns de um parceiro de dados que envia dados para contas de anunciantes com uma vinculação de produto estabelecida à conta do parceiro de dados.

Observação: em todos os cenários de parceiro de dados, as credenciais precisam ser de uma Conta do Google que seja um usuário na 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 produto.

Google Ads

Confira um diagrama com um exemplo de 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 de parceiro de dados, bem como as vinculações de produtos entre as contas.

Parceiro de dados D1

Existe uma vinculação de produtos entre D1 e a conta de administrador do Google Ads M2.

A Conta do Google [e-mail] é um usuário do D1.

Parceiro de dados D2

Existe uma vinculação de produto entre D2 e a conta de cliente C1 do Google Ads.

A Conta do Google [e-mail] é um usuário no D2.

Conta de administrador M1

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 mãe direta de C2.

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

Atue como parceiro de dados D1

Para agir como parceiro de dados D1, use as credenciais da Conta do Google [e-mail] para enviar dados à conta de administrador M2, à conta de cliente C1 ou à conta de cliente C2, usando um destino com login_account definido como conta de parceiro de dados D1 e linked_account definido como conta de administrador M2.

Como parceiro de dados D1, não é possível enviar dados para a conta de administrador M1 porque não há uma vinculação de produto entre D1 e M1.

Atue como parceiro de dados D2

Para agir como parceiro de dados D2, use as credenciais da Conta do Google [e-mail] para enviar dados à conta do cliente C1 usando um destino com login_account definido como a conta de parceiro de dados D2 e linked_account definido como a conta do cliente C1.

Como parceiro de dados D2, você não pode enviar dados para a conta de administrador M1, M2 ou de cliente C2 porque não há uma vinculação de produto 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.

• O parceiro de dados D1 está vinculado a uma conta de administrador do Google Ads. Este é um exemplo do cenário de vinculação de produto do administrador.
• O parceiro de dados D2 está vinculado a uma conta de cliente do Google Ads. Este é um exemplo do cenário de link direto do produto.

Cenário de link direto do produto

Se você quiser enviar dados para uma conta do Google Ads e a vinculação de produto for entre a conta do Google Ads e a conta do 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 de 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 de solicitação
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Não defina o cabeçalho linked-account.

Confira um exemplo de cenário de link direto do produto usando contas do diagrama e os cabeçalhos de solicitação correspondentes para solicitações de gerenciamento de recursos. Nesse cenário, o parceiro de dados D2 envia dados de um membro do público-alvo para o cliente C1 do Google Ads usando a vinculação de produto entre D2 e C1, além das credenciais da Conta do Google [e-mail]:

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 de solicitação
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	Não defina o cabeçalho linked-account.

Cenário de vínculo de produto do gerente

Se você quiser enviar dados para uma conta do Google Ads e a vinculação de produto for entre uma conta de administrador principal 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 de 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 de solicitação
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Confira um exemplo de cenário de vinculação de produto do administrador usando contas do diagrama. Nesse cenário, o parceiro de dados D1 envia dados de membros do público-alvo para o cliente C2 do Google Ads usando a vinculação de produto entre D1 e M2 e as credenciais da Conta do Google [e-mail]:

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 de solicitação
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 uma vinculação direta de produto 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 uma vinculação de produto entre uma conta de parceiro de dados e a conta principal de parceiro do Display & Video 360 do anunciante.

Cenários de link direto do produto

Se você quiser enviar dados para um anunciante do Display & Video 360 e a vinculação de produto for entre a conta de 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 de 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 de solicitação
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 vinculação direta de produto 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 de solicitação
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, precisará ter uma vinculação de produto 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 de 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 de solicitação
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 direto do produto para enviar dados a um parceiro 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_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Gerenciamento de recursos

Cabeçalhos de solicitação
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Não defina o cabeçalho linked-account.

Cenário de vinculação de produtos de parceiros do Display & Video 360

Se você quiser enviar dados para um anunciante do Display & Video 360 e o link do produto para sua conta de parceiro de dados for com uma conta de parceiro do Display & Video 360 em que a conta do anunciante é uma conta secundária:

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 de 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 de solicitação
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 vinculação de produto de parceiro que envia dados a um anunciante do Display & Video 360 usando uma vinculação de produto entre o parceiro de dados e o parceiro principal do anunciante no Display & Video 360:

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 de solicitação
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Analytics

A API Data Manager não permite enviar dados para uma conta do Google Analytics usando uma vinculação de produto. Em vez disso, use a abordagem de cenários de anunciantes para o Google Analytics.

Requisitos detalhados

Esta seção contém requisitos detalhados para os campos da conta de um Destination em uma solicitação IngestionService, os cabeçalhos de 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

Um 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:

• Uma conta do Google Ads
• Uma conta de anunciante do Display & Video 360
• Uma conta de parceiro do Display & Video 360
• Uma propriedade do Google Analytics
• Uma conta de parceiro de dados se os dados forem enviados para um público-alvo pertencente a ela.

Não há um cabeçalho de 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 é necessário e usa como 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 de 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 login.

2. A conta de login é uma das seguintes:

   • O mesmo que 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 parceiro do Display & Video 360 que é pai de operating_account em uma solicitação IngestionService ou pai da conta de destino em uma solicitação de gerenciamento de recursos.

   • Uma conta de parceiro de dados com um link de produto 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

Observação: especifique uma conta vinculada somente se a conta de login tiver account_type definido como DATA_PARTNER e um parent do operating_account estiver vinculado à conta do parceiro de dados. Se o operating_account estiver vinculado diretamente à conta do parceiro de dados, não defina linked_account.

O linked_account indica qual conta tem uma vinculação de produto ao login_account de uma solicitação IngestionService ou a conta de destino de uma solicitação de gerenciamento de recursos.

ID do 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 de ação de conversão do Google Ads ou um ID de métricas de um fluxo 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 ingerir 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.

Interface do Google Ads

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 de 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.

Para acessar 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 para conferir os detalhes.

3. O ID da ação de conversão é o valor do parâmetro de consulta do URL chamado ctId.

   https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
   

Para receber o ID da ação de conversão da 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. Receba o ID da ação de conversão do campo id no conversion_action da 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 ingerir 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 de 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 para ingestão de eventos é o ID de métricas do fluxo de dados.

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, do Display & Video 360 ou do Google Analytics.

Google Ads ou parceiro de dados

1. Acesse Acesso e segurança na interface do Google Ads para login_account.
2. Selecione a guia Usuários.
3. Se a login_account for uma conta de administrador do Google Ads, desative a opção Mostrar 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.