Konfigurowanie miejsc docelowych i nagłówków

Zarówno koncepcja Destination, jak i nagłówki żądań pojawiają się często podczas pracy z interfejsem Data Manager API. Z tego przewodnika dowiesz się, jak skonfigurować miejsca docelowe i nagłówki w różnych scenariuszach.

Kiedy używać miejsc docelowych lub nagłówków

• Używaj znaku Destination w żądaniach dotyczących przesyłania danych. Żądanie przesyłania danych używa IngestionService do dodawania lub usuwania członków z listy odbiorców albo do wysyłania zdarzeń. Lista destinations w IngestAudienceMembersRequest lub IngestEventsRequest określa:

  1. Konto, które otrzymuje dane. Może to być np. konto Google Ads lub usługa w Google Analytics.
  2. Jednostka docelowa danych na koncie, np. działanie powodujące konwersję w Google Ads lub strumień danych w Google Analytics.
  3. Ścieżka dostępu danych logowania żądania do konta, które otrzymuje dane.

  W tym samym żądaniu możesz uwzględnić wiele miejsc docelowych.

  Wskazówka: nie ustawiaj nagłówków żądania w żądaniu IngestionService. Interfejs Data Manager API ignoruje nagłówki w żądaniu przesyłania danych.

• Używaj nagłówków żądań w żądaniach zarządzania zasobami, które tworzą, aktualizują, usuwają lub pobierają zasoby. Nagłówki określają ścieżkę dostępu danych logowania żądania do konta docelowego żądania zarządzania zasobami. Oto lista zasobów z metodami zarządzania zasobami, które obsługują nagłówki żądań:

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

Jeśli na przykład chcesz utworzyć listę odbiorców, dodać do niej użytkowników, sprawdzić diagnostykę, a następnie pobrać listę, aby sprawdzić jej rozmiar, wykonaj te czynności, używając odpowiedniego typu żądania i określając, czy należy użyć miejsc docelowych czy nagłówków żądań:

Krok	Typ żądania	Nagłówki miejsca docelowego lub żądania
Tworzenie listy odbiorców	Zarządzanie zasobami	Nagłówki żądania
Dodawanie członków do grupy odbiorców	Przetwarzanie	Miejsca docelowe
Sprawdź diagnostykę	Przetwarzanie	Miejsca docelowe
Pobieranie listy odbiorców	Zarządzanie zasobami	Nagłówki żądania

Przełączaj się między szczegółami w tym przewodniku dla poszczególnych typów żądań, klikając karty Przetwarzanie lub Zarządzanie zasobami wokół każdej tabeli.

Jeśli jesteś reklamodawcą lub agencją, przejdź do sekcji Scenariusze dla reklamodawców, aby zobaczyć przykłady ustawiania nagłówków i tworzenia Destination:

• Google Ads
• Display & Video 360
• Google Analytics

Jeśli jesteś dostawcą danych, przejdź do sekcji Scenariusze dla dostawców danych, aby zobaczyć przykłady ustawiania nagłówków i tworzenia Destination do zarządzania zasobami i wysyłania danych na konto z linkiem do produktu na Twoje konto dostawcy danych:

• Google Ads
• Display & Video 360
• Google Analytics

W sekcji Szczegółowe wymagania znajdziesz szczegółowe informacje o wymaganiach i zasadach weryfikacji.

Scenariusze reklamodawców

Oto jak skonfigurować nagłówki Destination lub nagłówki żądań w przypadku typowych scenariuszy dla reklamodawców i agencji. Ten diagram pokazuje, jak interfejs Data Manager API używa pól credentials i Destination, aby uzyskać dostęp do konta reklamodawcy.

Google Ads

Oto diagram przedstawiający przykładowy zestaw kont Google Ads i użytkowników.

Konto menedżera M1

Konto M1 ma 2 bezpośrednie konta podrzędne:

1. Konto menedżera M2
2. Konto klienta C1

Konto Google [e-mail] jest użytkownikiem w M1.

Konto menedżera M2

Konto M2 ma 2 bezpośrednie konta podrzędne:

1. Konto klienta C1
2. Konto klienta C2

Konto Google [e-mail] jest użytkownikiem konta M2.

Konto klienta C1

Konto C1 ma 2 bezpośrednie nadrzędne konta menedżera:

1. Konto menedżera M1
2. Konto menedżera M2

Konto Google [e-mail] jest użytkownikiem na koncie C1.

Konto klienta C2

Konto menedżera M2 jest jedynym bezpośrednim kontem nadrzędnym konta C2.

Żadne z wymienionych kont Google nie jest użytkownikiem na koncie C2.

W scenariuszu bezpośredniego dostępu i scenariuszu dostępu menedżera pokazujemy, jak skonfigurować miejsce docelowe, aby wysyłać dane na te konta.

Scenariusz dostępu bezpośredniego

Jeśli chcesz wysyłać dane na konto Google Ads, a Twoje dane logowania dotyczą konta Google, które jest użytkownikiem konta Google Ads:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator klienta konta Google Ads account_type GOOGLE_ADS
login_account	Nie ustawiaj wartości parametru login_account lub ustaw dla niego te same wartości co w przypadku parametru operating_account.
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców lub działania powodującego konwersję.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład scenariusza bezpośredniego dostępu z użyciem kont z diagramu i danych logowania do konta Google [e-mail]:

Przetwarzanie

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

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

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Scenariusz dostępu menedżera

Jeśli chcesz wysyłać dane na konto Google Ads, a Twoje dane logowania dotyczą konta Google, które jest użytkownikiem konta menedżera Google Ads, na którym konto reklamodawcy jest kontem podrzędnym:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator klienta konta klienta Google Ads. account_type GOOGLE_ADS
login_account	account_id Identyfikator klienta konta menedżera Google Ads account_type GOOGLE_ADS
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców lub działania powodującego konwersję.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład scenariusza dostępu menedżera do konta klienta Google Ads C2 z diagramu oraz dane logowania do konta Google [e-mail]:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto kolejny przykład scenariusza dostępu menedżera do konta klienta Google Ads C2 i danych logowania do konta Google [e-mail], które jest użytkownikiem konta menedżera Google Ads M1:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Display & Video 360

Dane możesz wysyłać do Display & Video 360 na 2 sposoby:

1. Bezpośredni dostęp, w którym dane logowania dotyczą konta Google, które jest użytkownikiem konta reklamodawcy lub partnera w Display & Video 360.
2. Dostęp partnera Display & Video 360, w którym dane logowania dotyczą konta Google, które jest kontem użytkownika na koncie partnera Display & Video 360, a konto operacyjne to konto reklamodawcy Display & Video 360 na koncie partnera.

Scenariusze dostępu bezpośredniego

Jeśli chcesz wysyłać dane na konto reklamodawcy Display & Video 360, a Twoje dane logowania dotyczą konta Google, które jest użytkownikiem na koncie reklamodawcy:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator konta reklamodawcy Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	Nie ustawiaj wartości parametru login_account lub ustaw dla niego te same wartości co w przypadku parametru operating_account.
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład Destination w przypadku scenariusza bezpośredniego dostępu do wysyłania danych do reklamodawcy Display & Video 360:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Podobnie, jeśli chcesz wysyłać dane na konto partnera Display & Video 360, a Twoje dane logowania dotyczą konta Google, które jest użytkownikiem na koncie partnera:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator konta partnera Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	Nie ustawiaj wartości parametru login_account lub ustaw dla niego te same wartości co w przypadku parametru operating_account.
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład Destination w przypadku scenariusza bezpośredniego dostępu do wysyłania danych do partnera Display & Video 360:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Scenariusz dostępu partnera Display & Video 360

Jeśli chcesz wysyłać dane do reklamodawcy Display & Video 360, a Twoje dane logowania dotyczą konta Google, które jest użytkownikiem na koncie nadrzędnym partnera Display & Video 360 reklamodawcy:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator konta reklamodawcy Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Identyfikator konta partnera Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład Destination w przypadku scenariusza dostępu partnera do wysyłania danych do reklamodawcy Display & Video 360. W tym przypadku dane logowania muszą dotyczyć konta Google, które jest użytkownikiem konta partnera Display & Video 360DISPLAY_VIDEO_PARTNER_ID, a konto reklamodawcy Display & Video 360DISPLAY_VIDEO_ADVERTISER_ID musi być podrzędne względem konta partneraDISPLAY_VIDEO_PARTNER_ID.

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Google Analytics

Uwaga: jeśli operating_account to konto Google Analytics, nie ustawiaj parametru login_account lub ustaw go na te same wartości co parametr operating_account. W przeciwnym razie żądanie zakończy się niepowodzeniem z błędem OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator usługi w Google Analytics account_type GOOGLE_ANALYTICS_PROPERTY
login_account	Nie ustawiaj wartości parametru login_account lub ustaw dla niego te same wartości co w przypadku parametru operating_account.
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator pomiaru strumienia danych.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład Destination służący do wysyłania zdarzeń do Google Analytics:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Scenariusze dostawców danych

Oto jak skonfigurować Destination w przypadku typowych scenariuszy dostawcy danych, który wysyła dane na konta reklamodawców z ustanowionym połączeniem usługi z kontem dostawcy danych.

Uwaga: w każdym scenariuszu dotyczącym partnera danych dane logowania muszą być powiązane z kontem Google, które jest użytkownikiem konta partnera danych.

Ten diagram pokazuje, jak interfejs Data Manager API używa danych logowania i pól Destination, aby uzyskać dostęp do konta reklamodawcy za pomocą połączenia z usługą.

Google Ads

Diagram przedstawiający przykładowy zestaw kont Google Ads i kont partnera danych. Diagram pokazuje też, które konto Google jest użytkownikiem każdego konta Google Ads lub konta partnera danych, a także połączenia między kontami.

Dostawca danych D1

Istnieje połączenie usług między usługą D1 a kontem menedżera Google Ads M2.

Konto Google [e-mail] jest użytkownikiem domeny D1.

Dostawca danych D2

Istnieje połączenie usług między usługą D2 a kontem klienta Google Ads C1.

Konto Google [e-mail] jest użytkownikiem w D2.

Konto menedżera M1

Konto M1 ma 2 bezpośrednie konta podrzędne:

1. Konto menedżera M2
2. Konto klienta C1

Konto menedżera M2

Konto M2 ma 2 bezpośrednie konta podrzędne:

1. Konto klienta C1
2. Konto klienta C2

Konto klienta C1

Konto C1 ma 2 bezpośrednie nadrzędne konta menedżera:

1. Konto menedżera M1
2. Konto menedżera M2

Konto klienta C2

Konto menedżera M2 jest jedynym bezpośrednim kontem nadrzędnym konta C2.

Oto co możesz zrobić z tym zestawem kont:

Działanie jako dostawca danych D1

Aby działać jako partner danych D1, użyj danych logowania do konta [e-mail], aby wysyłać dane na konto menedżera M2, konto klienta C1 lub konto klienta C2, używając miejsca docelowego z parametrem login_account ustawionym na konto partnera danych D1, a parametrem linked_account ustawionym na konto menedżera M2.

Jako dostawca danych D1 nie możesz wysyłać danych na konto menedżera M1, ponieważ nie ma połączenia między usługami D1 i M1.

Działanie jako dostawca danych D2

Aby działać jako dostawca danych D2, użyj danych logowania do konta [e-mail], aby wysyłać dane na konto klienta C1, korzystając z miejsca docelowego z wartością login_account ustawioną na konto dostawcy danych D2 i wartością linked_account ustawioną na konto klienta C1.

Jako dostawca danych D2 nie możesz wysyłać danych na konto menedżera M1, konto menedżera M2 ani konto klienta C2, ponieważ nie ma połączenia z usługą między D2 a żadnym z tych kont ani ich nadrzędnymi kontami menedżera.

Główna różnica między partnerami danych D1 i D2 polega na sposobie połączenia partnera danych z kontami Google Ads.

• Partner danych D1 jest połączony z kontem menedżera Google Ads. To jest przykład scenariusza połączenia usługi z kontem menedżera.
• Dostawca danych D2 jest połączony z kontem klienta Google Ads. To jest przykład scenariusza bezpośredniego linku do produktu.

Scenariusz bezpośredniego linku do produktu

Jeśli chcesz wysyłać dane na konto Google Ads, a połączenie usługi jest między kontem Google Ads a kontem partnera danych:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator klienta konta Google Ads account_type GOOGLE_ADS
login_account	account_id Identyfikator klienta konta dostawcy danych account_type DATA_PARTNER
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców lub działania powodującego konwersję.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład scenariusza bezpośredniego linku do produktu z użyciem kont z diagramu oraz odpowiednich nagłówków żądań w przypadku żądań zarządzania zasobami. W tym scenariuszu partner danych D2 wysyła dane o członku listy odbiorców do klienta Google Ads C1 za pomocą połączenia między usługami D2 i C1 oraz danych logowania do konta Google [e-mail]:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Scenariusz połączenia usług na koncie menedżera

Jeśli chcesz wysyłać dane na konto Google Ads, a połączenie usługi jest między nadrzędnym kontem menedżera Google Ads a kontem dostawcy danych:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator klienta konta klienta Google Ads. account_type GOOGLE_ADS
login_account	account_id Identyfikator klienta konta dostawcy danych account_type DATA_PARTNER
linked_account	account_id Identyfikator klienta konta menedżera Google Ads account_type GOOGLE_ADS
product_destination_id	Identyfikator listy odbiorców lub działania powodującego konwersję.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

Oto przykład scenariusza dotyczącego linku do produktu na koncie menedżera z użyciem kont z diagramu. W tym scenariuszu partner danych D1 wysyła dane o członkach listy odbiorców do klienta Google Ads C2 za pomocą połączenia między usługami D1 i M2 oraz danych logowania do konta Google [e-mail]:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID

Display & Video 360

Jako partner danych możesz wysyłać dane na konto Display & Video 360 na 2 sposoby:

1. Użyj bezpośredniego połączenia usługi między kontem partnera danych a kontem partnera lub reklamodawcy Display & Video 360.
2. wysyłać dane do reklamodawcy Display & Video 360 za pomocą połączenia usługi między kontem partnera danych a nadrzędnym kontem partnera Display & Video 360 reklamodawcy;

Scenariusze bezpośredniego linku do produktu

Jeśli chcesz wysyłać dane do reklamodawcy Display & Video 360, a połączenie usługi jest między kontem reklamodawcy Display & Video 360 a Twoim kontem partnera danych:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator konta reklamodawcy Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Identyfikator klienta konta dostawcy danych account_type DATA_PARTNER
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców lub działania powodującego konwersję.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład Destination w przypadku scenariusza bezpośredniego linku do produktu, który umożliwia wysyłanie danych do reklamodawcy Display & Video 360, oraz odpowiednie nagłówki żądań w przypadku żądań zarządzania zasobami:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Jeśli chcesz wysyłać dane na konto partnera Display & Video 360, musisz mieć połączenie między kontem partnera Display & Video 360 a kontem partnera danych.

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator konta partnera Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
login_account	account_id Identyfikator klienta konta dostawcy danych account_type DATA_PARTNER
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator listy odbiorców lub działania powodującego konwersję.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Oto przykład Destination w przypadku scenariusza bezpośredniego linku do produktu, który umożliwia wysyłanie danych do partnera Display & Video 360, oraz odpowiednie nagłówki żądań w przypadku żądań zarządzania zasobami:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Nie ustawiaj nagłówka linked-account.

Scenariusz połączenia usługi partnera Display & Video 360

Jeśli chcesz wysyłać dane do reklamodawcy Display & Video 360, a połączenie usługi z kontem partnera danych jest z kontem partnera Display & Video 360, na którym konto reklamodawcy jest kontem podrzędnym:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator konta reklamodawcy Display & Video 360 account_type DISPLAY_VIDEO_ADVERTISER
login_account	account_id Identyfikator klienta konta dostawcy danych account_type DATA_PARTNER
linked_account	account_id Identyfikator konta partnera Display & Video 360 account_type DISPLAY_VIDEO_PARTNER
product_destination_id	Identyfikator listy odbiorców lub działania powodującego konwersję.

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Oto przykład Destination w scenariuszu połączenia z usługą partnera, który umożliwia wysyłanie danych do reklamodawcy Display & Video 360 za pomocą połączenia między partnerem danych a nadrzędnym partnerem Display & Video 360 reklamodawcy:

Przetwarzanie

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

Zarządzanie zasobami

Nagłówki żądania
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

Google Analytics

Interfejs Data Manager API nie obsługuje wysyłania danych na konto Google Analytics za pomocą połączenia usług. Zamiast tego użyj scenariuszy reklamodawców w Google Analytics.

Szczegółowe wymagania

Ta sekcja zawiera szczegółowe wymagania dotyczące pól konta w przypadku żądania Destination dla IngestionService, równoważne nagłówki żądań w przypadku żądań zarządzania zasobami, wskazówki dotyczące ustawiania product_destination_id oraz informacje o tym, jak określić, do czego masz dostęp za pomocą swoich danych logowania.

Pola konta

Destination może mieć maksymalnie 3 różne konta:

operating_account

Pole operating_account jest wymagane.

Symbol operating_account wskazuje, które konto otrzymuje dane w żądaniu. operating_account może być dowolnym z tych elementów:

• konto Google Ads;
• konto reklamodawcy Display & Video 360;
• Konto partnera Display & Video 360
• usługa w Google Analytics,
• Konto dostawcy danych, jeśli wysyłasz dane do odbiorców należących do tego konta.

Nie ma nagłówka żądania, który odpowiadałby polu operating_account w Destination. Gdy wysyłasz prośbę o zarządzanie zasobami, kontem docelowym jest konto operacyjne.

pole login_account i nagłówek żądania login-account.

Parametr login_account nie jest zawsze wymagany. W przypadku żądania IngestionService domyślnie przyjmuje wartość operating_account, a w przypadku żądania zarządzania zasobami – konto docelowe. W żądaniu zarządzania zasobami użyj nagłówka żądania login-account, aby zidentyfikować konto logowania.

Interfejs Data Manager API sprawdza, czy:

1. Konto Google powiązane z danymi logowania jest użytkownikiem konta logowania.

2. Konto logowania może być jednym z tych kont:

   • Taki sam jak operating_account. Jest to wartość domyślna, jeśli nie ustawisz login_account elementu Destination w żądaniu IngestionService lub nie ustawisz nagłówka login-account w żądaniu zarządzania zasobami.

   • Konto menedżera Google Ads lub konto partnera Display & Video 360, które jest kontem nadrzędnym konta operating_account w żądaniu IngestionService lub kontem nadrzędnym konta docelowego w żądaniu zarządzania zasobami.

   • Konto dostawcy danych z linkiem do produktu w żądaniu linked_account in an IngestionService lub w nagłówku linked-account w żądaniu zarządzania zasobami.

pole linked_account i nagłówek żądania linked-account.

Uwaga: połączone konto należy podać tylko wtedy, gdy konto logowania ma wartość account_type ustawioną na DATA_PARTNER, a konto nadrzędne usługi operating_account jest połączone z kontem partnera danych. Jeśli parametr operating_account jest bezpośrednio połączony z kontem dostawcy danych, nie ustawiaj parametru linked_account.

Symbol linked_account wskazuje, które konto ma połączenie z usługą w przypadku prośby o IngestionService lub konta docelowego w przypadku prośby o zarządzanie zasobami.login_account

Identyfikator miejsca docelowego produktu

product_destination_id obiektu Destination określa, który obiekt w operating_account otrzymuje dane. Może to być np. identyfikator odbiorców w Google Ads lub Display & Video 360, identyfikator działania powodującego konwersję w Google Ads lub identyfikator pomiaru w przypadku strumienia danych Google Analytics.

Oto jak znaleźć identyfikator każdego typu miejsca docelowego produktu.

Lista odbiorców Google Ads

Identyfikator miejsca docelowego produktu do pozyskiwania członków listy odbiorców to identyfikator listy odbiorców. Pobierz ten identyfikator za pomocą interfejsu Google Ads lub interfejsu Data Manager API.

Interfejs Google Ads

Aby uzyskać identyfikator listy odbiorców w interfejsie Google Ads:

1. W interfejsie Google Ads kliknij Zarządzanie odbiorcami.
2. Aby wyświetlić szczegóły, kliknij nazwę listy odbiorców.
3. Identyfikator odbiorców znajduje się obok pozycji Identyfikator listy.

Data Manager API

Pobierz UserList za pomocą metody List, w razie potrzeby podając nagłówki żądania, i użyj id z UserList jako identyfikatora miejsca docelowego produktu.

Zdarzenie w Google Ads

Identyfikator miejsca docelowego produktu do przesyłania zdarzeń to identyfikator działania powodującego konwersję.

Aby uzyskać identyfikator działania powodującego konwersję w interfejsie Google Ads:

1. W interfejsie Google Ads kliknij Konwersje.
2. Aby wyświetlić szczegóły, kliknij nazwę działania powodującego konwersję.

3. Identyfikator działania powodującego konwersję to wartość parametru zapytania adresu URL o nazwie ctId.

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

Aby uzyskać identyfikator działania powodującego konwersję z interfejsu Google Ads API:

1. Wyślij żądanie Search lub SearchStream do GoogleAdsService z tym zapytaniem:

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

2. Pobierz identyfikator działania powodującego konwersję z pola id w odpowiedzi.conversion_action

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

Lista odbiorców Display & Video 360

Identyfikator miejsca docelowego produktu do pozyskiwania członków listy odbiorców to identyfikator listy odbiorców. Pobierz ten identyfikator za pomocą interfejsu Display & Video 360 lub interfejsu Data Manager API.

Interfejs Display & Video 360

Aby uzyskać identyfikator listy odbiorców w interfejsie Display & Video 360:

1. Zaloguj się w interfejsie Display & Video 360 na stronie https://displayvideo.google.com.
2. Przejdź do partnera lub reklamodawcy Display & Video 360, którego używasz w przypadku operating_account.
3. W menu po lewej stronie kliknij kolejno Odbiorcy i Wszyscy odbiorcy.
4. Znajdź odbiorców na liście. Identyfikator odbiorców to numer obok nazwy w kolumnie Nazwa.

Data Manager API

Pobierz UserList za pomocą metody List, w razie potrzeby podając nagłówki żądania, i użyj id z UserList jako identyfikatora miejsca docelowego produktu.

Zdarzenie Google Analytics

Identyfikator miejsca docelowego produktu do pozyskiwania zdarzeń to identyfikator pomiaru strumienia danych.

Określanie, gdzie dane logowania mają dostęp

Dane logowania, których używasz do autoryzowania żądania interfejsu Data Manager API, są powiązane z określonym kontem Google.

• Jeśli używasz danych logowania użytkownika, żądania są autoryzowane jako konto Google użytkownika, który przyznał uprawnienia do działania w jego imieniu podczas generowania danych logowania.
• Jeśli używasz danych logowania konta usługi, żądania są autoryzowane jako konto Google konta usługi.

Aby sprawdzić, czy konto Google użyte do logowania ma dostęp do konta Google Ads, Display & Video 360 lub Google Analytics, wykonaj te czynności:

Google Ads lub dostawca danych

1. W interfejsie Google Ads kliknij Dostęp i bezpieczeństwo login_account.
2. Kliknij kartę Użytkownicy.
3. Jeśli login_account to konto menedżera Google Ads, wyłącz przełącznik Pokaż użytkowników w pełnej hierarchii, aby ukryć użytkowników z kont podrzędnych.
4. Sprawdź, czy konto Google powiązane z Twoimi danymi logowania znajduje się na liście kont wyświetlanych na karcie Użytkownicy.

Display & Video 360

1. W interfejsie Display & Video 360 kliknij Zarządzanie użytkownikami i ustawienia powiadomień e-mail.
2. Sprawdź, czy w sekcji Zarządzanie użytkownikami widać, że konto Google, którego używasz do logowania, jest użytkownikiem usługi login_account.

Google Analytics

1. W interfejsie Google Analytics otwórz Zarządzanie dostępem do usługi.
2. Sprawdź, czy wybrana jest usługa w Google Analytics podana w login_account.
3. Sprawdź, czy konto Google, na którym są zapisane Twoje dane logowania, ma w usłudze rolę Edytujący lub Administrator.