Skip to content

google/wci

WCI - Conversion Import for Whatsapp

WCI is an open source solution that enables advertisers who offer a WhatsApp channel to measure, attribute, target and optimize their campaigns through signals received in-chat messages. The solution offers a way to integrate and track conversions that happen in business-account WhatsApp chats by linking clicked leads (click to chat) to final conversions (scheduled events, purchased through chat app, etc). As a result, WCI allows advertisers to bring visibility to the WhatsApp journey; measure in-WhatsApp chat interactions; attribute in-WhatsApp chat conversions and target audience-lists with Customer Match.

Disclaimer: This is not an officially supported Google product

How does it work?

  • User clicks on the Contact via WhatsApp link
  • A cloud function collects an identifier such as gclid and generates a unique protocol
  • The user is redirected to the WhatsApp with a pre-typed message with the generated protocol
  • Once the user sends the message, a cloud function / webhook associated with the WhatsApp Business Account - checks for the protocol and relates it to the gclid and phone number that the message was sent from

image

Prerequisites

  • Whatsapp Business Account

Deployment

In the Cloud Shell, execute the following command:

git clone https://github.com/google/wci && cd wci && sh ./deployment/deploy.sh

Updating WCI to the latest version

In the Cloud Shell, execute the following command:

git clone https://github.com/google/wci && cd wci && sh ./deployment/deploy.sh service=update

Guided Deployment

If you want to do a guided deployment through Cloud Shell, click the link below:
Open in Cloud Shell

Video-guided Deployment

Open on Youtube

Resources

Video-guided deployment
https://youtu.be/OVXIO5RMHX8

WCI’s source code
https://github.com/google/wci

WhatsApp Business Platform Cloud API
https://developers.facebook.com/docs/whatsapp/cloud-api/guides/set-up-webhooks

Google Cloud’s Artifacts Registry
https://cloud.google.com/artifact-registry/docs

Google Cloud’s Run
https://cloud.google.com/run/docs

Google Cloud’s BigQuery
https://cloud.google.com/bigquery/docs

Google Ads’ Conversion API
https://developers.google.com/google-ads/api/docs/conversions/overview

Google Ads’ Customer Match API
https://developers.google.com/google-ads/api/docs/remarketing/audience-types/customer-match

Google Ads’ Enhanced Conversion for Leads API
https://developers.google.com/google-ads/api/docs/conversions/upload-identifiers