Dodaj nowe konwersje

Wywołaj metodę Conversion.insert(), aby dodać co najmniej 1 konwersję. Aby prawidłowo przypisać konwersję, w żądaniu musisz podać nazwę aktywności Floodlight, której reklamodawca używa do raportowania konwersji offline, a także identyfikator słowa kluczowego, reklamy i ewentualnie kliknięcia, które doprowadziło do konwersji. Informacje o uzyskiwaniu identyfikatorów Search Ads 360 znajdziesz w artykule Identyfikatory Search Ads 360 i konwersje.

Informacje o ograniczeniach dotyczących przesyłania historycznych konwersji 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ę z najwyższą starannością, zamiast przesyłać cały pakiet jako transakcję typu „wszystko albo nic”. Jeśli nie uda się przesłać niektórych konwersji w partii, inne mogą zostać przesłane. Przesyłanie konwersji może się nie udać z powodu nieprawidłowego żądania lub przejściowych błędów sieci lub systemu. Dlatego zalecamy odczytywanie odpowiedzi dla każdej wstawionej konwersji, aby mieć pewność, że przesyłanie się powiodło.

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

Jeśli podasz conversionTimestamp 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 conversionTimestamp starszą niż wczorajsza, 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 użyć interfejsu Campaign Managera 360 API, aby ją utworzyć. Za pomocą interfejsu API nie możesz określić, że aktywność Floodlight jest używana głównie do konwersji offline, co jest najlepszym rozwiązaniem, gdy strategie ustalania stawek będą korzystać z 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

Podczas dodawania konwersji zalecamy stosowanie tych sprawdzonych metod:

  1. Poproś użytkownika Search Ads 360 o zalogowanie się w Search Ads 360 i zmianę ustawień 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 udział w konwersjach konkretnym wizytom, poczekaj z przesłaniem konwersji co najmniej 6 godzin od wizyty. Search Ads 360 może nie rozpoznać identyfikatora clickID wizyty, jeśli prześlesz konwersję przed upływem 6 godzin. W rzadkich przypadkach może być konieczne odczekanie do 24 godzin, zanim Search Ads 360 rozpozna identyfikator kliknięcia.

    Upewnij się, że każdy przesyłany plik zawiera ostatnie konwersje. W ramach jednego żądania przesyłania wpisy mogą być w niechronologicznej kolejności. Strategia ustalania stawek może jednak nie uwzględnić starszych konwersji, jeśli prześlesz je później w innej prośbie.

Wysyłanie prośby o wstawienie

Możesz wysłać Conversion.insert()prośbę o wykonanie dowolnej z tych czynności:

  • Przypisywanie konwersji do konkretnej wizyty
  • Przypisywanie konwersji tylko do słowa kluczowego

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

Przypisywanie konwersji do konkretnej wizyty

Gdy klient kliknie co najmniej 1 reklamę i trafi do witryny reklamodawcy, Search Ads 360 uzna 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) w przypadku wizyty. W dziennikach sieciowych reklamodawcy poszukaj identyfikatora kliknięcia lub listy konwersji i użyj identyfikatora kliknięcia z innej konwersji. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które spowodowały wizytę.
    Poczekaj co najmniej 6 godzin po wygenerowaniu przez Search Ads 360 identyfikatora kliknięcia, aby przesłać konwersje. Jeśli pojawi się błąd „Nie znaleziono identyfikatora kliknięcia”, odczekaj 24 godziny, a potem ponownie prześlij konwersje. Wszystkie konwersje należy przesył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 reklamodawcy podają ten identyfikator. 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 u reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwości wartość 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 epoki: 1470412402000.
  • segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc w tym polu zawsze musisz podać wartość FLOODLIGHT.
  • segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

    Jeśli reklamodawca zawiera aktywności o tej samej nazwie (może się to zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecamy zmianę nazwy jednej z nich.

    Jeśli znasz identyfikator przypisany do aktywności Floodlight przez Search Ads 360, możesz podać go w polu segmentationId zamiast nazwy w polu segmentationName. (Usługa Campaign Manager też przypisuje identyfikator do aktywności Floodlight, ale jest on inny niż identyfikator Search Ads 360 i nie można go używać do przypisywania konwersji). Aby wyświetlić identyfikator Search Ads 360 aktywności Floodlight, pobierz raport o konwersjach (z interfejsu Search Ads 360 lub interfejsu Reporting API). Jeśli w okresie raportowania do aktywności Floodlight została przypisana co najmniej 1 konwersja, w raporcie zobaczysz identyfikator Search Ads 360.

  • type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja typu DZIAŁANIE nie ma wartości pieniężnej, a konwersja typu TRANSAKCJA ma. Przykładem może być rejestracja na listę e-mailową (ACTION) w porównaniu z zakupami w e-commerce (TRANSACTION).

    Jeśli określisz 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 zapisały się na 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 zakłada się, że przychody są podawane w walucie reklamodawcy. Jeśli określisz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
    Aby określić walutę, użyj formatu alfabetycznego ISO 4217 (3 znaki).
    Dotyczy tylko konwersji typu TRANSACTION.
  • customMetric i customDimension: przesyła dodatkowe dane o konwersji, np. kraj, do którego wysyłany jest zakupiony produkt, identyfikatory produktów, a nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych dotyczących niestandardowych zmiennych Floodlight.
  • deviceType: określa typ urządzenia, na którym doszło do konwersji. Listę akceptowanych wartości tego pola znajdziesz tutaj.

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())

Przypisywanie konwersji tylko do słowa kluczowego

Jeśli zależy Ci przede wszystkim na przypisywaniu konwersji do słów kluczowych, a nie do reklam, możesz pominąć większość identyfikatorów Search Ads 360 i określić tylko identyfikator słowa kluczowego wraz z kilkoma innymi polami:

Pola wymagane

  • criterionId: identyfikator słowa kluczowego. Możesz uzyskać wartość criterionId, dodając makro TrackerId do adresów URL stron docelowych. Informacje o uzyskiwaniu identyfikatorów słów kluczowych znajdziesz w artykule Identyfikatory Search Ads 360 i konwersje.
  • conversionId: w przypadku konwersji offline reklamodawcy podają ten identyfikator. 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 u reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwości wartość 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 epoki: 1470412402000.
  • segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc w tym polu zawsze musisz podać wartość FLOODLIGHT.
  • segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

    Jeśli reklamodawca zawiera aktywności o tej samej nazwie (może się to zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecamy zmianę nazwy jednej z nich.

    Jeśli znasz identyfikator przypisany do aktywności Floodlight przez Search Ads 360, możesz podać go w polu segmentationId zamiast nazwy w polu segmentationName. (Usługa Campaign Manager też przypisuje identyfikator do aktywności Floodlight, ale jest on inny niż identyfikator Search Ads 360 i nie można go używać do przypisywania konwersji). Aby wyświetlić identyfikator Search Ads 360 aktywności Floodlight, pobierz raport o konwersjach (z interfejsu Search Ads 360 lub interfejsu Reporting API). Jeśli w okresie raportowania do aktywności Floodlight została przypisana co najmniej 1 konwersja, w raporcie zobaczysz identyfikator Search Ads 360.

  • type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja typu DZIAŁANIE nie ma wartości pieniężnej, a konwersja typu TRANSAKCJA ma. Przykładem może być rejestracja na listę e-mailową (ACTION) w porównaniu z zakupami w e-commerce (TRANSACTION).

    Jeśli określisz 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 zapisały się na 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 zakłada się, że przychody są podawane w walucie reklamodawcy. Jeśli określisz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
    Aby określić walutę, użyj formatu alfabetycznego ISO 4217 (3 znaki).
    Dotyczy tylko konwersji typu TRANSACTION.
  • customMetric i customDimension: przesyła dodatkowe dane o konwersji, np. kraj, do którego wysyłany jest zakupiony produkt, identyfikatory produktów, a nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych dotyczących niestandardowych zmiennych Floodlight.
  • deviceType: określa typ urządzenia, na którym doszło do konwersji. Listę akceptowanych wartości tego pola znajdziesz tutaj.

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" : [{
    "criterionId": "43700003491981017", // 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,
      Long criterionId, String conversionId, Long revenue, Long timeStamp) {

    Conversion conversion = new Conversion()
        .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': [{
              'criterionId': '43700004289911004', // 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 zewnętrznego modelu atrybucji

Model atrybucji przypisuje udział w konwersji poszczególnym działaniom na ścieżce konwersji. Jeśli na przykład przed konwersją użytkownik kliknął reklamę w płatnych wynikach wyszukiwania, 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 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

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

Pola wymagane

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

  • clickId: identyfikator kliknięcia (z uwzględnieniem wielkości liter) w przypadku wizyty. W dziennikach sieciowych reklamodawcy poszukaj identyfikatora kliknięcia lub listy konwersji i użyj identyfikatora kliknięcia z innej konwersji. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które spowodowały wizytę.
    Poczekaj co najmniej 30 minut po wygenerowaniu 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 wartość Zewnętrzny model atrybucji. Więcej informacji
  • countMillis: kwota udziału w konwersji do przypisania do tego kliknięcia. Ma zastosowanie tylko wtedy, gdy żądanie zawiera też pole attributionModel.

    Nie myl tego z polem quantityMillis, które jest opcjonalne i określa liczbę produktów w konwersji (np. liczbę produktów w koszyku podczas zakupu).

  • conversionId: w przypadku konwersji offline reklamodawcy podają ten identyfikator. 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 u reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwości wartość 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 epoki: 1470412402000.
  • segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc w tym polu zawsze musisz podać wartość FLOODLIGHT.
  • segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

    Jeśli reklamodawca zawiera aktywności o tej samej nazwie (może się to zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecamy zmianę nazwy jednej z nich.

    Jeśli znasz identyfikator przypisany do aktywności Floodlight przez Search Ads 360, możesz podać go w polu segmentationId zamiast nazwy w polu segmentationName. (Usługa Campaign Manager też przypisuje identyfikator do aktywności Floodlight, ale jest on inny niż identyfikator Search Ads 360 i nie można go używać do przypisywania konwersji). Aby wyświetlić identyfikator Search Ads 360 aktywności Floodlight, pobierz raport o konwersjach (z interfejsu Search Ads 360 lub interfejsu Reporting API). Jeśli w okresie raportowania do aktywności Floodlight została przypisana co najmniej 1 konwersja, w raporcie zobaczysz identyfikator Search Ads 360.

  • type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja typu DZIAŁANIE nie ma wartości pieniężnej, a konwersja typu TRANSAKCJA ma. Przykładem może być rejestracja na listę e-mailową (ACTION) w porównaniu z zakupami w e-commerce (TRANSACTION).

    Jeśli określisz 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 w parametrze revenueMicros podajesz tylko taką kwotę.

Pola opcjonalne

  • quantityMillis: liczba elementów w tej konwersji. Może to być np. liczba osób, które zapisały się na 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 zakłada się, że przychody są podawane w walucie reklamodawcy. Jeśli określisz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
    Aby określić walutę, użyj formatu alfabetycznego ISO 4217 (3 znaki).
    Dotyczy tylko konwersji typu TRANSACTION.
  • customMetric i customDimension: przesyła dodatkowe dane o konwersji, np. kraj, do którego wysyłany jest zakupiony produkt, identyfikatory produktów, a nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych dotyczących niestandardowych zmiennych Floodlight.
  • deviceType: określa typ urządzenia, na którym doszło do konwersji. Listę akceptowanych wartości tego pola znajdziesz tutaj.

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 prawidłowo zweryfikowane i przesłane.

Jeśli prośba zostanie zrealizowana

Jeśli żądanie się powiedzie, odpowiedź będzie zawierać pełną wewnętrzną reprezentację Search Ads 360 każdej przesłanej konwersji, np. identyfikator kampanii, identyfikator grupy reklam i identyfikator słowa kluczowego (kryterium).

{
 "kind": "doubleclicksearch#conversionList",
 "conversion": [
  {
   "agencyId": "12300000000000456",
   "advertiserId": "45600000000010291",
   "engineAccountId": "700000000042441",
   "campaignId": "71700000002044839",
   "adGroupId": "58700000032026064",
   "criterionId": "43700004289911004",
   "adId": "0",
   "dsConversionId": "48719131694768384",
   "conversionId": "test_1383157331951",
   "state": "ACTIVE",
   "type": "TRANSACTION",
   "revenueMicros": "20000000",
   "currencyCode": "USD",
   "segmentationType": "FLOODLIGHT",
   "segmentationId": "25700000001464141",
   "segmentationName": "Test",
   "conversionTimestamp": "1378710000000",
   "conversionModifiedTimestamp": "1383157332368"
  },
  ...
 ]
}

Jeśli żądanie nie zostanie zrealizowane

Jeśli weryfikacja lub przesyłanie co najmniej 1 konwersji się nie powiedzie, odpowiedź będzie zawierać komunikaty dotyczące każdego nieudanego przesłania konwersji. Odpowiedź nie zawiera wiadomości 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 błędzie zawiera 2 ważne pola: przyczynę i szczegółowy komunikat o błędzie. Pole reason może zawierać wartości requestValidation, internalError, transactionFailed lub lateStageRequestError.

requestValidation errors

Błędy requestValidation wskazują na problemy z danymi w prośbie o przesłanie konwersji (np. konwersja została już przesłana lub nie znaleziono identyfikatora kliknięcia). W tym typie 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ą na wewnętrzny problem w Search Ads 360.

Reagowanie na błąd

Jeśli żądanie się nie powiedzie, spróbuj ponownie przesłać całe wywołanie żądania później. Search Ads 360 będzie zgłaszać 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ązywania problemów, aby dowiedzieć się, co zrobić.