अभियान मापन

यह दस्तावेज़, Android के लिए Google Analytics SDK v4 की मदद से कैंपेन और ट्रैफ़िक सोर्स को मेज़र करने की खास जानकारी देता है.

खास जानकारी

Google Analytics में कैंपेन को मेज़र करने से, ऐप्लिकेशन और कैंपेन के ट्रैफ़िक सोर्स का एट्रिब्यूशन, उपयोगकर्ता की गतिविधि में होता है. ये विकल्प Android के लिए Google Analytics SDK v4 में, कैंपेन और ट्रैफ़िक सोर्स एट्रिब्यूशन के लिए उपलब्ध हैं:

नीचे दिए गए सेक्शन में बताया जाएगा कि आपके ऐप्लिकेशन में हर तरह के कैंपेन मेज़रमेंट को कब और कैसे लागू करना है.

Google Play कैंपेन एट्रिब्यूशन

Google Play कैंपेन मेज़रमेंट की मदद से आप यह देख सकते हैं कि कौनसे कैंपेन और ट्रैफ़िक सोर्स, उपयोगकर्ताओं को Google Play Store से आपका ऐप्लिकेशन डाउनलोड करने के लिए भेज रहे हैं. यह सुझाव दिया जाता है कि सभी डेवलपर, Google Play Store कैंपेन मेज़रमेंट लागू करें.

Google Play कैंपेन एट्रिब्यूशन लागू करना

Google Play Store, डेवलपर को Google Play से रेफ़रल कॉन्टेंट को सुरक्षित रूप से वापस पाने के लिए, रेफ़रल देने वाला एपीआई इंस्टॉल करता है. यह API, रेफ़रलकर्ता पैरामीटर का मान दिखाता है, जिसका इस्तेमाल आपके ऐप्लिकेशन के 'Google Play Store' पेज तक पहुंचने पर किया जाता था, अगर कोई मौजूद हो.

किसी ऐप्लिकेशन के डाउनलोड को कैंपेन में एट्रिब्यूट करने के लिए, आपको 'Google Play Store' पर ले जाने वाले किसी भी लिंक में एक रेफ़रलकर्ता पैरामीटर जोड़ना होगा. साथ ही, अपने ऐप्लिकेशन को Google Analytics ट्रैकर के इंटेंट में मौजूद कैंपेन की जानकारी पाने और सेट करने के लिए, अपने ऐप्लिकेशन में Play का इंस्टॉल रेफ़रर एपीआई जोड़ना होगा.

1. AndroidManifest.xml फ़ाइल से Google Analytics पाने वाला हटाएं.

अगर आपने Google Tag Manager रिसीवर भी लागू किया हुआ है, तो उसे अपने मेनिफ़ेस्ट से भी हटाएं.

2. 'इंस्टॉलर रेफ़रर एपीआई लाइब्रेरी' पर निर्भरता जोड़ें.

डिपेंडेंसी जोड़ने के लिए, build.gradle में यह जानकारी शामिल करें:

dependencies {
    ...
    implementation 'com.android.installreferrer:installreferrer:1.1'
}

3. अपने ऐप्लिकेशन के लॉन्च गतिविधि में, इंस्टॉल का रेफ़रल देने वाला एपीआई कॉल करें.

इंस्टॉल किए गए ऐप्लिकेशन पैकेज का रेफ़रल देने वाला यूआरएल फिर से पाने के लिए, इंस्टॉल रेफ़रर एपीआई का इस्तेमाल करें. इसके बाद, यूआरएल वैल्यू को Google Analytics या Google Tag Manager के पाने वाले को भेजें. अपने ऐप्लिकेशन के लॉन्च गतिविधि में, इंस्टॉल का रेफ़रलकर्ता API (एपीआई) का इस्तेमाल करने के लिए नीचे दिए गए कोड से मिलते-जुलते कोड का पालन करें.

अगर ऐप्लिकेशन में एक से ज़्यादा एंट्री पॉइंट हैं, जैसे कि खास हिस्सों में डीप लिंक, तो आप ActivityLifecycleListener में बताए गए तरीकों को लागू कर सकते हैं. ये तरीके ActivityLifecycleCallbacks से ट्रिगर होते हैं.

package com.example.myapplication;

import static com.android.installreferrer.api.InstallReferrerClient.InstallReferrerResponse;

import androidx.appcompat.app.AppCompatActivity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.os.Handler;
import android.os.RemoteException;

import com.android.installreferrer.api.InstallReferrerClient;
import com.android.installreferrer.api.InstallReferrerStateListener;
import com.android.installreferrer.api.ReferrerDetails;
import com.google.android.gms.analytics.CampaignTrackingReceiver;
import com.google.tagmanager.InstallReferrerReceiver;

import java.util.concurrent.Executor;
import java.util.concurrent.Executors;

public class MainActivity extends AppCompatActivity {

    private final Executor backgroundExecutor = Executors.newSingleThreadExecutor();

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        checkInstallReferrer();
    }

    // TODO: Change this to use whatever preferences are appropriate. The install referrer should
    // only be sent to the receiver once.
    private final String prefKey = "checkedInstallReferrer";

    void checkInstallReferrer() {
        if (getPreferences(MODE_PRIVATE).getBoolean(prefKey, false)) {
            return;
        }

        InstallReferrerClient referrerClient = InstallReferrerClient.newBuilder(this).build();
        backgroundExecutor.execute(() -> getInstallReferrerFromClient(referrerClient));
    }

    void getInstallReferrerFromClient(InstallReferrerClient referrerClient) {

        referrerClient.startConnection(new InstallReferrerStateListener() {
            @Override
            public void onInstallReferrerSetupFinished(int responseCode) {
                switch (responseCode) {
                    case InstallReferrerResponse.OK:
                        ReferrerDetails response = null;
                        try {
                            response = referrerClient.getInstallReferrer();
                        } catch (RemoteException e) {
                            e.printStackTrace();
                            return;
                        }
                        final String referrerUrl = response.getInstallReferrer();


                        // TODO: If you're using GTM, call trackInstallReferrerforGTM instead.
                        trackInstallReferrer(referrerUrl);


                        // Only check this once.
                        getPreferences(MODE_PRIVATE).edit().putBoolean(prefKey, true).commit();

                        // End the connection
                        referrerClient.endConnection();

                        break;
                    case InstallReferrerResponse.FEATURE_NOT_SUPPORTED:
                        // API not available on the current Play Store app.
                        break;
                    case InstallReferrerResponse.SERVICE_UNAVAILABLE:
                        // Connection couldn't be established.
                        break;
                }
            }

            @Override
            public void onInstallReferrerServiceDisconnected() {

            }
        });
    }

    // Tracker for Classic GA (call this if you are using Classic GA only)
    private void trackInstallReferrer(final String referrerUrl) {
        new Handler(getMainLooper()).post(new Runnable() {
            @Override
            public void run() {
                CampaignTrackingReceiver receiver = new CampaignTrackingReceiver();
                Intent intent = new Intent("com.android.vending.INSTALL_REFERRER");
                intent.putExtra("referrer", referrerUrl);
                receiver.onReceive(getApplicationContext(), intent);
            }
        });
    }

    // Tracker for GTM + Classic GA (call this if you are using GTM + Classic GA only)
    private void trackInstallReferrerforGTM(final String referrerUrl) {
        new Handler(getMainLooper()).post(new Runnable() {
            @Override
            public void run() {
                InstallReferrerReceiver receiver = new InstallReferrerReceiver();
                Intent intent = new Intent("com.android.vending.INSTALL_REFERRER");
                intent.putExtra("referrer", referrerUrl);
                receiver.onReceive(getApplicationContext(), intent);
            }
        });
    }

}

4. Google Play के यूआरएल में Google Analytics के कैंपेन पैरामीटर जोड़ना

इसके बाद, ऐसे किसी भी यूआरएल में एक referrer पैरामीटर जोड़ें जो सीधे Google Play Store से लिंक होगा और उस पैरामीटर के मान को Google Analytics कैंपेन पैरामीटर की एक स्ट्रिंग पर सेट करेगा जो स्रोत का ब्यौरा देता है, जैसा कि इस उदाहरण में दिया गया है:

https://play.google.com/store/apps/details?id=com.example.application
&referrer=utm_source%3Dgoogle
%26utm_medium%3Dcpc
%26utm_term%3Drunning%252Bshoes
%26utm_content%3Dlogolink
%26utm_campaign%3Dspring_sale

कैंपेन पैरामीटर स्ट्रिंग बनाने का तरीका जानने के लिए, Google Play यूआरएल निर्माता का इस्तेमाल करें या कैंपेन पैरामीटर रेफ़रंस सेक्शन देखें.

सामान्य कैंपेन और ट्रैफ़िक सोर्स एट्रिब्यूशन

ऐप्लिकेशन इंस्टॉल होने के बाद, उसे विज्ञापन कैंपेन, वेबसाइटों या दूसरे ऐप्लिकेशन के रेफ़रल से लॉन्च किया जा सकता है. ऐसी स्थिति में, रेफ़र करने वाले ट्रैफ़िक सोर्स या मार्केटिंग कैंपेन को बाद के सेशन में उपयोगकर्ता की गतिविधि की जानकारी मिल सकती है. ऐसा करने के लिए, वे setCampaignParamsFromUrl पैरामीटर का इस्तेमाल करके, ट्रैकर पैरामीटर पर सीधे कैंपेन पैरामीटर सेट कर देते हैं.

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);

// Set screen name.
t.setScreenName(screenName);

// In this example, campaign information is set using
// a url string with Google Analytics campaign parameters.
// Note: This is for illustrative purposes. In most cases campaign
//       information would come from an incoming Intent.
String campaignData = "http://examplepetstore.com/index.html?" +
    "utm_source=email&utm_medium=email_marketing&utm_campaign=summer" +
    "&utm_content=email_variation_1";

// Campaign data sent with this hit.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCampaignParamsFromUrl(campaignData)
    .build()
);

getTracker तरीके के बारे में जानने के लिए, बेहतर कॉन्फ़िगरेशन देखें.

कैंपेन के पैरामीटर

कैंपेन पैरामीटर का इस्तेमाल, उन ट्रैफ़िक सोर्स और कैंपेन के बारे में जानकारी पास करने के लिए किया जाता है जो उपयोगकर्ताओं को आपके ऐप्लिकेशन पर लाते हैं.

नीचे दी गई टेबल में उपलब्ध कैंपेन पैरामीटर दिए गए हैं. इनका इस्तेमाल Google Play या सामान्य कैंपेन मेज़रमेंट में किया जा सकता है:

पैरामीटर जानकारी उदाहरण
utm_source कैंपेन का सोर्स; इसका इस्तेमाल किसी सर्च इंजन, न्यूज़लेटर या दूसरे सोर्स की पहचान करने के लिए किया जाता है utm_source=google
utm_medium कैंपेन का माध्यम; इसका इस्तेमाल ईमेल या हर क्लिक की लागत (सीपीसी) जैसे किसी माध्यम की पहचान करने के लिए किया जाता है utm_medium=cpc
utm_term कैंपेन शब्द; विज्ञापनों के लिए कीवर्ड देने के लिए, पैसे देकर की गई खोज के लिए इस्तेमाल किया जाता है utm_term=running+shoes
utm_content कैंपेन का कॉन्टेंट; A/B टेस्टिंग और कॉन्टेंट-टारगेट किए गए विज्ञापनों के लिए इस्तेमाल किया जाता है, ताकि एक ही यूआरएल पर ले जाने वाले विज्ञापनों या लिंक में अंतर किया जा सके utm_content=logolink
utm_content=textlink
utm_campaign कैंपेन का नाम; इसका इस्तेमाल किसी खास प्रॉडक्ट के प्रमोशन या रणनीति वाले कैंपेन को पहचानने के लिए, कीवर्ड का विश्लेषण करने के लिए किया जाता है utm_campaign=spring_sale
gclid Google Ads ऑटो-टैगिंग पैरामीटर; इसका इस्तेमाल विज्ञापनों को मेज़र करने के लिए किया जाता है. यह वैल्यू डाइनैमिक तौर पर जनरेट की जाती है. इसमें कभी बदलाव नहीं किया जाना चाहिए.

Google Play यूआरएल निर्माता

Google Play कैंपेन मेज़रमेंट के लिए यूआरएल जनरेट करने के लिए, नीचे दिए गए टूल का इस्तेमाल करें.