Wysyłaj wydarzenia

Dzięki temu krótkiemu wprowadzeniu dowiesz się, jak wysyłać dane o zdarzeniach.

Użyj interfejsu Data Manager API w jednym z tych przypadków:

• Wysyłaj konwersje tagu Google Ads lub kluczowe zdarzenia Google Analytics jako dodatkowe źródło danych dla konwersji tagu, aby zmaksymalizować sygnały interakcji z reklamą oraz wzmocnić dane i ogólną skuteczność.

  Ta funkcja jest dostępna tylko na kontach na liście dozwolonych. Jeśli chcesz dodać konto Google Ads lub usługę w Google Analytics, wypełnij formularz.

• Wysyłaj dane o zdarzeniach dotyczące konwersji offline lub konwersji rozszerzonych dotyczących potencjalnych klientów w Google Ads.

Wybierz wersję przewodnika, którą chcesz wyświetlić:

Reklamodawca Partner danych

W tym krótkim wprowadzeniu wykonasz te czynności:

1. Przygotuj Destination do odbierania danych zdarzenia.
2. Przygotuj dane zdarzenia do wysłania.
3. Utwórz żądanie IngestionService dotyczące zdarzeń.
4. Wyślij żądanie za pomocą narzędzia Google APIs Explorer.
5. Poznaj odpowiedzi o sukcesie i niepowodzeniu.

Przygotowywanie miejsc docelowych

Zanim wyślesz dane, musisz przygotować co najmniej 1 Destination. Oto przykładowy kod Destination, którego możesz użyć:

    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID"
    }

Oto pola Destination:

operatingAccount

Konto, na które są przesyłane zdarzenia.

W przypadku zdarzeń przesyłanych jako dodatkowe źródło danych konto obsługujące może być kontem Google Ads lub usługą w Google Analytics. Ustaw wartość accountType na GOOGLE_ADS lub GOOGLE_ANALYTICS_PROPERTY, a wartość accountId na identyfikator klienta Google Ads lub identyfikator usługi w Google Analytics. Jeśli wartość parametru accountType to GOOGLE_ANALYTICS_PROPERTY, dane logowania w żądaniu muszą należeć do użytkownika Google Analytics, który ma w usłudze rolę Edytujący lub Administrator.

W przypadku konwersji offline i konwersji rozszerzonych dotyczących potencjalnych klientów konto operacyjne musi być kontem Google Ads, więc ustaw accountType na GOOGLE_ADS, a accountId na identyfikator klienta Google Ads.

loginAccount

Konto, do którego użytkownik danych logowania ma dostęp.

Jeśli dane logowania OAuth dotyczą użytkownika, który ma dostęp do konta menedżera Google Ads, które ma operatingAccount jako jedno ze swoich subkont, wymagane jest loginAccount. Ustaw wartość accountId elementu loginAccount na identyfikator konta menedżera, a wartość accountType elementu loginAccount na GOOGLE_ADS.

Jeśli dane logowania OAuth dotyczą użytkownika z bezpośrednim dostępem do operatingAccount, nie musisz ustawiać loginAccount, ponieważ domyślnie jest to operatingAccount. Zalecamy jednak ustawienie loginAccount na te same wartości accountId i accountType co operatingAccount. Pomaga to uniknąć problemów, jeśli zmieni się zestaw kont, do których użytkownik ma dostęp.

productDestinationId

Identyfikator elementu w operatingAccount, który otrzymuje zdarzenia.

W przypadku zdarzeń wysyłanych jako dodatkowe źródło danych parametr productDestinationId musi być identyfikatorem konwersji Google Ads, w której parametr type ma wartość WEBPAGE, lub identyfikatorem pomiaru strumienia danych z sieci w Google Analytics. Nie możesz wysyłać zdarzeń jako dodatkowego źródła danych do strumienia danych z aplikacji na iOS lub Androida w Google Analytics.

W przypadku konwersji offline lub konwersji rozszerzonych dotyczących potencjalnych klientów element productDestinationId musi być identyfikatorem działania powodującego konwersję w Google Ads, w którym parametr type ma wartość UPLOAD_CLICKS.

Przykład w tym przewodniku pokazuje, jak utworzyć żądanie, które wysyła każde zdarzenie do tego samego miejsca docelowego. Jeśli chcesz wysyłać zdarzenia do wielu miejsc docelowych w tym samym żądaniu, przeczytaj artykuł Wysyłanie zdarzeń do wielu miejsc docelowych.

Przygotowywanie danych zdarzenia

Rozważmy te dane zdarzenia. Każda tabela odpowiada jednemu zdarzeniu konwersji. Każde zdarzenie konwersji ma znacznik czasu zdarzenia, działanie powodujące konwersję i wartość konwersji.

Każde zdarzenie może zawierać identyfikatory reklam, np. gclid, lub identyfikatory użytkowników, np. adresy e-mail, numery telefonów i informacje o adresie. Zdarzenie może też mieć:

• Informacje o użytkowniku oceniane w momencie wystąpienia zdarzenia, np. wartość klienta lub to, czy jest on nowym, powracającym czy ponownie zaangażowanym klientem.
• Dane koszyka.
• Dodatkowe parametry zdarzenia lub właściwości użytkownika w przypadku miejsca docelowego, np. client_id lub user_id w Google Analytics.

Oto dane wydarzenia:

Formatowanie danych

Sformatuj pola zgodnie z informacjami podanymi w przewodniku po formatowaniu. Oto dane zdarzenia po sformatowaniu:

Zaszyfruj i zakoduj dane.

Dodatkowo sformatowane adresy e-mail, imiona i nazwiska muszą być zahaszowane za pomocą algorytmu SHA-256 i zakodowane w formacie szesnastkowym lub Base64. Oto dane zdarzenia po sformatowaniu, zaszyfrowaniu i zakodowaniu za pomocą kodowania szesnastkowego:

Konwertowanie danych na obiekty Event

Przekształć sformatowane i zaszyfrowane dane każdego zdarzenia w Event. Wypełnij te pola zgodnie z instrukcjami:

1. Ustaw eventTimestamp na czas wystąpienia zdarzenia.

   Zdarzenia w Google Analytics muszą mieć znacznik czasu eventTimestamp z ostatnich 72 godzin.

2. Ustaw wymagane pola dla swojego przypadku użycia.

   Przypadek użycia	Identyfikatory	transactionId	eventSource
   Konwersje offline lub konwersje rozszerzone dotyczące potencjalnych klientów	Wymagany. Ustaw co najmniej jedną z tych opcji: adIdentifiers z ustawioną co najmniej jedną z tych wartości: gclid, gbraid, wbraid lub sessionAttributes userData	Opcjonalny	Wymagany. Ustaw na jedną z wartości wyliczeniowych dla EventSource.
   Zdarzenia wysyłane jako dodatkowe źródło danych do miejsca docelowego Google Ads	Wymagany. Ustaw co najmniej jedną z tych opcji: adIdentifiers z ustawioną co najmniej jedną z tych wartości: gclid, gbraid lub wbraid userData	Wymagany	Opcjonalnie: Jeśli jest ustawiona, musi mieć wartość WEB.
   Zdarzenia wysyłane jako dodatkowe źródło danych do miejsca docelowego w Google Analytics	Wymagany. Ustaw co najmniej jedną z tych opcji: clientId adIdentifiers z ustawionym parametrem gclid userData	Wymagany	Opcjonalnie: Jeśli jest ustawiona, musi mieć wartość WEB.

3. Wypełnij pozostałe pola, w których masz wartość zdarzenia. Pełną listę dostępnych pól znajdziesz w Event dokumentacji.

Dodawanie informacji o Google Analytics

Jeśli miejscem docelowym zdarzenia wysłanego jako dodatkowe źródło danych jest usługa w Google Analytics, wypełnij te pola w podany sposób:

eventName

Wymagany. Nazwa zdarzenia w Google Analytics.

transactionId

Wymagany Unikalny identyfikator zdarzenia.

Co najmniej 1 identyfikator

Musisz ustawić wartość w co najmniej 1 polu z tej listy:

• clientId: unikalny identyfikator instancji klienta internetowego użytkownika. Zobacz Wysyłanie zdarzeń do Measurement Protocol.

• adIdentifiers.gclid: Identyfikator kliknięcia Google.

• userData: identyfikatory użytkownika, takie jak adresy e-mail, numery telefonów lub informacje o adresie.

destinationReferences

Wymagany, jeśli lista destinations na poziomie żądania zawiera więcej niż 1 usługę Google Analytics Destination. Dodaj wpis do destinationReferences, aby określić, które miejsce docelowe w Google Analytics ma otrzymywać zdarzenie. Więcej informacji o odwołaniach do usług docelowych znajdziesz w artykule wysyłanie zdarzeń do wielu usług docelowych.

Jeśli parametr destinationReferences nie jest ustawiony lub zawiera wiele wpisów odnoszących się do miejsc docelowych Google Analytics, interfejs Data Manager API odrzuca zdarzenie z błędem MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT.

userId

Opcjonalnie: Identyfikator użytkownika.

additionalEventParameters

Opcjonalny, ale zalecany. Wypełnij tę listę dowolnymi parametrami zdarzeń Google Analytics, które nie są rejestrowane w innych polach Event. Parametry mogą obejmować dodatkowe zalecane parametry z purchasezdarzenia lub inne parametry, które chcesz rejestrować. Użyj nazwy parametru Google Analytics dla parameterName w EventParameter.

Jeśli na przykład masz podatki powiązane z transakcją, dodaj wpis do additionalEventParameters z atrybutem parameterName ustawionym na tax i atrybutem value ustawionym na koszt podatku.

Nie zalecamy dodawania wpisów dla parametrów zdarzeń transactionId, currency ani value Google Analytics. Zamiast tego wypełnij pola transactionId, currency i conversionValue w Event, które mają pierwszeństwo przed wszystkimi wpisami w additionalEventParameters.

Dodawanie danych koszyka do zdarzeń zakupu

Wypełnij pole cartData w obiekcie Event informacjami o zakupionych produktach. W przypadku każdego zakupionego produktu dodaj obiekt Item do listy items w obiekcie CartData i wypełnij te pola:

itemId

Wymagany. Unikalny identyfikator produktu.

unitPrice

Wymagany. Cena jednostkowa bez podatku, dostawy i rabatów w zakresie zdarzenia (na poziomie transakcji).

Jeśli produkt ma zniżkę obejmującą produkt, użyj obniżonej ceny jednostkowej. Jeśli na przykład produkt ma cenę jednostkową 27.67 i rabat jednostkowy 6.66, ustaw wartość unitPrice na 21.01.

quantity

Wymagany. Liczba zakupionych sztuk tego produktu.

additionalItemParameters

Wypełnij tę listę dowolnymi parametrami o zakresie obejmującym produkt, które nie są rejestrowane w innych polach Item. Użyj nazwy parametru elementu Google Analytics w przypadku parameterName w ItemParameter.

Jeśli np. masz markę i kategorię produktu, dodaj wpis do additionalItemParameters produktu z parameterName ustawionym na item_brand i value ustawionym na nazwę marki, a także kolejny wpis z parameterName ustawionym na item_category i value ustawionym na kategorię produktu.

Nie zalecamy dodawania wpisów dla parametrów elementu quantity, price ani item_idGoogle Analytics. Zamiast tego wypełnij pola itemId, unitPrice i quantity w Item, które mają pierwszeństwo przed wszystkimi wpisami w additionalItemParameters.

Oto przykład Event sformatowanych, zaszyfrowanych i zakodowanych danych z drugiego zdarzenia z dodatkowymi danymi dla Google Analytics:

{
  "adIdentifiers": {
     "gclid": "GCLID_2"
  },
  "conversionValue": 42.02,
  "currency": "EUR",
  "eventTimestamp": "2025-06-10T23:42:33-05:00",
  "transactionId": "DEF999911111",
  "eventSource": "WEB",
  "userData": {
    "userIdentifiers": [
      {
        "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
      },
      {
        "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
      },
      {
        "address": {
          "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
          "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
          "regionCode": "PT",
          "postalCode": "1229-076"
        }
      }
    ],
  },
  "userProperties": {
    "customerType": "RETURNING"
  },
  "eventName": "purchase",
  "clientId": "9876543210.1761582117",
  "userId": "user_DEF9876",
  "additionalEventParameters": [
    {
      "parameterName": "ad_unit_name",
      "value": "Banner_02"
    }
  ],
  "cartData": {
    "transactionDiscount": 6.66,
    "items": [
      {
        "itemId": "SKU_12346",
        "quantity": 2,
        "unitPrice": 21.01,
        "additionalItemParameters": [
          {
            "parameterName": "item_name",
            "value": "Google Grey Women's Tee"
          },
          {
            "parameterName": "affiliation",
            "value": "Google Merchandise Store"
          },
          {
            "parameterName": "coupon",
            "value": "SUMMER_FUN"
          },
          {
            "parameterName": "discount",
            "value": "3.33"
          },
          {
            "parameterName": "index",
            "value": "1"
          },
          {
            "parameterName": "item_brand",
            "value": "Google"
          },
          {
            "parameterName": "item_category",
            "value": "Apparel"
          },
          {
            "parameterName": "item_category2",
            "value": "Adult"
          },
          {
            "parameterName": "item_category3",
            "value": "Shirts"
          },
          {
            "parameterName": "item_category4",
            "value": "Crew"
          },
          {
            "parameterName": "item_category5",
            "value": "Short sleeve"
          },
          {
            "parameterName": "item_list_id",
            "value": "related_products"
          },
          {
            "parameterName": "item_list_name",
            "value": "Related Products"
          }
        ]
      }
    ]
  }
}

Tworzenie treści żądania

Połącz Destination i Events w treści żądania:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "CONVERSION_ACTION_1_ID"
    }
  ],
  "encoding": "HEX",
  "events": [
     {
       "adIdentifiers": {
         "gclid": "GCLID_1"
       },
       "conversionValue": 30.03,
       "currency": "USD",
       "eventTimestamp": "2025-06-10T20:07:01Z",
       "transactionId": "ABC798654321",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "address": {
               "givenName": "96D9632F363564CC3032521409CF22A852F2032EEC099ED5967C0D000CEC607A",
               "familyName": "DB98D2607EFFFA28AFF66975868BF54C075ECA7157E35064DCE08E20B85B1081",
               "regionCode": "US",
               "postalCode": "94045"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "NEW",
         "customerValueBucket": "HIGH"
       },
       "eventName": "purchase",
       "clientId": "1234567890.1761581763",
       "userId": "user_ABC12345",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_01"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12345",
             "quantity": 3,
             "unitPrice": 10.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Stan and Friends Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "2.22"
               },
               {
                 "parameterName": "index",
                 "value": "0"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]

       }
     },
     {
       "adIdentifiers": {
         "gclid": "GCLID_2"
       },
       "conversionValue": 42.02,
       "currency": "EUR",
       "eventTimestamp": "2025-06-11T04:42:33Z",
       "transactionId": "DEF999911111",
       "eventSource": "WEB",
       "userData": {
         "userIdentifiers": [
           {
             "emailAddress": "3E693CF7E5B67880BFF33B2D2626DADB7BF1D4BC737192E47CF8BAA89ACF2250"
           },
           {
             "emailAddress": "223EBDA6F6889B1494551BA902D9D381DAF2F642BAE055888E96343D53E9F9C4"
           },
           {
             "address": {
               "givenName": "2752B88686847FA5C86F47B94CE652B7B3F22A91C37617D451A4DB9AFA431450",
               "familyName": "6654977D57DDDD3C0329CA741B109EF6CD6430BEDD00008AAD213DF25683D77F",
               "regionCode": "PT",
               "postalCode": "1229-076"
             }
           }
         ]
       },
       "userProperties": {
         "customerType": "RETURNING"
       },
       "eventName": "purchase",
       "clientId": "9876543210.1761582117",
       "userId": "user_DEF9876",
       "additionalEventParameters": [
         {
           "parameterName": "ad_unit_name",
           "value": "Banner_02"
         }
       ],
       "cartData": {
         "transactionDiscount": 6.66,
         "items": [
           {
             "itemId": "SKU_12346",
             "quantity": 2,
             "unitPrice": 21.01,
             "additionalItemParameters": [
               {
                 "parameterName": "item_name",
                 "value": "Google Grey Women's Tee"
               },
               {
                 "parameterName": "affiliation",
                 "value": "Google Merchandise Store"
               },
               {
                 "parameterName": "coupon",
                 "value": "SUMMER_FUN"
               },
               {
                 "parameterName": "discount",
                 "value": "3.33"
               },
               {
                 "parameterName": "index",
                 "value": "1"
               },
               {
                 "parameterName": "item_brand",
                 "value": "Google"
               },
               {
                 "parameterName": "item_category",
                 "value": "Apparel"
               },
               {
                 "parameterName": "item_category2",
                 "value": "Adult"
               },
               {
                 "parameterName": "item_category3",
                 "value": "Shirts"
               },
               {
                 "parameterName": "item_category4",
                 "value": "Crew"
               },
               {
                 "parameterName": "item_category5",
                 "value": "Short sleeve"
               },
               {
                 "parameterName": "item_list_id",
                 "value": "related_products"
               },
               {
                 "parameterName": "item_list_name",
                 "value": "Related Products"
               }
             ]
           }
         ]
       }
     }
  ],
  "validateOnly": true
}

1. Zastąp symbole zastępcze w treści, np. OPERATING_ACCOUNT_ID i PRODUCT_DESTINATION_ID, wartościami dla Twojego konta i miejsca docelowego.
2. Ustaw wartość validateOnly na true, aby zweryfikować prośbę bez stosowania zmian. Gdy zechcesz zastosować zmiany, ustaw validateOnly na false.
3. Pamiętaj, że w tym przykładzie nie używamy szyfrowania.

Wysyłanie żądania

1. Skopiuj treść żądania, korzystając z przycisku kopiowania w prawym górnym rogu przykładu.
2. Na pasku narzędzi kliknij przycisk API.
3. Wklej skopiowaną treść żądania do pola Treść żądania.
4. Kliknij przycisk Wykonaj, postępuj zgodnie z wyświetlanymi instrukcjami autoryzacji i sprawdź odpowiedź.

Odpowiedzi o sukcesie

Żądanie zakończone pomyślnie zwraca odpowiedź z obiektem zawierającym requestId.

{
  "requestId": "126365e1-16d0-4c81-9de9-f362711e250a"
}

Zapisz zwrócony requestId, aby móc pobrać diagnostykę w miarę przetwarzania każdego miejsca docelowego w żądaniu.

Odpowiedzi o błędzie

Nieudane żądanie powoduje zwrócenie kodu stanu odpowiedzi o błędzie, np. 400 Bad Request, oraz odpowiedzi ze szczegółami błędu.

Na przykład emailAddress zawierający ciąg tekstowy zamiast wartości zakodowanej w formacie szesnastkowym generuje tę odpowiedź:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0].user_data.user_identifiers",
            "description": "Email is not hex encoded.",
            "reason": "INVALID_HEX_ENCODING"
          }
        ]
      }
    ]
  }
}

emailAddress, który nie jest haszowany i jest tylko zakodowany w formacie szesnastkowym, generuje tę odpowiedź:

{
  "error": {
    "code": 400,
    "message": "There was a problem with the request.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "INVALID_ARGUMENT",
        "domain": "datamanager.googleapis.com"
      },
      {
        "@type": "type.googleapis.com/google.rpc.BadRequest",
        "fieldViolations": [
          {
            "field": "events.events[0]",
            "reason": "INVALID_SHA256_FORMAT"
          }
        ]
      }
    ]
  }
}

Wysyłanie zdarzeń do wielu miejsc docelowych

Jeśli dane zawierają zdarzenia dotyczące różnych miejsc docelowych, możesz wysłać je w tym samym żądaniu, używając odwołań do miejsc docelowych.

Jeśli na przykład masz zdarzenie dla identyfikatora działania powodującego konwersję 123456789 i inne zdarzenie dla identyfikatora działania powodującego konwersję 777111122, wyślij oba zdarzenia w jednym żądaniu, ustawiając parametr reference każdego elementu Destination. Wartość reference jest zdefiniowana przez użytkownika. Jedynym wymaganiem jest to, aby każdy Destination miał unikalny reference. Oto zmodyfikowana lista destinations w przypadku tego żądania:

  "destinations": [
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_TYPE",
        "accountId": "OPERATING_ACCOUNT_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_TYPE",
        "accountId": "LOGIN_ACCOUNT_ID"
      },

      "productDestinationId": "PRODUCT_DESTINATION_ID",
      "reference": "destination_a"
    },
    {
      "operatingAccount": {
        "accountType": "OPERATING_ACCOUNT_2_TYPE",
        "accountId": "OPERATING_ACCOUNT_2_ID"
      },

      "loginAccount": {
        "accountType": "LOGIN_ACCOUNT_2_TYPE",
        "accountId": "LOGIN_ACCOUNT_2_ID"
      },

      "productDestinationId": "777111122",
      "reference": "destination_b"
    }
  ]

Ustaw destinationReferences każdego elementu Event, aby wysłać go do co najmniej jednego określonego miejsca docelowego. Oto na przykład Event, który dotyczy tylko pierwszego Destination, więc jego lista destinationReferences zawiera tylko reference pierwszego Destination:

{
   "adIdentifiers": {
      "gclid": "GCLID_1"
   },
   "conversionValue": 1.99,
   "currency": "USD",
   "eventTimestamp": "2025-06-10T20:07:01Z",
   "transactionId": "ABC798654321",
   "eventSource": "WEB",
   "destinationReferences": [
      "destination_a"
   ]
}

Pole destinationReferences to lista, więc możesz określić wiele miejsc docelowych zdarzenia. Jeśli nie ustawisz parametru destinationReferences w przypadku parametru Event, interfejs Data Manager API wyśle zdarzenie do wszystkich miejsc docelowych w żądaniu.

Jeśli zdarzenie ma wiele miejsc docelowych, interfejs Data Manager API wysyła odpowiednie pola do każdego z nich. Jeśli np. zdarzenie ma miejsce docelowe w Google Ads i w Google Analytics, interfejs API uwzględnia pola Google Analytics, takie jak clientId lub eventName, gdy wysyła zdarzenie do miejsca docelowego w Google Analytics, a także pola Google Ads, takie jak customVariables, gdy wysyła zdarzenie do miejsca docelowego w Google Ads.

Dalsze kroki

• Skonfiguruj uwierzytelnianie i skonfiguruj środowisko za pomocą biblioteki klienta.
• Poznaj wymagania dotyczące formatowania, szyfrowania i kodowania poszczególnych typów danych.
• Dowiedz się, jak szyfrować dane użytkowników.
• Dowiedz się, jak pobrać diagnostykę dotyczącą Twoich próśb.
• Dowiedz się więcej o sprawdzonych metodach.
• Dowiedz się więcej o limitach.