Configura destinazioni e intestazioni

Sia il concetto di Destination sia le intestazioni della richiesta vengono visualizzati di frequente quando si utilizza l'API Data Manager. Leggi questa guida per capire come configurare destinazioni e intestazioni per scenari diversi.

Quando utilizzare destinazioni o intestazioni

  • Utilizza un Destination nelle richieste di importazione. Una richiesta di importazione utilizza l'IngestionService per aggiungere o rimuovere membri in un segmento di pubblico o inviare eventi. L'elenco destinations in un IngestAudienceMembersRequest o IngestEventsRequest definisce:

    1. L'account che riceve i dati. Ad esempio, un account Google Ads o una proprietà Google Analytics.
    2. L'entità di destinazione dei dati all'interno dell'account, ad esempio un'azione di conversione di Google Ads o uno stream di Google Analytics.
    3. Il percorso di accesso per le credenziali della richiesta all'account che riceve i dati.

    Puoi includere più destinazioni nella stessa richiesta di importazione.

  • Utilizza le intestazioni delle richieste nelle richieste di gestione delle risorse che creano, aggiornano, eliminano o recuperano le risorse. Le intestazioni definiscono il percorso di accesso per le credenziali della richiesta all'account di destinazione della richiesta di gestione delle risorse. Ecco l'elenco delle risorse con i metodi di gestione delle risorse che supportano le intestazioni delle richieste:

Ad esempio, se vuoi creare un segmento di pubblico, aggiungere membri, controllare la diagnostica e poi recuperare il segmento di pubblico per verificarne le dimensioni, ecco ogni passaggio, il tipo di richiesta da utilizzare e se devi utilizzare le destinazioni o le intestazioni della richiesta:

Passaggio Tipo di richiesta Intestazioni di destinazione o della richiesta
Crea un segmento di pubblico Gestione delle risorse Intestazioni delle richieste
Aggiungi membri a un segmento di pubblico Importazione Destinazioni
Controlla la diagnostica Importazione Destinazioni
Recupera il segmento di pubblico Gestione delle risorse Intestazioni delle richieste

Passa da un dettaglio all'altro in questa guida per ogni tipo di richiesta facendo clic sulla scheda Importazione o Gestione delle risorse che circonda ogni tabella.

Se sei un inserzionista o un'agenzia, vai agli Scenari per gli inserzionisti per esempi su come impostare le intestazioni e creare un Destination:

Se sei un partner di dati, vai agli scenari per i partner di dati per esempi di come impostare le intestazioni e creare un Destination per gestire le risorse e inviare dati a un account con un link partner al tuo account partner di dati:

La sezione Requisiti dettagliati illustra in modo approfondito i requisiti e le regole di convalida.

Scenari degli inserzionisti

Ecco come configurare un Destination o le intestazioni della richiesta per scenari comuni per inserzionisti e agenzie. Questo diagramma mostra in che modo l'API Data Manager utilizza le credenziali e i campi Destination per accedere all'account inserzionista.

Percorso di accesso dell'inserzionista

Google Ads

Di seguito è riportato un diagramma che mostra un esempio di un insieme di account e utenti Google Ads.

Account e utenti Google Ads

Account amministratore M1

M1 ha due account secondari diretti:

  1. Account amministratore M2
  2. Account cliente C1

L'Account Google cloudysanfrancisco@gmail.com è un utente in M1.

Account amministratore M2

M2 ha due account secondari diretti:

  1. Account cliente C1
  2. Account cliente C2

L'Account Google baklavainthebalkans@gmail.com è un utente in M2.

Account cliente C1

C1 ha due account amministratore principale diretto:

  1. Account amministratore M1
  2. Account amministratore M2

L'Account Google jeffersonloveshiking@gmail.com è un utente in C1.

Account cliente C2

L'account amministratore M2 è l'unico account principale diretto di C2.

Nessuno degli Account Google elencati è un utente in C2.

Lo scenario di accesso diretto e lo scenario di accesso amministratore mostrano come configurare una destinazione per inviare dati a questi account.

Scenario di accesso diretto

Se vuoi inviare dati a un account Google Ads e le tue credenziali sono relative a un Account Google che è un utente nell'account Google Ads:

Importazione
Destinazione
operating_account
account_id L'ID cliente dell'account Google Ads
account_type GOOGLE_ADS
login_account Non impostare login_account o impostalo sugli stessi valori di operating_account.
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico o dell'azione di conversione.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di scenario di accesso diretto, che utilizza gli account del diagramma e le credenziali dell'Account Google jeffersonloveshiking@gmail.com:

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

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

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account Non impostare l'intestazione linked-account.

Scenario di accesso dell'amministratore

Se vuoi inviare dati a un account Google Ads e le tue credenziali sono relative a un Account Google che è un utente di un account amministratore Google Ads in cui l'account inserzionista è un account secondario:

Importazione
Destinazione
operating_account
account_id L'ID cliente dell'account cliente Google Ads
account_type GOOGLE_ADS
login_account
account_id L'ID cliente dell'account amministratore Google Ads
account_type GOOGLE_ADS
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico o dell'azione di conversione.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di scenario di accesso amministratore per l'account cliente Google Ads C2 del diagramma e le credenziali per l'Account Google baklavainthebalkans@gmail.com:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un altro esempio di scenario di accesso amministratore per l'account cliente Google Ads C2 e le credenziali per l'Account Google cloudysanfrancisco@gmail.com, che è un utente dell'account amministratore Google Ads M1:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account Non impostare l'intestazione linked-account.

Display & Video 360

Puoi inviare dati a Display & Video 360 utilizzando due approcci:

  1. Accesso diretto, in cui le credenziali sono relative a un Account Google che è un utente nell'account inserzionista o partner Display & Video 360.
  2. Accesso partner Display & Video 360, in cui le credenziali sono relative a un Account Google che è un utente nell'account partner Display & Video 360 e l'account operativo è un account inserzionista Display & Video 360 nell'account partner.

Scenari di accesso diretto

Se vuoi inviare dati a un account inserzionista Display & Video 360 e le tue credenziali sono relative a un Account Google che è un utente nell'account inserzionista:

Importazione
Destinazione
operating_account
account_id L'ID dell'account inserzionista Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account Non impostare login_account o impostalo sugli stessi valori di operating_account.
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di Destination per uno scenario di accesso diretto per inviare dati a un inserzionista Display & Video 360:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account Non impostare l'intestazione linked-account.

Analogamente, se vuoi inviare dati a un account partner Display & Video 360 e le tue credenziali sono relative a un Account Google che è un utente nell'account partner:

Importazione
Destinazione
operating_account
account_id L'ID dell'account partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account Non impostare login_account o impostalo sugli stessi valori di operating_account.
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di Destination per uno scenario di accesso diretto per l'invio di dati a un partner Display & Video 360:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Scenario di accesso dei partner Display & Video 360

Se vuoi inviare dati a un inserzionista Display & Video 360 e le tue credenziali sono relative a un Account Google che è un utente nell'account partner Display & Video 360 principale dell'inserzionista:

Importazione
Destinazione
operating_account
account_id L'ID dell'account inserzionista Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id L'ID dell'account partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di Destination per uno scenario di accesso partner per l'invio di dati a un inserzionista Display & Video 360. In questo scenario, le credenziali devono essere relative a un Account Google che è un utente nell'account partner Display & Video 360 DISPLAY_VIDEO_PARTNER_ID e l'account inserzionista Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID deve essere un account secondario dell'account partner DISPLAY_VIDEO_PARTNER_ID.

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Google Analytics

Nota:se operating_account è un account Google Analytics, non impostare login_account o impostalo sugli stessi valori di operating_account. In caso contrario, la richiesta non va a buon fine e viene visualizzato l'errore OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Importazione
Destinazione
operating_account
account_id L'ID della proprietà Google Analytics
account_type GOOGLE_ANALYTICS_PROPERTY
login_account Non impostare login_account o impostalo sugli stessi valori di operating_account.
linked_account Non impostare il campo linked_account.
product_destination_id
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di Destination per l'invio di eventi a Google Analytics:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account Non impostare l'intestazione linked-account.

Floodlight

Importazione
Destinazione
operating_account
account_id L'ID configurazione Floodlight
Se il tuo inserzionista è un inserzionista secondario di un inserzionista principale, utilizza l'ID dell'inserzionista principale in Campaign Manager 360 come ID configurazione Floodlight. In caso contrario, utilizza l'ID del tuo inserzionista. Scopri come trovare l'ID inserzionista nell'interfaccia utente di Campaign Manager 360.
account_type FLOODLIGHT_CONFIG
login_account Non impostare login_account o impostalo sugli stessi valori di operating_account.
linked_account Non impostare il campo linked_account.
product_destination_id L'ID attività Floodlight

Ecco un esempio di Destination per l'invio di eventi a Floodlight:

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

Scenari dei partner di dati

Ecco come configurare un Destination per gli scenari comuni per un partner di dati che invia dati agli account degli inserzionisti con un link partner stabilito con l'account del partner di dati.

Questo diagramma mostra in che modo l'API Data Manager utilizza le credenziali e i campi Destination per accedere all'account inserzionista tramite un link partner.

Percorso di accesso del partner di dati

Google Ads

Ecco un diagramma che mostra un esempio di un insieme di account Google Ads e partner di dati. Il diagramma mostra anche quale Account Google è un utente in ogni account Google Ads o partner di dati, nonché i link dei partner tra gli account.

Utenti e account Google Ads e partner di dati

Partner di dati D1

Esiste un link partner tra D1 e l'account amministratore Google Ads M2.

L'Account Google 222larabrown@gmail.com è un utente in D1.

Partner di dati D2

Esiste un link partner tra D2 e l'account cliente Google Ads C1.

L'Account Google jeffersonloveshiking@gmail.com è un utente in D2.

Account amministratore M1

M1 ha due account secondari diretti:

  1. Account amministratore M2
  2. Account cliente C1
Account amministratore M2

M2 ha due account secondari diretti:

  1. Account cliente C1
  2. Account cliente C2
Account cliente C1

C1 ha due account amministratore principale diretto:

  1. Account amministratore M1
  2. Account amministratore M2
Account cliente C2

L'account amministratore M2 è l'unico account principale diretto di C2.

Ecco cosa puoi fare con questo insieme di account:

Agisci come partner di dati D1

Per agire in qualità di partner di dati D1, utilizza le credenziali dell'Account Google 222larabrown@gmail.com per:

  • Invia i dati all'account cliente C1 o all'account cliente C2 utilizzando una destinazione con login_account impostato sull'account partner di dati D1 e linked_account impostato sull'account amministratore M2.

  • Invia i dati direttamente all'account amministratore M2 utilizzando una destinazione con login_account impostato sull'account partner di dati D1. Non impostare linked_account.

In qualità di partner di dati D1, non puoi inviare dati all'account amministratore M1 perché non esiste un link partner tra D1 e M1.

Agisci come partner di dati D2

Per agire come partner di dati D2, utilizza le credenziali dell'Account Google jeffersonloveshiking@gmail.com per inviare i dati all'account cliente C1, utilizzando una destinazione con login_account impostato sull'account partner di dati D2. Non impostare linked_account.

In qualità di partner di dati D2, non puoi inviare dati all'account amministratore M1, all'account amministratore M2 o all'account cliente C2 perché non esiste un link partner tra D2 e uno di questi account o i relativi account amministratore principali.

La differenza principale tra i partner di dati D1 e D2 è il modo in cui il partner di dati è collegato agli account Google Ads.

Scenario di collegamento diretto con il partner

Se vuoi inviare dati a un account Google Ads e il link partner è tra l'account Google Ads e il tuo account partner di dati:

Importazione
Destinazione
operating_account
account_id L'ID cliente dell'account Google Ads
account_type GOOGLE_ADS
login_account
account_id L'ID cliente dell'account partner di dati
account_type DATA_PARTNER
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico o dell'azione di conversione.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di scenario di link partner diretto che utilizza gli account del diagramma e le intestazioni della richiesta corrispondenti per le richieste di gestione delle risorse. In questo scenario, il partner di dati D2 invia i dati dei membri del segmento di pubblico al cliente Google Ads C1 utilizzando il link partner tra D2 e C1 e le credenziali dell'Account Google jeffersonloveshiking@gmail.com:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account Non impostare l'intestazione linked-account.

Scenario di collegamento del partner amministratore

Se vuoi inviare dati a un account Google Ads e il link del partner è tra un account amministratore Google Ads principale e il tuo account partner di dati:

Importazione
Destinazione
operating_account
account_id L'ID cliente dell'account cliente Google Ads
account_type GOOGLE_ADS
login_account
account_id L'ID cliente dell'account partner di dati
account_type DATA_PARTNER
linked_account
account_id L'ID cliente dell'account amministratore Google Ads
account_type GOOGLE_ADS
product_destination_id L'ID del segmento di pubblico o dell'azione di conversione.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Ecco un esempio di scenario di collegamento di un partner amministratore che utilizza gli account del diagramma. In questo scenario, il partner di dati D1 invia i dati dei membri del segmento di pubblico all'intermediazione Google Ads C2 utilizzando il link del partner tra D1 e M2 e le credenziali dell'Account Google 222larabrown@gmail.com:

Importazione
{
  "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"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

In qualità di partner di dati, puoi inviare dati a un account Display & Video 360 utilizzando due approcci:

  1. Utilizza un link partner diretto tra un account partner di dati e l'account partner o inserzionista Display & Video 360.
  2. Invia i dati a un inserzionista Display & Video 360 utilizzando un link partner tra un account partner di dati e l'account partner Display & Video 360 principale dell'inserzionista.

Se vuoi inviare dati a un inserzionista Display & Video 360 e il link partner è tra l'account inserzionista Display & Video 360 e il tuo account partner di dati:

Importazione
Destinazione
operating_account
account_id L'ID dell'account inserzionista Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id L'ID cliente dell'account partner di dati
account_type DATA_PARTNER
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico o dell'azione di conversione.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di Destination per uno scenario di collegamento diretto con un partner per l'invio di dati a un inserzionista Display & Video 360 e le intestazioni della richiesta corrispondenti per le richieste di gestione delle risorse:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Se vuoi inviare dati a un account partner Display & Video 360, devi disporre di un link partner tra l'account partner Display & Video 360 e il tuo account partner di dati.

Importazione
Destinazione
operating_account
account_id L'ID dell'account partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id L'ID cliente dell'account partner di dati
account_type DATA_PARTNER
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico o dell'azione di conversione.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di Destination per uno scenario di link diretto con un partner per l'invio di dati a un partner Display & Video 360 e le intestazioni della richiesta corrispondenti per le richieste di gestione delle risorse:

Importazione
{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Se vuoi inviare dati a un inserzionista Display & Video 360 e il link partner al tuo account partner di dati è con un account partner Display & Video 360 in cui l'account inserzionista è un account secondario:

Importazione
Destinazione
operating_account
account_id L'ID dell'account inserzionista Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id L'ID cliente dell'account partner di dati
account_type DATA_PARTNER
linked_account
account_id L'ID dell'account partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
product_destination_id L'ID del segmento di pubblico o dell'azione di conversione.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Ecco un esempio di Destination per uno scenario di link partner per l'invio di dati a un inserzionista Display & Video 360 utilizzando un link partner tra il partner di dati e il partner Display & Video 360 principale dell'inserzionista:

Importazione
{
  "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"
    }
  ]
}
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Ad Manager

Se vuoi inviare dati a un account Google Ad Manager e hai un link partner tra il tuo account partner di dati e l'account Google Ad Manager:

Importazione
Destinazione
operating_account
account_id L'ID link pubblico dell'account Google Ad Manager
account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
login_account
account_id L'ID cliente dell'account partner di dati
account_type DATA_PARTNER
linked_account Non impostare il campo linked_account.
product_destination_id L'ID del segmento di pubblico.
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Ecco un esempio di Destination per l'invio di dati a un account Google Ad Manager utilizzando un link partner:

Importazione
      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "loginAccount": {
              "accountId": "DATA_PARTNER_ID",
              "accountType": "DATA_PARTNER"
            },
            "productDestinationId": "AUDIENCE_ID"
          }
        ]
      }
Gestione delle risorse
Intestazioni delle richieste
login-account accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account Non impostare l'intestazione linked-account.

Google Analytics

L'API Data Manager non supporta l'invio di dati a un account Google Analytics utilizzando un link partner. Utilizza invece l'approccio degli scenari per gli inserzionisti per Google Analytics.

Floodlight

L'API Data Manager non supporta l'invio di dati a una configurazione Floodlight utilizzando un link partner. Utilizza invece l'approccio degli scenari degli inserzionisti per Floodlight.

Requisiti dettagliati

Questa sezione contiene i requisiti dettagliati per i campi dell'account di un Destination per una richiesta IngestionService, le intestazioni della richiesta equivalenti per le richieste di gestione delle risorse, suggerimenti su come impostare product_destination_id e come determinare dove hanno accesso le tue credenziali.

Campi dell'account

Un Destination può avere fino a 3 account diversi:

operating_account

Il campo operating_account è obbligatorio.

operating_account indica quale account riceve i dati nella richiesta. operating_account può essere uno dei seguenti:

Non esiste un'intestazione della richiesta che corrisponda al campo operating_account di un Destination. Quando invii una richiesta di gestione delle risorse, l'account di destinazione della richiesta è l'account operativo.

Campo login_account e intestazione della richiesta login-account

login_account non è sempre obbligatorio e per impostazione predefinita corrisponde a operating_account in una richiesta IngestionService e all'account di destinazione in una richiesta di gestione delle risorse. In una richiesta di gestione delle risorse, utilizza l'intestazione della richiesta login-account per identificare l'account di accesso.

L'API Data Manager verifica che:

  1. L'Account Google delle credenziali è un utente nell'account di accesso.

  2. L'account di accesso è uno dei seguenti:

    • Uguale a operating_account. Questo è il valore predefinito se non imposti login_account di un Destination in una richiesta IngestionService o non imposti l'intestazione login-account in una richiesta di gestione delle risorse.

    • Un account amministratore Google Ads o partner Display & Video 360 principale di operating_account in una richiesta IngestionService o principale dell'account di destinazione in una richiesta di gestione delle risorse.

    • Un account partner di dati con un link partner alla linked_account in una richiesta IngestionService o l'intestazione linked-account in una richiesta di gestione delle risorse.

Campo linked_account e intestazione della richiesta linked-account

linked_account indica quale account ha un link partner alla login_account di una richiesta IngestionService o l'account di destinazione di una richiesta di gestione delle risorse.

ID destinazione del prodotto

La proprietà product_destination_id di un Destination identifica l'oggetto nella operating_account che riceve i dati. Ad esempio, potrebbe essere un ID segmento di pubblico per Google Ads o Display & Video 360, un ID azione di conversione per Google Ads o un ID misurazione per uno stream di dati di Google Analytics.

Ecco come trovare l'ID per ogni tipo di destinazione del prodotto.

Segmento di pubblico Google Ads

L'ID destinazione del prodotto per l'importazione dei membri del segmento di pubblico è l'ID segmento di pubblico. Recupera questo ID utilizzando l'interfaccia utente di Google Ads o l'API Data Manager.

Per ottenere l'ID segmento di pubblico dalla UI di Google Ads:

  1. Vai a Gestione segmenti di pubblico nell'interfaccia utente di Google Ads.
  2. Fai clic sul nome del segmento di pubblico per visualizzare i dettagli.
  3. L'ID segmento di pubblico è elencato accanto a ID elenco.

API Data Manager

Recupera UserList utilizzando il metodo List, fornendo le intestazioni della richiesta, se necessario, e utilizza id di UserList per l'ID destinazione del prodotto.

Evento Google Ads

L'ID destinazione del prodotto per l'importazione degli eventi è l'ID azione di conversione. Recupera questo ID utilizzando l'interfaccia utente o l'API Google Ads.

Per ottenere l'ID azione di conversione dalla UI di Google Ads:

  1. Vai a Conversioni nell'interfaccia utente di Google Ads.
  2. Fai clic sul nome dell'azione di conversione.
  3. Vai alla scheda Dettagli.
  4. L'ID azione di conversione è il numero accanto a ID tipo di conversione.

Per ottenere l'ID azione di conversione dall'API Google Ads:

  1. Invia una richiesta Search o SearchStream a GoogleAdsService con la seguente query:

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

  2. Recupera l'ID azione di conversione dal campo id in conversion_action nella risposta.

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

Pubblico di Display & Video 360

L'ID destinazione del prodotto per l'importazione dei membri del segmento di pubblico è l'ID segmento di pubblico. Recupera questo ID utilizzando l'interfaccia utente di Display & Video 360 o l'API Data Manager.

UI di Display & Video 360

Per ottenere l'ID segmento di pubblico dalla UI di Display & Video 360:

  1. Accedi alla UI di Display & Video 360 all'indirizzo https://displayvideo.google.com.
  2. Vai al partner o all'inserzionista Display & Video 360 che utilizzi per operating_account.
  3. Vai a Segmenti di pubblico nel menu a sinistra e seleziona Tutti i segmenti di pubblico.
  4. Trova il segmento di pubblico nell'elenco. L'ID segmento di pubblico è il numero accanto al nome nella colonna Nome.

API Data Manager

Recupera UserList utilizzando il metodo List, fornendo le intestazioni della richiesta, se necessario, e utilizza id di UserList per l'ID destinazione del prodotto.

Evento Google Analytics

L'ID destinazione del prodotto dipende dal tipo di stream di dati.

Stream di dati web
Utilizza l'ID misurazione dello stream di dati.
Stream di dati dell'app

Utilizza l'ID app Firebase dello stream di dati. Ecco due opzioni per trovare il tuo ID app Firebase:

Evento Floodlight

L'ID destinazione del prodotto per l'importazione degli eventi in Floodlight è l'ID attività Floodlight. Recupera questo ID utilizzando l'interfaccia utente di Campaign Manager 360 o l'API Campaign Manager 360.

UI di Campaign Manager 360

Per ottenere l'ID attività Floodlight dalla UI di Campaign Manager 360:

  1. Accedi alla UI di Campaign Manager 360.
  2. Vai all'inserzionista Campaign Manager 360 che utilizzi per operating_account.
  3. Vai a Floodlight nel menu a sinistra, poi seleziona Attività.
  4. Trova l'attività Floodlight nell'elenco. L'ID è il numero accanto al nome nella colonna Nome attività.

API Campaign Manager 360

Per ottenere l'ID attività Floodlight dall'API Campaign Manager 360:

  1. Invia una richiesta list alla risorsa floodlightActivities.
  2. Specifica l'ID floodlightConfigurationId della configurazione Floodlight.
  3. Facoltativamente, utilizza il parametro searchString per filtrare in base al nome dell'attività.
  4. Recupera l'ID attività Floodlight dal campo id della FloodlightActivity selezionata nella risposta.

Determina dove hanno accesso le credenziali

Le credenziali che utilizzi per autorizzare una richiesta API Data Manager sono associate a un Account Google specifico.

  • Se utilizzi le credenziali utente, le richieste vengono autorizzate come Account Google dell'utente che ha concesso l'autorizzazione ad agire per suo conto quando hai generato le credenziali.
  • Se utilizzi le credenziali del service account, le richieste vengono autorizzate come Account Google del service account.

Ecco come verificare che l'Account Google per le tue credenziali abbia accesso a un account Google Ads, Display & Video 360, Google Analytics o Campaign Manager 360.

Google Ads o partner di dati

  1. Vai ad Accesso e sicurezza nell'interfaccia utente di Google Ads per login_account.
  2. Seleziona la scheda Utenti.
  3. Se login_account è un account amministratore Google Ads, disattiva l'opzione Mostra gli utenti di tutta la gerarchia per nascondere gli utenti degli account secondari.
  4. Verifica che l'Account Google per le tue credenziali sia nell'elenco degli account mostrati nella scheda Utenti.

Display & Video 360

  1. Vai a Gestione utenti e preferenze email nell'interfaccia utente di Display & Video 360.
  2. Verifica che in Gestione utenti l'Account Google per le tue credenziali sia un utente di login_account.

Google Analytics

  1. Vai a Gestione dell'accesso alla proprietà nella UI di Google Analytics.
  2. Verifica che la proprietà Google Analytics specificata nel login_account sia selezionata.
  3. Verifica che l'Account Google per le tue credenziali disponga del ruolo Editor o Amministratore nella proprietà.

Floodlight (Campaign Manager 360)

  1. Accedi alla UI di Campaign Manager 360.
  2. Vai ad Amministratore > Profili utente nel menu a sinistra.
  3. Verifica che l'Account Google per le tue credenziali sia nell'elenco dei profili mostrati.
  4. Fai clic sul profilo e verifica che abbia accesso all'account inserzionista utilizzato come login_account. Se non imposti un login_account nella richiesta, il valore predefinito è operating_account. Assicurati che l'account abbia un ruolo utente con l'autorizzazione Inserisci conversioni offline.
Avanti
Formattare i dati utente