Listy odbiorców remarketingu – przewodnik dla programistów

Z tego artykułu dowiesz się, jak zarządzać listami odbiorców remarketingu w Google Analytics za pomocą interfejsu API zarządzania.

Uwaga: korzystając z tego interfejsu API, musisz przestrzegać zasad korzystania z funkcji reklamowych Google Analytics, w tym zasad dotyczących reklam o charakterze kontrowersyjnym.

Wstęp

Interfejs API zarządzania umożliwia stosowanie list odbiorców remarketingu (create, get, delete, list, update i patch) w usłudze w Google Analytics. Więcej informacji o listach odbiorców remarketingu znajdziesz w artykule Listy odbiorców remarketingu w Analytics – informacje w Centrum pomocy.

Przykłady zastosowań

Zasób Odbiorcy remarketingu obsługuje funkcje uzyskiwania, usuwania, listy, poprawek i aktualizacji, ale najważniejsze przypadki użycia to:

• Lista odbiorców remarketingu.
• Utwórz nową listę odbiorców remarketingu.
• Aktualizowanie dotychczasowej listy odbiorców remarketingu

Uwaga: jeśli nie włączysz tagu do zbierania odpowiednich danych, listy odbiorców remarketingu pozostaną puste, a kampanie remarketingowe nie będą działać. Zacznij od włączenia Funkcji reklamowych w ustawieniach usługi w Google Analytics.

Lista odbiorców remarketingu

Aby wyświetlić listę wszystkich odbiorców remarketingu w usłudze:

1. Użyj interfejsu Management API lub Account Explorer, aby pobrać accountId i webPropertyId.
2. Wykonaj metodę list zasobu Odbiorcy remarketingu.

Szczegółowe informacje o metodzie list dla odbiorców remarketingu znajdziesz w dokumentacji interfejsu API.

Tworzenie nowej grupy odbiorców remarketingu

Aby utworzyć nową listę odbiorców remarketingu dla usługi:

1. Użyj interfejsu API zarządzania lub Account Explorera, aby pobrać accountId i webPropertyId.
2. Za pomocą interfejsu API zarządzania lub eksploratora kont pobierz identyfikator widoku (profilu) usługi linkedViews [].
3. Użyj kolekcji Połączenia z Google Ads, aby pobrać identyfikator konta Google Ads dla: linkedAdAccounts.linkedAccountId.
   • Właściwość linkedAdAccounts[] jest obecnie ograniczona do tylko 1 elementu linkedForeignAccount.
   • linkedAdAccounts[].type może mieć wartość ADWORDS_LINKS, DBM_LINKS, MCC_LINKS lub OPTIMIZE.
4. Skorzystaj z kolekcji Segmenty, aby zobaczyć opcje konfigurowania właściwości segment elementu includeConditions. Jeśli tworzysz listę odbiorców na podstawie stanu, zrób to samo w przypadku elementu excludeConditions. Aby dowiedzieć się, jak zdefiniować segment, przeczytaj informacje o segmentach.
   • includeConditions może opcjonalnie mieć wartości membershipDurationDays i daysToLookBack
   • Pole excludeConditions.exclusionDuration może mieć opcjonalnie wartość PERMANENT.
5. Wykonaj metodę insert zasobu Odbiorcy remarketingu.

Interfejs API umożliwia tworzenie 2 typów list odbiorców: SIMPLE i STATE_BASED. W przypadku list odbiorców typu SIMPLE wystarczy utworzyć tylko audienceDefinition z dodatnią wartością segment, bez operatora NOT (znak !). Jeśli chcesz uwzględnić warunek wykluczenia, musisz zdefiniować statebasedDefinition. Więcej informacji znajdziesz w artykule Listy odbiorców zależne od stanu. Więcej informacji znajdziesz w przykładzie referencyjnym.

Uwaga: możesz zdefiniować audienceDefinition lub stateBasedAudienceDefinition i ustawić audienceType na odpowiednią wartość. Obowiązuje też limit 2000 dozwolonych list odbiorców remarketingu. Zachowaj ostrożność, gdy automatyzujesz tworzenie list odbiorców remarketingu.

Aktualizowanie dotychczasowej listy odbiorców remarketingu

Aby zaktualizować istniejącą listę odbiorców remarketingu w usłudze:

1. Jeśli masz już identyfikator odbiorców remarketingu, możesz zadzwonić pod numer get. W przeciwnym razie możesz zadzwonić pod numer list i wybrać odbiorców, których chcesz zaktualizować.
2. Zaktualizuj wszystkie pola dostępne do zapisu i wywołaj metodę update, która przekazuje zaktualizowany obiekt odbiorców.

Uwaga: po utworzeniu listy odbiorców nie możesz zmienić jej audienceType. Inaczej mówiąc, jeśli lista odbiorców ma wartość audienceDefinition, nie możesz wywołać funkcji update z wartością stateBasedAudienceDefinition. Więcej informacji znajdziesz w artykule na temat odbiorców zależnych od stanu. Więcej informacji znajdziesz w przykładzie referencyjnym.