Configurare le destinazioni

Ogni Destination 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 per i dati all'interno dell'account, ad esempio un'azione di conversione Google Ads o uno stream Google Analytics.
3. Il percorso di accesso per le credenziali della richiesta all'account che riceve i dati.

Se sei un inserzionista o un'agenzia, vai agli scenari per gli inserzionisti per esempi di come creare un Destination:

• Google Ads
• Display & Video 360
• Google Analytics

Se sei un partner di dati, vai a Scenari per i partner di dati per esempi di come creare un Destination per inviare dati a un account con un link di prodotto al tuo account partner di dati:

• Google Ads
• Display & Video 360
• Google Analytics

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

Scenari dell'inserzionista

Ecco come configurare un Destination per gli scenari comuni per gli inserzionisti e le agenzie. Questo diagramma mostra come l'API Data Manager utilizza le credenziali e i campi Destination per accedere all'account inserzionista.

Google Ads

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

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 di 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 di M2.

Account cliente C1

C1 ha due account amministratore principali diretti:

1. Account amministratore M1
2. Account amministratore M2

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

Account cliente C2

L'account amministratore M2 è l'unico genitore 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 per un Account Google che è un utente nell'account Google Ads:

Ecco un esempio di scenario di accesso diretto, utilizzando gli account del diagramma e le credenziali per l'Account 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"
    }
  ]
}

Scenario di accesso gestore

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

Di seguito è riportato un esempio di scenario di accesso amministratore per l'account cliente Google Ads C2 dal diagramma e dalle credenziali per l'account 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"
    }
  ]
}

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:

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

Display & Video 360

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

1. Accesso diretto, in cui le credenziali sono per 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 per 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 per un Account Google che è un utente nell'account inserzionista:

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

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

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

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

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

Scenario di accesso partner Display & Video 360

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

Ecco un esempio di Destination per uno scenario di accesso partner per inviare dati a un inserzionista Display & Video 360. In questo scenario, le credenziali devono essere per un account Google che sia un utente nell'account partner Display & Video 360 PARTNER_ID e l'account inserzionista Display & Video 360 ADVERTISER_ID deve essere un account secondario dell'account partner PARTNER_ID.

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

Google Analytics

Nota:operating_account e login_account devono essere identici quando la destinazione è un account Google Analytics. In caso contrario, la richiesta non va a buon fine e viene visualizzato l'errore OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

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

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

Scenari dei partner di dati

Ecco come configurare un Destination per scenari comuni per un partner di dati che invia dati agli account inserzionista con un collegamento prodotto stabilito all'account del partner di dati.

Questo diagramma mostra come l'API Data Manager utilizza le credenziali e i campi Destination per accedere all'account inserzionista tramite un collegamento prodotto.

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 ciascun account Google Ads o partner di dati, nonché i collegamenti tra gli account.

Partner di dati D1

Esiste un collegamento dei prodotti 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 collegamento dei prodotti 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 principali diretti:

1. Account amministratore M1
2. Account amministratore M2

Account cliente C2

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

Ecco cosa puoi fare con questo insieme di account:

Agire come partner di dati D1

Per agire in qualità di partner di dati D1, utilizza le credenziali per l'Account Google 222larabrown@gmail.com per inviare dati all'account amministratore M2, 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.

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

Agire come partner di dati D2

Per agire in qualità di partner di dati D2, utilizza le credenziali per l'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 e linked_account impostato sull'account cliente C1.

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 collegamento prodotto tra D2 e uno di questi account o i relativi account amministratore padre.

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

• Il partner di dati D1 è collegato a un account amministratore Google Ads. Questo è un esempio dello scenario di collegamento del prodotto dell'amministratore.
• Il partner di dati D2 è collegato a un account cliente Google Ads. Questo è un esempio di scenario di link diretto al prodotto.

Scenario di link diretto al prodotto

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

Ecco un esempio di scenario di link diretto al prodotto che utilizza gli account del diagramma. In questo scenario, il partner di dati D2 invia i dati dei membri del segmento di pubblico al cliente C1 di Google Ads utilizzando il collegamento del prodotto tra D2 e C1 e le credenziali per l'Account 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"
    }
  ]
}

Scenario di collegamento dei prodotti dell'account amministratore

Se vuoi inviare dati a un account Google Ads e il collegamento del prodotto si trova tra un account amministratore Google Ads principale e il tuo account partner di dati:

Ecco un esempio di scenario di collegamento dei prodotti amministratore utilizzando gli account del diagramma. In questo scenario, il partner di dati D1 invia i dati dei membri del segmento di pubblico al cliente C2 di Google Ads utilizzando il collegamento del prodotto tra D1 e M2 e le credenziali per l'Account 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

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

1. Utilizza un collegamento 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 collegamento prodotto tra un account partner di dati e l'account partner Display & Video 360 principale dell'inserzionista.

Scenari di link diretto al prodotto

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

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

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

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

Ecco un esempio di Destination per uno scenario di collegamento diretto al prodotto per inviare dati a un partner 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"
    }
  ]
}

Scenario di collegamento del prodotto partner Display & Video 360

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

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

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

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

Requisiti dettagliati

Questa sezione contiene requisiti dettagliati per i campi dell'account di un Destination, suggerimenti su come impostare product_destination_id e come determinare a cosa 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 l'account che riceve i dati nella richiesta. operating_account può essere uno dei seguenti:

• Un account Google Ads
• Un account inserzionista Display & Video 360
• Un account partner Display & Video 360
• Una proprietà Google Analytics
• Un account partner di dati se invii dati a un segmento di pubblico di proprietà dell'account partner di dati.

login_account

login_account non è sempre obbligatorio e il valore predefinito è operating_account.

L'API Data Manager verifica che:

1. L'Account Google delle credenziali è un utente di login_account.

2. login_account è uno dei seguenti:

   • Uguale a operating_account. Questa è l'impostazione predefinita se non imposti login_account.

   • Un account Google Ads Manager o partner Display & Video 360 che sia un account principale dell'operating_account.

   • Un account partner di dati con un link prodotto a linked_account.

linked_account

Il linked_account indica l'account con un collegamento prodotto al login_account.

ID destinazione prodotto

L'product_destination_id di un Destination identifica l'oggetto in 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 <x0A>ID misurazione per uno stream Google Analytics.

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

Segmento di pubblico Google Ads

L'ID destinazione prodotto per l'importazione dei membri del segmento di pubblico è l'ID segmento di pubblico.

Per ottenere l'ID segmento di pubblico dall'interfaccia utente 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 visualizzarne i dettagli.
3. L'ID segmento di pubblico è elencato accanto a ID elenco.

Per ottenere l'ID segmento di pubblico dall'API Google Ads:

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

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

2. Recupera l'ID pubblico dal campo id in user_list nella risposta.

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

Evento Google Ads

L'ID destinazione prodotto per l'importazione degli eventi è l'ID azione di conversione.

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

1. Vai a Conversioni nell'interfaccia utente di Google Ads.
2. Fai clic sul nome dell'azione di conversione per visualizzare i dettagli.

3. L'ID azione di conversione è il valore del parametro di query URL denominato ctId.

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

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

Segmento di pubblico Display & Video 360

L'ID destinazione prodotto per l'importazione dei membri del segmento di pubblico è l'ID segmento di pubblico.

Per ottenere l'ID segmento di pubblico dall'interfaccia utente di Display & Video 360:

1. Accedi all'interfaccia utente di Display & Video 360 all'indirizzo https://displayvideo.google.com.
2. Vai al partner o all'inserzionista Display & Video 360 che utilizzi per il 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.

Evento Google Analytics

L'ID destinazione prodotto per l'importazione degli eventi è l'ID misurazione dello stream di dati.

Determinare a cosa possono accedere 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 dell'account di servizio, le richieste vengono autorizzate come Account Google dell'account di servizio.

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

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 presente nell'elenco degli account visualizzati nella scheda Utenti.

Display & Video 360

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

Google Analytics

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