Dodaj nowe konwersje

Wywołaj metodę Conversion.insert(), aby dodać co najmniej 1 konwersję. Aby prawidłowo przypisać konwersję, żądanie musi zawierać nazwę aktywności Floodlight, której reklamodawca używa do raportowania konwersji offline, oraz identyfikator kliknięcia wizyty lub identyfikatory słowa kluczowego, które doprowadziło do konwersji. Informacje o uzyskiwaniu identyfikatorów Search Ads 360 znajdziesz w artykule Identyfikatory i konwersje Search Ads 360.

Informacje o ograniczeniach dotyczących przesyłania konwersji historycznych znajdziesz w Centrum pomocy Search Ads 360.

Jeśli żądanie Conversion.insert() określa wiele konwersji, Search Ads 360 próbuje przesłać każdą konwersję, dokładając wszelkich starań, zamiast przesyłać całą partię jako transakcję typu „wszystko albo nic”. Jeśli nie uda się przesłać niektórych konwersji z partii, pozostałe mogą zostać przesłane. Przesyłanie konwersji może się nie udać z powodu nieprawidłowego żądania lub tymczasowych awarii sieci lub systemu. Dlatego zalecamy zapoznanie się z odpowiedzią dotyczącą każdej wstawionej konwersji, aby upewnić się, że przesyłanie się powiodło.

Jak szybko mogę zacząć korzystać z przesłanych danych?

Jeśli podasz conversionTimestamp konwersji z dzisiaj lub wczoraj, dane związane z konwersją pojawią się w interfejsie Search Ads 360 w ciągu godziny od przesłania. Jeśli podasz starszą wartość conversionTimestamp, dane zostaną zaktualizowane w ciągu kilku godzin.

Przekonwertuj wszystkie sygnatury czasowe konwersji na czas epoki (znany też jako czas uniksowy).

Czy mogę tworzyć aktywności Floodlight za pomocą interfejsu API?

Jeśli reklamodawca nie utworzył jeszcze aktywności Floodlight do śledzenia konwersji offline, możesz utworzyć ją za pomocą interfejsu Campaign Manager API. Nie możesz używać interfejsu API do określania, że aktywność Floodlight jest używana głównie do konwersji offline, co jest sprawdzoną metodą, gdy strategie ustalania stawek będą używać danych z konwersji.

Zalecamy, aby po utworzeniu aktywności Floodlight za pomocą interfejsu API użytkownik Search Ads 360 zalogował się w Search Ads 360 i zmienił ustawienie aktywności, aby wskazać, że głównym źródłem konwersji jest aktywność offline.

Sprawdzone metody dodawania konwersji

Zalecamy stosowanie tych sprawdzonych metod dodawania konwersji:

  1. Poproś użytkownika Search Ads 360, aby zalogował się w Search Ads 360 i zmienił ustawienia każdej aktywności Floodlight, której używasz do raportowania konwersji offline. Ustawienia powinny wskazywać, że głównym źródłem konwersji jest aktywność offline. Instrukcje znajdziesz w Centrum pomocy Search Ads 360.

  2. Przesyłaj konwersje, gdy tylko będą dostępne. Jeśli przypisujesz konwersje do konkretnych wizyt, odczekaj co najmniej 6 godzin od wizyty, zanim prześlesz konwersję. Search Ads 360 może nie rozpoznać identyfikatora kliknięcia wizyty, jeśli prześlesz go wcześniej niż 6 godzin po wizycie. W rzadkich przypadkach może minąć nawet 24 godziny, zanim Search Ads 360 rozpozna identyfikator kliknięcia.

    Upewnij się, że każdy przesyłany plik zawiera ostatnie konwersje. W ramach pojedynczego żądania przesyłania wpisy mogą być niechronologiczne. Strategia ustalania stawek może jednak nie uwzględniać starszych konwersji, które prześlesz później w innym żądaniu.

Wysyłanie żądania wstawienia

Możesz wysłać żądanie Conversion.insert(), aby:

  • Przypisywanie udziału w konwersji do konkretnej wizyty
  • Przypisanie udziału w konwersji tylko do słowa kluczowego

Pola wymagane w żądaniu Conversion.insert() zależą od zdarzenia lub elementu, do którego przypisujesz konwersję. W sekcjach poniżej znajdziesz listę wymaganych i opcjonalnych pól dla każdego zdarzenia lub elementu, któremu możesz przypisać konwersję.

Przypisywanie udziału w konwersji do konkretnej wizyty

Gdy klient kliknie co najmniej 1 reklamę i przejdzie do witryny reklamodawcy, Search Ads 360 uznaje sesję użytkownika w witrynie reklamodawcy za wizytę. Aby przypisać konwersję do wizyty, w żądaniu Conversion.insert() podaj te informacje:

Pola wymagane

  • clickId: identyfikator kliknięcia (z uwzględnieniem wielkości liter). Poszukaj identyfikatora kliknięcia w dziennikach strony internetowej reklamodawcy lub pobierz conversion.click_id innej konwersji za pomocą nowego interfejsu Search Ads 360 Reporting API. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które wygenerowały wizytę.
    Odczekaj co najmniej 6 godzin od wygenerowania przez Search Ads 360 identyfikatora kliknięcia, zanim prześlesz konwersje. Jeśli pojawi się błąd „Nie znaleziono identyfikatora kliknięcia”, odczekaj 24 godziny i ponownie prześlij konwersje. Wszystkie konwersje należy przesłać w ciągu 90 dni od wygenerowania identyfikatora kliknięcia. W przeciwnym razie interfejs Search Ads 360 API może nie rozpoznać wizyty.
  • conversionId: w przypadku konwersji offline ten identyfikator podają reklamodawcy. Reklamodawcy mogą określić dowolny identyfikator, który jest dla nich istotny. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być unikalna wśród wszystkich konwersji w obrębie reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwości dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy.
  • conversionTimestamp: wskazuje datę i godzinę wystąpienia konwersji. Jeśli na przykład konwersja nastąpiła w piątek 5 sierpnia 2016 r. o godzinie 11:53:22 czasu letniego wschodniego (GMT -4:00), podaj sygnaturę czasową w milisekundach od początku epoki: 1470412402000.
  • segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane, aby określić wartość FLOODLIGHT.
  • segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

    Jeśli reklamodawca ma aktywności o tej samej nazwie (może się tak zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecane działanie to zmiana nazwy jednej z nich.

    Możesz też podać identyfikator aktywności Floodlight w polu segmentationId zamiast nazwy w polu segmentationName. Użyj identyfikatora przypisanego przez Campaign Managera do aktywności Floodlight. Identyfikator ten możesz pobrać za pomocą pola conversion_action.floodlight_settings.activity_id w nowym interfejsie Search Ads 360 Reporting API. Akceptowany jest też identyfikator segmentationId, który Search Ads 360 zwraca w odpowiedzi na żądanie konwersji.

  • type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja typu TRANSACTION ma taką wartość. Przykłady: zapisanie się na listę e-mailową (DZIAŁANIE) i zakup w e-commerce (TRANSAKCJA).

    Jeśli podasz TRANSACTION, musisz też podać to pole:

    • revenueMicros: wartość pieniężna konwersji.

Pola opcjonalne

  • quantityMillis: liczba elementów w tej konwersji. Może to być np. liczba osób, które zasubskrybowały newsletter, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola w przypadku konwersji typu ACTION, Search Ads 360 automatycznie wstawi wartość 1000.
  • currencyCode: waluta przychodów z transakcji. Domyślnie przyjmuje się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
    Użyj formatu alfabetycznego ISO 4217 (3 znaki), aby określić walutę.
    Dotyczy tylko konwersji typu TRANSACTION.
  • customMetric i customDimension: przesyłają dodatkowe dane o konwersji, np. kraj, do którego wysłano zakupiony produkt, identyfikatory produktów, a nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.
  • deviceType: określa typ urządzenia, na którym nastąpiła konwersja. Zobacz listę wartości akceptowanych w tym polu.

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
    "currencyCode": "USD"
  }]
}
          

Java

  /**
   * Instantiate the Doubleclicksearch service, create conversions, and upload them.
   */
  public static void main(String[] args) throws Exception {

    Doubleclicksearch service = getService(); // See Set Up Your Application.

    // Set up a List to keep track of each conversion you create.
    List<Conversion> conversions = new Vector<Conversion>();

    // Add a conversion to the List.
    addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
        "test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);

    // Upload the List and handle the response.
    uploadConversions(conversions, service);
  }


  /**
   * Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
   * the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
   */
  private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
      String clickId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion().setClickId(clickId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }


  /**
   * Convert the List of conversions to a DS ConversionList, send an insert request to DS,
   * and output the response to a file.
   */
  private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
      throws IOException {

    FileOutputStream outputStream =
        new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
    final PrintStream printStream = new PrintStream(outputStream);

    try {
      // Convert the List to a ConversionList.
      ConversionList conversionList = new ConversionList().setConversion(conversions);

      // Insert an upload request and download the response to a file.
      service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
      printStream.close();
    } catch (GoogleJsonResponseException e) {
      System.err.println("Get request was rejected.");
      for (ErrorInfo error : e.getDetails().getErrors()) {
        System.err.println(error.getMessage());
      }
      System.exit(e.getStatusCode());
    }
  }
            

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a visit.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
              'conversionId': 'test_20140206_00',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Przypisanie udziału w konwersji tylko do słowa kluczowego

Jeśli nie masz identyfikatora kliknięcia, możesz przypisać konwersję bezpośrednio do słowa kluczowego. W nowej wersji Search Ads 360 identyfikatory słów kluczowych są unikalne tylko w obrębie grupy reklam, dlatego musisz podać pełny zestaw identyfikatorów nowej wersji Search Ads 360, które identyfikują słowo kluczowe, oraz kilka innych pól:

Pola wymagane

  • customerId: identyfikator klienta konta klienta, które zawiera słowo kluczowe, np. 123-456-7890.
  • campaignId: identyfikator kampanii, która zawiera słowo kluczowe.
  • adGroupId: identyfikator grupy reklam, która zawiera słowo kluczowe.
  • criterionId: identyfikator słowa kluczowego.

    Jeśli konwersja określa criterionId bez customerId, campaignId lub adGroupId, kończy się niepowodzeniem i wyświetla kod błędu 0x0000012E. Informacje o tym, jak uzyskać te identyfikatory, znajdziesz w artykule Identyfikatory i konwersje Search Ads 360.

  • conversionId: w przypadku konwersji offline ten identyfikator podają reklamodawcy. Reklamodawcy mogą określić dowolny identyfikator, który jest dla nich istotny. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być unikalna wśród wszystkich konwersji w obrębie reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwości dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy.
  • conversionTimestamp: wskazuje datę i godzinę wystąpienia konwersji. Jeśli na przykład konwersja nastąpiła w piątek 5 sierpnia 2016 r. o godzinie 11:53:22 czasu letniego wschodniego (GMT -4:00), podaj sygnaturę czasową w milisekundach od początku epoki: 1470412402000.
  • segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane, aby określić wartość FLOODLIGHT.
  • segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

    Jeśli reklamodawca ma aktywności o tej samej nazwie (może się tak zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecane działanie to zmiana nazwy jednej z nich.

    Możesz też podać identyfikator aktywności Floodlight w polu segmentationId zamiast nazwy w polu segmentationName. Użyj identyfikatora przypisanego przez Campaign Managera do aktywności Floodlight. Identyfikator ten możesz pobrać za pomocą pola conversion_action.floodlight_settings.activity_id w nowym interfejsie Search Ads 360 Reporting API. Akceptowany jest też identyfikator segmentationId, który Search Ads 360 zwraca w odpowiedzi na żądanie konwersji.

  • type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja typu TRANSACTION ma taką wartość. Przykłady: zapisanie się na listę e-mailową (DZIAŁANIE) i zakup w e-commerce (TRANSAKCJA).

    Jeśli podasz TRANSACTION, musisz też podać to pole:

    • revenueMicros: wartość pieniężna konwersji.

Pola opcjonalne

  • quantityMillis: liczba elementów w tej konwersji. Może to być np. liczba osób, które zasubskrybowały newsletter, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola w przypadku konwersji typu ACTION, Search Ads 360 automatycznie wstawi wartość 1000.
  • currencyCode: waluta przychodów z transakcji. Domyślnie przyjmuje się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
    Użyj formatu alfabetycznego ISO 4217 (3 znaki), aby określić walutę.
    Dotyczy tylko konwersji typu TRANSACTION.
  • customMetric i customDimension: przesyłają dodatkowe dane o konwersji, np. kraj, do którego wysłano zakupiony produkt, identyfikatory produktów, a nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.
  • deviceType: określa typ urządzenia, na którym nastąpiła konwersja. Zobacz listę wartości akceptowanych w tym polu.

JSON

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "customerId": "123-456-7890", // Replace with your ID
    "campaignId": "14660344555", // Replace with your ID
    "adGroupId": "105138634255", // Replace with your ID
    "criterionId": "948710340465", // Replace with your ID
    "conversionId": "customerTransaction73126",
    "conversionTimestamp": "1351196386000",
    "segmentationType": "FLOODLIGHT",
    "segmentationName": "Offline Purchase",
    "type": "TRANSACTION",
    "revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
    "currencyCode": "USD"
  }]
}

Java

  /**
   * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>.
   * The example in the preceding section contains the uploadConversions method,
   * which can submit the list as an insert() request.
   */
  private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions,
      String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId,
      Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .setCustomerId(customerId)
        .setCampaignId(campaignId)
        .setAdGroupId(adGroupId)
        .setCriterionId(criterionId)
        .setConversionId(conversionId)
        .setSegmentationType("FLOODLIGHT")
        .setSegmentationName("Test")
        .setType("TRANSACTION")
        .setRevenueMicros(revenue)
        .setCurrencyCode("USD")
        .setConversionTimestamp(BigInteger.valueOf(timeStamp));

    conversions.add(conversion);
    return conversions;
  }        

Python

def insert_conversion(service):
  """Create and upload a TRANSACTION conversion that is attributed to a keyword only.

  Args:
    service: An authorized Doubleclicksearch service. See Set Up Your Application.
  """
  request = service.conversion().insert(
      body=
      {
          'conversion': [{
              'customerId': '123-456-7890', // Replace with your ID
              'campaignId': '14660344555', // Replace with your ID
              'adGroupId': '105138634255', // Replace with your ID
              'criterionId': '948710340465', // Replace with your ID
              'conversionId': 'test_1378710000000',
              'conversionTimestamp': '1378710000000',
              'segmentationType': 'FLOODLIGHT',
              'segmentationName': 'Test',
              'type': 'TRANSACTION',
              'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
              'currencyCode': 'USD'
              }]
      }
  )

  pprint.pprint(request.execute())

Przesyłanie danych z modelu atrybucji innej firmy

Model atrybucji rozdziela udział w konwersji między wszystkie aktywności na ścieżce konwersji. Jeśli na przykład przed konwersją użytkownik kliknął reklamę w wyszukiwarce, reklamę displayową i inną reklamę w płatnych wynikach wyszukiwania, liniowy model atrybucji przypisze każdemu kliknięciu 33% udziału w konwersji.

Search Ads 360 udostępnia gotowe modele atrybucji, ale jeśli do przypisywania udziału w konwersji kliknięciom korzystasz z usługi innej firmy lub usługi opracowanej samodzielnie, możesz przesłać zewnętrzne dane atrybucji do Search Ads 360 i używać ich w raportach oraz strategiach ustalania stawek Search Ads 360.

Zanim rozpoczniesz

Utwórz w usłudze Campaign Manager niestandardowy model atrybucji i zaimportuj go do Search Ads 360. Pamiętaj, aby nazwać model External Attribution Model (Zewnętrzny model atrybucji). Dzięki temu funkcje Search Ads 360 mogą wykryć, że do przesyłanych danych o konwersjach został zastosowany model atrybucji. Więcej informacji

Pola wymagane

Aby zastosować do konwersji model atrybucji innej firmy, w żądaniu Conversion.insert() podaj wszystkie te informacje:

  • clickId: identyfikator kliknięcia (z uwzględnieniem wielkości liter). Poszukaj identyfikatora kliknięcia w dziennikach strony internetowej reklamodawcy lub pobierz conversion.click_id innej konwersji za pomocą nowego interfejsu Search Ads 360 Reporting API. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które wygenerowały wizytę.
    Odczekaj co najmniej 30 minut od wygenerowania przez Search Ads 360 identyfikatora kliknięcia, zanim prześlesz konwersję z tym identyfikatorem. W przeciwnym razie interfejs Search Ads 360 API może nie rozpoznać wizyty.
  • attributionModel: ustaw na External Attribution Model (Zewnętrzny model atrybucji). Więcej informacji
  • countMillis: udział w konwersji, który ma zostać przypisany temu kliknięciu. Ma zastosowanie tylko wtedy, gdy żądanie zawiera też pole attributionModel.

    Nie należy go mylić z polem quantityMillis, które jest opcjonalne i określa liczbę elementów w konwersji (np. liczbę produktów w koszyku).

  • conversionId: w przypadku konwersji offline ten identyfikator podają reklamodawcy. Reklamodawcy mogą określić dowolny identyfikator, który jest dla nich istotny. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być unikalna wśród wszystkich konwersji w obrębie reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwości dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy.
  • conversionTimestamp: wskazuje datę i godzinę wystąpienia konwersji. Jeśli na przykład konwersja nastąpiła w piątek 5 sierpnia 2016 r. o godzinie 11:53:22 czasu letniego wschodniego (GMT -4:00), podaj sygnaturę czasową w milisekundach od początku epoki: 1470412402000.
  • segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane, aby określić wartość FLOODLIGHT.
  • segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

    Jeśli reklamodawca ma aktywności o tej samej nazwie (może się tak zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecane działanie to zmiana nazwy jednej z nich.

    Możesz też podać identyfikator aktywności Floodlight w polu segmentationId zamiast nazwy w polu segmentationName. Użyj identyfikatora przypisanego przez Campaign Managera do aktywności Floodlight. Identyfikator ten możesz pobrać za pomocą pola conversion_action.floodlight_settings.activity_id w nowym interfejsie Search Ads 360 Reporting API. Akceptowany jest też identyfikator segmentationId, który Search Ads 360 zwraca w odpowiedzi na żądanie konwersji.

  • type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja typu TRANSACTION ma taką wartość. Przykłady: zapisanie się na listę e-mailową (DZIAŁANIE) i zakup w e-commerce (TRANSAKCJA).

    Jeśli podasz TRANSACTION, musisz też podać to pole:

    • revenueMicros: wartość pieniężna konwersji.

Jeśli śledzisz przychody z konwersji, upewnij się, że stosowany model przypisuje odpowiedni udział w nich każdemu punktowi kontaktu na ścieżce konwersji. Jeśli na przykład Twój model stosuje podejście liniowe (które zakłada przypisywanie każdemu punktowi kontaktu równego udziału w przychodach), każde kliknięcie reklamy na ścieżce konwersji obejmującej 3 takie kliknięcia otrzyma 33% udziału w konwersji. Jeśli konwersja przyniosła przychód w wysokości 100 PLN, upewnij się, że model przypisze każdemu kliknięciu 33 PLN przychodu i że parametr revenueMicros określa dla każdego kliknięcia tylko taką kwotę.

Pola opcjonalne

  • quantityMillis: liczba elementów w tej konwersji. Może to być np. liczba osób, które zasubskrybowały newsletter, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola w przypadku konwersji typu ACTION, Search Ads 360 automatycznie wstawi wartość 1000.
  • currencyCode: waluta przychodów z transakcji. Domyślnie przyjmuje się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
    Użyj formatu alfabetycznego ISO 4217 (3 znaki), aby określić walutę.
    Dotyczy tylko konwersji typu TRANSACTION.
  • customMetric i customDimension: przesyłają dodatkowe dane o konwersji, np. kraj, do którego wysłano zakupiony produkt, identyfikatory produktów, a nawet czas trwania rozmowy telefonicznej. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.
  • deviceType: określa typ urządzenia, na którym nastąpiła konwersja. Zobacz listę wartości akceptowanych w tym polu.

Przykład

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
 "kind": "doubleclicksearch#conversionList",
  "conversion" : [{
    "clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
    "conversionId" : "test_20130906_04",
    "conversionTimestamp" : "1378710000000",
    "segmentationType" : "FLOODLIGHT",
    "segmentationName" : "Test",
    "type": "TRANSACTION",
    "attributionModel": "External Attribution Model",
    "countMillis": "330",
    "revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
    "currencyCode": "USD"
  }]
}
          

Obsługa odpowiedzi Search Ads 360

Odpowiedź z Search Ads 360 wskazuje powodzenie tylko wtedy, gdy wszystkie konwersje w żądaniu zostały pomyślnie zweryfikowane i przesłane.

Jeśli żądanie się powiedzie

Jeśli żądanie się powiedzie, odpowiedź będzie zawierać pełną wewnętrzną reprezentację Search Ads 360 dla każdej przesłanej konwersji. Reprezentacja używa nowych identyfikatorów Search Ads 360: identyfikatora klienta konta klienta oraz identyfikatora kampanii, identyfikatora grupy reklam, identyfikatora słowa kluczowego (kryterium) i identyfikatora reklamy, do których przypisana jest konwersja.

Oto przykładowa odpowiedź dotycząca konwersji przypisanej do wizyty:

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "customerId": "123-456-7890",
   "campaignId": "14660344555",
   "adGroupId": "105138634255",
   "criterionId": "948710340465",
   "adId": "562719339005",
   "clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
   "conversionId": "test_20130906_04",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "10000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368",
   "floodlightOrderId": "test_20130906_04",
   "countMillis": "1000",
   "deviceType": "DESKTOP"
  },
  ...
 ]
}

Odpowiedź zawiera tylko identyfikatory, które mają zastosowanie do konwersji. Na przykład odpowiedź dotycząca konwersji przypisanej tylko do słowa kluczowego nie zawiera pól clickId i adId.

Jeśli prośba nie zostanie rozpatrzona pozytywnie

Jeśli nie uda się zweryfikować lub przesłać co najmniej 1 konwersji, odpowiedź będzie zawierać komunikaty dotyczące każdej nieudanej próby przesłania konwersji. Odpowiedź nie zawiera komunikatów o konwersjach, które zostały przesłane.

Oto przykładowa odpowiedź na żądanie, które nie zostało w pełni zrealizowane:

{
 "error": {
    "errors": [
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
       },
       {
          "reason": "requestValidation",
          "message": "The request was not valid. Details:  [0x00000101: Click ID ..."
       }
    ]
  }
}

Każdy komunikat o niepowodzeniu zawiera 2 ważne pola: przyczynę i szczegółowy komunikat o błędzie. Pole przyczyny może zawierać wartość requestValidation, internalError, transactionFailed lub lateStageRequestError.

Błędy requestValidation

Błędy requestValidation wskazują na problemy z danymi w żądaniu przesłania konwersji (np. konwersja została już przesłana lub nie znaleziono identyfikatora kliknięcia). W przypadku tego typu błędu szczegóły komunikatu zawierają 2 elementy:

  • Kod szesnastkowy, który identyfikuje typ błędu. Możesz użyć tego kodu we własnych skryptach, aby zidentyfikować błędy.
  • Opis błędu weryfikacji.

Więcej informacji znajdziesz na liście kodów i opisów, które Search Ads 360 może zwracać w przypadku błędów przesyłania konwersji.

Inne typy błędów

Wszystkie inne typy błędów (internalError, transactionFailed lub lateStageRequestError) wskazują, że w Search Ads 360 wystąpił problem wewnętrzny.

Reagowanie na błąd

Jeśli żądanie się nie powiedzie, spróbuj później przesłać je ponownie. Search Ads 360 zgłosi błędy requestValidation w przypadku wszystkich konwersji, które zostały już przesłane, ale spróbuje przesłać pozostałe konwersje.

Jeśli po ponownym przesłaniu nadal widzisz błędy, zapoznaj się z sekcją Rozwiązywanie problemów, aby dowiedzieć się, co zrobić.