Dodaj nowe konwersje

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

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

Przekształć wszystkie sygnatury czasowe konwersji na czas epoki (zwany też czasem uniksowym).

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 API Campaign Managera, aby ją utworzyć. Nie możesz użyć interfejsu API, aby określić, że aktywność Floodlight jest używana głównie do konwersji offline. Jest to dobra praktyka, 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 tym systemie 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 tym systemie 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 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 clickId.

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

Wysyłanie żądania wstawienia

Możesz wysłać prośbę Conversion.insert(), aby wykonać dowolną z tych czynności:

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

Pola wymagane w żądaniu Conversion.insert() zależą od zdarzenia lub produktu, do którego przypisujesz konwersję. W następnych sekcjach podajemy wymagane i opcjonalne pola w przypadku 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 przejdzie do witryny reklamodawcy, Search Ads 360 uzna sesję użytkownika w witrynie reklamodawcy za wizytę. Aby przypisać konwersję do wizyty, w prośbie Conversion.insert()podaj:

Pola wymagane

• clickId: identyfikator kliknięcia z uwzględnieniem wielkości liter. W dzienniku sieciowym reklamodawcy poszukaj identyfikatora kliknięcia lub wyświetl listę 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 przyczyniły się do jej wystąpienia.
  Poczekaj co najmniej 6 godzin, aż Search Ads 360 wygeneruje identyfikator kliknięcia, aby przesłać 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 reklamodawcy podają ten identyfikator. Reklamodawcy mogą podać dowolny identyfikator, który uznają za odpowiedni. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a połączenie identyfikatora i sygnatury czasowej musi być unikalne w śród wszystkich konwersji u reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej usługi zmienną dsConversionId lub floodlightOrderId, zależnie od instrukcji Floodlight podanych przez reklamodawcę.
• 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 godz. 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 to pole jest zawsze wymagane do określenia wartości FLOODLIGHT.
• segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

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

  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. (Campaign Manager przypisuje też identyfikator do aktywności Floodlight, ale identyfikator Campaign Managera różni się od identyfikatora 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 z interfejsu API do raportowania). Jeśli w okresie objętym raportem co najmniej 1 konwersja została przypisana do aktywności Floodlight, w raporcie zobaczysz identyfikator Search Ads 360.

• type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja polegająca na wykonaniu działania nie ma wartości pieniężnej, a konwersja polegająca na dokonaniu transakcji – tak. Przykładem może być rejestracja na liście e-mailowej (działanie) w porównaniu z zakupami e-commerce (transakcja).

  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ę do newslettera e-mailowego, lub łączna liczba sprzedanych produktów. Jeśli nie podasz 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ą wyrażone w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podany przychód na walutę reklamodawcy. Więcej informacji
  Aby określić walutę, użyj formatu alfabetycznego ISO 4217 (3 znaki).
  Dotyczy tylko konwersji typu TRANSACTION (Transakcja).
• customMetric i customDimension: przesyłają dodatkowe dane o konwersji, takie jak kraj, do którego wysyłany jest zakupiony produkt, identyfikatory produktów czy nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych do niestandardowych zmiennych Floodlight.
• deviceType: określa typ urządzenia, na którym nastąpiła konwersja. Zobacz listę akceptowanych wartości dla tego pola.

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

  /**
   * 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());
    }
  }
            

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 Twoim głównym celem jest przypisywanie 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 oraz kilka innych pól:

Pola wymagane

• criterionId: to identyfikator słowa kluczowego. Aby uzyskać criterionId, dodaj makro TrackerId do adresów URL stron docelowych. Informacje o uzyskiwaniu identyfikatorów słów kluczowych znajdziesz w artykule Identyfikatory i konwersje Search Ads 360.
• conversionId: w przypadku konwersji offline reklamodawcy podają ten identyfikator. Reklamodawcy mogą podać dowolny identyfikator, który uznają za odpowiedni. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a połączenie identyfikatora i sygnatury czasowej musi być unikalne w śród wszystkich konwersji u reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej usługi zmienną dsConversionId lub floodlightOrderId, zależnie od instrukcji Floodlight podanych przez reklamodawcę.
• 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 godz. 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 to pole jest zawsze wymagane do określenia wartości FLOODLIGHT.
• segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.

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

  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. (Campaign Manager przypisuje też identyfikator do aktywności Floodlight, ale identyfikator Campaign Managera różni się od identyfikatora 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 z interfejsu API do raportowania). Jeśli w okresie objętym raportem co najmniej 1 konwersja została przypisana do aktywności Floodlight, w raporcie zobaczysz identyfikator Search Ads 360.

• type: typ konwersji, czyli ACTION lub TRANSACTION. Konwersja polegająca na wykonaniu działania nie ma wartości pieniężnej, a konwersja polegająca na dokonaniu transakcji – tak. Przykładem może być rejestracja na liście e-mailowej (działanie) w porównaniu z zakupami e-commerce (transakcja).

  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ę do newslettera e-mailowego, lub łączna liczba sprzedanych produktów. Jeśli nie podasz 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ą wyrażone w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podany przychód na walutę reklamodawcy. Więcej informacji
  Aby określić walutę, użyj formatu alfabetycznego ISO 4217 (3 znaki).
  Dotyczy tylko konwersji typu TRANSACTION (Transakcja).
• customMetric i customDimension: przesyłają dodatkowe dane o konwersji, takie jak kraj, do którego wysyłany jest zakupiony produkt, identyfikatory produktów czy nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych do niestandardowych zmiennych Floodlight.
• deviceType: określa typ urządzenia, na którym nastąpiła konwersja. Zobacz listę akceptowanych wartości dla tego pola.

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

  /**
   * 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;
  }        

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

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

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 przypadku tego typu błędu komunikat Szczegóły zawiera 2 elementy:

• Szesnastkowy kod identyfikujący rodzaj błędu. Możesz użyć kodu w swoich skryptach, aby zidentyfikować błędy.
• Opis błędu weryfikacji.

Więcej informacji znajdziesz w liście kodów i ich 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.

Odpowiedź na błąd

Jeśli żądanie się nie powiedzie, spróbuj ponownie przesłać całą funkcję wywołania żądania. Search Ads 360 zgłosi błędy requestValidation dotyczące wszystkich konwersji, które zostały już przesłane, ale spróbuje przesłać pozostałe konwersje.

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