Pakiet SDK dla kampanii produktowych: instrukcje integracji technicznej firm zewnętrznych

Google tworzy interfejs na urządzeniu, który porządkuje aplikacje użytkowników według branży i umożliwia nowe wciągające wrażenia podczas przeglądania i odtwarzania spersonalizowanych treści w aplikacji. Tryb pełnoekranowy daje partnerom deweloperom możliwość zaprezentowania swoich najlepszych treści w ramach dedykowanego kanału poza aplikacją.

Ten przewodnik zawiera instrukcje dla partnerów deweloperów dotyczące integracji treści związanych z zakupami za pomocą pakietu Engage SDK, aby wypełnić nową powierzchnię oraz istniejące powierzchnie Google, takie jak Entertainment Space.

Szczegóły integracji

Terminologia

Ta integracja obejmuje 5 typów klastrów: Rekomendacja, Polecane, Koszyk, Lista zakupów, Ponowne zamówienie i Śledzenie zamówienia zakupów.

  • Rekomendacje to grupy zawierające spersonalizowane sugestie dotyczące zakupów od konkretnego dewelopera. Rekomendacje mogą być spersonalizowane dla danego użytkownika lub ogólne (np. dotyczące popularnych treści). Używaj ich do wyświetlania produktów, wydarzeń, wyprzedaży, promocji i subskrypcji.

    Rekomendacje mają następującą strukturę:

    • Klaster rekomendacji: widok interfejsu użytkownika zawierający grupę rekomendacji od tego samego partnera deweloperskiego.

    • ShoppingEntity: obiekt reprezentujący pojedynczy element w klastrze.

  • Grupa Polecane zawiera wybrane elementy od wielu partnerów programistów w jednym układzie interfejsu. Będzie jeden wyróżniony klaster, który będzie wyświetlany u góry interfejsu w priorytetowym miejscu nad wszystkimi innymi klastrami rekomendacji. Każdy partner deweloper może transmitować maksymalnie 10 elementów w klastrze Polecane.

  • Grupa Koszyk zawiera podgląd koszyków wielu partnerów deweloperów w jednym układzie interfejsu, zachęcając użytkowników do sfinalizowania otwartych koszyków. Jest jeden klaster koszyka, który jest wyświetlany u góry interfejsu i ma priorytet nad wszystkimi innymi klastrami rekomendacji. Każdy partner deweloper może przesyłać do klastra koszyka zakupowego maksymalnie 3 ShoppingCart instancje.

    Koszyk ma następującą strukturę:

    • Klaster koszyka zakupowego: widok interfejsu z grupą podglądów koszyka zakupowego od wielu partnerów programistów.

    • ShoppingCart: obiekt reprezentujący podgląd koszyka zakupowego pojedynczego partnera dewelopera, który ma być wyświetlany w klastrze ShoppingCart. ShoppingCart musi zawierać łączną liczbę produktów w koszyku i może zawierać obrazy niektórych produktów w koszyku użytkownika.

  • Klaster Lista zakupów zawiera podgląd list zakupów od wielu partnerów deweloperów w jednym obszarze interfejsu, a także prośbę o powrót do odpowiedniej aplikacji w celu zaktualizowania i uzupełnienia list. Jest jeden klaster listy zakupów.

  • Klaster Zmień kolejność zawiera podgląd poprzednich zamówień od wielu partnerów deweloperów w jednym układzie interfejsu, aby zachęcić użytkowników do zmiany kolejności. Jest 1 klaster „Zmien kolejność”.

    • Grupa elementów do ponownego zamówienia musi zawierać łączną liczbę produktów z poprzedniego zamówienia użytkownika. Musi też zawierać co najmniej jedną z tych informacji:

      • Obrazy X elementów z poprzedniego zamówienia użytkownika.
      • Etykiety X produktów w poprzednim zamówieniu użytkownika.

  • Klaster Śledzenie zamówień zakupowych zawiera w jednym interfejsie widok oczekujących lub niedawno zrealizowanych zamówień zakupowych wielu partnerów programistów, co pozwala użytkownikom śledzić ich zamówienia.

    Jest jeden klaster ShoppingOrderTracking, który jest wyświetlany u góry interfejsu i ma priorytet nad wszystkimi klastrami rekomendacji. Każdy partner deweloper może przesyłać wiele elementów ShoppingOrderTrackingEntity w klastrze śledzenia zamówień produktowych.

    • ShoppingOrderTrackingCluster ma następującą strukturę:

      • Klaster śledzenia zamówień zakupowych: widok interfejsu zawierający grupę podglądów śledzenia zamówień od wielu partnerów programistów.
      • ShoppingOrderTrackingEntity: obiekt reprezentujący podgląd śledzenia zamówienia produktowego dla pojedynczego partnera deweloperskiego, który ma być wyświetlany w klastrze śledzenia zamówienia produktowego. ShoppingOrderTrackingEntity musi zawierać stan zamówienia i czas jego złożenia. Zdecydowanie zalecamy wypełnienie pola oczekiwany czas dostawy w przypadku ShoppingOrderTrackingEntity, ponieważ jest ono wyświetlane użytkownikom.

Przygotowanie

Minimalny poziom interfejsu API: 19

Dodaj bibliotekę com.google.android.engage:engage-core do aplikacji:

dependencies {
    // Make sure you also include that repository in your project's build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.2'
}

Więcej informacji znajdziesz w artykule Widoczność pakietów w Androidzie 11.

Podsumowanie

Projekt jest oparty na implementacji usługi z ograniczeniami.

Dane, które klient może publikować, podlegają następującym ograniczeniom w przypadku różnych typów klastrów:

Typ klastra Limity klastra Maksymalne limity elementów w klastrze
Klastry rekomendacji Maksymalnie 7 Maksymalnie 50 ShoppingEntity
Polecany klaster Maksymalnie 1 Maksymalnie 20 ShoppingEntity
Grupa koszyków na zakupy Maksymalnie 1 Maksymalnie 3 ShoppingCart

Wiele koszyków jest oczekiwane tylko w przypadku aplikacji z osobnymi koszykami dla każdego sprzedawcy.

Grupa lista zakupów Maksymalnie 1 Maksymalnie 1 ShoppingListEntity
Shopping Reorder Cluster Maksymalnie 1 Maksymalnie 1 ReorderEntity
Shopping Order Tracking Cluster Maksymalnie 3 Maksymalnie 3 ShoppingOrderTrackingEntity

Krok 1. Podaj dane o podmiocie

Pakiet SDK definiuje różne elementy reprezentujące poszczególne typy elementów. W przypadku kategorii Zakupy obsługiwane są te elementy:

  1. ShoppingEntity
  2. ShoppingCart
  3. ShoppingList
  4. Reorder
  5. ShoppingOrderTracking

W tabelach poniżej znajdziesz dostępne atrybuty i wymagania dotyczące poszczególnych typów.

ShoppingEntity

Obiekt ShoppingEntity reprezentuje produkt, promocję, ofertę, subskrypcję lub zdarzenie, które partnerzy deweloperzy chcą opublikować.

ShoppingEntity
Atrybut Wymaganie Opis Format
obrazy plakatu, Wymagany Musisz podać co najmniej 1 obraz. Więcej informacji znajdziesz w specyfikacji zdjęć.
Identyfikator URI działania Wymagany

Precyzyjny link do strony w aplikacji z informacjami o danym elemencie.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania

Identyfikator URI
Tytuł Opcjonalny Nazwa elementu.

Tekst otwarty

Zalecana długość tekstu: mniej niż 90 znaków (za długi tekst może być wyświetlany z wielokropem)
Cena – bieżąca Wymagane warunkowo

Bieżąca cena elementu.

Musi być podana, jeśli podano cenę z przekreśleniem.

Tekst otwarty
Cena – przekreślenie Opcjonalny Pierwotna cena elementu, która jest przekreślona w interfejsie użytkownika. Tekst otwarty
Objaśnienie Opcjonalny Wskazówka dotycząca promocji, wydarzenia lub aktualizacji dotyczącej danego podmiotu (jeśli jest dostępna).

Tekst otwarty

Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropki)
Drobny druk Opcjonalny Drobny druk objaśnienia.

Tekst otwarty

Zalecane rozmiary tekstu: poniżej 45 znaków (tekst, który jest za długi, może zawierać wielokropki)
Ocena (opcjonalnie) – uwaga: wszystkie oceny są wyświetlane w standardowym systemie oceniania za pomocą gwiazdek.
Ocena – wartość maksymalna Opcjonalny

Maksymalna wartość skali oceny.

Musi być podana, jeśli podana jest też aktualna wartość oceny.

 Liczba >= 0,0
Rating - Current value Opcjonalny

Bieżąca wartość skali ocen.

Musi być podana, jeśli podana jest też maksymalna wartość oceny.

 Liczba >= 0,0
Rating - Count (Liczba ocen) Opcjonalny

Liczba ocen danej encji.

Uwaga: wypełnij to pole, jeśli Twoja aplikacja kontroluje sposób wyświetlania liczby użytkownikom. Użyj zwięzłego ciągu znaków. Jeśli np. liczba wynosi 1 000 000, rozważ użycie skrótu, takiego jak 1 mln, aby liczba nie została obcięta w mniejszych rozmiarach wyświetlacza.

Ciąg znaków
Rating - Count Value Opcjonalny

Liczba ocen danej encji.

Uwaga: wypełnij to pole, jeśli nie obsługujesz samodzielnie logiki wyświetlania skrótu. Jeśli występują zarówno parametry Liczba, jak i Wartość liczby, użytkownikom wyświetlana jest liczba.

 Długie
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na powierzchni
Sygnatura czasowa rozpoczęcia Opcjonalny

sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie;

Jeśli nie skonfigurujesz tej zasady, treści mogą być wyświetlane na powierzchni.

 Sygnatura czasowa od początku epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalny

Znak czasu epoki, po którym treści nie są już wyświetlane na powierzchni.

Jeśli nie skonfigurujesz tej zasady, treści mogą być wyświetlane na powierzchni.

 Sygnatura czasowa od początku epoki w milisekundach

ShoppingCart

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do koszyka w aplikacji partnera.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania

Identyfikator URI
Liczba elementów Wymagany

Liczba elementów (a nie tylko liczba produktów) w koszyku.

Na przykład: jeśli w koszyku są 3 identyczne koszule i 1 kapelusz, liczba powinna wynosić 4.

Liczba całkowita > 1
Tekst wezwania do działania Opcjonalny

Tekst wezwania do działania na przycisku w koszyku (np. Twój koszyk).

Jeśli deweloper nie poda tekstu działania, domyślnie będzie to Wyświetl koszyk.

Ten atrybut jest obsługiwany od wersji 1.1.0.

Ciąg znaków
Tytuł Opcjonalny

Tytuł koszyka (np. Twój koszyk).

Jeśli deweloper nie poda tytułu, domyślnie zostanie użyty tytuł Twój kosz.

Jeśli partner deweloper publikuje osobny koszyk dla każdego sprzedawcy, w tytule podaj nazwę sprzedawcy.

Tekst otwarty

Zalecane rozmiary tekstu: poniżej 25 znaków (tekst, który jest za długi, może zawierać wielokropki)
Obrazy koszyka Opcjonalny

obrazy każdego produktu w koszyku.

Możesz przesłać maksymalnie 10 obrazów w kolejności priorytetów. Rzeczywista liczba wyświetlanych obrazów zależy od formy urządzenia.

 Więcej informacji znajdziesz w specyfikacji zdjęć.
Etykiety elementów Opcjonalny

Lista etykiet produktów na liście zakupów.

Rzeczywista liczba wyświetlanych etykiet zależy od formatu urządzenia.

Lista etykiet tekstowych

Zalecane rozmiary tekstu: poniżej 20 znaków (tekst, który jest za długi, może zawierać wielokropki)
Sygnatura czasowa ostatniej interakcji użytkownika Opcjonalny Liczba milisekund od początku ery, która identyfikuje ostatni czas, gdy użytkownik miał kontakt z koszem.

Będzie ono przekazywane przez partnerów deweloperskich, którzy publikują osobny koszyk dla każdego sprzedawcy. Może ono też służyć do ustalania rankingu.

Sygnatura czasowa od początku epoki w milisekundach
DisplayTimeWindow (opcjonalnie) – ustaw przedział czasu, w którym treści mają być wyświetlane na urządzeniu
Sygnatura czasowa rozpoczęcia Opcjonalny

sygnatura czasowa epoki, po której treści powinny być wyświetlane na danej platformie;

Jeśli nie skonfigurujesz tej zasady, treści mogą być wyświetlane na powierzchni.

 Sygnatura czasowa od początku epoki w milisekundach
Sygnatura czasowa zakończenia Opcjonalny

Znak czasu epoki, po którym treści nie są już wyświetlane na powierzchni.

Jeśli nie skonfigurujesz tej zasady, treści mogą być wyświetlane na powierzchni.

 Sygnatura czasowa od początku epoki w milisekundach

ShoppingList

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

Precyzyjny link do listy zakupów w aplikacji partnera.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania

Identyfikator URI
Liczba elementów Wymagany Liczba produktów na liście zakupów. Liczba całkowita > 1
Tytuł Opcjonalny

Tytuł listy (np. Twoja lista zakupów).

Jeśli deweloper nie poda tytułu, domyślnie zostanie wyświetlona Lista zakupów.

Tekst otwarty

Zalecane rozmiary tekstu: poniżej 25 znaków (tekst, który jest za długi, może zawierać wielokropki)
Etykiety elementów Wymagany

Lista etykiet produktów na liście zakupów.

Musisz podać co najmniej 1 etykietę, a maksymalnie 10 etykiet w kolejności priorytetów. Rzeczywista liczba wyświetlanych etykiet zależy od formatu urządzenia.

Lista etykiet tekstowych

Zalecane rozmiary tekstu: poniżej 20 znaków (tekst, który jest za długi, może zawierać wielokropki)

ShoppingReorderCluster

Atrybut Wymaganie Opis Format
Identyfikator URI działania Wymagany

precyzyjny link do ponownego zamówienia w aplikacji partnera;

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania

Identyfikator URI
Tekst wezwania do działania Opcjonalny

Tekst wezwania do działania przycisku „Zamówienie ponownie” (np. Zamówienie ponownie).

Jeśli deweloper nie poda tekstu działania, domyślnie będzie to Zmień kolejność.

Ten atrybut jest obsługiwany od wersji 1.1.0.

Ciąg znaków
Liczba elementów Wymagany

Liczba elementów (nie tylko liczba produktów) w poprzednim zamówieniu.

Na przykład: jeśli w poprzednim zamówieniu były 3 małe kawy i 1 rogalik, liczba ta powinna wynosić 4.

Liczba całkowita > 1
Tytuł Wymagany Tytuł zamówienia powtórnego.

Tekst otwarty

Zalecana długość tekstu: mniej niż 40 znaków (tekst, który jest za długi, może zawierać wielokropki)
Etykiety elementów

Opcjonalny

(jeśli nie zostały przesłane, należy przesłać obrazy plakatu)

Lista etykiet produktów z poprzedniego zamówienia.

Możesz podać maksymalnie 10 etykiet w kolejności priorytetów. Rzeczywista liczba wyświetlanych etykiet zależy od formatu urządzenia.

Lista z tekstem dowolnym

Zalecany rozmiar tekstu na etykietę: mniej niż 20 znaków(w przypadku zbyt długiego tekstu mogą być wyświetlane wielokropki)

obrazy plakatu,

Opcjonalny

(jeśli nie podano, należy podać etykiety produktów)

zdjęcia produktów z poprzedniego zamówienia.

Możesz przesłać maksymalnie 10 obrazów w kolejności priorytetów. Rzeczywista liczba wyświetlanych obrazów zależy od formy urządzenia.

 Więcej informacji znajdziesz w specyfikacji zdjęć.

ShoppingOrderTrackingCluster

Atrybut Wymaganie Opis Format
Tytuł Wymagany

Krótki tytuł przesyłki lub śledzonych elementów albo numer śledzenia.

Tekst otwarty

Zalecane rozmiary tekstu: 50 znaków (za długi tekst będzie zawierał wielokropki)

Typ zamówienia Wymagany

Krótki tytuł przesyłki lub śledzonych elementów albo numer śledzenia.

Typ: IN_STORE_PICKUP, SAME_DAY_DELIVERY, MULTI_DAY_DELIVERY
Stan Wymagany

Bieżący stan zamówienia.

Na przykład: „Opóźnienie”, „W drodze”, „Opóźnienie”, „Wysłano”, „Dostarczono”, „Brak w magazynie”, „Zamówienie gotowe”

Tekst otwarty

Zalecane rozmiary tekstu: 25 znaków (za długi tekst będzie zawierał wielokropki)

Czas zamówienia Wymagany

Sygnatura czasowa epoki w milisekundach, w których złożono zamówienie.

Czas zamówienia będzie wyświetlany, jeśli nie ma oczekiwanego okna dostawy

 Sygnatura czasowa od początku epoki w milisekundach
Identyfikator URI działania Wymagany

precyzyjny link do śledzenia zamówienia w aplikacji partnera.

 Identyfikator URI
OrderDeliveryTimeWindow (opcjonalnie) – ustaw przedział czasu dla śledzonego zamówienia od momentu jego złożenia do przewidywanej lub faktycznej dostawy.
OrderDeliveryTimeWindow - Start Time Opcjonalny

Sygnatura czasowa epoki w milisekundach, w której zamówienie zostanie dostarczone lub będzie gotowe do odbioru.

 Sygnatura czasowa od początku epoki w milisekundach
OrderDeliveryTimeWindow – End Time Opcjonalny

Sygnatura czasowa w epoce w milisekundach, do której zamówienie zostanie dostarczone lub będzie gotowe do odbioru.

Sygnatura czasowa od początku epoki w milisekundach
obrazy plakatu, Opcjonalny

Zdjęcie jednego produktu, który jest częścią zamówienia.

Zalecany format obrazu to 1:1.

 Więcej informacji znajdziesz w specyfikacji zdjęć.
Liczba elementów Opcjonalny Liczba produktów w zamówieniu. Liczba całkowita > 1
Opis Opcjonalny

Jeden akapit tekstu opisujący produkty w zamówieniu.

Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.

Tekst otwarty

Zalecany rozmiar tekstu: 180 znaków
Lista napisów Opcjonalny

Maksymalnie 3 napisy, z których każdy stanowi pojedynczy wiersz tekstu.

Uwaga: użytkownik zobaczy albo opis, albo listę napisów, ale nie oba naraz.

Tekst otwarty

Zalecane rozmiary tekstu dla każdego z podtytułów: maks. 50 znaków
Wartość zamówienia – bieżąca cena Opcjonalny Bieżąca wartość zamówienia. Tekst otwarty
Numer zamówienia Opcjonalny Numer lub identyfikator zamówienia, który umożliwia jednoznaczną identyfikację zamówienia.

Tekst otwarty

Zalecany rozmiar tekstu: maks. 25 znaków
Numer śledzenia przesyłki Opcjonalny Numer śledzenia przesyłki w przypadku zamówienia wymagającego dostawy.

Tekst otwarty

Zalecany rozmiar tekstu: maks. 25 znaków

Specyfikacja obrazu

Wymagania dotyczące komponentów z obrazem:

Format obrazu Minimalna liczba pikseli Zalecany rozmiar w pikselach

Kwadrat (1 x 1)

Preferowane w przypadku klastrów bez wyróżnienia

 300 x 300 1200 x 1200

Orientacja pozioma (1,91 x 1)

Preferowane w przypadku wyróżnionych klastrów

 600 x 314 1200 x 628
Orientacja pionowa (4 x 5) 480 x 600 960 x 1200

Formaty plików

PNG, JPG, statyczny GIF, WebP

Maksymalny rozmiar pliku

5120 KB

Dodatkowe rekomendacje

  • Bezpieczny obszar obrazu: ważne treści umieść w środkowych 80% obrazu.
  • Użyj przezroczystego tła, aby obraz był prawidłowo wyświetlany w ustawieniach motywu ciemnego i jasnego.

Krok 2. Podaj dane klastra

Zalecamy, aby zadanie publikowania treści było wykonywane w tle (np. za pomocą WorkManagera) i zaplanowane regularnie lub w zależności od zdarzenia (np. za każdym razem, gdy użytkownik otworzy aplikację lub doda coś do koszyka).

AppEngageShoppingClient odpowiada za publikowanie klastrów produktowych.

Do publikowania klastrów w kliencie służą te interfejsy API:

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishShoppingCart
  • publishShoppingCarts
  • publishShoppingList
  • publishShoppingReorderCluster
  • publishShoppingOrderTrackingCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteShoppingCartCluster
  • deleteShoppingListCluster
  • deleteShoppingReorderCluster
  • deleteShoppingOrderTrackingCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

Ten interfejs API służy do sprawdzania, czy usługa jest dostępna do integracji i czy można wyświetlić treści na urządzeniu.

KotlinJava
client.isServiceAvailable.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // Handle IPC call success
        if(task.result) {
          // Service is available on the device, proceed with content publish
          // calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
}
 
client.isServiceAvailable().addOnCompleteListener(task - > {
    if (task.isSuccessful()) {
        // Handle success
        if(task.getResult()) {
          // Service is available on the device, proceed with content
          // publish calls.
        } else {
          // Service is not available, no further action is needed.
        }
    } else {
      // The IPC call itself fails, proceed with error handling logic here,
      // such as retry.
    }
});

publishRecommendationClusters

Ten interfejs API służy do publikowania listy obiektów RecommendationCluster.

Obiekt RecommendationCluster może mieć te atrybuty:

Atrybut Wymaganie Opis
Lista ShoppingEntity Wymagany Lista obiektów ShoppingEntity, które stanowią rekomendacje dla tego klastra rekomendacji.
Tytuł Wymagany

Tytuł klastra rekomendacji.

Zalecane rozmiary tekstu: poniżej 25 znaków (tekst, który jest za długi, może zawierać wielokropki)
Podtytuł Opcjonalny Podtytuł klastra rekomendacji.
Identyfikator URI działania Opcjonalny

Precyzyjny link do strony w aplikacji partnera, na której użytkownicy mogą zobaczyć pełną listę rekomendacji.

Uwaga: do atrybucji możesz używać precyzyjnych linków. Zapoznaj się z odpowiedziami na najczęstsze pytania

KotlinJava
client.publishRecommendationClusters(
            PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Black Friday Deals")
                        .build())
                .build())
 
client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Black Friday Deals")
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Wszystkie istniejące dane klastra rekomendacji zostaną usunięte.
  • Dane z zapytania są analizowane i przechowywane w nowych klastrach rekomendacji.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishFeaturedCluster

Ten interfejs API służy do publikowania obiektu FeaturedCluster.

KotlinJava
client.publishFeaturedCluster(
            PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    FeaturedCluster.Builder()
                        ...
                        .build())
                .build())
 
client.publishFeaturedCluster(
            new PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    new FeaturedCluster.Builder()
                        ...
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Istniejące dane FeaturedCluster od partnera dewelopera zostaną usunięte.
  • Dane z zapytania są analizowane i przechowywane w zaktualizowanym zbiorze polecanych.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishShoppingCart

Ten interfejs API służy do publikowania obiektu ShoppingCartCluster.

KotlinJava
client.publishShoppingCart(
            PublishShoppingCartRequest.Builder()
                .setShoppingCart(
                    ShoppingCart.Builder()
                        ...
                        .build())
                .build())
 
client.publishShoppingCart(
            new PublishShoppingCartRequest.Builder()
                .setShoppingCart(
                    new ShoppingCart.Builder()
                        ...
                        .build())
                .build())

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Istniejące dane ShoppingCart od partnera dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze koszyka z zakupami.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishShoppingCarts

Ten interfejs API służy do publikowania wielu obiektów ShoppingCart. Dotyczy to partnera deweloperskiego publikującego osobne koszyki dla każdego sprzedawcy. Podczas korzystania z tego interfejsu API uwzględnij nazwę sprzedawcy w tytule.

KotlinJava
client.publishShoppingCarts(
            PublishShoppingCartClustersRequest.Builder()
                .addShoppingCart(
                    ShoppingCart.Builder()
                        ...
                        .build())
                .build())
 
client.publishShoppingCarts(
            new PublishShoppingCartClustersRequest.Builder()
                .addShoppingCart(
                    new ShoppingCart.Builder()
                        ...
                        .build())
                .build())

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Istniejące dane ShoppingCart od partnera dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze koszyka z zakupami.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishShoppingList

Ten interfejs API służy do publikowania obiektu FoodShoppingList.

KotlinJava
client.publishFoodShoppingList(
            PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    FoodShoppingListEntity.Builder()
                        ...
                        .build())
                .build())
 
client.publishFoodShoppingList(
            new PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    new FoodShoppingListEntity.Builder()
                        ...
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Istniejące dane FoodShoppingList od partnera dewelopera zostaną usunięte.
  • Dane z zapytania są analizowane i przechowywane w zaktualizowanym klastrze listy zakupów.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishShoppingReorderCluster

Ten interfejs API służy do publikowania obiektu ShoppingReorderCluster.

KotlinJava
client.publishShoppingReorderCluster(
            PublishShoppingReorderClusterRequest.Builder()
                .setReorderCluster(
                    ShoppingReorderCluster.Builder()
                        ...
                        .build())
                .build())
 
client.publishShoppingReorderCluster(
            new PublishShoppingReorderClusterRequest.Builder()
                .setReorderCluster(
                    new ShoppingReorderCluster.Builder()
                        ...
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Istniejące dane ShoppingReorderCluster od partnera dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze do ponownego uporządkowania.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishShoppingOrderTrackingCluster

Ten interfejs API służy do publikowania obiektu ShoppingOrderTrackingCluster.

KotlinJava
client.publishShoppingOrderTrackingCluster(
            PublishShoppingOrderTrackingClusterRequest.Builder()
                .setShoppingOrderTrackingCluster(
                    ShoppingOrderTrackingCluster.Builder()
                        ...
                        .build())
                .build())
 
client.publishShoppingOrderTrackingCluster(
            new PublishShoppingOrderTrackingClusterRequest.Builder()
                .setShoppingOrderTrackingCluster(
                    new ShoppingOrderTrackingCluster.Builder()
                        ...
                        .build())
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Dotychczasowe dane ShoppingOrderTrackingCluster od partnera dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze śledzenia zamówień w Zakupach Google.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

publishUserAccountManagementRequest

Ten interfejs API służy do publikowania karty logowania . Działanie logowania kieruje użytkowników na stronę logowania w aplikacji, aby aplikacja mogła publikować treści (lub udostępniać bardziej spersonalizowane treści).

Te metadane są częścią karty logowania:

Atrybut Wymaganie Opis
Identyfikator URI działania Wymagane Precyzyjny link do aplikacji Action (np. przekierowuje na stronę logowania do aplikacji)
Obraz Opcjonalnie – jeśli nie zostanie podany, należy podać tytuł.

Obraz na karcie

obrazy w formacie 16 x 9 o rozdzielczości 1264 x 712;
Tytuł Opcjonalnie – jeśli nie zostanie podany, należy podać obraz Tytuł na karcie
Tekst wezwania do działania Opcjonalny Tekst wezwania do działania (np. Zaloguj się)
Podtytuł Opcjonalny Opcjonalny napis na karcie
KotlinJava
var SIGN_IN_CARD_ENTITY =
      SignInCardEntity.Builder()
          .addPosterImage(
              Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build()

client.publishUserAccountManagementRequest(
            PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());
 
SignInCardEntity SIGN_IN_CARD_ENTITY =
      new SignInCardEntity.Builder()
          .addPosterImage(
              new Image.Builder()
                  .setImageUri(Uri.parse("http://www.x.com/image.png"))
                  .setImageHeightInPixel(500)
                  .setImageWidthInPixel(500)
                  .build())
          .setActionText("Sign In")
          .setActionUri(Uri.parse("http://xx.com/signin"))
          .build();

client.publishUserAccountManagementRequest(
            new PublishUserAccountManagementRequest.Builder()
                .setSignInCardEntity(SIGN_IN_CARD_ENTITY)
                .build());

Gdy usługa otrzyma żądanie, w ramach jednej transakcji wykona te działania:

  • Dotychczasowe dane UserAccountManagementCluster od partnera dewelopera zostaną usunięte.
  • Dane z żądania są analizowane i przechowywane w zaktualizowanym klastrze UserAccountManagementCluster.

W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

updatePublishStatus

Jeśli z jakiegokolwiek wewnętrznego powodu biznesowego żaden z tych klastrów nie został opublikowany, zdecydowanie zalecamy zaktualizowanie stanu publikacji za pomocą interfejsu updatePublishStatus API. Jest to ważne, ponieważ :

  • Podanie stanu we wszystkich scenariuszach, nawet gdy treści są opublikowane (STATUS = PUBLISHED), jest kluczowe dla wypełniania paneli, które używają tego stanu do przekazywania informacji o stanie i innych danych dotyczących integracji.
  • Jeśli nie ma opublikowanych treści, ale integracja nie jest uszkodzona (STATUS = NOT_PUBLISHED), Google może nie uruchamiać alertów na panelach danych dotyczących zdrowia w aplikacji. Potwierdza, że treści nie są publikowane z powodu oczekiwanego stanu z punktu widzenia dostawcy.
  • Pomaga deweloperom udostępniać informacje o tym, kiedy dane są publikowane, a kiedy nie.
  • Google może używać kodów stanu, aby zachęcić użytkownika do wykonania określonych działań w aplikacji, dzięki którym będzie on mógł zobaczyć jej zawartość lub ją pokonać.

Lista kodów stanu publikacji, które kwalifikują się do wyświetlania :

// Content is published
AppEngagePublishStatusCode.PUBLISHED,

// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,

// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,

// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,

// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,

// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,

// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,

// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,

// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER

Jeśli treści nie są publikowane, ponieważ użytkownik nie jest zalogowany, Google zaleca opublikowanie karty logowania. Jeśli z jakiegokolwiek powodu dostawcy nie mogą opublikować karty logowania, zalecamy wywołanie interfejsu API updatePublishStatus z kodem stanu NOT_PUBLISHED_REQUIRES_SIGN_IN.

KotlinJava
client.updatePublishStatus(
   PublishStatusRequest.Builder()
     .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
     .build())
 
client.updatePublishStatus(
    new PublishStatusRequest.Builder()
        .setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
        .build());

deleteRecommendationClusters

Ten interfejs API służy do usuwania treści z grup rekomendacji.

KotlinJava
client.deleteRecommendationClusters()
 
client.deleteRecommendationClusters();

Gdy usługa otrzyma prośbę, usunie istniejące dane z klastrów rekomendacji. W przypadku błędu cała prośba zostaje odrzucona, a istniejący stan jest zachowany.

deleteFeaturedCluster

Ten interfejs API służy do usuwania treści z wyróżnionego klastra.

KotlinJava
client.deleteFeaturedCluster()
 
client.deleteFeaturedCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z wyróżnionego klastra. W przypadku błędu cała prośba zostaje odrzucona, a istniejący stan jest zachowany.

deleteShoppingCartCluster

Ten interfejs API służy do usuwania zawartości klastra koszyka zakupowego.

KotlinJava
client.deleteShoppingCartCluster()
 
client.deleteShoppingCartCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastra koszyka. W przypadku błędu cała prośba zostaje odrzucona, a istniejący stan jest zachowany.

deleteShoppingListCluster

Ten interfejs API służy do usuwania zawartości klastra listy zakupów.

KotlinJava
client.deleteShoppingListCluster()
 
client.deleteShoppingListCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z klastra listy zakupów. W przypadku błędu cała prośba zostaje odrzucona, a istniejący stan jest zachowany.

deleteShoppingReorderCluster

Ten interfejs API służy do usuwania treści z klastra ponownego zamówienia w Zakupach Google.

KotlinJava
client.deleteShoppingReorderCluster()
 
client.deleteShoppingReorderCluster();

Gdy usługa otrzyma żądanie, usuwa istniejące dane z grupy ponownego zamówienia w zakupach. W przypadku błędu cała prośba zostaje odrzucona, a istniejący stan jest zachowany.

deleteShoppingOrderTrackingCluster

Ten interfejs API służy do usuwania treści z klastra śledzenia zamówień w Zakupach Google.

KotlinJava
client.deleteShoppingOrderTrackingCluster()
 
client.deleteShoppingOrderTrackingCluster();

Gdy usługa otrzyma żądanie, usunie istniejące dane z grupy śledzenia zamówień w zakupach. W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

deleteUserManagementCluster

Ten interfejs API służy do usuwania treści z klastra UserAccountManagement.

KotlinJava
client.deleteUserManagementCluster()
 
client.deleteUserManagementCluster();

Gdy usługa otrzyma żądanie, usuwa istniejące dane z klastra UserAccountManagement. W przypadku błędu cała prośba jest odrzucana, a obecny stan jest zachowany.

deleteClusters

Ten interfejs API służy do usuwania treści danego typu klastra.

KotlinJava
client.deleteClusters(
    DeleteClustersRequest.Builder()
      .addClusterType(ClusterType.TYPE_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      ...
      .build())
 
client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                ...
                .build());

Gdy usługa otrzyma żądanie, usunie istniejące dane ze wszystkich klastrów pasujących do określonych typów klastrów. Klienci mogą przekazywać jeden lub wiele typów klastrów. W przypadku błędu cała prośba jest odrzucana, a istniejący stan jest zachowany.

Obsługa błędów

Zdecydowanie zalecamy odsłuchanie wyniku zadania z interfejsów API do publikowania, aby można było podjąć dalsze działania w celu odzyskania i ponowniego przesłania zadania, które zostało wykonane prawidłowo.

KotlinJava
client.publishRecommendationClusters(
        PublishRecommendationClustersRequest.Builder()
          .addRecommendationCluster(..)
          .build())
      .addOnCompleteListener { task ->
        if (task.isSuccessful) {
          // do something
        } else {
          val exception = task.exception
          if (exception is AppEngageException) {
            @AppEngageErrorCode val errorCode = exception.errorCode
            if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
              // do something
            }
          }
        }
      }
 
client.publishRecommendationClusters(
              new PublishRecommendationClustersRequest.Builder()
                  .addRecommendationCluster(...)
                  .build())
          .addOnCompleteListener(
              task -> {
                if (task.isSuccessful()) {
                  // do something
                } else {
                  Exception exception = task.getException();
                  if (exception instanceof AppEngageException) {
                    @AppEngageErrorCode
                    int errorCode = ((AppEngageException) exception).getErrorCode();
                    if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
                      // do something
                    }
                  }
                }
              });

Błąd jest zwracany jako AppEngageException, a jego przyczyna jest podana w postaci kodu błędu.

Kod błędu Nazwa błędu Uwaga:
1 SERVICE_NOT_FOUND Usługa jest niedostępna na danym urządzeniu.
2 SERVICE_NOT_AVAILABLE Usługa jest dostępna na danym urządzeniu, ale nie jest dostępna w momencie połączenia (na przykład jest wyraźnie wyłączona).
3 SERVICE_CALL_EXECUTION_FAILURE Nie udało się wykonać zadania z powodu problemów z wątkami. W takim przypadku możesz spróbować ponownie.
4 SERVICE_CALL_PERMISSION_DENIED Rozmówca nie ma uprawnień do zgłoszenia.
5 SERVICE_CALL_INVALID_ARGUMENT Żądanie zawiera nieprawidłowe dane (np. więcej niż dozwoloną liczbę klastrów).
6 SERVICE_CALL_INTERNAL Po stronie usługi wystąpił błąd.
7 SERVICE_CALL_RESOURCE_EXHAUSTED wywołanie usługi jest wykonywane zbyt często.

Krok 3. Obsługa intencji przesyłania

Oprócz wywoływania interfejsu Content API za pomocą zadania musisz też skonfigurować BroadcastReceiver, aby odbierać prośby o publikowanie treści.

Intencje przesyłania są przeznaczone głównie do ponownej aktywacji aplikacji i wymuszania synchronizacji danych. Intencje dotyczące transmisji nie są przeznaczone do wysyłania zbyt często. Jest ona wywoływana tylko wtedy, gdy usługa Engage stwierdzi, że treści mogą być nieaktualne (np. mają tydzień). Dzięki temu użytkownik ma pewność, że będzie mieć dostęp do aktualnych treści, nawet jeśli aplikacja nie była uruchamiana przez długi czas.

Element BroadcastReceiver musi być skonfigurowany w jednym z tych 2 sposobów:

  • Dynamicznie zarejestruj instancję klasy BroadcastReceiver za pomocą funkcji Context.registerReceiver(). Umożliwia to komunikację z aplikacji, które są nadal aktywne w pamięci.
KotlinJava
class AppEngageBroadcastReceiver : BroadcastReceiver(){
  // Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION
  // broadcast is received
  // Trigger featured cluster publish when PUBLISH_FEATURED broadcast is
  // received
  // Trigger shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast
  // is received
  // Trigger shopping list cluster publish when PUBLISH_SHOPPING_LIST broadcast
  // is received
  // Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER broadcast is
  // received
  // Trigger shopping order tracking cluster publish when
  // PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER broadcast is received
}

fun registerBroadcastReceivers(context: Context){
  var  context = context
  context = context.applicationContext

// Register Recommendation Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_RECOMMENDATION))

// Register Featured Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_FEATURED))

// Register Shopping Cart Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_CART))

// Register Shopping List Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_LIST))

// Register Reorder Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_REORDER_CLUSTER))

// Register Shopping Order Tracking Cluster Publish Intent
  context.registerReceiver(AppEngageBroadcastReceiver(),
                           IntentFilter(Intents.ACTION_PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER))
}
 
class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received

// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received

// Trigger shopping cart cluster publish when PUBLISH_SHOPPING_CART broadcast is
// received

// Trigger shopping list cluster publish when PUBLISH_SHOPPING_LIST broadcast is
// received

// Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER broadcast is
// received

// Trigger reorder cluster publish when PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER
// broadcast is received
}

public static void registerBroadcastReceivers(Context context) {

context = context.getApplicationContext();

// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Shopping Cart Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_CART));

// Register Shopping List Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_LIST));

// Register Reorder Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_REORDER_CLUSTER));

// Register Shopping Order Tracking Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.shopping.service.Intents.ACTION_PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER));

}
  • Zadeklaruj statycznie implementację za pomocą tagu <receiver> w pliku AndroidManifest.xml. Dzięki temu aplikacja może odbierać intencje przesyłania, gdy nie jest uruchomiona, a także publikować treści.
<application>
   <receiver
      android:name=".AppEngageBroadcastReceiver"
      android:exported="true"
      android:enabled="true">
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CART" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LIST" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTER" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER" />
      </intent-filter>
   </receiver>
</application>

Usługa wysyła te intencje:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION W przypadku otrzymania tej intencji zalecamy rozpoczęcie publishRecommendationClusters.
  • com.google.android.engage.action.PUBLISH_FEATUREDZalecamy rozpoczęcie wywołania publishFeaturedCluster po otrzymaniu tej intencji.
  • com.google.android.engage.action.shopping.PUBLISH_SHOPPING_CARTZalecamy rozpoczęcie wywołania publishShoppingCart po otrzymaniu tej intencji.
  • com.google.android.engage.action.shopping.PUBLISH_SHOPPING_LISTZalecamy rozpoczęcie wywołania publishShoppingList po otrzymaniu tej intencji.
  • com.google.android.engage.action.shopping.PUBLISH_REORDER_CLUSTERZalecamy rozpoczęcie wywołania publishReorderCluster po otrzymaniu tej intencji.
  • com.google.android.engage.action.shopping.PUBLISH_SHOPPING_ORDER_TRACKING_CLUSTER Gdy otrzymasz tę intencję, zalecamy nawiązanie połączenia publishShoppingOrderTrackingCluster.

Proces integracji

Szczegółowy przewodnik po weryfikacji integracji po jej zakończeniu znajdziesz w artykule Proces integracji z Engage dla deweloperów.

Najczęstsze pytania

Najczęstsze pytania dotyczące Engage SDK znajdziesz w artykule Najczęstsze pytania dotyczące Engage SDK.

Kontakt

Jeśli masz pytania dotyczące procesu integracji, wyślij e-maila na adres engage-developers@google.com. Nasz zespół odpowiada tak szybko, jak to możliwe.

Dalsze kroki

Po zakończeniu tej integracji wykonaj te czynności:

  • Wyślij e-maila na adres engage-developers@google.com i załącz zintegrowany pakiet APK, który jest gotowy do przetestowania przez Google.
  • Google przeprowadza weryfikację i sprawdza integrację wewnętrznie, aby upewnić się, że działa ona zgodnie z oczekiwaniami. Jeśli będą potrzebne zmiany, Google skontaktuje się z Tobą, podając niezbędne informacje.
  • Gdy testy zostaną zakończone i nie trzeba będzie wprowadzać żadnych zmian, skontaktujemy się z Tobą, aby poinformować, że możesz rozpocząć publikowanie zaktualizowanego i zintegrowanego pliku APK w Sklepie Play.
  • Gdy Google potwierdzi, że zaktualizowany plik APK został opublikowany w Sklepie Play, Twoje grupy Rekomendacja, Polecane, Koszyk, Lista zakupów, Klaster ponownego zamówienia i Klaster śledzenia zamówień mogą zostać opublikowane i widoczne dla użytkowników.