Konfigurowanie miejsc docelowych i nagłówków

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

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

• Użyj Destination w żądaniach pozyskiwania. Żądanie pozyskiwania danych używa metody IngestionService, aby dodawać lub usuwać członków listy odbiorców albo wysyłać zdarzenia. Lista destinations w obiekcie IngestAudienceMembersRequest lub IngestEventsRequest określa:

  1. Konto, które otrzymuje dane. na przykład konto Google Ads lub usługę w Google Analytics.
  2. Element docelowy danych na koncie, np. działanie powodujące konwersję w Google Ads lub strumień Google Analytics.
  3. Ścieżka dostępu danych logowania żądania do konta, które otrzymuje dane.

  W jednym żądaniu pozyskiwania 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 pozyskiwania.

• Używaj nagłówków żądań w żądaniach zarządzania zasobami, które tworzą, aktualizują, usuwają lub pobierają zasoby. Nagłówki definiują ś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 członków, sprawdzić diagnostykę, a następnie pobrać listę odbiorców, aby sprawdzić jej rozmiar, oto każdy krok, typ żądania, którego należy użyć, oraz informacja, czy należy użyć miejsc docelowych czy nagłówków żądania:

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

Uwaga: żądanie RetrieveRequestStatus nie akceptuje bezpośrednio miejsc docelowych ani nagłówków żądań. Zamiast tego interfejs Data Manager API weryfikuje autoryzację, korzystając z miejsc docelowych i ścieżki dostępu z pierwotnego żądania pozyskiwania. Szczegółowe informacje znajdziesz w sekcji Autoryzacja w przewodniku po diagnostyce.

Aby przełączać się między szczegółami dotyczącymi poszczególnych typów żądań, klikaj kartę Przetwarzanie lub Zarządzanie zasobami obok każdej tabeli.

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

• Google Ads
• Display & Video 360
• Google Analytics
• Floodlight

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

• Google Ads
• Display & Video 360
• Google Ad Manager
• Google Analytics
• Floodlight

Sekcja Szczegółowe wymagania zawiera szczegółowe informacje o wymaganiach i regułach weryfikacji.

Scenariusze rozmów z reklamodawcami

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

Google Ads

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

Konto menedżera M1

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

M2 ma 2 bezpośrednie konta podrzędne:

1. Konto klienta C1
2. Konto klienta C2

Konto Google [e-mail] jest użytkownikiem na koncie 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 K1.

Konto klienta C2

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

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

Scenariusz dostępu bezpośredniego i scenariusz dostępu menedżera pokazują, 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 parametru login_account lub ustaw go na takie same wartości jak parametr 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 dostępu bezpośredniego z użyciem kont z diagramu i danych logowania na konto 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 na koncie 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 i danych logowania na konto 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 na konto 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 do Display & Video 360 możesz wysyłać na 2 sposoby:

1. Dostęp bezpośredni, w którym dane logowania dotyczą konta Google, które jest użytkownikiem na koncie reklamodawcy lub partnera Display & Video 360.
2. Dostęp partnera Display & Video 360, gdzie dane logowania dotyczą konta Google, które jest użytkownikiem 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 parametru login_account lub ustaw go na takie same wartości jak parametr 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 scenariuszu bezpośredniego dostępu do wysyłania danych do reklamodawcy w 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 parametru login_account lub ustaw go na takie same wartości jak parametr 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 w 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 w 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 nadrzędnym koncie 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, który wysyła dane do reklamodawcy Display & Video 360. W tym scenariuszu dane logowania muszą dotyczyć konta Google, które jest użytkownikiem na koncie partnera Display & Video 360 DISPLAY_VIDEO_PARTNER_ID, a konto reklamodawcy Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID musi być kontem podrzędnym konta partnera DISPLAY_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 login_account lub ustaw te same wartości co w operating_account. W przeciwnym razie żądanie nie powiedzie się i pojawi się błąd 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 parametru login_account lub ustaw go na takie same wartości jak parametr operating_account.
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator pomiaru strumienia danych z sieci. Identyfikator aplikacji w Firebase strumienia danych z aplikacji.

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

Floodlight

Uwaga: jeśli operating_account to konfiguracja Floodlight, nie ustawiaj login_account lub ustaw takie same wartości jak w przypadku operating_account. W przeciwnym razie żądanie nie powiedzie się i pojawi się błąd OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator konfiguracji Floodlight Jeśli reklamodawca jest podrzędny względem reklamodawcy nadrzędnego, jako identyfikatora konfiguracji Floodlight użyj identyfikatora reklamodawcy nadrzędnego w usłudze Campaign Manager 360. W przeciwnym razie użyj identyfikatora reklamodawcy. Dowiedz się, jak znaleźć identyfikator reklamodawcy w interfejsie Campaign Managera 360 account_type FLOODLIGHT_CONFIG
login_account	Nie ustawiaj parametru login_account lub ustaw go na takie same wartości jak parametr operating_account.
linked_account	Nie ustawiaj pola linked_account.
product_destination_id	Identyfikator aktywności Floodlight

Oto przykład tagu Destination do wysyłania zdarzeń do Floodlight:

Przetwarzanie

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

Scenariusze dotyczące dostawców danych

Oto jak skonfigurować Destination w typowych scenariuszach dla dostawcy danych, który wysyła dane na konta reklamodawców z ustalonym połączeniem partnera z kontem dostawcy danych.

Uwaga: w każdym przypadku dostawcy danych dane logowania muszą dotyczyć konta Google, które jest użytkownikiem na koncie dostawcy 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ą linku partnera.

Google Ads

Oto diagram przedstawiający przykładowy zestaw kont Google Ads i dostawców danych. Diagram pokazuje też, które konto Google jest użytkownikiem na każdym koncie Google Ads lub koncie dostawcy danych, a także połączenia partnerskie między kontami.

Dostawca danych D1

Między kontem D1 a kontem menedżera Google Ads M2 istnieje połączenie partnerskie.

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

Dostawca danych D2

Między kontem klienta Google Ads C1 a kontem D2 istnieje połączenie partnerskie.

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

Konto menedżera M1

M1 ma 2 bezpośrednie konta podrzędne:

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

Konto menedżera M2

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

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

Działanie jako dostawca danych D1

Aby działać jako dostawca danych D1, użyj danych logowania na konto Google [e-mail], aby:

• wysyłać dane na konto klienta K1 lub K2, używając miejsca docelowego z parametrem login_account ustawionym na konto dostawcy danych D1 i parametrem linked_account ustawionym na konto menedżera M2;

• Wysyłaj dane bezpośrednio na konto menedżera M2, używając miejsca docelowego z parametrem login_account ustawionym na konto dostawcy danych D1. Nie ustawiaj linked_account.

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

Działanie jako dostawca danych D2

Aby działać jako dostawca danych D2, użyj danych logowania na konto Google [e-mail] i wyślij dane na konto klienta C1, korzystając z miejsca docelowego z parametrem login_account ustawionym na konto dostawcy danych D2. Nie ustawiaj linked_account.

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 partnerskiego między D2 a żadnym z tych kont ani ich nadrzędnymi kontami menedżera.

Kluczowa różnica między dostawcami danych D1 i D2 polega na sposobie ich połączenia z kontami Google Ads.

• Dostawca danych D1 jest połączony z kontem menedżera Google Ads. To jest przykład scenariusza połączenia z partnerem zarządzającym.
• Dostawca danych D2 jest połączony z kontem klienta Google Ads. To jest przykład scenariusza z bezpośrednim linkiem do partnera.

Scenariusz bezpośredniego połączenia z partnerem

Jeśli chcesz wysyłać dane na konto Google Ads, a połączenie z partnerem jest między kontem Google Ads a kontem dostawcy 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 połączenia partnera z użyciem kont z diagramu i odpowiednich nagłówków żądań dotyczących zarządzania zasobami. W tym scenariuszu dostawca danych D2 wysyła dane odbiorców do klienta Google Ads C1, korzystając z połączenia partnerskiego między D2 i C1 oraz danych logowania na konto 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 z partnerem menedżera

Jeśli chcesz wysyłać dane na konto Google Ads, a połączenie z partnerem 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 połączenia konta menedżera z kontem partnera z użyciem kont z diagramu. W tym scenariuszu dostawca danych D1 wysyła dane odbiorców do klienta Google Ads C2, korzystając z połączenia między D1 i M2 oraz danych logowania na konto 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 dostawca danych możesz wysyłać dane na konto Display & Video 360 na 2 sposoby:

1. Użyj bezpośredniego połączenia partnera między kontem dostawcy danych a kontem partnera lub reklamodawcy Display & Video 360.
2. Wysyłanie danych do reklamodawcy Display & Video 360 za pomocą połączenia partnerskiego między kontem dostawcy danych a kontem nadrzędnym partnera Display & Video 360 reklamodawcy.

Scenariusze bezpośredniego połączenia z partnerem

Jeśli chcesz wysyłać dane do reklamodawcy w Display & Video 360, a połączenie partnera jest między kontem reklamodawcy w Display & Video 360 a Twoim kontem dostawcy 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 połączenia z partnerem, który umożliwia wysyłanie danych do reklamodawcy Display & Video 360, oraz odpowiadające mu nagłówki żą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 partnerskie między kontem partnera Display & Video 360 a kontem dostawcy 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 scenariuszu bezpośredniego połączenia z partnerem, który służy do wysyłania danych do partnera Display & Video 360, oraz odpowiednie nagłówki żą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 z partnerem nadrzędnym

Jeśli chcesz wysyłać dane do reklamodawcy Display & Video 360, a link partnera do Twojego konta dostawcy danych jest powiązany 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 przypadku scenariusza połączenia z partnerem, w którym dane są wysyłane do reklamodawcy Display & Video 360 za pomocą połączenia między dostawcą danych a partnerem nadrzędnym 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 Ad Manager

Jeśli chcesz wysyłać dane na konto Google Ad Managera i masz połączenie partnerskie między kontem dostawcy danych a kontem Google Ad Managera:

Przetwarzanie

Miejsce docelowe
operating_account	account_id Identyfikator połączenia z listą odbiorców konta Google Ad Managera. account_type GOOGLE_AD_MANAGER_AUDIENCE_LINK
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.

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 do wysyłania danych na konto menedżera Google Ads za pomocą linku partnera:

Przetwarzanie

      {
        "destinations": [
          {
            "operatingAccount": {
              "accountId": "GAM_AUDIENCE_LINK_ID",
              "accountType": "GOOGLE_AD_MANAGER_AUDIENCE_LINK"
            },
            "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.

Google Analytics

Interfejs Data Manager API nie obsługuje wysyłania danych na konto Google Analytics za pomocą linku partnera. Zamiast tego użyj podejścia scenariusze reklamodawcy w Google Analytics.

Floodlight

Interfejs Data Manager API nie obsługuje wysyłania danych do konfiguracji Floodlight za pomocą linku partnera. Zamiast tego użyj podejścia scenariusze reklamodawcy dotyczące Floodlight.

Szczegółowe wymagania

Ta sekcja zawiera szczegółowe wymagania dotyczące pól konta w obiekcie Destination w żądaniu IngestionService, odpowiadające im nagłówki żądań zarządzania zasobami, wskazówki dotyczące ustawiania pola product_destination_id oraz informacje o tym, jak określić, do czego mają dostęp Twoje dane logowania.

Pola konta

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

operating_account

Pole operating_account jest wymagane.

Parametr 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,
• konto Google Ad Managera,
• usługę w Google Analytics,
• konto dostawcy danych, jeśli wysyłasz dane do odbiorców należących do konta dostawcy danych.

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

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

Parametr login_account nie zawsze jest wymagany i domyślnie jest ustawiony na operating_account w żądaniu IngestionService oraz na konto docelowe w żądaniu zarządzania zasobami. 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, którego dotyczą dane logowania, jest użytkownikiem na koncie logowania.

2. Konto logowania jest jednym z tych kont:

   • Taka sama jak operating_account. Jest to ustawienie domyślne, jeśli nie ustawisz login_account dla Destination w żądaniu IngestionService lub nie ustawisz nagłówka login-account w żądaniu zarządzania zasobami.

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

   • Konto dostawcy danych z linkiem partnera do linked_account w żądaniu IngestionService lub nagłówek 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 parametr account_type ustawiony na DATA_PARTNER, a konto nadrzędne konta operating_account jest połączone z kontem dostawcy danych. Jeśli operating_account jest bezpośrednio połączony z kontem dostawcy danych, nie ustawiaj linked_account.

linked_account wskazuje, które konto ma połączenie partnerskie z login_account prośby IngestionService lub konto docelowe prośby o zarządzanie zasobami.

Identyfikator miejsca docelowego produktu

product_destination_id elementu 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 strumienia danych Google Analytics.

Poniżej znajdziesz informacje o tym, jak znaleźć identyfikator dla każdego typu miejsca docelowego produktu.

Lista odbiorców Google Ads

Identyfikator miejsca docelowego usługi na potrzeby pozyskiwania 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. Kliknij nazwę listy odbiorców, aby wyświetlić szczegóły.
3. Identyfikator odbiorców jest podany 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 elementu UserList jako identyfikatora miejsca docelowego produktu.

Zdarzenie w Google Ads

Identyfikator miejsca docelowego usługi na potrzeby pozyskiwania zdarzeń to identyfikator działania powodującego konwersję. Ten identyfikator możesz pobrać za pomocą interfejsu Google Ads lub interfejsu Google Ads API.

Interfejs Google Ads

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

1. W interfejsie Google Ads kliknij Konwersje.
2. Kliknij nazwę działania powodującego konwersję.
3. Otwórz kartę Szczegóły.
4. Identyfikator działania powodującego konwersję to numer obok Identyfikatora typu konwersji.

Interfejs Google Ads API

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 conversion_action w odpowiedzi.

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

Odbiorcy Display & Video 360

Identyfikator miejsca docelowego usługi na potrzeby pozyskiwania 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 odbiorców z interfejsu 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, podając w razie potrzeby nagłówki żądania, i użyj id elementu UserList jako identyfikatora miejsca docelowego produktu.

Zdarzenie Google Analytics

Identyfikator miejsca docelowego usługi zależy od typu strumienia danych.

Strumień danych z sieci

Użyj identyfikatora pomiaru strumienia danych.

Strumień danych z aplikacji

Użyj identyfikatora aplikacji w Firebase strumienia danych. Identyfikator aplikacji w Firebase możesz znaleźć na 2 sposoby:

• W interfejsie Google Analytics kliknij Strumienie danych, wybierz strumień danych i znajdź IDENTYFIKATOR APLIKACJI W FIREBASE.
• Użyj konsoli Firebase.

Zdarzenie Floodlight

Identyfikator miejsca docelowego usługi na potrzeby pozyskiwania zdarzeń do Floodlight to identyfikator aktywności Floodlight. Możesz go pobrać za pomocą interfejsu Campaign Managera 360 lub interfejsu Campaign Manager 360 API.

Interfejs Campaign Managera 360

Aby uzyskać identyfikator aktywności Floodlight z interfejsu Campaign Managera 360:

1. Zaloguj się w interfejsie Campaign Managera 360.
2. Przejdź do reklamodawcy Campaign Managera 360, którego używasz w operating_account.
3. W menu po lewej stronie kliknij kolejno Floodlight i Aktywności.
4. Znajdź aktywność Floodlight na liście. Identyfikator to liczba obok nazwy w kolumnie Nazwa aktywności.

Interfejs Campaign Manager 360 API

Aby uzyskać identyfikator aktywności Floodlight z interfejsu Campaign Manager 360 API:

1. Wyślij żądanie list do zasobu floodlightActivities.
2. Podaj floodlightConfigurationId konfiguracji Floodlight.
3. Opcjonalnie możesz użyć parametru searchString, aby filtrować według nazwy aktywności.
4. Pobierz identyfikator aktywności Floodlight z pola id wybranego elementu FloodlightActivity w odpowiedzi.

Określanie, do czego mają dostęp dane logowania

Dane logowania, których używasz do autoryzacji żądania do interfejsu Data Manager API, są powiązane z konkretnym kontem Google.

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

Oto jak sprawdzić, czy konto Google, którego dane logowania podajesz, ma dostęp do konta Google Ads, Display & Video 360, Google Analytics lub Campaign Managera 360.

Google Ads lub dostawca danych

1. W interfejsie Google Ads otwórz Dostęp i bezpieczeństwo dla konta 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, którego dane logowania chcesz wykorzystać, znajduje się na liście kont 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 konto Google, którego dane logowania podajesz, jest widoczne jako użytkownik w login_account.

Google Analytics

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

Floodlight (Campaign Manager 360)

1. Zaloguj się w interfejsie Campaign Managera 360.
2. W menu po lewej stronie kliknij Administracja > Profile użytkowników.
3. Sprawdź, czy konto Google, którego dane logowania chcesz usunąć, znajduje się na liście wyświetlonych profili.
4. Kliknij profil i sprawdź, czy ma on dostęp do konta reklamodawcy używanego jako login_account. Jeśli nie ustawisz parametru login_account w żądaniu, domyślnie zostanie użyta wartość operating_account. Upewnij się, że konto ma rolę użytkownika z uprawnieniem Wstawianie konwersji offline.