Configurar destinos

Cada Destination 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.

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

Se você é um parceiro de dados, acesse os cenários de parceiros de dados para ver exemplos de como criar um Destination e enviar dados para uma conta com um link de produto para sua conta de parceiro de dados:

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

Caminho de acesso do anunciante

Google Ads

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

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 cloudysanfrancisco@gmail.com é 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 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 mãe direta de C2.

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

Os cenários de acesso direto e 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:

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.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

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

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

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:

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.

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 baklavainthebalkans@gmail.com:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

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 cloudysanfrancisco@gmail.com, que é um usuário da conta de administrador M1 do Google Ads:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

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:

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.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

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:

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.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

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:

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.

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 PARTNER_ID, e a conta de anunciante do Display & Video 360 ADVERTISER_ID precisa ser uma conta secundária da conta de parceiro PARTNER_ID.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Analytics

Observação:operating_account e login_account precisam ser idênticos quando o destino é uma conta do Google Analytics. Caso contrário, a solicitação falhará com o erro OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

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.

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

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

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.

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.

Caminho de acesso do parceiro de dados

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, contas e usuários do Google Ads

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 222larabrown@gmail.com é 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 jeffersonloveshiking@gmail.com é 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 222larabrown@gmail.com 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 jeffersonloveshiking@gmail.com para enviar dados à conta de cliente C1 usando um destino com login_account definido como a conta de parceiro de dados D2 e linked_account definido como a conta de 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.

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:

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.

Confira um exemplo de cenário de link direto do produto usando contas do diagrama. Nesse cenário, o parceiro de dados D2 envia dados de membros do público-alvo para o cliente C1 do Google Ads usando a vinculação de produto entre D2 e C1 e as credenciais da Conta do Google jeffersonloveshiking@gmail.com:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Cenário de vinculação de produtos 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:

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.

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 222larabrown@gmail.com:

{
  "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"
    }
  ]
}

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.

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:

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.

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:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

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.

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.

Confira um exemplo de Destination para um cenário de vinculação direta de produto para enviar dados a um parceiro do Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

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:

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.

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:

{
  "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"
    }
  ]
}

Google Analytics

A API Data Manager não aceita o envio de 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, 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:

login_account

O login_account nem sempre é obrigatório e o padrão é o operating_account.

A API Data Manager verifica se:

  1. A Conta do Google das credenciais é um usuário no login_account.

  2. O login_account é um dos seguintes:

    • O mesmo que operating_account. Esse é o padrão se você não definir o login_account.

    • Uma conta de gerente do Google Ads ou parceiro do Display & Video 360 que é uma conta principal de operating_account.

    • Uma conta de parceiro de dados com um link de produto para o linked_account.

linked_account

O linked_account indica qual conta tem um link de produto para o login_account.

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.

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.

Para acessar o ID do público-alvo na API Google Ads:

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

    SELECT
  user_list.id,
  user_list.name
FROM user_list
WHERE user_list.name = 'USER_LIST_NAME'

  2. Receba o ID do público-alvo do campo id no user_list da resposta.

    [
  {
    "results": [
      {
        "userList": {
          "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
          "id": "USER_LIST_ID",
          "name": "USER_LIST_NAME"
        }
      }
    ]
  }
]

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.

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.

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.
Avançar
Formatar dados do usuário