Pinterest Conversions API za Shopify: vodič za postavljanje

Pinterest Conversions API Pinterestov je način slanja događaja konverzije od poslužitelja do poslužitelja. Vaša web-trgovina ili alat poput ROASaurusa šalje događaje poput kupnji izravno na vaš Pinterest oglasni račun, umjesto da se oslanja samo na Pinterest Tag u pregledniku kupca. Pinterest podatke koristi za izvješćivanje o konverzijama, optimizaciju kampanja i ciljanje.

Ovaj vodič obuhvaća v5 API i događaje koje prihvaća, ID klika epik, način hashiranja podataka o kupcu, kako funkcionira deduplikacija s Pinterest Tagom, kako testirati i kako sve to postaviti na Shopifyju.

Što je Pinterest Conversions API?

Pinterest Tag je skripta u pregledniku kupca. Conversions API radi isti posao s poslužitelja. U verziji API-ja 5 događaje šaljete na endpoint za događaje svojeg oglasnog računa, autorizirane pristupnim tokenom za konverzije koji izradite u Pinterest Ads Manageru. Svaki događaj navodi gdje se dogodio: za web-trgovinu je izvor akcije web.

Pinterest traži od oglašivača koji uz Tag koriste i API da ne broje konverziju dvaput, tako da uz svaki događaj proslijede event_id. Traži i da se događaji šalju u stvarnom vremenu ili najkasnije sat vremena nakon što se dogode.

Na Shopifyju veza s poslužitelja ima jednu jasnu prednost: kupnje dolaze iz same narudžbe. Shopify svaku plaćenu narudžbu prijavljuje ROASaurusu webhookom, a ROASaurus je šalje Pinterestu ubrzo nakon plaćanja, bez obzira na to je li se Tag aktivirao u pregledniku. Vodič za praćenje na strani poslužitelja na Shopifyju objašnjava ideju podrobnije.

Koje događaje prihvaća Pinterest Conversions API?

Pinterest ima fiksan popis standardnih naziva događaja, napisanih malim slovima s podvlakama, poput page_visit, add_to_cart i checkout. Po oglašivaču možete definirati i do 15 prilagođenih tipova događaja. ROASaurus pet Shopifyjevih događaja kupovanja mapira ovako:

Naziv može zbuniti. Pinterestov checkout je dovršena kupnja, a ne početak naplate. Početak naplate zaseban je događaj, initiate_checkout.

Za događaj checkout Pinterest preporučuje slanje vrijednosti, valute, ID-a narudžbe, ID-ova sadržaja i broja stavki. ROASaurus šalje svih pet, uz količinu i cijenu svake stavke. Pinterest traži vrijednost prije poreza i dostave. Na Shopifyju ROASaurus šalje upravo to: ukupni iznos narudžbe umanjen za porez i dostavu, s poslužitelja i iz oznake u pregledniku. Kada web-trgovina ne prijavljuje porez i dostavu zasebno, ROASaurus šalje ukupni iznos narudžbe.

Kako Pinterest povezuje događaj s osobom?

Svaki događaj nosi korisničke podatke. Pinterest traži barem jedno od tri: hashiranu e-adresu, hashirani ID oglašavanja na mobilnom uređaju ili IP adresu zajedno s user agentom. Web-trgovina nema ID oglašavanja, pa joj trebaju e-adresa ili IP adresa i user agent. ROASaurus preskače događaj koji nema ni jedno ni drugo, umjesto da šalje onaj koji Pinterest ne može iskoristiti.

ID klika epik

Pinterestov ID klika može doći s dva mjesta: iz parametra epik u URL-u odredišne stranice ili iz kolačića _epik na vašoj domeni. Pinterestov vodič za API preporučuje prosljeđivanje vrijednosti kolačića _epik, jer i dalje radi kada parametra u URL-u nema ili je uklonjen, što daje bolje pokrivanje.

ROASaurus čita oboje na stranici vaše trgovine, koristeći parametar iz URL-a kada ga novi klik donese, a inače kolačić. ID klika pohranjuje uz posjetitelja i šalje ga u polju click_id svakog događaja s poslužitelja, uključujući kupnju. Posjeti s parametrom epik u ROASaurusovim izvješćima o atribuciji računaju se kao Pinterest posjeti.

POST https://api.pinterest.com/v5/ad_accounts/549755885175/events

{
  "data": [{
    "event_name": "checkout",
    "action_source": "web",
    "event_time": 1793016000,
    "event_id": "order-5512345678901",
    "event_source_url": "https://example-store.com/checkouts/…/thank-you",
    "user_data": {
      "em": ["a3f1…9c2e"],
      "ph": ["7b40…11d8"],
      "external_id": ["e05c…4a7f"],
      "client_ip_address": "203.0.113.24",
      "client_user_agent": "Mozilla/5.0 (iPhone; …)",
      "click_id": "dj0yJnU9…"
    },
    "custom_data": {
      "currency": "USD",
      "value": "84",
      "order_id": "5512345678901",
      "content_ids": ["44123456789"],
      "contents": [{ "id": "44123456789", "quantity": 2, "item_price": "42" }],
      "num_items": 2
    }
  }]
}

Kako funkcionira deduplikacija s Pinterest Tagom?

Ako Tag i API prijave istu kupnju, Pinterest prima dva događaja za jednu narudžbu. Da bi ih tretirao kao jedan, treba isti ID s obje strane: ID događaja u Tagu mora odgovarati event_id u događaju s poslužitelja. Pinterest zadržava prvi događaj koji primi i uklanja duplikate koji stignu unutar 48 sati.

ROASaurus ID kupnje gradi iz ID-a Shopify narudžbe. Kupnja iz narudžbe 5512345678901 ima ID događaja order-5512345678901, i u Tagu koji se aktivira u naplati i u događaju s poslužitelja.

Deduplicira se svih pet događaja

Svaki događaj u procesu kupnje u ROASaurusu ima jedan ID događaja, koji koristi Tag u pregledniku i događaj s poslužitelja. Tag za iste događaje koristi Pinterestove vlastite nazive: pagevisit, viewcontent, addtocart, initiatecheckout i checkout, koji odgovaraju nazivima page_visit, view_content, add_to_cart, initiate_checkout i checkout u API-ju. Kada rade oba, Pinterest zadržava jednu kopiju svake posjete stranici, pregleda proizvoda, dodavanja u košaricu, početka naplate i kupnje.

Možete ga pokrenuti na dva načina:

• Tag i Conversions API zajedno. Tag dodaje signale iz preglednika, poslužitelj nadopunjuje ono što Tag propusti, a Pinterest spaja kopije.
• Koristite API bez Taga. Ostavite ID Taga prazan ili isključite Also load the browser tag. Svaki se događaj tada šalje jednom, samo s poslužitelja.

Članak pomoći o dvostrukom brojanju obuhvaća iste provjere za ostale oglasne platforme.

Kako testirati Pinterest Conversions API?

API ima testnu zastavicu. Zahtjevi poslani s test=true idu u sandbox: Pinterest ih obrađuje kao testne podatke i ne koristi ih za izvješćivanje ni optimizaciju.

1. Uključite testni način

   U ROASaurusu uredite Pinterest piksel pod Tracking & platforms i označite Test mode (events show under Test events, max 20). Svaki se događaj s poslužitelja tada šalje s test=true. Pinterest obrađuje najviše 20 testnih događaja po seriji.

2. Napravite probnu narudžbu

   Posjetite svoju trgovinu, pregledajte proizvod, dodajte ga u košaricu i dovršite narudžbu.

3. Pročitajte rezultat

   Otvorite Event log. Pinterest može odgovoriti s HTTP 200 iako je jedan događaj u zahtjevu neuspješan, pa ROASaurus provjerava status svakog događaja i ondje prikazuje pogreške.

4. Isključite testni način

   Odznačite testni način kako bi se događaji računali u izvješćivanju i optimizaciji.

5. Provjerite Events Overview

   U Pinterest Ads Manageru otvorite stranicu Events Overview. Prikazuje događaje koji stižu i deduplicirane konverzije. Pinterest preporučuje ciljati na Good Event Quality Score.

Kako postaviti Pinterest Conversions API na Shopifyju s ROASaurusom

Trebate Shopify trgovinu s aplikacijom ROASaurus i pristup Pinterest Ads Manageru. Stranica Pinterest integracije navodi svako polje koje ROASaurus šalje.

1. Povežite svoju Shopify trgovinu

   Idite na Add a store › Shopify, kliknite Install app i uključite ugradnju aplikacije ROASaurus u uređivaču teme. Ona bilježi epik i kolačić _epik na svakoj stranici. Vodič za postavljanje Shopifyja prikazuje svaki korak.

2. Izradite pristupni token za konverzije

   U Pinterest Ads Manageru idite na Conversions i izradite pristupni token za konverzije. Zabilježite ID svojeg oglasnog računa.

3. Dodajte Pinterest piksel u ROASaurus

   Idite na Tracking & platforms, kliknite Add pixel na kartici Pinterest i ispunite Ad account ID i Conversion access token.

4. Dodajte svoj ID Taga

   Za deduplikaciju s Tagom ispunite Pinterest Tag ID i ostavite označeno Also load the browser tag. Bez ID-a Taga ROASaurus šalje samo događaje s poslužitelja i ne učitava Tag.

5. Dodajte piksel naplate

   U Shopify admin › Settings › Customer events dodajte prilagođeni piksel naziva ROASaurus i zalijepite isječak sa svoje stranice Tracking & platforms. On aktivira Tagov događaj checkout u Shopifyjevoj naplati, s ID-om narudžbe kao event_id.

6. Odaberite događaje s poslužitelja, pa testirajte

   Odaberite događaje s poslužitelja koje želite i prije puštanja u rad testirajte testnim načinom.

Kada je uključeno Respect visitor consent, što je zadano, ROASaurus poštuje izbor kupca u Shopifyjevu banneru za kolačiće. Kada kupac odbije marketinške kolačiće, ROASaurus za njega ne učitava Pinterest Tag, ne postavlja ID posjetitelja pa se njegovi klikovi ne povezuju s njim i ne šalje Pinterestu njegove događaje pregledavanja. Njegova plaćena narudžba i dalje se s poslužitelja šalje na Conversions API, s hashiranim podacima o narudžbi te IP adresom i user agentom narudžbe, ali bez ID-a klika. Vodič o privoli i privatnosti objašnjava što se pohranjuje i šalje.

Povežite svoj Pinterest oglasni račun pod Setup › Ad spend i ROASaurus svakog sata preuzima potrošnju kampanja, pa u analitici dobiti vidite Pinterest ROAS i dobit nakon oglasa. Vodič za TikTok Events API obuhvaća isto postavljanje za TikTok, gdje se deduplicira svaki događaj koji ide obama putevima.

Izvori

1. Pinterest Developers: Track conversion events in the API
2. Pinterest Business help: The Pinterest Conversions API
3. Pinterest Developers: Track conversions with Pinterest Tag

U ROASaurusu

• Integracija s Pinterestom
• Praćenje na strani poslužitelja u ROASaurusu
• Pomoć: sprječavanje dvostrukog brojanja

Nastavite čitati